Camera view

Some commands like selectCamera and fillLayout require a cameraview parameter or comma separated list of cameraview parameters. A cameraview parameter consists of maximal 6 name:value pairs, separated by a semicolon (‘;’), see table below. Only the cameraid is required. A cameraid value of 0 will blank the corresponding panel. The order of the pairs is arbitrary.

If the server id is omitted, the server this command is send to will be used. If one of the cutout parameters is ommited, a default value of 0 is used for the left and top parameter and a default value of 1000 is used for the right and bottom parameter.

Parameters

Name Value Remarks
serverid [uid] Optional unique server id. When omitted, uses the default server.
cameraid [uid] Required unique camera id. A value of zero (0) blanks the panel. (deviceid works similar)
left [0..1000] Optional left position in promille for image cutout.
top [0..1000] Optional top position in promille for image cutout.
right [0..1000] Optional right position in promille for image cutout.
bottom [0..1000] Optional bottom position in promille for image cutout.

Query Examples

Example of the most elementary camera view:
cameraid:1

Example with serverid, fields separated by a semicolon (‘;’):
cameraid:1;serverid:8889181777222111211

Complete example:
cameraid:8001;serverid:1234567812345001;left:10;top:20;right:30;bottom:40

Mixed example:
top:21;right:300;serverid:1234567812345002;left:10;cameraid:80;bottom:40

Example with some missing cutout parameters.
cameraid:8001;right:500;bottom:500

Example of a simple cameraview list, cameraviews separated by a comma (‘,’):
cameraid:1,cameraid:2,cameraid:3,cameraid:4

Example of a more complex cameraview list,
(notice left and right for cameraid 3!):
cameraid:1;left=500;top=500,cameraid:2:right=500;top=500,cameraid:3;right=250;top=250;left=750;bottom=750,cameraid:4;left=100;top=100;right=400;bottom=400

Example of a complete cameraview list:
cameraid:81;serverid:1234567812345001;left:10;top:20;right:30;bottom:41, bottom:42;
cameraid:82;serverid:1234567812345002;left:12;top:22;right:32

Cutout

The image cutout parameters left, top, right and bottom are used to zoom in on the image. They select a part of the image that is displayed on the panel. The parameter values range from 0 up to 1000, representing a promile part of the image.

Left top of the image is considered as basepoint (0,0).

The original aspect ratio of the image is always maintained. Because the cutout parameters are promiles, the image aspect ratio is kept if the cutout width and height are the same. If the cutout width and height are not equal, the largest of the two is taken.

If the left value is larger then the right value, these values are swapped. The same goes for top and bottom. If the values are out of bounds, they are rounded to the nearest boundary. The visual examples will make things clear.

Example Description

The following examples all start with an image showing the original image (yellow), the image cutout (blue) and the resulting part of the image (cross pattern). Hereafter follows a calculation of the resulting image cutout. The cutout parameters are checked to see if they exceed boundaries and if they are reversed (right before left, bottom before top). The aspect ratio of the image is kept, the result has the same aspect ratio as the image (and the cutout aspect ratio after checking it is 1:1).

The cutout parameters show their recalculated values (to maintain aspect ratio) after the ‘—->’.

For all examples, a 4:3 image is used.

Cutout Examples

Example 1

Cutout with correct aspect ratio within borders.

Cutout parameters (all values are in promille)
Left 200
Top 300
Right 700
Bottom 800
Result:
Width 500
Height 500
ZoomFactor 2

Result:

 

Example 2

Cutout with incorrect aspect ratio within borders.

Cutout parameters (all values are in promille)
Left 500
Top 200
Right 800
Bottom 300 —-> 500 (corrected to match aspect ratio)
Result:
Width 300
Height 300
Zoomfactor 3.33333

Result:

Example 3

Cutout with incorrect aspect ratio within borders.

Cutout parameters  (all values are in promille)
Left 300
Top 500
Right 400 —-> 600 (corrected to match aspect ratio)
Bottom 800
Result:
Width 100
Height 300
Zoomfactor 3.33333

Result

 

Example 4

Cutout with incorrect aspect ratio where the resulting cutout would pass the bottom border.

Cutout parameters  (all values are in promille)
Left 500
Top 800
Right 800 —-> 700 (corrected to match aspect ratio)
Bottom 900 —-> 1000 (corrected to match aspect ratio)
Result:
Width 300 —-> 200 (corrected to match aspect ratio)
Height 100 —-> 200 (corrected to match aspect ratio)
ZoomFactor 5

Result

 

Example 5

Cutout with incorrect aspect ratio where the resulting cutout would pass the right border.

Cutout parameters  (all values are in promille)
Left 800
Top 500
Right 900 —-> 1000
Bottom 900 —-> 700
Result:
Width 100 —-> 200
Height 400 —-> 200
ZoomFactor 5

Result

 

Example 6

Cutout with correct aspect ratio that passes the right border.

Cutout parameters  (all values are in promille)
Left 800
Top 200
Right 1200 —-> 1000
Bottom 600 —-> 400
Result:
Width 400 —-> 200
Height 400 —-> 200
ZoomFactor 5

Result

 

Example 7

Cutout with incorrect aspect ratio that passes the right border.

Cutout parameters  (all values are in promille)
Left 700
Top 500
Right 1100 —-> 1000
Bottom 600 —-> 800
Result:
Width 400 —-> 300
Height 100 —-> 300
ZoomFactor 3.3333333

Result

 

Example 8

Cutout with correct aspect ratio that passes the bottom border.

Cutout parameters  (all values are in promille)
Left 500
Top 700
Right 900 —-> 800
Bottom 1100 —-> 1000
Result:
Width 400 —-> 300
Height 400 —-> 300
ZoomFactor 3.3333333

Result

 

Example 9

Cutout with incorrect aspect ratio that passes the bottom border.

Cutout parameters  (all values are in promille)
Left 500
Top 700
Right 600 —-> 800
Bottom 1100 —-> 1000
Result:
Width 100 —-> 300
Height 400 —-> 300
Max 300
Aspect ratio 0.25 —> 1
ZoomFactor 3.3333333

Result

 

Example 10

Cutout with incorrect aspect ratio and reversed values that also passes all borders.

Cutout parameters  (all values are in promille)
Left 1200 —-> 0
Top 1100 —-> 0
Right -100 —-> 1000
Bottom -100 —-> 1000
Result:
Width -1300 —-> 1000
Height -1200 —-> 1000
ZoomFactor 1

Result