Format

From RealMotion Wiki

Image Processing/Operations/Format

Changes the format and the resolution of a texture. ​

Description

The Format box changes the format and the resolution of a texture.

Note: The process generates a new memory allocation for the new texture.

General Use Case: The Format box is useful to reduce the resolution of a texture before a demanding texture-based operation. The Format box is also used before process like Gradient and Simulation to increase the bit depth as 16 bits texture is needed.

Inputs

Texture 2D Texture Receives the texture to be processed.

Outputs

Texture 2D Render Target Outputs the texture created.

Parameters

Format Section

|}

Channel Settings

Set Format Toggle Allows the box to change the format of the outputted texture. Once enabled, this creates a new memory allocation for the texture created.
Format String Sets the format of the outputted texture. RGBA 8 bits is the common format. RGBA 16 bits allows negative vector calculation and is mostly used for simulation. RGBA 32 bits allows high precision but may negatively affect the FPS and the Grayscale has only the Red component.
Format Components String Sets the Components used for the outputted texture.
Format Component Bit Depth String Sets the Bit Depth of the outputted texture. 8 bits is the common format, 16 bits allow negative vector calculation and is mostly used for simulation, 32 bits allow high precision but may negatively affect the FPS.
Format Component Type String Sets the pixels value type depending on the Bit Depth.

Canvas Settings

Set Resolution Toggle Allows the box to change the resolution of the outputted texture. Once enabled, this creates a new memory allocation for the texture created.
Resolution Mode String Sets the Resolution Mode. Canvas uses the project configuration settings, Custom uses local setting resolution not shared with other box and Project Aspect Ratio uses the project aspect ratio and proportionally scales the height and width. The parameter chooses the reference Canvas setting the resolution of the outputted texture.
Canvas 2D ResolutionRef Chooses the reference Canvas and sets the resolution of the outputted texture.
Maximum Resolution Int Sets the maximal resolution of the X-axis and calculates the resolution of the Y-axis based on the aspect ratio of the Content Canvas.
Lock Aspect Ratio Toggle Locks the Aspect Ratio for Custom resolution.
Aspect Ratio 2D ResolutionRef Chooses the reference Canvas for the aspect ratio.
Size XY Int2 Sets the size in pixels of the outputted texture.

NA

Set Multisampling Toggle Allows the box to change the Subsample count. By default, the Subsample Count is set to 1x.
Subsample Count String Sets the number of multisamples per pixel for MSAA. High value may reduce the frame rate.

Alpha

Set Alpha Toggle Enables the alpha overwrite.
Alpha Float Sets the alpha value to override with.

See Also

Boxes related

Texture Buffer, Texture Out, Gradient, Blend, Get Channel, Texture Components, Add, Fluid Sim, Massive Particles, Particle System 2D, Wave Sim, ​​

Version Information

Current documentation version: 2.1.0. ​ ​