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

# texture(withContentsOfFile:options:)

Loads a 2D texture image from a file and creates a new texture from the data.

## Declaration

```swift
class func texture(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 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 Textures from Files

- [texture(withContentsOfFile:options:queue:completionHandler:)](glkit/glktextureloader/texture(withcontentsoffile:options:queue:completionhandler:).md)