// // ZoneMinder Monitor Class Interfaces, $Date$, $Revision$ // Copyright (C) 2001-2008 Philip Coombes // // This program is free software; you can redistribute it and/or // modify it under the terms of the GNU General Public License // as published by the Free Software Foundation; either version 2 // of the License, or (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program; if not, write to the Free Software // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. // #ifndef ZM_MONITOR_H #define ZM_MONITOR_H #include #include #include #include "zm.h" #include "zm_coord.h" #include "zm_image.h" #include "zm_rgb.h" #include "zm_zone.h" #include "zm_event.h" class Monitor; #include "zm_group.h" #include "zm_camera.h" #include "zm_storage.h" #include "zm_utils.h" #include "zm_image_analyser.h" #include #include #define SIGNAL_CAUSE "Signal" #define MOTION_CAUSE "Motion" #define LINKED_CAUSE "Linked" // // This is the main class for monitors. Each monitor is associated // with a camera and is effectively a collector for events. // class Monitor { friend class MonitorStream; public: typedef enum { QUERY=0, CAPTURE, ANALYSIS } Purpose; typedef enum { NONE=1, MONITOR, MODECT, RECORD, MOCORD, NODECT } Function; typedef enum { LOCAL, REMOTE, FILE, FFMPEG, LIBVLC, CURL, } CameraType; typedef enum { ROTATE_0=1, ROTATE_90, ROTATE_180, ROTATE_270, FLIP_HORI, FLIP_VERT } Orientation; typedef enum { IDLE, PREALARM, ALARM, ALERT, TAPE } State; typedef enum { DISABLED, X264ENCODE, H264PASSTHROUGH, } VideoWriter; protected: typedef std::set ZoneSet; typedef enum { GET_SETTINGS=0x1, SET_SETTINGS=0x2, RELOAD=0x4, SUSPEND=0x10, RESUME=0x20 } Action; typedef enum { CLOSE_TIME, CLOSE_IDLE, CLOSE_ALARM } EventCloseMode; /* sizeof(SharedData) expected to be 340 bytes on 32bit and 64bit */ typedef struct { uint32_t size; /* +0 */ uint32_t last_write_index; /* +4 */ uint32_t last_read_index; /* +8 */ uint32_t state; /* +12 */ uint64_t last_event; /* +16 */ uint32_t action; /* +24 */ int32_t brightness; /* +28 */ int32_t hue; /* +32 */ int32_t colour; /* +36 */ int32_t contrast; /* +40 */ int32_t alarm_x; /* +44 */ int32_t alarm_y; /* +48 */ uint8_t valid; /* +52 */ uint8_t active; /* +53 */ uint8_t signal; /* +54 */ uint8_t format; /* +55 */ uint32_t imagesize; /* +56 */ uint32_t epadding1; /* +60 */ uint32_t epadding2; /* +64 */ /* ** This keeps 32bit time_t and 64bit time_t identical and compatible as long as time is before 2038. ** Shared memory layout should be identical for both 32bit and 64bit and is multiples of 16. */ union { /* +68 */ time_t startup_time; /* When the zmc process started. zmwatch uses this to see how long the process has been running without getting any images */ uint64_t extrapad1; }; union { /* +76 */ time_t last_write_time; uint64_t extrapad2; }; union { /* +84 */ time_t last_read_time; uint64_t extrapad3; }; uint8_t control_state[256]; /* +92 */ char alarm_cause[256]; } SharedData; typedef enum { TRIGGER_CANCEL, TRIGGER_ON, TRIGGER_OFF } TriggerState; /* sizeof(TriggerData) expected to be 560 on 32bit & and 64bit */ typedef struct { uint32_t size; uint32_t trigger_state; uint32_t trigger_score; uint32_t padding; char trigger_cause[32]; char trigger_text[256]; char trigger_showtext[256]; } TriggerData; /* sizeof(Snapshot) expected to be 16 bytes on 32bit and 32 bytes on 64bit */ struct Snapshot { struct timeval *timestamp; Image *image; void* padding; }; //TODO: Technically we can't exclude this struct when people don't have avformat as the Memory.pm module doesn't know about avformat #if 1 //sizeOf(VideoStoreData) expected to be 4104 bytes on 32bit and 64bit typedef struct { uint32_t size; uint64_t current_event; char event_file[4096]; timeval recording; // used as both bool and a pointer to the timestamp when recording should begin //uint32_t frameNumber; } VideoStoreData; #endif // HAVE_LIBAVFORMAT class MonitorLink { protected: unsigned int id; char name[64]; bool connected; time_t last_connect_time; #if ZM_MEM_MAPPED int map_fd; char mem_file[PATH_MAX]; #else // ZM_MEM_MAPPED int shm_id; #endif // ZM_MEM_MAPPED off_t mem_size; unsigned char *mem_ptr; volatile SharedData *shared_data; volatile TriggerData *trigger_data; volatile VideoStoreData *video_store_data; int last_state; uint64_t last_event; public: MonitorLink( int p_id, const char *p_name ); ~MonitorLink(); inline int Id() const { return id; } inline const char *Name() const { return( name ); } inline bool isConnected() const { return( connected ); } inline time_t getLastConnectTime() const { return( last_connect_time ); } bool connect(); bool disconnect(); bool isAlarmed(); bool inAlarm(); bool hasAlarmed(); }; protected: // These are read from the DB and thereafter remain unchanged unsigned int id; char name[64]; unsigned int server_id; // Id of the Server object unsigned int storage_id; // Id of the Storage Object, which currently will just provide a path, but in future may do more. CameraType type; Function function; // What the monitor is doing bool enabled; // Whether the monitor is enabled or asleep unsigned int width; // Normally the same as the camera, but not if partly rotated unsigned int height; // Normally the same as the camera, but not if partly rotated bool v4l_multi_buffer; unsigned int v4l_captures_per_frame; Orientation orientation; // Whether the image has to be rotated at all unsigned int deinterlacing; bool videoRecording; int savejpegs; VideoWriter videowriter; std::string encoderparams; std::vector encoderparamsvec; bool record_audio; // Whether to store the audio that we receive int brightness; // The statically saved brightness of the camera int contrast; // The statically saved contrast of the camera int hue; // The statically saved hue of the camera int colour; // The statically saved colour of the camera char event_prefix[64]; // The prefix applied to event names as they are created char label_format[64]; // The format of the timestamp on the images Coord label_coord; // The coordinates of the timestamp on the images int label_size; // Size of the timestamp on the images int image_buffer_count; // Size of circular image buffer, at least twice the size of the pre_event_count int pre_event_buffer_count; // Size of dedicated circular pre event buffer used when analysis is not performed at capturing framerate, // value is pre_event_count + alarm_frame_count - 1 int warmup_count; // How many images to process before looking for events int pre_event_count; // How many images to hold and prepend to an alarm event int post_event_count; // How many unalarmed images must occur before the alarm state is reset int stream_replay_buffer; // How many frames to store to support DVR functions, IGNORED from this object, passed directly into zms now int section_length; // How long events should last in continuous modes bool adaptive_skip; // Whether to use the newer adaptive algorithm for this monitor int frame_skip; // How many frames to skip in continuous modes int motion_frame_skip; // How many frames to skip in motion detection double analysis_fps; // Target framerate for video analysis unsigned int analysis_update_delay; // How long we wait before updating analysis parameters int capture_delay; // How long we wait between capture frames int alarm_capture_delay; // How long we wait between capture frames when in alarm state int alarm_frame_count; // How many alarm frames are required before an event is triggered int fps_report_interval; // How many images should be captured/processed between reporting the current FPS int ref_blend_perc; // Percentage of new image going into reference image. int alarm_ref_blend_perc; // Percentage of new image going into reference image during alarm. bool track_motion; // Whether this monitor tries to track detected motion int signal_check_points; // Number of points in the image to check for signal Rgb signal_check_colour; // The colour that the camera will emit when no video signal detected bool embed_exif; // Whether to embed Exif data into each image frame or not bool last_signal; double fps; unsigned int last_camera_bytes; Image delta_image; Image ref_image; Image alarm_image; // Used in creating analysis images, will be initialized in Analysis Image write_image; // Used when creating snapshot images Purpose purpose; // What this monitor has been created to do int event_count; int image_count; int ready_count; int first_alarm_count; int last_alarm_count; int buffer_count; int prealarm_count; State state; time_t start_time; time_t last_fps_time; time_t auto_resume_time; unsigned int last_motion_score; EventCloseMode event_close_mode; #if ZM_MEM_MAPPED int map_fd; char mem_file[PATH_MAX]; #else // ZM_MEM_MAPPED int shm_id; #endif // ZM_MEM_MAPPED off_t mem_size; unsigned char *mem_ptr; SharedData *shared_data; TriggerData *trigger_data; VideoStoreData *video_store_data; Snapshot *image_buffer; Snapshot next_buffer; /* Used by four field deinterlacing */ Snapshot *pre_event_buffer; Camera *camera; Event *event; Storage *storage; int n_zones; Zone **zones; struct timeval **timestamps; Image **images; const unsigned char *privacy_bitmask; std::thread *event_delete_thread; // Used to close events, but continue processing. int n_linked_monitors; MonitorLink **linked_monitors; std::vector groups; public: explicit Monitor( int p_id ); // OurCheckAlarms seems to be unused. Check it on zm_monitor.cpp for more info. //bool OurCheckAlarms( Zone *zone, const Image *pImage ); Monitor( int p_id, const char *p_name, unsigned int p_server_id, unsigned int p_storage_id, int p_function, bool p_enabled, const char *p_linked_monitors, Camera *p_camera, int p_orientation, unsigned int p_deinterlacing, int p_savejpegs, VideoWriter p_videowriter, std::string p_encoderparams, bool p_record_audio, const char *p_event_prefix, const char *p_label_format, const Coord &p_label_coord, int label_size, int p_image_buffer_count, int p_warmup_count, int p_pre_event_count, int p_post_event_count, int p_stream_replay_buffer, int p_alarm_frame_count, int p_section_length, int p_frame_skip, int p_motion_frame_skip, double p_analysis_fps, unsigned int p_analysis_update_delay, int p_capture_delay, int p_alarm_capture_delay, int p_fps_report_interval, int p_ref_blend_perc, int p_alarm_ref_blend_perc, bool p_track_motion, int p_signal_check_points, Rgb p_signal_check_colour, bool p_embed_exif, Purpose p_purpose, int p_n_zones=0, Zone *p_zones[]=0 ); ~Monitor(); void AddZones( int p_n_zones, Zone *p_zones[] ); void AddPrivacyBitmask( Zone *p_zones[] ); bool connect(); inline int ShmValid() const { return( shared_data->valid ); } inline int Id() const { return id; } inline const char *Name() const { return name; } inline Storage *getStorage() { if ( ! storage ) { storage = new Storage( storage_id ); } return storage; } inline Function GetFunction() const { return( function ); } inline bool Enabled() { if ( function <= MONITOR ) return false; return enabled; } inline const char *EventPrefix() const { return event_prefix; } inline bool Ready() { if ( function <= MONITOR ) return false; return( image_count > ready_count ); } inline bool Active() { if ( function <= MONITOR ) return false; return( enabled && shared_data->active ); } inline bool Exif() { return embed_exif; } Orientation getOrientation() const; unsigned int Width() const { return width; } unsigned int Height() const { return height; } unsigned int Colours() const; unsigned int SubpixelOrder() const; int GetOptSaveJPEGs() const { return savejpegs; } VideoWriter GetOptVideoWriter() const { return videowriter; } const std::vector* GetOptEncoderParams() const { return &encoderparamsvec; } uint64_t GetVideoWriterEventId() const { return video_store_data->current_event; } void SetVideoWriterEventId( unsigned long long p_event_id ) { video_store_data->current_event = p_event_id; } unsigned int GetPreEventCount() const { return pre_event_count; }; State GetState() const; int GetImage( int index=-1, int scale=100 ); Snapshot *getSnapshot() const; struct timeval GetTimestamp( int index=-1 ) const; void UpdateAdaptiveSkip(); useconds_t GetAnalysisRate(); unsigned int GetAnalysisUpdateDelay() const { return analysis_update_delay; } int GetCaptureDelay() const { return capture_delay; } int GetAlarmCaptureDelay() const { return alarm_capture_delay; } unsigned int GetLastReadIndex() const; unsigned int GetLastWriteIndex() const; uint64_t GetLastEventId() const; double GetFPS() const; void ForceAlarmOn( int force_score, const char *force_case, const char *force_text="" ); void ForceAlarmOff(); void CancelForced(); TriggerState GetTriggerState() const { return (TriggerState)(trigger_data?trigger_data->trigger_state:TRIGGER_CANCEL); } inline time_t getStartupTime() const { return shared_data->startup_time; } inline void setStartupTime( time_t p_time ) { shared_data->startup_time = p_time; } void actionReload(); void actionEnable(); void actionDisable(); void actionSuspend(); void actionResume(); int actionBrightness( int p_brightness=-1 ); int actionHue( int p_hue=-1 ); int actionColour( int p_colour=-1 ); int actionContrast( int p_contrast=-1 ); int PrimeCapture() const; int PreCapture() const; int Capture(); int PostCapture() const; int Close(); unsigned int DetectMotion( const Image &comp_image, Event::StringSet &zoneSet ); // DetectBlack seems to be unused. Check it on zm_monitor.cpp for more info. //unsigned int DetectBlack( const Image &comp_image, Event::StringSet &zoneSet ); bool CheckSignal( const Image *image ); bool Analyse(); void DumpImage( Image *dump_image ) const; void TimestampImage( Image *ts_image, const struct timeval *ts_time ) const; bool closeEvent(); void Reload(); void ReloadZones(); void ReloadLinkedMonitors( const char * ); bool DumpSettings( char *output, bool verbose ); void DumpZoneImage( const char *zone_string=0 ); std::vector Groups(); StringVector GroupNames(); static int LoadMonitors(std::string sql, Monitor **&monitors, Purpose purpose); // Returns # of Monitors loaded, 0 on failure. #if ZM_HAS_V4L static int LoadLocalMonitors(const char *device, Monitor **&monitors, Purpose purpose); #endif // ZM_HAS_V4L static int LoadRemoteMonitors(const char *protocol, const char *host, const char*port, const char*path, Monitor **&monitors, Purpose purpose); static int LoadFileMonitors(const char *file, Monitor **&monitors, Purpose purpose); #if HAVE_LIBAVFORMAT static int LoadFfmpegMonitors(const char *file, Monitor **&monitors, Purpose purpose); #endif // HAVE_LIBAVFORMAT static Monitor *Load(unsigned int id, bool load_zones, Purpose purpose); static Monitor *Load(MYSQL_ROW dbrow, bool load_zones, Purpose purpose); //void writeStreamImage( Image *image, struct timeval *timestamp, int scale, int mag, int x, int y ); //void StreamImages( int scale=100, int maxfps=10, time_t ttl=0, int msq_id=0 ); //void StreamImagesRaw( int scale=100, int maxfps=10, time_t ttl=0 ); //void StreamImagesZip( int scale=100, int maxfps=10, time_t ttl=0 ); #if HAVE_LIBAVCODEC //void StreamMpeg( const char *format, int scale=100, int maxfps=10, int bitrate=100000 ); #endif // HAVE_LIBAVCODEC }; #define MOD_ADD( var, delta, limit ) (((var)+(limit)+(delta))%(limit)) #endif // ZM_MONITOR_H