API reference
OVRGLTFLoader Class
This is a lightweight GLTF model loader that is guaranteed to work with models loaded from the Meta Quest runtime using OVRPlugin.LoadRenderModel OVRPlugin.LoadRenderModel.
The loader only accepts GLTF files/data in the GLB format. We do not recommended using this class as a general purpose GLTF loader.
Fields
OVRGLTFScene scene[Get]
Func< string, Material, Texture2D > textureUriHandler[Get]
Public Statics
static readonly Vector3 GLTFToUnitySpace[Get]
static readonly Vector3 GLTFToUnityTangent[Get]
static readonly Vector4 GLTFToUnitySpace_Rotation[Get]
Member Functions
OVRGLTFLoader
( string fileName )
Creates a new GLTF loader using a file path.
Parameters
fileName
Path to GLB file
OVRGLTFLoader
( byte[] data )
Creates a new GLTF loader using a binary data array.
Parameters
data
GLB byte data
OVRGLTFLoader
( Func< Stream > deferredStream )
Creates a new GLTF loader with a deferred data stream.
This should be used with OVRGLTFLoader.LoadGLBCoroutine to allow for async loading of the GLTF model. This can help prevent stalling on complex GLTF models.
Parameters
deferredStream
GLB data as a Stream
OVRGLTFScene LoadGLB
( bool supportAnimation,
bool loadMips )
Starts the loading process for the full GLTF file into Unity.
Parameters
supportAnimation
Load GLTF animations.
loadMips
Load GLTF textures with mip maps.
Returns
Full GLTF scene
IEnumerator LoadGLBCoroutine
( bool supportAnimation,
bool loadMips )
Starts the loading process for the full GLTF file into Unity as a coroutine.
This can help prevent stalling as loading will be spread out over multiple frames.
Parameters
supportAnimation
Load GLTF animations
loadMips
Load GLTF textures with mip maps.
Returns
IEnumerator that can be yielded on.
void SetModelShader
( Shader shader )
Sets the shader that should be used by the GLTF loader on materials.
Parameters
shader
Shader to be used.
void SetModelAlphaBlendShader
( Shader shader )
Sets the alpha blending shader that should be used by the GLTF loader on materials.
Parameters
shader
Shader to be used.
void SetTextureQualityFiltering
( OVRTextureQualityFiltering loadedTexturesQuality )
Sets the texture quality for loading all textures in the GLTF model.
The default is Bilinear. Once loaded, textures will be read-only on GPU memory.
Parameters
loadedTexturesQuality
The quality setting.
void SetMipMapBias
( float loadedTexturesMipmapBiasing )
Sets the MipMap bias value for loading all textures in the GLTF model.
The default is 0. Only supported when MipMaps are loaded and the provided shader has a property named "_MainTexMMBias"
Parameters
loadedTexturesMipmapBiasing
The value for bias. Value is clamped between [-1,1]
Static Member Functions
static OVRTextureQualityFiltering DetectTextureQuality
( in Texture2D srcTexture )
Decodes the Texture Quality setting from the input Texture2D properties' values.
Parameters
srcTexture
The input Texture2D
Returns
The enum TextureQualityFiltering representing the quality.
static void ApplyTextureQuality
( OVRTextureQualityFiltering qualityLevel,
ref Texture2D destTexture )
Applies the input Texture Quality setting into the ref Texture2D provided as input.
Texture2D must not be readonly.
Parameters
qualityLevel
The quality level to apply
destTexture
The destination Texture2D to apply quality setting to
static bool ValidateGLB
( Stream glbStream )
Checks the GLB data stream to check if it is a valid GLTF file.
Parameters
glbStream
Data stream of the GLB file.
Returns
If the stream is a valid GLTF file.
static byte[] ReadChunk
( Stream glbStream,
OVRChunkType type )
Reads a chunk of binary data from the stream that either represents the JSON or BIN part of the GLTF file.
Parameters
glbStream
The binary stream of the GLTF file.
type
Type indicating which part of the GLTF file should be read.
Returns
Did you find this page helpful?
Virtual reality / Meta Horizon
Support and legal
Virtual reality / Meta Horizon
Support and legal
Virtual reality / Meta Horizon
Support and legal
English (US)
© 2025 Meta