Go to documentation repository
The CAM object corresponds to the Camera system object.
The CAM object sends the events given in the table. Procedure is started when the corresponding event occurs.
Description of the events from the CAM object.
Events | Description | Comment |
ARM | Camera is armed | If arming was performed by the Operator from the Map or Video surveillance monitor, the user_id<> parameter contains the identifier of the user who performed this action |
ATTACH | Connecting | |
BLINDING | Camera is sealed | |
DETACH | Break | Event is generated when the input signal from the camera on the video capture device is lost |
DISARM | Camera is disarmed | If disarming was performed by the Operator from the Map or Video surveillance monitor, the user_id<> parameter contains the identifier of the user who performed this action |
FILE_REC_ERROR | Error of recording on disk | Event is generated when an error occurs when writing the video archive to disk |
MD_START | Alarm | |
MD_STOP | End of alarm | |
Print frame | ||
REC | Recording on disk | If recording was initiated by the Operator from the Map or Video surveillance monitor, the user_id<> parameter contains the identifier of the user who performed this action |
REC_STOP | Stop recording on disk | If recording was stopped by the Operator from the Map or Video surveillance monitor, the user_id<> parameter contains the identifier of the user who performed this action |
UNBLINDING | Camera is opened | |
RECORDER_ON | Record is enabled | |
RECORDER_OFF | Record is disabled | |
DISC_MOUNT | Disk is mounted | |
DISC_UNMOUNT | Disk is unmounted | |
FINISHED_AVI_EXPORT | Video export is completed | If the video export fails, the event has the non-null error_result parameter. In the param<0> parameter there is additional information displayed in the corresponding column of the Event Viewer, in the following format: "ComputerName;ExportPeriod;UserName;UserID", for example, param0<LOCALHOST;04-06-18 16:50:55_04-06-18 16:55:55;Smith;1> |
| MD_LIMIT | Object count in a frame exceeded | The event is generated when the number of objects detected by the tracker in the frame is exceeded (see Creating and configuring the Tracker object section of the Administrator's Guide for details on how to set this parameter). An event is generated whenever the number of objects is changed (up or down), until it is less than the threshold. The object_count<> parameter is the number of objects in the frame that the tracker detected, exceeds the specified limit, and differs from the previous value. See also the description of the NEW_OBJECT event below |
| NEW_OBJECT | New object on a frame detected by tracker | Among others, it contains the following parameters:
|
| ARCH_DELETE | Record deletion | Deletion of the record from the camera archive from the Video surveillance monitor |
| OPEN_FILE | File opening | Opening a file for playback by a virtual video capture device. Indicates that playback of the next file from the selected folder starts. Among others, the event contains the following parameters:
|
| CLOSE_FILE | File closing | Finishing a file playback in a virtual video capture device. Indicates that playback of a file is ended. Among others, the event contains the following parameters:
|
| ARCH_PROTECTED | File protected from rewriting | The event is displayed when a user protects the file from being overwritten. The param<0> parameter contains additional information about the computer name, fragment, user name and user id, which is displayed in the Add. Info column in the Event Viewer in the following format: "ComputerName;ProtectionPeriod;UserName;UserID", for example, param0<LOCALHOST;04-06-18 16:50:55.612_04-06-18 16:55:55.612;Smith;1> |
| ARCH_UNPROTECTED | Rewrite protection removed from file | The event is displayed when a user removes protection of the file from being overwritten. The param<0> parameter contains additional information about the computer name, fragment, user name and user id, which is displayed in the Add. Info column in the Event Viewer in the following format: "ComputerName;ProtectionPeriod;UserName;UserID", for example, param0<LOCALHOST;04-06-18 16:50:55.612_04-06-18 16:55:55.612;Smith;1> |
| FRAME_SKIPPED | Frames skipped | The FRAME_SKIPPED event occurs in Axxon PSIM if there are frames skipped when recording to the archive. By default, the event is generated if there were more than 50 frame skips during the testing period. When frame skipping stops, the FRAME_SKIPPED_STOP event is generated. The description of this event contains information about the number of skipped frames and the time period in which there were skips. By default, both events are generated no more than once every 30 seconds. The events are controlled by the following registry keys (see Registry keys reference guide):
|
| FRAME_SKIPPED_STOP | End of frames skipping | |
| ARCH_BOOKMARKED | Bookmark created | The event is displayed when a user adds a bookmark. The param<0> (i.e. the Add. Info column in the Event Viewer) parameter contains the comment to the bookmark |
| ARCH_UNBOOKMARKED | Bookmark deleted | The event is displayed when a user deletes a bookmark |
| TEMPERATURE_ALARM | Temperature threshold | The param0<> parameter contains the temperature value received from the thermal camera |
| IGNORE_KEEP_NO_LESS | Ignoring "Keep no less than" | The event is generated when a video fragment is deleted from the archive before expiration of the time period set by the Keep no less than parameter. See also Configuring video camera archive depth |
| AVAILABILITY | Availability of the key position in the license file and the number of objects | The event occurs in response to the GET_AVAILABILITY command and contains information about the number of objects added to the license key for the given position. Parameters:
If there is no position in the key, the event will have a zero value |
| WRITING_FAILED | Writing error | |
| FILESYSTEM_FAILED | File system error | Contains mandatory parameter error_msg<>—error text; can also contain parameters cam<>—camera ID and error_code<>—error code. Example: CAM|-1|FILESYSTEM_FAILED|error_msg<Failed to delete index file: D:\\VIDEO\\INDEX\\14061608.idx, error code: 5.>,error_code<5> |
The list of commands and parameters for the CAM object is given in the following table:
Command—command description | Parameters | Description of parameters |
SETUP—sets (changes) the parameters of a camera | rec_priority<> | Record priority (from 0 to 3, 0—standard, 3—all resources) |
compression<> | Compression ration (0—no compression, 1—maximum quality, …, 5—minimum quality) | |
sat_u<> | Value of color (0—min, 10—max) | |
proc_time<> | Append period (0–30 sec) | |
manual<> | Control brightness and contrast settings (0—manual; 1—auto; 2—auto, but close to values specified manually) | |
contrast<> | Contrast (0—min, 10—max) | |
md_size<> | Size of motion detection objects (1–16) | |
md_mode<> | Mode of pause record (1—enabled, 0—disabled) | |
audio_type<> | Type of sound accompaniment | |
pre_rec_time<> | Time of pre-record (0–20 sec) | |
bright<> | Brightness (0—min, 10—max) | |
audio_id<> | Number of a microphone (empty parameter if there is no microphone) | |
rec_time<> | Record speed (1–30 FPS, 0—not used) | |
alarm_rec<> | Record of alarms (1—enabled, 0—disabled) | |
hot_rec_time<> | Time of hot record (0–30 sec) | |
hot_rec_period<> | Period of hot record (0–20 sec) | |
mux<> | Number of channel (0–1 channel, 15–16 channel) | |
color<> | Color (0—black and white, 1—multicolor) | |
activity<> | - | |
arch_days<> | Number of archive days | |
blinding<> | Camera is sealed | |
config_id<> | - | |
decoder<> | - | |
flags<> | Flags | |
fps<> | Speed of record (0—not used, 1–30 FPS) | |
ifreq<> | Frequency of key frames in sequence (1—each frame is key, 2—100th frame) | |
mask 0, mask1, mask2, mask3, mask4 | Detection tool mask | |
md_contrast<> | Sensitivity of motion detection tool (0–15) | |
motion<> | Estimation of compressor motion (5–255) | |
name<> | Object name | |
password_crc<> | Video archive password | |
priority<> | Priority of record resource (0—auto, 1—manual) | |
resolution<> | Resolution (0—standard CIF, 1—high 2CIF, 2—maximum 4CIF) | |
type<> | Type of object | |
yuv<> | Color schema of video signal coding (0—YUV4:2:0, 1—YUV4:2:2) | |
DELETE—disables camera | - | - |
START_VIDEO—enables video stream for the current camera | slave_id<> | Name of the computer to which the camera is connected |
comress<> | Level of compression | |
register_only<> | - | |
STOP_VIDEO—disables video stream for the current camera | slave_id<> | Name of computer to which camera is connected |
REQUEST_MASK | mask<> | Mask |
MUX1, MUX2, MUX3—display the image of a camera on 1, 2, 3 analog outputs | - | - |
ACTIVATE—display camera on monitor | monitor<> | Number of a monitor |
ARM—arm camera | - | - |
DISARM—disarm camera | - | - |
REC—start recording from a camera | time<> | Time of record in seconds, if null than only one frame is recorded |
rollback<> | If 1, the record is performed with a rollback | |
priority<> | Sets priority of command to start recording. See Appendix 1. Priorities of the start and stop recording commands | |
| stream_id<> | Sets an identification number of a stream for recording. The stream ID is set as "n.m" where n is the camera ID, m is the number of the stream. Note. If the specified stream isn't used for any purpose other than record by command (and custom on clients), make sure that the Lock disabling streams not in use checkbox is set for it—see The Settings panel of the Camera object | |
REC_STOP—stop recording from a camera | priority<> | Sets priority of a command to stop recording. See Appendix 1. Priorities of the start and stop recording commands |
| user_id<> | If recording was stopped by a user from the Video surveillance monitor, the parameter contains the user ID. Otherwise the parameter is absent | |
| from_macro<> | If recording was stopped by a macro, the parameter contains the macro ID. Otherwise the parameter is absent | |
SET_MASK—set mask | mask<> | Mask |
ADD_SUBTITLES—add titles | command<> | Test of imposed titles |
title_id<> | The ID of the Captioner object which is used to impose | |
page<> | Required parameter to allow recording titles to the titles database to provide search by titles. Available values: BEGIN (start of recording in the database), END (end of recording in the database) | |
SIP_CONNECT—Sip connected | - | - |
SIP_DISCONNECT—Sip disconnected | - | - |
SET_IPINT_PARAM—set (change) the parameters of an IP device. Reaction allows changing the IP device settings without going into its web-interface. Note. For reaction operation it is required to enable the mode of multi-flow video signal—see Configuration of multistream video and Appendix 2. Defining the param_id and param_value values for the SET_IPINT_PARAM reaction | param_id<> | Name of a parameter. Set of parameters for each camera is individual—see Appendix 2. Defining the param_id and param_value values for the SET_IPINT_PARAM reaction |
param_value<> | Value of a parameter. Set of parameters for each camera is individual—see Appendix 2. Defining the param_id and param_value values for the SET_IPINT_PARAM reaction | |
vstream_id<> | Number of a video stream (optional parameter). It is given by “Number of camera”.”Number of a stream”, for example 1.1, 1.2 | |
GET_FRAME—get frame from a camera even if it is not displayed in the Video surveillance monitor | path<> | Path to save a frame. If there is no parameter, the FRAME_SENT event with the data parameter will be formed in the system. Processing of this event is described in The SaveToFile method of the The Script object. Programming using the JScript language |
| stream<> | Optional parameter. Sets Axxon PSIM stream to get a frame from. The stream can be specified by a number or purpose. Possible purposes:
Stream number consists of a camera ID and a stream ID divided by dot, for example, 4.3 is for stream 3 from camera 4 | |
| time<> | Optional parameter. It is set to request video frame from the archive. Format: DD-MM-YYYY hh:mm:ss. Example: time<19-09-2017 11:35:34> | |
| gate<> | Optional parameter. Specifies the network name of the Videogate from the archive of which to get the frame | |
| arch<> | Optional parameter. Specifies the network name of the Backup archive to get the frame from | |
| slave_id<> | Optional parameter. Specifies the network name of the Server to get the frame from | |
| password_crc<> | Optional parameter. Specifies the CRC sequence to be recorded to the file together with the frame | |
| ARCH_DEL_RECORD—delete archive recordings over the specified period. | fromTime<> | Mandatory parameter. Time in the YYYY-MM-DDTHH: MM: SS.NNN format, where NNN—milliseconds. The recordings will be deleted (starting with the first one containing the specified time and ending with the last one containing the toTime time). If no time is specified in the toTime parameter, then only one recording will be deleted |
| toTime<> | Optional parameter. Time in the YYYY-MM-DDTHH: MM: SS.NNN format, where NNN—milliseconds. See description above | |
| REC_RESTART—restart recording | - | - |
| ARCH_BOOKMARK_RECORD—create a bookmark | time1<> | The date of the archive period beginning included in the bookmark in the DD-MM-YY HH: MM: SS.NNN format, where NNN - milliseconds |
| time2<> | The date of the archive period ending included in the bookmark in the DD-MM-YY HH: MM: SS.NNN format, where NNN— milliseconds | |
| comment<> | Comment to a bookmark | |
| slave_id<> | Computer and Video surveillance monitor IDs using which the bookmark will be created. Parameter format: <computer id>.<monitor id>. For example, slave_id<WS2.1>—WS2 is a computer ID and 1 is Video surveillance monitor ID | |
| CRUISE_START—auto cruise | cruise_id<> | Route name on a camera |
| action<> | Executed action:
| |
| cam_id<> | Camera ID | |
| GET_DEPTH—get the archive depth. The ARCHIVE_DEPTH event from the SLAVE object (see SLAVE Computer) is created in the system as the response to this reaction. If one or both parameters are absent it means that there is the archive depth request for all possible parameters | drive<> | Disk or network path to request the archive depth. The disk name is set in the "<disk letter>:\\" format, for example drive<D:\\> Note. The "\" character is an escape character. The network path is set in the UNC format |
| arch | Get the backup archive depth. Example. DoReactStr("CAM","2","GET_DEPTH","drive<D:\\>,cam<2>,arch"); | |
| gate | Get the videogate archive depth. Example. DoReactStr("CAM","1","GET_DEPTH","drive<V:\\>,gate"); | |
| CLEAR_SUBTITLES—remove all titles from the video image | title_id<> | The ID of the Captioner object |
| GET_AVAILABILITY—check the availability of the key position | pos<> | The position number in the license key |
Properties of the CAM object are shown in the table.
Properties of the CAM object | Description of the object properties |
ID<> | Object ID |
PARENT_ID<> | Parent object ID |
TELEMETRY_ID<> | Telemetry module ID (PTZ ID) |
REGION_ID<> | Region ID |
The CAM object can be in the following states.
State of CAM object | Description |
ALARMED | Camera is in alarm mode. |
DISARM_DETACHED | No signal from camera |
DETACHED | No signal from camera |
ARMED | Camera is armed |
DISARMED | Camera is disarmed |
Overview
Content Tools