Camera Masking (Region of interest)
For all types of cameras the procedure to define a Region of Interest by creating a mask is identical. The masking tools are integrated in the camera adjustment dialog
Whenever new projector masks are created or edited, the mask tool described below is used. It consists of a drawing area (A) , an area that contains mask layers (B) and a list of tools (C). It is possible to create multiple shapes and thus generate complex masks.

Load/Save
Save: This saves the mask as XML and PNG into extra files The XML lets you modify the mask anytime while PNG represents the mask as pixel per pixel dataset. PNG masks are required to use a mask for cropping. Masks are saved internally with the whole calibration, but you might consider to save the masks additionally.
Load: This loads an ediable mask from XML
Adding shapes
Click "+ Poligon" to start drawing a shape. It creates a layer with a rectangle mask, where the inner part is see-through and the outer part is red. Areas covered by red are excluded from the camera view.

Clicking+ Empty to add a layer without any pre-defined shape. +Bitmap loads an image file - typically a black-white image - that is used to define the region of interest (black = see through, white = masked).
Tools to draw shapes:
![]()
Select drawing point
![]()
Add point to shape
![]()
Delete point from shape
![]()
Toggle between linear and spline based shape drawing
![]()
Insert rectangle shape (replacing existing shape - careful!)
![]()
Insert round shape (replacing existing shape - careful)
![]()
Display a helper grid
![]()
Display a helper crosshair
Modifying Layer properties
Each shape acts as a layer that are arranged top-down. By modifying the layers, the overall mask output will be processed.
Tools to modify the layer properdies
![]()
Toggle layer visibility
![]()
Toggle layer black/white
![]()
Invert layer
![]()
Delete layer
After all masking tasks are completed, consider to click "Save" to have the mask saved independently from the current calibration, e.g. to share with anohter calibration.
Last updated