Skip to content

Configuration: Screen Manager

Justin Aquadro edited this page Jan 13, 2023 · 1 revision

The screen manager is a main component of all the TXL sync and local video players. It's responsible for managing textures and materials on other resources in your project. There's a number of different ways the screen manager can update resources in response to the video texture or other settings changing.

Material Overrides

The material overrides section can be used to change the material used on specific mesh renderers. This can be useful to completely change out the shader used in certain modes, such as a DVD-style bouncing logo when the logo screen should be displayed.

Material Texture Overrides

The material texture overrides section can be used to change out the texture and specific settings on individual materials. In addition to providing optional placeholder textures for various video player states, there are two sub-sections for applying the overrides.

Video Screen Materials

Use this section to update materials directly. This is global, so all objects using the material will reflect the changes. A Property Map is used to specify the names of the material's shader properties to update, such as the name of the main texture or attributes related to gamma and inversion.

Material Property Block Overrides

Use this section to update materials on a per-object basis. Specifically, the material property block of specific mesh renderers will be updated, so the updates are completely local to that object. If the object has multiple materials, the override can be set either at the renderer level, or for a specific material slot. A property map is used to specify the names of the material's shader properties to update, such as the name of the main texture or attributes related to gamma and inversion.

Render Texture Output

Use this section to have the underlying video texture rendered out to a custom render texture (CRT). This option is disabled by default, but it's preconfigured to write out to the resource VideoTXLCRT, which will automatically apply all of the transforms needed to the texture such as gamma, inversion, and aspect ratio correction. The CRT can be plugged into any other material without needing to worry about any further changes in video player state.