Introduction to Texture Atlasses

To provide good performance on multiple platforms, Wonderland Editor automatically combines textures into texture atlases. A texture atlas reduces the amount of texture binds your device needs by joining multiple textures into one single texture.

However, with large assets, the generated texture atlas may be cause for textures not rendering, if the texture image sizes exceed the maximum atlas size.

Increasing Atlas Size 

The easiest way to avoid textures from breaking due to atlases is to increase the atlas size. Increasing the atlas size will reduce performance, but many projects will not see any noticeable decrease.

To change the size of a texture atlas, go to Views > Project Settings > Rendering and find textureAtlasSize, where you can use the dropdown menu to change the size in pixels. Use the compressedTextureAtlasSize options to change the size of the compressed texture atlas.

Decreasing Texture Sizes 

Another easy way to avoid textures breaking is to reduce the size of the asset’s image textures: navigate to Views > Resources > Images. This tab contains a list of all images that have been imported into the project.

Here, you can use the maxSize setting to reduce the amount of space each image will use on an atlas.

Remember, reducing the size of the image will make its texture appear at a lower resolution in your application.

Atlas Types 

Font images and images loaded from .glb/.gltf or image files not compressed, and will be added to the uncompressed atlas. Changing the atlas size or size of these images will affect sufficiency of the uncompressed texture atlas.

Images imported in the editor get compressed by default and end up in the compressed texture atlas. Changing the compressed atlas size or size of these images will therefore affect sufficiency of the compressed texture atlas.

If the uncompressed atlas size is insufficient, but a lot of space is left in the uncompressed atlas, it can be useful to disable compression for some of the imported images as described in the following section.

Compressing Images 

To preserve image memory on the GPU, Wonderland Editor will automatically compress imported images. Compressed images may have artifacts that might be unacceptable for your application. To disable compression for an image, navigate to Views > Resources > Images and uncheck the compressed checkbox.