Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.Close
For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.Close
A Cubemap is a collection of six square textures that represent the reflections on an environment. The six squares form the faces of an imaginary cube that surrounds an object; each face represents the view along the directions of the world axes (up, down, left, right, forward and back).
Preferred way of creating cubemaps is importing them from specially laid out textures.
Cubemap texture import type and Unity should do the rest. Several commonly used cubemap layouts are
supported (and in most cases detected automatically).
Vertical and horizontal cross layouts, as well as column and row of cubemap faces are supported:
Another common layout is
LatLong (Latitude-Longitude, sometimes called cylindrical). Panorama images are
often in this layout:
SphereMap (spherical environment map) images can also be found:
By default Unity looks at the aspect ratio of the imported texture to determine the most appopriate layout from the above. When imported, a cubemap is produced which can be used for skyboxes and reflections:
Glossy Reflection option is useful for cubemap textures that will be used by
Reflection Probes. It processed cubemap mip levels in a special way
(specular convolution) that can be used to simulate reflections from surfaces of different smoothness:
Unity also supports creating cubemaps out of six separate textures. Select from the menu, and drag six textures into empty slots in the inspector.
|Right..Back Slots||Textures for the corresponding cubemap face.|
|Face Size||Width and Height of each Cubemap face in pixels. The textures will be scaled automatically to fit this size.|
|Mipmap||Should mipmaps be created?|
|Linear||Should the cubemap use linear color?|
|Readable||Should the cubemap allow scripts to access the pixel data?|
Note that it is preferred to create cubemaps using the Cubemap texture import type (see above) - this way cubemap texture data can be compressed; edge fixups and glossy reflection convolution be performed; and HDR cubemaps are supported.
Another useful technique is to generate the cubemap from the contents of a Unity scene using a script. The Camera.RenderToCubemap function can record the six face images from any desired position in the scene; the code example on the function’s script reference page adds a menu command to make this task easy.