CLEAR

Technical Guidelines

While it's important that effects are high quality, we want to make sure effects perform well on a variety of devices and in a range of network conditions.

These guidelines will help you strike a balance between quality, file size and runtime performance. We've also added tips to highlight where trade-offs can be made.

Object Count

The recommended limit for the number of scene objects in a single effect is 50.

This only includes objects listed in the Scene tab. It doesn't include assets, like textures and materials. Reducing the number of objects in a scene improves the runtime performance of the effect.

Object count is the biggest factor to consider when improving effect performance. If you want to include a 3D model in your effect that's more complex than our guidelines below, keep the object count low. Including a few high quality objects in a scene is better for performance than multiple low quality objects.

Exported File Size

Keep the exported file size of your effect below 1.6 MB.

This is the file people download onto their device. The size of this file affects the speed at which the file is downloaded and the amount of data used, so it's important to keep it as small as possible.

3D Object Complexity

Make sure your 3D models have the smallest number amount of vertices and triangles for your desired level of quality. This will make sure your effect runs on a wide range of devices. You can check these values in your 3D modeling software.

We recommend keeping:

  • The maximum vertices count per object below 20,000
  • The total triangle count for all object in an effect below 50,000

Texture Format and Resolution

Format

All textures must be square and sized to the power of 2 (example: 2x2, 4x4, 16x16, 32x32). Some of the texture compression options, like PVR, require textures to be in this format. We've set this as a general rule to make that you can use all of the options available to compress and render your textures.

When you choose the texture format, you're prioritizing either file size or in-memory size:

  • If you want a smaller effect file size, choose uncompressed.
  • If you want a smaller in-memory size, use ETC and PVR.

An uncompressed effect uses either a PNG or JPG image file. Using either one of these formats reduces the image file size when exporting the effect, but both of these files expand to the full raw image on loading.

Compressed textures like ETC have a fixed compression ratio. This means that the image file can be larger than the equivalent PNG or JPG, but will be smaller than the full raw image. In memory, ETC textures stay the same size, which is smaller than the equivalent PNG or JPG.

Resolution

The maximum resolution for every texture in an effect is 1024x1024. Where possible, please use lower resolution textures because it helps when running effects on devices with less memory. Using high resolution textures can also harm performance and frame rate.

Animated Textures

Using a sprite sheet instead of a sequence for animated textures. This helps with performance, as the effect only needs to load one texture, rather than several.