---
title: "cubeMap(withContentsOfFile:options:)"
framework: glkit
role: symbol
role_heading: Type Method
path: "glkit/glktextureloader/cubemap(withcontentsoffile:options:)"
---

# cubeMap(withContentsOfFile:options:)

Loads a cube map texture image from a single file and creates a new texture from the data.

## Declaration

```swift
class func cubeMap(withContentsOfFile path: String, options: [String : NSNumber]? = nil) throws -> GLKTextureInfo
```

## Parameters

- `path`: A path to the file to load.
- `options`: A dictionary that describes any additional steps you want the texture loader to take when loading the texture. See doc://com.apple.glkit/documentation/GLKit/texture-loading-options.

## Return Value

Return Value A texture info object that describes the loaded texture or nil if an error occurred.

## Discussion

Discussion The file is assumed to be a single image that includes the six faces of the cube map. The image’s height must be six times the width, and the images should be arranged in the following order from top to bottom: north, south, east, west, top, bottom. Alternatively, the image can have a width that is six times the height, and arranged from left to right, but this takes additional processing to load. This class method loads the texture into the sharegroup attached to the current context for the thread this method is called on. note: In Swift, this method returns a nonoptional result and is marked with the throws keyword to indicate that it throws an error in cases of failure. You call this method in a try expression and handle any errors in the catch clauses of a do statement, as described in Error Handling in The Swift Programming Language and About Imported Cocoa Error Parameters.

## See Also

### Loading Cube Maps from Files

- [cubeMap(withContentsOfFile:options:queue:completionHandler:)](glkit/glktextureloader/cubemap(withcontentsoffile:options:queue:completionhandler:).md)
- [cubeMap(withContentsOfFiles:options:)](glkit/glktextureloader/cubemap(withcontentsoffiles:options:).md)
- [cubeMap(withContentsOfFiles:options:queue:completionHandler:)](glkit/glktextureloader/cubemap(withcontentsoffiles:options:queue:completionhandler:).md)