Video Properties

<< Click to Display Table of Contents >>

Navigation:  Object Reference >

Video Properties

The video output of cameras connected to the device can be displayed on the screen. Whether video input is supported depends on the used device.

The following differences exist on the different hardware platforms:

 

Devices with i.MX35 CPU:

0, 1 or 3 analog video inputs (depending on the device)

Only one video can be shown at the same time

Analog video is always drawn as the most-backward graphics layer and the field of the video objects will be made invisible so that the video image gets visible.
Any other objects (e.g. other non-video frames on top of a video frame/page) will be displayed in front of the video image

 

Devices with i.MX6 CPU:

1, 2 or 3 analog video inputs (depending on the device)

Two cameras can be shown at the same time (Please note: Due to hardware limitations, input 1 and 3 can not be displayed at the same time, only 1 and 2 or 2 and 3)

It's possible to show a video stream over Ethernet with either H.264 or MJPEG. See below for details and limitations

Video is drawn as the background texture of the video frame or page.

For i.MX6 devices with a quad core processor it is possible to show two analog camera inputs plus an Ethernet camera at the same time.

Video Properties

Display Video

Use this property to enable showing video in this object (only analog video will be mirrored):

None
Disable video for this object

Unmirrored
Enable video, no mirror

clip0040

Horizontally Mirrored
Enable video, mirror at the horizontal axis (up will be down)

clip0065

Vertically Mirrored
Enable video, mirror at the vertical axis (left will be right)

clip0115

Both
Enable video, mirror it horizontally and vertically (only analog video will be mirrored)

clip0144

 

Note that the camera preview image in the tool changes with the different mirror settings.

Video Type

Depending on the selection of the property Display Video:

Analog Video Input
One of the device's analog video inputs shall be used (select which with Video Camera property below)

Ethernet Stream
Show a video stream received via Ethernet (see below for requirements and limitations)

Stream Type

Here the type of the Ethernet camera stream can be chosen:

H.264 via UDP/RTP

MJPEG via UDP/RTP

H.264 via RTSP

UDP Port

If the Video Type was set to Ethernet stream and a Stream Type with UDP protocol was selected, the UDP port used by the camera can be configured here.

RTSP URL

If the Video Type was set to Ethernet stream and a Stream Type with RTSP protocol was selected, the RTSP URL can be written here.

The typical URL for Axis cameras is: rtsp://user:password@<IP>/axis-media/media.amp (e.g. rtsp://root:root@192.168.135.90/axis-media/media.amp)

Anonymous viewing can be enabled in the camera settings. Then user:pass@ can be omitted.

Please check the camera documentation for correct url.

Video Rotation

The camera image can be displayed rotated in 90° steps. This is useful if the camera is e.g. mounted sideways.  

Note: The camera preview image changes with different rotation settings.

Also note: For analog cameras the rotation will be overwritten by the variables @CAM1Rotation, @CAM2Rotation and @CAM3Rotation

Video Camera

Choose which camera to display. Either one of the three analog cameras or Ethernet Stream.

Scaling Factor

Choose between "Whole Frame" and "Whole Image":

 

Whole Frame: The camera image is scaled to the dimension of the frame / page without respecting the aspect ratio of the camera image. The frame / page background will not be visible but the image will look distorted if both aspect ratios differ too much.

 

Whole Image: The camera image is scaled to fit within the frame page but the camera's aspect ratio is preserved. If the aspect ratio of camera and frame/page differ, there will be parts of the frame that are not filled with the camera image at top and bottom or left and right.

 

Video Standard

This property is only applicable for analog cameras. The video standard of the connected analog camera can be selected with this property. PAL and NTSC are the supported standards. If value AUTO is selected, the video standard will be automatically detected between PAL and NTSC.

Auto detection of the video standard needs some time (up to 1 second). If it is clear at design time what camera with which standard is connected, the real standard should be selected here instead of AUTO.

Auto detection might not work for all analog camera models so an option for the user to manually select the standard should be included in the project (if it is not clear at design time what kind of cameras will be connected).

Auto detection will only happen once for every camera port. It will be internally stored if the auto detection was successful to speed up showing the image when entering a page with video a second time.

This property can be updated via JavaScript (0: Auto, 1: PAL, 2: NTSC)

Ethernet camera requirements and limitations

General:

 

The properties of the camera itself like resolution, IP, etc. can currently not be changed by the device. A tool to change camera settings via ISO 17215 is available in the OPUS Projektor. See here.

Rotation is supported.

The higher the resolution and/or bandwith of the camera is, the worse the performance on the screen will be. A rough recommendation is to keep it under 15 Mbit/s.

It is possible to show the stream together with analog video on the same page. It is however recommended to do this only on devices that have multi-core CPU. On single core CPUs the performance might drop a lot.

It is possible to show more than one Ethernet camera stream on a page. This is limited to 4 streams on devices with a quad core CPU and 2 streams on all other devices. Performance should be monitored if multiple streams are shown on a page. This will produce a high system load and depending on the camera settings and the overall system load, the video and overall performance may be impacted.

Ethernet needs to be activated on the device for the stream to be shown, see @Ethernet0_applynstart and @Ethernet0_UpAtStart

 

H.264 via UDP/RTP / MJPEG via UDP/RTP:

 

H.264 / MJPEG video streams over Ethernet are only supported on devices with i.MX6 CPU.

The camera needs to use the RTP protocol via UDP/RTP to deliver the stream.

The camera can either send the stream directly to the IP address of the device or via UDP broadcasts.

The UDP Port that the camera uses needs to be set in the "UDP Port" property of the frame or page that shall show the stream.

 

H.264 via RTSP:

 

RTSP video streams over Ethernet are only supported on devices with i.MX6 CPU.

The camera needs to use the RTSP protocol to deliver the stream.

 

The program has a tool included with which Ethernet cameras can be configured. It can be accessed via the menu Tools -> See here.

 

Starting and stopping camera streams

It should not be necessary to start or stop camera video manually.

Entering a page where video is configured will automatically start the camera video. Leaving a page will automatically stop it.

Making a frame invisible will automatically stop the camera video. Making a frame visible, will automatically start it.

If it is really necessary to manually start or stop camera video, the value of the property "Display Video" can be changed in JavaScript:

Value 0: stop (eq. None)

Value 1: start unmirrored

Value 2: start horizontally mirrored

Value 3: start vertically mirrored

Value 4: start horizontally and vertically mirrored

 

Changing any of the following property values while video is displayed will cause an automatic restart:

Video Standard

UDP Port

Stream Type

RTSP URL

Video Camera

 

 

Download this project to see a basic Ethernet camera configuration or check out the welcome project sample.