Loads a cube texture from the specified image files in the app’s main bundle.
- iOS 9.0+
- macOS 10.11+
- Mac Catalyst 13.0+Beta
- tvOS 9.0+
- Model I/O
An array of strings, each the name (including extension) of an image file.
A new cube texture object, or
nil if the specified files could not be found or are not property formatted for a cube texture..
You can create a cube texture with any of the following combinations of images:
6 square images of the same size, containing the +X, -X, +Y, -Y, +Z, and -Z faces of the cube in that order.
3 images, each of which has height twice its width. Each image contains both the positive and negative faces for one axis of the cube, and the three images are in the order X, Y, then Z.
2 images, each of which has height three times its width. The first image contains the +X, +Y, and +Z faces of the cube, and the second image contains the -X, -Y, and -Z faces.
A single image. If the image’s height is six times its width, Model I/O assumes it to contain the the +X, -X, +Y, -Y, +Z, and -Z faces of the cube in that order and leaves the image data unchanged. If the images width is six times its height, Model I/O rearranges the image data into the vertical format.
Calling this method with any other arrangement of images returns
After initialization, the texture’s data (accessible through the methods listed in Accessing Texture Data) is organized such that the six faces are in one image whose height is six times its width, and its
dimensions property reflects this arrangement.
This method does not cache the texture objects it creates.