Texture Settings Editor

You can use the Texture Settings Editor to edit the texture settings for individual images. This is useful if you are customizing your images for different platforms, such as PC and Android. For example, you can specify compression scheme, mipmap generation parameters, alpha map combinations, and so on for images. When you edit your texture settings for an image, the Texture Settings Editor generates a .imagesettings file to save your settings.

The Texture Settings Editor supports the following image formats:

• .bmp
• .gif
• .jpg
• .jpeg
• .png
• .tga
• .tif
• .tiff

Note
The Texture Settings Editor requires the Image Processing gem. By default, this gem is enabled.

The Texture Settings Editor can also load the previous Resource Compiler (RC) generated .exportsettings file. If you make any changes to this file, the Texture Settings Editor deletes this file and generates a new .imagesettings file. If you have Perforce enabled, Perforce tracks the new or modified files.

You can find the default settings for the Texture Settings Editor in the ImageBuilderDefaultPresets.settings file. You can modify the default settings file as needed.

To modify the default settings

1. Copy the ImageBuilderDefaultPresets.settings file.

2. Navigate to the lumberyard_version/dev/game_project/Config/ImageBuilder/ directory.

3. Paste the copied file and rename it to ImageBuilderPresets.settings.

4. In a text editor, make your changes and save.

Note
This file replaces the previous rc.ini file, which contains the predefined presets to generate textures for your game. To migrate your settings from the rc.ini file, see Migrate RC.ini Settings to the Texture Settings Editor.

Topics

• Using the Texture Settings Editor
• Preview
• Texture Presets
• Platform
• Mipmap Settings
• Migrate RC.ini Settings to the Texture Settings Editor

Using the Texture Settings Editor

To use the Texture Settings Editor

1. In Lumberyard Editor, choose Tools, Asset Browser.

2. In the Asset Browser, navigate and select a source file, such as a .tif file.
   

   You can preview the texture, its file size, dimensions, and select the drop-down menu to preview the texture with the following channels:

   • RGB
   • Alpha
   • RGBA

3. To view more information, expand the arrow icon, and select the texture file that appears below the source file.
   

   See the following information about the texture:

   • Compiled texture
   • File size
   • Resolution
   • Format
   • Mip count
   • Memory size
   • Color space
   • Image flag

4. To open the Texture Settings Editor, right-click the source file, and choose Edit Texture Settings.
   

5. In the Texture Settings Editor, you can view the following:

   1. Preview – Preview of the processed image with the current settings.

   2. Texture Presets – List of presets to choose.

   3. Platform – Specify the different resolution adjustments on different platforms.

   4. Mipmap Settings – Allows the adjustment of mipmap generation.

6. When finished, click Apply to save the current properties. This exports a setting file named imageName.imagesettings next to the source file. Note
   If there is an existing legacy .exportsettings file associated with the texture file, the legacy file will be automatically deleted. Click the ? icon to open the texture documentation.

Preview

In the preview panel, you can do the following:

1. Click the drop-down menu to preview the texture in the following channels:

   • RGB – Displays the RGB color channels (default).
   • R – Previews the red channel in grayscale.
   • G – Previews the green channel in grayscale.
   • Alpha – Previews the alpha channel in grayscale.
   • RGBA – Previews the alpha blended with the background.

2. Preview tiled – Preview the texture in a 2x2 tiled layout. By default, the texture appears in a fixed size.

3. Press and hold the following shortcuts to change the preview for the texture:

   • Shift – Changes the preview to RGBA mode.
   • Alt – Changes the preview to Alpha mode.
   • Space – Opens a pop up window that previews the texture in its actual output size.

4. Click the arrow icons to view the different mipmap previews. Mip 0 is the original output image.

5. Click the refresh icon to refresh the preview. You can click the drop-down menu to specify the following:

   • Always refresh preview – Refresh automatically when you make a change.
   • Press to refresh preview – Manually refresh the preview.

Texture Presets

In the Texture presets, you can do the following:

• Active preset – Click the drop-down menu to view the presets that you can assign to a texture. The texture using the preset values automatically appears in the preview panel. Texture properties are also updated. Note
  The Texture Settings Editor supports different presets that specify the options that are applied when an image asset is compiled. When you open the Texture Settings Editor, it loads the main settings and presets from the game project folder at the following file:
  lumberyard_version\dev\game_project\Config\ImageBuilder\ImageBuilderPresets.settings
  If this file doesn’t exist, the Texture Settings Editor loads the default settings from the following file:
  lumberyard_version\dev\Gems\ImageProcessing\Code\Source\ImageBuilderDefaultPresets.settings

• Click the reset icon to reset all texture properties to the default values of the current preset.

• Click the info icon to display a pop-up window for the current settings.
  

• Active file conventions – Name convention that the current preset setting supports. For more information, see Texture Map Types.

• Suppress spec reduction – By default, when Lumberyard Editor switches from high to low specification, textures are automatically scaled down so that they can load into the graphics card memory. However, you can set this setting, which overwrites all resolution reduction settings, so that the texture keep its original size throughout the different quality settings. It’s recommended that you set this setting for textures that have text.

  For more information, see Editor Settings.

Platform

In the Platform, you can specify the following.

Mipmap Settings

In the Mipmap Settings, you can specify the following.

Migrate RC.ini Settings to the Texture Settings Editor

The Resource Compiler uses the rc.ini file to store your default texture presets. In Lumberyard 1.18, the Texture Settings Editor uses the ImageBuilderDefaultPresets.settings instead.

If you want to transfer your settings from the Resource Compiler to the Texture Settings Editor, you must do this manually.

Example
In rc.ini, settings are ordered by preset, which contains the format for all devices. For example, the Albedo preset is stored.

[Albedo]
pixelformat=BC1
pixelformat:es3=ETC2
pixelformat:ios=PVRTC4
maxtexturesize:es3=512
rgbweights=ciexyz
powof2=1
mipmaps=1
colorspace=sRGB,auto
filemasks=*_diff*

The ImageBuilderDefaultPresets.settings file is in a format that Lumberyard can serialize.
The following example contains the Albedo preset for PC with only the relevant parts that match the settings used in rc.ini. If you modify the PC Albedo preset, you should also make the change to other platforms. This ensures that your changes take effect on all platforms.

<ObjectStream version="3">
...
    <Class name="AZStd::string" field="value1" value="pc" type="{03AAAB3F-5C47-5A66-9EBC-D5FA4DB353C9}"/>
    ...
        <Class name="PresetSettings" field="value2" version="1" type="{935BCE3F-9E76-494E-9408-47C5937D7288}">
            <Class name="AZ::Uuid" field="UUID" value="{08A95286-ADB2-41E4-96EB-DB48F4726D6A}" type="{E152C105-A133-4D03-BBF8-3D4B2FBA3E2A}"/>
            <Class name="AZStd::string" field="Name" value="Albedo" type="{03AAAB3F-5C47-5A66-9EBC-D5FA4DB353C9}"/>
            <Class name="unsigned int" field="RGB_Weight" value="2" type="{43DA906B-7DEF-4CA8-9790-854106D3F983}"/>
            <Class name="unsigned int" field="SourceColor" value="1" type="{43DA906B-7DEF-4CA8-9790-854106D3F983}"/>
            <Class name="unsigned int" field="DestColor" value="2" type="{43DA906B-7DEF-4CA8-9790-854106D3F983}"/>
            <Class name="AZStd::vector" field="FileMasks" type="{99DAD0BC-740E-5E82-826B-8FC7968CC02C}">
                <Class name="AZStd::string" field="element" value="_diff" type="{03AAAB3F-5C47-5A66-9EBC-D5FA4DB353C9}"/>
            </Class>
            <Class name="AZStd::string" field="PixelFormat" value="BC1" type="{03AAAB3F-5C47-5A66-9EBC-D5FA4DB353C9}"/>
            <Class name="bool" field="IsPowerOf2" value="true" type="{A0CA880C-AFE4-43CB-926C-59AC48496112}"/>
            <Class name="AZStd::unique_ptr" field="MipMapSetting" type="{2CB9DED6-5513-5BB1-A4EC-8E92A591BB81}">
            <Class name="MipmapSettings" field="element" version="1" type="{9239618E-23A6-43C8-9B87-50528CBFA6FF}">
                <Class name="unsigned int" field="MipGenType" value="5" type="{43DA906B-7DEF-4CA8-9790-854106D3F983}"/>
                <Class name="Color" field="BorderColor" value="0.0000000 0.0000000 0.0000000 0.0000000" type="{7894072A-9050-4F0F-901B-34B1A0D29417}"/>
                <Class name="unsigned int" field="StreamableMips" value="0" type="{43DA906B-7DEF-4CA8-9790-854106D3F983}"/>
            </Class>
        </Class>
...