# Projector masking Digital masks play an important role in VIOSO. 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:

projection with added digital mask on each projector

typical shape of such mask on a single projector

### 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. #### 1.2.1. 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:

cropping masks applied to uniform the blending regions

#### 1.2.2. 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](https://docs.vioso.com/calibration/scanning/projector-masking "mention") {% hint style="info" %} Save the mask after creation. You need to access this masks later during the scanning procedure. {% endhint %}

#### 1.2.3. Apply cropping masks after each scan After each projector scan (see [#parameters-explained](https://docs.vioso.com/calibration/scan-result#parameters-explained "mention")), these cropping masks have to be applied to the appropriate projector in this dialog:

After each projector scan, these cropping masks are then applied

{% hint style="info" %} Note: \ Cropping masks can be applied only when running the scans in "curved screen" mode! {% endhint %} ## 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".

Accessing the projector adjustment dialog

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: | ![](https://helpdesk.vioso.com/wp-content/uploads/2022/08/arrow-1.png) | Select drawing point | | ----------------------------------------------------------------------------------- | ------------------------------------------------------------ | | ![](https://helpdesk.vioso.com/wp-content/uploads/2022/08/add_point-1.png) | Add point to shape | | ![](https://helpdesk.vioso.com/wp-content/uploads/2022/08/minus_point-1.png) | Delete point from shape | | ![](https://helpdesk.vioso.com/wp-content/uploads/2022/08/toggle_cornerstyle-1.png) | Toggle between linear and spline based shape drawing | | ![](https://helpdesk.vioso.com/wp-content/uploads/2022/08/insert_form_square-1.png) | Insert rectangle shape (replacing existing shape - careful!) | | ![](https://helpdesk.vioso.com/wp-content/uploads/2022/08/insert_form_circle-1.png) | 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).