Canvas Configuration

Output rotation

It is possible to change the rotation of the output canvas. This can be useful in a situation where the projectors or the Igloo Setup regions are set up in a way that results in the canvas centre being positioned in the corner of a room. New layers in ICE are positioned in the centre of the canvas; in most cases, it’s preferable that the centre of the canvas is located in the middle of the room.

The output rotation will only affect the output before warping is applied, the console canvas texture will remain unchanged. You can also see the effects in the Screen tab, where the canvas is applied to the 3D preview of your screen.

Floors and walls

In the Igloo setup app, you can export not only a wall but also a floor region. A wall region is always exported, but a floor is optional. This creates two regions in the output settings file named CanvasSettings.xml. The rotation of the wall is applied horizontally and shifts the output, the rotation on the floor rotates the floor region around its own center.

CanvasSettings.xml

This is what is exported from Igloo Setup, it’s also where the default settings are saved. There will always be a wall “roi” (region of interest), the floor will be exported only if selected in Igloo Setup.

<CanvasSettings>
	<Resolution>
		<width>4000</width>
		<height>1000</height>
	</Resolution>
	<ScreenType>
		<type>Box</type>
		<rois>
			<roi type="floor" x="0.365517318" y="0.500000000" w="0.249999970" h="0.500000000" />
			<roi type="walls" x="0.000000000" y="0.000000000" w="1.000000000" h="0.500000000" />
		</rois>
		<IgnoreWallRotationTP>1</IgnoreWallRotationTP>
		<IgnoreFloorRotationTP>1</IgnoreFloorRotationTP>
		<defaultWallRotation>0</defaultWallRotation>
		<defaultFloorRotation>0</defaultFloorRotation>
	</ScreenType>
</CanvasSettings>

The settings window has a tab named “Canvas” where you can alter the variables in the XML. Every time a new workspace is created, it gets initialised by these values. The workspace can then be altered in the workspace properties.

Ignore rotation for True Perspective

The two checkboxes named “Ignore wall/floor rotation TP” refers to how layers that use the TruePerspective (TP) effect will behave in regard to the rotation. Rotating the canvas output of a true perspective layer can break the effect of true perspective, for example, true perspective expects the corners of the room to be in one spot, but by changing the output the corners calculated by the true perspective shader will not be in line with the physical corners of the room. If “Ignore wall/floor rotation TP” is enabled all layers with True perspective will compensate its output so that it’s not affected by the canvas rotation. This means that even though all other UI elements and non-TP layers will be rotated, the image of a TP layer will appear to stay in the same place. To change the image of a TP layer, the user should change the “Heading” variable in the TP menu. When this is enabled, the TP layer seems to not be moving in the output, but in the console Canvas tab, the layer texture is rotated, what you see is the compensation for the rotation being applied on output.