Textures

Use textures to show content in Image nodes, to set the look of textured materials, and to show content in Texture Brush brushes. You can create textures from common image file formats. See Images.

In a Kanzi Studio project, image files are located in Library > Resource Files > Images. These image files correspond to the files on your hard drive. When you modify a file on the hard drive, Kanzi automatically applies the modifications to the textures generated from that file. If you remove the file from the hard drive, you cannot use the file in your Kanzi project.

Loading time of images depends on their size and compression:

• Image size defines the time required to load the data into RAM.
• Image compression can reduce the size, but keep in mind that before your application can use the image, it must decompressed it, which is often slower than loading the raw data. You can often achieve the fastest start-up times when using Raw image format, where data is loaded into RAM and sent to the GPU memory. See Image Compression.
• Texture compression you can use on devices with GPUs that support the selected compression algorithm. When using compression, the data size is smaller both when loading from .kzb to RAM and when loading from RAM to the GPU memory. Also less GPU memory is reserved. Depending on the target hardware, by using texture compression you can reduce loading times. Before using texture compression, make sure that your target platform supports the texture compression format you selected.
  Kanzi supports ATC, ETC, PVRTC, and S3TC compression formats, but decompression only for the ETC1. If the hardware does not support texture compression, Kanzi Engine tries to decompress the data before sending it to the GPU. If Kanzi cannot decompress a format, it throws an exception.
  See Compressing textures.

Texture types

These textures are available in Kanzi:

• Single textures use a single image for the texture. See Using single textures.
• Cubemap textures combine six square-shaped images into one texture to represent reflections of the environment. Each image represents the scenery in one of the six directions along the x, y, and z axes from the viewpoint of the cubemapped object. See Using cubemap textures.
• Use a Render Target Texture to render content to a texture or to apply anti-aliasing to only a part of your application. You can use render target textures like any other texture. For example, you can use it in a Texture Brush or as an image in an Image node. See Using render target textures.

Setting the image target format

When you export your project to a kzb file, Kanzi Studio reads the images in the project using the format of the original image and writes the images to a kzb file in the format you set with the Target Format property for each image.

If the file format of the original image is the same as the format you select in the Target Format property, Kanzi does not modify the image when it writes the image to a kzb file under these conditions:

• Premultiply Alpha is disabled, or the alpha channel does not need to be premultiplied
  You can set the value of the Premultiply Alpha property in the Project > Properties and in the properties for each image file.
• Generate Mipmaps is disabled
  You can set the value of the Generate Mipmaps property in each image file.
• Round Images to Nearest Power of 2 property is disabled
  You can set the value of the Round Images to Nearest Power of 2 property in the Project > Properties.

To set the target format for an image in your Kanzi Studio project:

1. In the Library > Resource Files > Images select the image for which you want to set the target format.
2. In the Properties set the Target Format property to the image format you want to use in your Kanzi application.
   The format you select is important because this influences the size of the .kzb binary and the loading time when your Kanzi application needs the resource. Make sure that your target device supports the target format you select for the image. See Images and textures best practices.
3. If the image format you selected in the previous step supports compression, select the compression scheme you want to use. See Compressing textures.

See also

Using single textures

Using cubemap textures

Using render target textures

Compressing textures

Images and textures best practices

Resource management

Images

Material types and materials

Using meshes

Open topic with navigation