Summer 2022 - Igloo Warper

Software	Release Version	Icon

Software	Release Version	Icon
Igloo Warper	1.20.x	Open

Function:

Igloo Warper is an application that provides a canvas for the playback of images, videos and a variety of other content types. Igloo Warper also Warps and Blends the output, fitting the canvas to any shaped screen, geometrically correcting the warped image, and allowing for multiple projectors to be seamlessly blended together if there’s an overlap in projection.

The User Interface:

Open

The Warper UI window contains 3 main sections: a menu bar, a canvas preview, and a playhead bar (applicable only when playing back videos).

File menu

The file dropdown menu has 2 items:

Enable Admin Mode/Disable Admin Mode: toggles the admin mode setting. When enabled, admin mode expands the menus available in the menu bar to include the Config, Warping and Blending menus.

Save, this saves all the current warper settings in the configuration files folder shown above.

Config menu

The config dropdown has a few items; Controller, High Performance Warping, Black Level Adjustment, Timing, Audio, Window, and Communication.

Hovering over any item will bring up another context menu.

Controller submenu

The Controller menu covers the relevant settings for using game controllers such as the steam controller, and also covers the relevant settings for sending gyroscope data to game engines.

Type: Contains a list of valid controller types. Types are None, XIMU, DS4 (For use with Playstation’s DualShock 4 controllers), GYRO_OSC (For use with the mobile application Gyro OSC), IGLOO_REMOTE (For use with Igloo Touch), STEAM (for use with the discontinued Steam Controller), and OPEN_VR (For use with VR wand-style controllers)

Invert: Inverts the effect the Gyroscope data has on Game-Engine cursor controls.

Annotation: Enabled allows for the annotation of the Igloo Canvas using the specified controller. The colour of the annotation can be edited using a standard RGB (255,255,255) scheme

Messages: Defines which controller inputs are handled by the warper

Frequencies: Defines how frequently the Igloo Warper checks the message types for changes in state

Black Level Adjustment submenu

See the advanced topics page here: https://360igloo.atlassian.net/wiki/spaces/EDoc/pages/3291381771

Timing submenu

Timing Allows the monitoring of movie and application FPS and defines the framerate cap of the Igloo Warper application (0 is uncapped).

Adaptive framerate: Attempts to match the application framerate to the movie’s

Audio submenu

Audio Allows the definition of a delay between the audio and visuals, and allows the configuration of the Igloo Audio Engine:

The Sources menu shows the available audio output sources from the Warper. Individual audio levels can be defined:

Channel mappings allows the manipulation of audio channels - here the audio channels from the warper can be mapped to different speakers. This would allow for a stereo repeat to “up-mix” 2-channel content to a 6 speaker system, for instance.

Output device defines which device the warper passes audio to. If no device is chosen, the Windows default device will be used. Test tone output in this menu also allows a test tone to be sent to each channel, allowing for the identification of channels & speakers.

Master Volume allows the volume for the entire application to be changed, as opposed to the clip volume seen in Igloo Playback.

AVSync allows a delay to be set on the audio output, which can help rectify AV Syncing issues

Window submenu

Window: Allows the definition of the width of a window, and the number of projectors in the system

Communication submenu

Communication: Defines the ports that Igloo Warper sends and receives messages on

Blending menu

Overlaps: Defines the percentage of the content that is repeated at the given edge of the screen

Width: Defines the size of the canvas that affected by the gamma correction

Gamma: Defines the intensity of the colour correction. Lower numbers result in darker areas

Rotation degrees: Specific to circular or semicircular warping, rotates the entire mesh clockwise against the defined rotation amount.

Warping menu

Replicates the warping tab from TouchOSC. See the Warping page for more information

View menu

Change settings specific to how the canvas is viewed

Warp: Defines whether warping is turned on, or off.

Blend: Defines whether blending is turned on, or off

Show test image: Shows/Hides one of the Igloo full-canvas test images to check alignment

Info: Shows/Hides the info panels which denote screen number and the application framerate, as well as the “active screen” when warping

Show Control Points: Shows/Hides the control points which are used to manipulate the mesh

Black Level Adjustment: enables/disables the black level adjustment feature.

Full Screen: Places the Warper canvas in fullscreen, or brings the Warper canvas to the terminal display for debugging purposes.

Mask Layers: Masks allow regions of the screen to be black, instead of displaying content. These masks are separated into 2 layers that can be enabled and disabled independently.

Stereo: Turns on and off Side-by-Side Stereo 3D conversion.

Y offset: Moves the entire content mesh up, or down

Global Wrap: Rotates the entire canvas clockwise as the value increases

Wrap rate: Continuously rotates the entire canvas clockwise. Speed of the rotation increases as the value does

Layers menu

Allows settings to be applied to any input on a given layer, and allows the order of the layers to be defined.

Movie → wrap: Defines the wrap position for everything on the movie layer (videos, images). Can be used instead of Global Wrap if the wrap position shouldn’t impact the other layers.

Capture inputs: This context menu provides a list of inputs with settings for each.

Enabled: Determines whether or not the input is shown on the canvas

Position: 2 normalised values representing the x and y position on the canvas that the input starts being drawn to (i.e, the top left corner of the input will be at this position on the canvas)

Size: 1 normalised value that scales the width and height by the same amount, maintaining the aspect ratio

Scale Factor: 2 normalised values that scale the width and height respectively. Can stretch by increasing the value above 1

Wrap: As above for movie layer, but for individual capture inputs:

Play and Pause: Controls for Video inputs. Plays or pauses the video playback

Inverted and Flipped: Mirrors the input on the x and y axes

Canvas width: When enabled, stretches the input to fill the entire canvas

Alpha: When enabled, turns any alpha textures on the input transparent.

Z Level & Bring to front, send to back: Changes the order of the inputs - an input with a “higher” Z level will display “on top” of inputs with a “lower” Z level

External Application Inputs: External inputs share many of the same settings with Capture Inputs

Fish Eye Strength: Distortion applied on the x and y value respectively to mimic the effect of a fisheye camera

Order & Startup: Sets the order of the layers, allowing the movie layer and external application inputs layer to be switched. Startup allows you to save these settings to Load on Warper start.

Layouts & regions: Layouts are a collection of regions. Regions allow capture inputs to be locked in certain areas of the canvas - the Horizontal 2 layout splits the canvas down the middle, with Region 0 being the whole canvas, Region 1 being the left half and Region 2 being the right half:

In each region, the first slider is the start position on the x axis, the second slider is the end position on the x axis. The third slider is the start position on the y axis and the fourth slider is the end position on the y axis.

Layouts and regions are set on an input by input basis.

Refresh Inputs: this button refreshes the spout receiver inputs in the Warper. This is useful if any of the layers appear to be ‘frozen’ and can be fixed with a refresh.

Media Folders menu

Allows the definition of folders that images and videos are stored

Media Files menu

Shows a list of all available images and videos that a user can click on to play.

Play menu

Contains playback controls such as Play, pause, stop, etc. Also here, the startup behaviour can be set to play a movie immediately when Igloo Warper opens.

Keep last frame: Holds the last frame of the video on the canvas when the video ends, instead of showing a black screen

Movie Background Colour: Sets the colour of the canvas that isn’t showing the content

Auto Canvas Average Colour: Takes an average of all the colours from the content and sets that as the movie background colour

Output menu

Allows the sharing of the Warper Canvas over Spout and NDI. Allows the creation of screenshots and .mov files from the Warper canvas.

Help menu

Shows licensing information, Software versioning, and provides a shortcut to the Warper settings folder