12/21

Mask & Filters

Filters modify the output of the Media Frame. You can add brightness, remove specific colours, or "mask" your pictures and videos. The mask is an essential tool for projection-mapping applications, enabling you to precisely control where light appears by "cutting out" certain areas. You can use a mask to define precise boundaries for the projected content, blocking light from windows and other unwanted surfaces.

There are four different ways to apply a Mask in Lumiverse™:

  • You can create a custom mask file with an external image editor, such as Photoshop (Windows Paint, etc.) Recommended for professional projects. Read more
  • You can paint a quick mask in Lumiverse™ with the Paint Mask filter.
  • You can define a quick vector mask in Lumiverse™ with the Vector Mask filter.
  • You can create a soft mask with a linear or radial gradient effect with the Lumiverse™ Gradient Mask filter

Mask from pixelmap

  • Open the Pixelmap in your favourite image editor, such as Photoshop, Paint, or similar
  • Paint all areas where you want to enable the projection, full white (RGB: 255; 255; 255).
  • Paint all areas where you want to hide (erase) the projection, full black (RGB: 0; 0; 0).
  • Save the resulting black and white image as a .PNG or .JPG file
  • Advanced: You can also use a video file as a mask

Mask from pixelmap

  • Navigate to the Editor
  • Click the '+' button in the bottom-right corner
  • If you end up in the last visited folder, click the arrow-up '↑' in the top-left corner to leave the folder
  • Navigate to "My" folder
  • Click the "Upload New" at the bottom of the screen
  • Browse the device and select the mask file
  • Wait for the upload/download/convert to complete
  • Select the Media Frame
  • Click the 'edit-pencil' button at the bottom-right
  • Click the 'filters' tab at the top-right
  • Click the '+' button to add a new filter
  • Click the '↑' at the top left of the screen to browse all folders
  • Click the 'media' tab (sun & mountain symbol) at the top-right
  • Click the 'My' folder
  • Select the newly uploaded mask file
  • Click the 'three-dots' (⋯) button next to the mask name
  • Click the 'edit-pencil'
  • Change "Mode" to "Mask"
  • Note: You can update the mask simply by uploading the updated mask version under the same name; it will overwrite the previous mask file
  • Note: You can upload a mask to all projectors in a group with the same group method that applies to other media uploads

  • Navigate to the Editor
  • Select the Media Frame
  • Click the 'edit-pencil' button at the bottom right
  • Click the 'filters' tab at the top right
  • Click the '+' button to add a new filter
  • Select the "Vector Mask"
  • Click the 'three-dots' (⋯) button next to the "Vector Mask"
  • Click the 'edit-pencil'
  • This is the Vector Mask control
  • The white canvas area shows; the black canvas area hides (erases) media output.
  • Use the first 'arrow' button to select and move a control point on the mask canvas
  • Use the second '+' button to add a new control point
  • Use the third 'x' button to remove a control point
  • Use the fourth 'edit-pencil' button to convert a control point from corner type to bezier type
  • Use the "scan/media" slider to control the visibility balance between the scan and media samples on the mask canvas
  • Use the "Invert" button to invert white (show) and black (hide) areas of the mask

  • Navigate to the Editor
  • Select the Media Frame
  • Click the 'edit-pencil' button at the bottom-right
  • Click the 'filters' tab at the top-right
  • Click the '+' button to add a new filter
  • Select the "Paint Mask"
  • Click the 'three-dots' (⋯) button next to the "Paint Mask"
  • Click the 'edit-pencil'
  • This is the Paint Mask control
  • The first slider controls the brush size
  • The second "scan/media" slider controls the visibility balance between the scan and media samples on the mask canvas
  • The third slider controls the brush color. Use a white brush to paint areas where you want the projection to show, and use a black brush to paint areas where you want to hide (erase) the projection
  • Paint the mask on the canvas (right or bottom of the screen)

  • Navigate to the Editor
  • Select the Media Frame
  • Click the 'edit-pencil' button at the bottom-right
  • Click the 'filters' tab at the top-right
  • Click the '+' button to add a new filter
  • Select the "Image" filter
  • Click the 'three-dots' (⋯) button next to the "Image"
  • Click the 'edit-pencil'
  • This is the "Image" control
  • You can use the sliders to change different image settings, such as Opacity, Brightness, Contrast, Gamma, Red Channel, Green Channel, and Blue Channel
  • The most common problem with the content is low contrast and low brightness: Increasing both Brightness and Contrast simultaneously to a similar level usually works the best.

With Invert Color, you can invert the colors of the media content. Especially useful if you need to turn black graphics white, or vice versa.

  • Navigate to the Editor
  • Select the Media Frame
  • Click the 'edit-pencil' button at the bottom right
  • Click the 'filters' tab at the top right
  • Click the '+' button to add a new filter
  • Select the "Invert Color" filter

  • Navigate to the Editor
  • Select the Media Frame
  • Click the 'edit-pencil' button at the bottom-right
  • Click the 'filters' tab at the top-right
  • Click the '+' button to add a new filter
  • Select the "Color Mask" filter
  • Click the 'three-dots' (⋯) button next to the "Color Mask"
  • Click the 'edit-pencil'
  • This is the "Color Mask" control. Here, you can define what colour to remove from the media output.
  • Use the first slider to define the color hue
  • Use the second slider to add white
  • Use the third slider to add black
  • Increase the "Threshold" to make the color selection broader, thus more impactful; decrease the "Threshold" to make the color selection narrower
  • Fine-tune the filter's visual performance with the "Cut-off" slider

  • Select the Media Frame
  • Click the 'edit-pencil' button at the bottom-right
  • Click the 'filters' tab at the top-right
  • Click the '+' button to add a new filter
  • Select the "Gradient Mask" filter
  • Click the 'three-dots' (⋯) button next to the "Gradient Mask"
  • Click the 'edit-pencil'
  • This is the "Gradient Mask" control. Here, you can define a soft gradient that will mask the content
  • The first two bars control the effect range of the mask: full white sets full visibility, full black sets full hide (erase), and gray is in between
  • Change "Gradient" from "Linear" to "Radial" to make the effect circular
  • You can rotate the effect with the "Rotation" slider

Useful if the Media Frame has the "Transform" or "Multi-canvas" applied, and the mask doesn't align properly

  • Navigate to Media Frame > 'edit-pencil' > 'filters' (top right corner)
  • Click the problematic mask filter 'three-dots' (⋯) > 'edit-pencil'
  • Click "XY" tab at the top-right corner
  • Toggle the "Position" between "Absolute" and "Relative" values to align the mask filter with the media transformations; see whether this resolves the issue.