Table of Contents  MOBOTIX Online Help

Placeholders for Dynamic Image Texts

The Text & Display Settings dialog allows using placeholders in the Comment textbox to dynamically display certain camera information in the image.

Notes

Description of Placeholders

Placeholders

Description

Note

Image information

^F#

Image number (# = number of digits to display: 1.. 9)

every image

^f#

Image counter (as for ^F#, but with leading zeros (# = number of digits: 1.. 9)

every image

^Er

Exposure time for the right lens in seconds.

every image

^El

Exposure time for the left lens in seconds.

every image

^ER

Exposure time for the right lens in milliseconds.

every image

^EL

Exposure time for the left lens in milliseconds.

every image

^Ir

Illumination value (-20..100 dB) of the right lens at F-stop 2.0

every image

^Il

Illumination value (-20..100 dB) of the left lens at F-stop 2.0

every image

^Ib

Average illumination value (-20..100 dB) of both lenses at F-stop 2.0

every image

^IR

Illumination value (0..100000 lux) of the right lens at F-stop 2.0

every image

^IL

Illumination value (0..100000 lux) of the left lens at F-stop 2.0

every image

^IB

Average illumination value (0..100000 lux) of both lenses at F-stop 2.0

every image

^J#

JPEG image size in KB (# = number of digits to display: 1..9) of the previous image

Note

This placeholder will only return values if the following conditions are true:

  • The camera's arming has been activated in the General Event Settings dialog.

  • The number of Pre-Alarm Images has been set to 1 or higher in the Recording dialog.

every image

^j#

JPEG image size in bytes (# = number of digits to display: 1..9) of the previous image

Note

This placeholder will only return values if the following conditions are true:

  • The camera's arming has been activated in the General Event Settings dialog.

  • The number of Pre-Alarm Images has been set to 1 or higher in the Recording dialog.

every image

^h#

Various image information; # can have the following values:

  • j: JPEG frame rate

  • m: Converted MxPEG tiles in percent

  • q: JPEG quality in percent

every image

Event information

^Lt

Time of the last event

(hh:mm:ss)

^Ld

Date and time of the last event

(YYYY-MM-DD hh:mm:ss)

^Ls

Time since last event in seconds

(+s)

^Lr

Time since last event in hours, minutes and seconds

(+hh:mm:ss)

Date information

^D#

Date & time (top right in the image); # can have the following values:

  • 0: Date Time zone (short) Time

  • 1: Time

  • 2: Time, milliseconds

  • 3: Date

  • 4: Preferred date format

  • 5: Date Time milliseconds

  • 6: Time Zone

Note

This placeholder will only display values if Date and Time in the Setup Menu > Text & Display Settings dialog has been set to Off. The camera will always display the desired values in the top right corner of the image (instead of the date and time information displayed by default). The position of the ^D placeholder does not have any influence on the position of the displayed text.

If you would like to display the date and time information at a different position, you should use the ^d placeholder (see below).

 

^d#

Date information just like ^D#, but displayed inline at the current position in the text.

 

Text information

^#xx

Use this placeholder to format the text in the image in different colors.

In order to format the text display in different colors, the following color codes are available:

Color

Hexadecimal notation

^#00

^#01

^#02

^#03

^#04

^#05

^#06

^#07

^#08

^#09

^#0A

^#0B

^#0C

^#0D

^#0E

^#0F

Example 1. Colored Text Display

^#0AWWW.^#09MOBOTIX.^#0CCOM

results in this colored text display:

WWW.MOBOTIX.COM

 

^s#;

Use this placeholder to display data of the serial interface (RS232) or a network message in the image. The text color is black, the background color is white.

The maximum number of characters per line is limited to 80 characters.

The # character represents the number of lines that are to be displayed. Replace # by the desired number of lines.

Values: 1..64

This command takes a semicolon (";") at the end.

Example 2. Display data from the serial interface or from a network message (black letters on white background)

^s3;

Displays three lines in the image using black text color and white background.

^s16;

Displays sixteen lines in the image using black text color and white background.

 

^S#;

This placeholder also allows displaying data of the serial interface (RS232) or a network message in the image. In this case, the text color is white while the background color is standard.

The maximum number of characters per line is limited to 80 characters.

The # character represents the number of lines that are to be displayed. Replace # by the desired number of lines.

Values: 1..64

This command takes a semicolon (";") at the end.

Example 3. Display data from the serial interface or from a network message (white letters on standard background)

^S3;

Displays three lines in the image using white text color and standard background.

^S16;

Displays sixteen lines in the image using white text color and standard background.

 

Identification Information

~E

The current IP address of the camera's Ethernet interface

 

~H

The computer name of the camera as defined in the Ethernet Interface dialog or assigned via DHCP.

 

~N

The camera's factory default IP address

 

~S

Serial number of the camera

 

Sensor Information

^Ti

Internal temperature in °C (degrees Celsius)

every twelfth image

^Tn

Internal temperature in °F (degrees Fahrenheit)

every twelfth image

Other information

~fp

Service Update

 

~ft

Creation Date

 

~fv

The version of the file system

 

Special characters

~~

The tilde (~) character

 

^^

The caret (^) character

 

^CC

The copyright character ©

 

^CE

The Euro character €

 

^CR

The registered trademark character ®

 

Formatting instructions

^gx;^gx,y;

Position of the text (lines and columns) in the following; displays the text at position x,y. The origin of the coordinates (0,0) is in the top left corner.

For x,y, the following applies:

  • x is the number of columns, by which the beginning of the text is offset to the right.

  • y is the number of rows, by which the beginning of the text is offset down.

This command takes a semicolon (";") at the end.

Notes

  • You can also use negative values for x and y:

    • -x is the number of columns, by which the beginning of the text is offset to the left from the right image border.

    • -x is the number of rows, by which the beginning of the text is offset upward from the bottom image border.

  • The positioning within the image is directly dependent on the following settings:

Example 4. Calculating the Maximum Values for Columns and Rows

For an image size of 1280x960 (MEGA) and a font size of 8 pt, the image consists of 160 columns and 12 rows:

  • Columns: 1280 / 8 = 160

  • Rows: 960 / 8 = 120

Example 5. Positioning Text Using the ^gx,y; Variable

^g-7,20;MOBOTIX

Shows the text "MOBOTIX" using font size 8 pt at the right-hand border of the image in row 20.

^g77,60;MOBOTIX

Shows the text "MOBOTIX" using font size 8 pt and MEGA image size at the right-hand border in the center of the image.

 


Storing the Configuration

Click on the Set button to activate your settings and to save them until the next reboot of the camera.

Click on the Factory button to load the factory defaults for this dialog (this button may not be present in all dialogs).

Click on the Restore button to undo your most recent changes that have not been stored in the camera permanently.

Click on the Close button to close the dialog. While closing the dialog, the system checks the entire configuration for changes. If changes are detected, you will be asked if you would like to store the entire configuration permanently.


© 2001-2018 MOBOTIX, · http://www.mobotix.com/