VIOSO 6
Exaplay Documentation
  • Welcome to VIOSO 6
  • Changelog and Version History
  • System Preparation
    • Operating System
      • Visual Studio Runtime
      • DirectX Runtime
    • Graphics cards
      • Display Adaptors
      • NVIDIA RTX/Quadro Setup
        • Find and install NVIDIA Drivers
        • EDID Emulation
        • 3D Settings for video playback
        • NVIDIA Mosaic
        • Output Synchronization
      • Others/onBoard GPUs
      • Expanders
    • Network
      • setup a network of fixed IPs
      • firewall configuration
      • camera network
      • remote access via LAN and internet
      • Network settings in VIOSO 6
    • Camera
      • Webcams
      • VIOSO Camera kits
        • Configuring Daheng Cameras
        • Configuring HIK Vision Cameras
        • Configuring IDS Imaging Cameras
      • SLR Cameras via USB connection
      • Other IP-cameras (IP, cctv etc)
    • Projectors
      • Blacklevel explained
    • Deploy VIOSO 6
      • Licensing
        • License information
        • Demo License
        • License Activation
        • License Transfer
        • Maintenance
      • First Init & Autostart
      • Updating VIOSO 6
  • Getting Started
    • Testpattern
    • Project Mode vs. Free Mode
    • Free Mode
      • Multiclient Configuration (Abstract Displays)
      • 3D Model Handling
    • Project Mode
      • Project Creation
      • Designer
  • Calibration
    • Scanning
      • Device Selection
      • Camera adjustment
        • Webcams / DirectShow devices
        • Using Daheng Cameras within VIOSO 6
        • Using HIK Vision Cameras within VIOSO 6
        • Camera Masking (Region of interest)
      • Projector masking
      • Scanning projectors
      • Scan Result
    • Content Mapping
      • 3D Mapping
        • 3D Mapping parameters
        • 3D Mapping in Freemode
      • 2D Warp
    • Blending & Global Adjustments
    • Adjust Projectors
  • USING CALIBRATIONS
    • Integrated Videoplayer
    • Export to Exaplay
    • Export to any application
    • Desktop Embedding
    • Real-time Engines
      • Unity3D
      • Unreal Engine
        • UE Examples & Sample files
      • MiddleVR
      • Techviz
    • VIOSO WarpBlend API
      • VIOSOWarpBlend.ini Reference
  • STEP BY STEP GUIDES
    • Calibration for common media servers
      • AV Stumpfl Pixera
        • Pixera v.2
          • Project Mode Walkthrough
          • Free Mode Walkthrough
        • Pixera v.1
      • Dataton Watchout
        • Watchout v.7
        • Watchout v.6
      • Ioversal Vertex
      • 7th Sense Delta Server
      • Christie Pandoras Box
      • Derivative TouchDesigner
      • BrightSign
  • Typical Calibration Workflows
    • Immersive Rooms (free mode)
    • Cylindrical Panorama with fisheye camera (project mode)
    • 3D calibration in VIOSO 6 free mode
  • References
    • Command Line Reference
    • Remote Control Reference
    • Export Automation Reference
    • Scripting for VIOSO applications
  • Tools
    • Configure Mosaic
  • Knowledgebase
    • FAQ
Powered by GitBook
On this page
  • 1. Purpose of projector masks
  • 1.1. Masks to limit overspill and unwanted covering
  • 1.2. Masks for optimising the blending zones (cropping masks)
  • 2. Creating Projector Masks
  • 2.1. Prior to the scanning
  • 2.2. On an existing calibration
  • 3. Projector masking tools
  • 3.1. Load/Save
  • 3.2. Adding shapes
  • 3.3. Modifying Layer properties
Export as PDF
  1. Calibration
  2. Scanning

Projector masking

PreviousCamera Masking (Region of interest)NextScanning projectors

Last updated 8 months ago

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

projection without masking
projection with added digital mask on each projector
typical shape of such mask on a single projector
native projection
cropping masks applied to uniform the blending regions
Accessing the projector adjustment dialog