Projector masking

Digital masks play an important role in VIOSO 6. These are commonly referred to as ‘projector masks’ as they are defined per projector (and not per content) .

1. Purpose of projector masks

1.1. Masks to limit overspill and unwanted covering

Whenever this will affect the stability and quality of the scan, masks should be applied before the scan. Projector masks can also help to optimise the quality of the overall projection after warping.

Example: Masking to avoid overshooting on the floor of a cylindrical panoramic projection:

1.2. Masks for optimising the blending zones (cropping masks)

These masks are created for each projector and are used to limit the blending. In this way, blending lines can be optimised. We call this ‘cropping masks’, which are used in the pre-scan step of the ‘curved screen/dome’ scanning process.

Example: Dome projection without cropping masks

Projection with applied cropping masks - the overlapping areas are now more uniform, resulting in a better overall blending quality:

Creating cropping masks

Masks for use to crop the blending areas are created in the same way as other projection masks. Create the mask using the toolset explained here: Projector masking

Make sure to save every mask to use as cropping mask in a dedicated file. Later, the *.png mask will be used in the step Scan Result.

2. Creating Projector Masks

2.1. Prior to the scanning

In the calibration settings, check the box "set display calibration mask":

After configuring the camera, a dialog to select projectors and masks will show up:

  • Select the projector you want to create a mask. Tick the box "Show display identification" to get the display name printed on the projector when it's marked on the list - this will help you selecting the intended projector.

  • Click "create mask" to open the mask creation and editng dialog (see below)

  • "Clear mask" will delete any mask that is applied already.

  • From file let's you load and apply a mask created as image (bitmap, png) e.g. from an image processing software.

2.2. On an existing calibration

Whenever a calibration is made, projector masks are available as a post-calibration adjustment. Select the approrpiate target and Activate. The buttons in group "Adjustment" get active. Then choose "Adjust projectors".

In this dialog, select the appropriate projector from the list and choose "new/edit mask".

3. Projector masking tools

Whenever new projector masks are created or edited, the mask tool described below is used. It consists of a drawing area (A) and an area that displays mask layers. It is possible to create multiple shapes and thus generate complex masks.

3.1. 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

3.2. Adding shapes

Click "+ Poligon" to start drawing a shape. It creates a layer with a rectanle mask, blacked out on the outer border. This is the recommended approach for most masking tasks.

Black parts are covered while white parts let anything through. By adding more shapes, complex masking tasks can be handled easily.

Click "+ Empty" to add a layer without any pre-defined shape.

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)

3.3. 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 or use the mask for other purposes (e.g. as cropping mask).

Last updated