Documentation for Axxon PSIM 2.0. Documentation for other versions of Axxon PSIM is available too.

Previous page Next page


The CAM object corresponds to the Camera system object.

The CAM object sends the events given in the table. The procedure is started when the corresponding event occurs.

Description of the events from the CAM object.

Events

Description of events

Comment

ARM

The camera is armed

If the operator armed the camera from the map or video surveillance monitor, the user_id<> parameter contains the identifier of the user who performed this action

ATTACH

Connecting

NA

BLINDING

The camera is blinded

NA

DETACH

Break

The event is generated when the input signal from the camera on the video capture device is lost

DISARM

The camera is disarmed

If the operator disarmed the camera from the map or video surveillance monitor, the user_id<> parameter contains the identifier of the user who performed this action

FILE_REC_ERROR

Writing to disk error

The event is generated when an error occurs when writing the video archive to disk

MD_START

Alarm

NA

MD_STOP

End of alarm

NA

PRINT

Print frame

NA

REC

Writing to disk

If the operator initiated the recording from the map or video surveillance monitor, the user_id<> parameter contains the identifier of the user who performed this action

REC_STOP

Stop writing to disk

If the operator stopped the recording from the map or video surveillance monitor, the user_id<> parameter contains the identifier of the user who performed this action

UNBLINDING

The camera is unblinded

NA

RECORDER_ON

Recording is on

NA

RECORDER_OFF

Recording is off

NA

DISC_MOUNT

The disk is mounted

NA

DISC_UNMOUNT

The disk is unmounted

NA

FINISHED_AVI_EXPORT

Video export is completed

If the video export fails, the event has a 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_LIMITThe number of objects in the frame is exceeded

The event is generated when the number of objects detected by the tracker in the frame is exceeded (see Create and configure the Tracker object). 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_OBJECTThe tracker detected a new object in a frame

Among others, it contains the following parameters:

  • total<> is the total number of objects in the frame at the time the event occurred
  • new_id<> is the identifier of the detected object
ARCH_DELETERecord deletionDeletion of the record from the camera archive from the video surveillance monitor
OPEN_FILEFile 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:

  • name<> is the name of the file being played back
  • tss<> is the time in UTC format in milliseconds from 1/1/1970
CLOSE_FILEFile closing 

Finishing a file playback by a virtual video capture device. Indicates that playback of a file has ended.

Among others, the event contains the following parameters:

  • name<> is the name of the file that finished being played back
  • tss<> is the time in UTC format in milliseconds from 1/1/1970
ARCH_PROTECTEDFile protected from overwriting

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, username, and user ID that 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_UNPROTECTEDOverwrite protection removed from file

The event is displayed when a user removes protection from the file from being overwritten.

The param<0> parameter contains additional information about the computer name, fragment, username, and user ID that 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_SKIPPEDFrames 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 are 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):

  • You can disable the FRAME_SKIPPED event using the FileSystem.NotifyCoreFrameSkipped registry key.

  • The delay time between the state changes in seconds is specified in the FileSystem.RecordingStateChangeDelay key.
    The minimum value is 30 seconds. If you specify a smaller value, the minimum value of 30 seconds will still be used (the key in the registry will be overwritten).
  • The number of skipped frames for the period, during which the FRAME_SKIPPED event will be generated, is specified in the FileSystem.MaxSkippedFramesByPeriod key
FRAME_SKIPPED_STOPEnd of frames skipping
ARCH_BOOKMARKEDBookmark created

The event is displayed when a user adds a bookmark.

The param<0> parameter (in the Add. Info column in the event viewer) contains the comment to the bookmark

ARCH_UNBOOKMARKEDBookmark deleted

The event is displayed when a user deletes a bookmark

ARCH_UNBOOKMARK_PERIODBookmarks within a certain period of time deleted

The event is displayed when the user deletes bookmarks within a specific time period.

All bookmarks whose time period overlaps the one specified in this command are also deleted

TEMPERATURE_ALARMTemperature threshold

The param0<> parameter contains the temperature value received from the thermal camera

IGNORE_KEEP_NO_LESSIgnoring "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 Store no less than parameter. See also Configuration of the camera archive depth
AVAILABILITYAvailability 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:

  • qty_localpriority<> is the number of allowed objects of the specified type on this computer (local key).
  • qty<> is the total number of allowed objects of the specified type in the license (generic key).
  • pos<> is the position number in the license key

If there is no position in the key, the event has a zero value

WRITING_FAILEDWriting errorNA
FILESYSTEM_FAILEDFile 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.

Commandcommand description

Parameters

Description of parameters

SETUPsets (changes) the parameters of a camera

rec_priority<>

Record priority (from 0 to 3, 0standard, 3all resources)

compression<>

Compression ratio (0no compression, 1maximum quality, …, 5minimum quality)

sat_u<>

Color saturation (0min, 10max)

proc_time<>

Additional recording period (0–30 sec)

manual<>

Control brightness and contrast settings (0manual; 1auto; 2auto, but close to values specified manually)

contrast<>

Contrast (0min, 10max)

md_size<>

Size of motion detector objects (1–16)

md_mode<>

Mode of pause record (1enabled, 0disabled)

audio_type<>

Type of sound accompaniment

pre_rec_time<>

Time of pre-record  (0–20 sec)

bright<>

Brightness (0min, 10max)

audio_id<>

Number of a microphone (empty parameter if there is no microphone)

rec_time<>

Record speed (1–30 FPS, 0not used)

alarm_rec<>

Recording of alarms (1enabled, 0disabled)

hot_rec_time<>

Time of hot record (0–30 sec)

hot_rec_period<>

Period of hot record (0–20 sec)

mux<>

Number of a channel (0–1 channel, 15–16 channel)

color<>

Color (0black and white, 1multicolor)

activity<>

NA

arch_days<>

Number of archive days

blinding<>

The camera is blinded

config_id<>

NA

decoder<>

NA

flags<>

Flags

fps<>

Speed of recording (0not used, 1–30 FPS)

ifreq<>

Frequency of key frames in sequence (1each frame is key, 2100th frame)

mask 0, mask1, mask2, mask3, mask4

Detector mask

md_contrast<>

Sensitivity of motion detector (0–15)

motion<>

Estimation of compressor motion (5–255)

name<>

Object name

password_crc<>

Video archive password

priority<>

Priority of record resource (0auto, 1manual)

resolution<>

Resolution (0standard CIF, 1high 2CIF, 2maximum 4CIF)

type<>

Type of object

yuv<>

Color scheme of video signal coding (0YUV4:2:0, 1YUV4:2:2)

DELETEdisables camera

NA

NA

START_VIDEOenables video stream for the current camera

slave_id<>

Name of the computer to which the camera is connected

comress<>

Level of compression

register_only<>

NA

STOP_VIDEOdisables video stream for the current camera

slave_id<>

Name of computer to which camera is connected

REQUEST_MASK

mask<>

Mask

MUX1, MUX2, MUX3display the image of a camera on 1, 2, 3 analog outputs

NA

NA

ACTIVATEdisplay camera on monitor

monitor<>

Number of a monitor

ARMarm camera

NA

NA

DISARMdisarm camera

NA

NA

RECstart recording

time<>

Time of recording in seconds, if null, then 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 recording by command (and custom on clients), make sure that the Lock disabling streams not in use checkbox is set for itsee The settings panel of the Camera object

REC_STOPstop recording

priority<>

Sets priority of a command to stop recording. See Appendix 1. Priorities of the start and stop recording commands

user_id<>If the user stopped the recording 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_MASKset mask

mask<>

Mask

ADD_SUBTITLESadd titles

command<>

Test of the titles

title_id<>

The ID of the Captioner object that is used to add the titles

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_CONNECTSIP connected

NA

NA

SIP_DISCONNECTSIP disconnected

NA

NA

SET_IPINT_PARAMset (change) the parameters of an IP device. Reaction allows changing the IP device settings without going into its web interface.

Note. For the reaction to work, it is required to enable the mode of multi-stream video signalsee Configuring the 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 individualsee 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 individualsee 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 has the format “Number of camera”.”Number of a stream”, for example 1.1, 1.2

GET_FRAMEget 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

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_archivestream for archive recording
  • stream_alarmstream for archive recording by alarms
  • stream_clientstream for display
  • stream_analyticstream for video analytics

Stream number consists of a camera ID and a stream ID divided by a 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 whose archive the frame must be retrieved.

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 from whose archive the frame must be retrieved
password_crc<>Optional parameter. Specifies the CRC sequence to be recorded to the file together with the frame
ARCH_DEL_RECORDdelete archive recordings over the specified periodfromTime<>Mandatory parameter. Time in the YYYY-MM-DDTHH: MM: SS.NNN format, where NNNmilliseconds. 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 is deleted
toTime<>Optional parameter. Time in the YYYY-MM-DDTHH: MM: SS.NNN format, where NNNmilliseconds. See description above
REC_RESTARTrestart recordingNANA
ARCH_BOOKMARK_RECORDcreate a bookmarktime1<>The date of the archive period beginning included in the bookmark in the DD-MM-YY HH: MM: SS.NNN format, where NNNmilliseconds
time2<>The date of the archive period end included in the bookmark in the DD-MM-YY HH: MM: SS.NNN format, where NNN milliseconds
comment<>Comment to a bookmark
slave_id<>

IDs of the computer and video surveillance monitor using which the bookmark is 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

ARCH_UNBOOKMARK_PERIOD—delete a bookmark for a certain period

time1<>The start date of the archive period included in the bookmark, in the format DD-MM-YY HH:MM:SS.NNN, where NNN is milliseconds
time2<>The end date of the archive period included in the bookmark, in the format DD-MM-YY HH:MM:SS.NNN, where NNN is milliseconds
computer<>The name of the computer to which the camera is connected and on which the archive is saved
CRUISE_STARTauto cruisecruise_id<>Route name on a camera
action<>

Executed action:

  • CRUISE_STARTstart cruising along the specified route
  • PATROL_PLAYstart patrolling along the specified route
cam_id<>Camera ID
GET_DEPTHget 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 parametersdrive<>

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 videotitle_id<>The ID of the Captioner object
GET_AVAILABILITY—check the availability of the key positionpos<>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

The camera is in alarm mode

DISARM_DETACHED

No signal from the camera

DETACHED

No signal from the camera

ARMED

The camera is armed

DISARMED

The camera is disarmed

  • No labels