Oodle Texture

Oodle Texture provides fast, high quality encoding of textures to the various BCn/DXTn formats. Once Oodle Texture is configured it will operate automatically in the background. You can set Oodle Texture globally, and then define it more specifically for LOD groups and individual textures.

Oodle Texture does not encode ASTC or other mobile formats.

Enabling Oodle Texture

The plugin for Oodle Texture is enabled by default in Unreal Engine.

In addition to the plugin, Oodle Texture requires a setting in the DefaultEngine.ini file.

	\Engine\Config\DefaultEngine.ini
	[AlternateTextureCompression]
	TextureCompressionFormat="TextureFormatOodle"
	TextureFormatPrefix="OODLE_"
	bEnableInEditor=True
Copy full snippet

\Engine\Config\DefaultEngine.ini [AlternateTextureCompression] TextureCompressionFormat="TextureFormatOodle" TextureFormatPrefix="OODLE_" bEnableInEditor=True

As Oodle Texture is enabled by default in 4.27, these lines should already be present in your BaseEngine.ini file.

We strongly recommend leaving bEnableInEditor=true to maintain consistent behavior between the editor and packaged builds. If set to false, artists reviewing encoding results in the Editor will see different results than the cook system produces. You can verify Oodle Texture is enabled by examining the log:

LogTextureFormatOodle: Display: Oodle Texture 2.9.0 init RDO On with DefaultRDOLambda=30

When Oodle is used for a given texture, the format will contain the prefix OODLE_:

LogTexture: Display: Building textures: test (OODLE_AutoDXT, 256X256)

Key Concepts for Oodle Texture

There are two concepts you need to understand in order to make use of Oodle Texture: RDO (Rate Distortion Optimization) and Lambda.

Understanding RDO

RDO is a term that refers to trading quality (distortion) for size (rate). For texture encoding, this sounds odd -- DXTn/BCn textures do not vary in size with quality, they are a fixed size based on the format, resolution, and mip count.

Oodle Texture optionally expose a way to manage the resulting encoded texture data so that when a uasset containing a texture is compressed for distribution via the IOStore / .pak file system, it compresses smaller. Thus, RDO in Oodle Texture only reduces distribution sizes.

Additionally, it is tuned to work with the Kraken compression format. Refer to Oodle Data for more information.

Understanding Lambda

The parameter that determines how much distortion is introduced, and thus how much smaller the resulting file is, is referred to as lambda.

Lambda can be set between 0 and 100, with lower numbers representing lower distortion, and therefore higher quality results. A lambda value of around 30 still produces high quality results. A lambda value of 0 disables RDO entirely, resulting in the theoretical best quality. However, even when seeking best quality, we recommend using a lambda value of 1 as the cost / benefit ratio is still very good, resulting in very little distortion for reasonable distribution size gains.

Generally speaking, we expect lambda to be set globally and not often overridden. Determining a value appropriate for your project will be a collaborative effort based on distribution size needs. It is best to have your global lambda be your highest value (lowest quality) one, and selectively set higher quality / lower lambda on LOD groups or specific textures, as needed.

Textures other than diffuse / albedo maps will likely require a lower lambda (usually 5-20), especially normal maps, as distortion that is not visible to the naked eye can be more noticeable with textures like specular highlights.

Configuring Oodle Texture

Oodle Texture is primarily configured using the DefaultEngine.ini file, but also exposes lambda on texture LOD groups and on a per-texture basis.

Global Configuration

The TextureFormatOodle section in the DefaultEngine.ini file contains the global settings for Oodle Texture.

	\Engine\Config\DefaultEngine.ini
	[TextureFormatOodle]
	DefaultRDOLambda=30
	GlobalLambdaMultiplier=1.0
	bForceAllBC23ToBC7=False
	bForceRDOOff=False
	bDebugColor=False
Copy full snippet

\Engine\Config\DefaultEngine.ini [TextureFormatOodle] DefaultRDOLambda=30 GlobalLambdaMultiplier=1.0 bForceAllBC23ToBC7=False bForceRDOOff=False bDebugColor=False

Configuring Texture LOD Groups

The LOD group parameter representing RDO lambda is called Lossy Compression Amount. This parameter is defined for LOD groups in the DefaultDeviceProfiles.ini file.

	TextureLODGroups=(Group=TEXTUREGROUP_WorldNormalMap,MinLODSize=1,MaxLODSize=8192,LODBias=0,MinMagFilter=aniso,MipFilter=point,MipGenSettings=TMGS_SimpleAverage,**LossyCompressionAmount=TLCA_Low**)
Copy full snippet

TextureLODGroups=(Group=TEXTUREGROUP_WorldNormalMap,MinLODSize=1,MaxLODSize=8192,LODBias=0,MinMagFilter=aniso,MipFilter=point,MipGenSettings=TMGS_SimpleAverage,**LossyCompressionAmount=TLCA_Low**)

Lossy Compression Amount can take the following values:

Configuring Individual Textures

RDO Lambda can also be set for individual textures using the Lossy Compression Amount parameter, and takes the same values shown above.

To set the parameter for a single texture:

1. Double-click the texture you want to set RDO Lambda for in the Content Browser to open it in the Texture Editor window.

2. In the Details panel, expand the Compression section and click the arrow icon to show the Advanced options.

   

3. Use the dropdown menu next to the Lossy Compression Amount parameter to select the desired value.