Click or drag to resize
SoComplexitytextureQuality Property

Hint about texture quality.

Namespace: OIV.Inventor.Nodes
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 2023.1.3.0 (2023.1.3)
Syntax
public SoSFFloat textureQuality { get; }

Property Value

Type: SoSFFloat
Remarks

Default is 0.5. A value of 0 indicates that the fastest texturing should be used, while a value of 1 indicates that the best quality texturing should be used. The default value can also be set using the environment variable OIV_TEXTURE_QUALITY (0.0 to 1.0).

For backward compatibility, the default value is 0.5. This value was chosen when texturing was an expensive (low performance) feature of graphics hardware. It produces relatively low quality texture rendering because no interpolation is done. On modern graphics hardware we recommend setting this to a higher value, e.g. 0.75.

If the filter options are set explicitly in the OIV.Inventor.Nodes.SoTexture.minFilter and/or OIV.Inventor.Nodes.SoTexture.magFilter fields, this field has no effect.

The table below shows the correspondence between Open Inventor texture quality and OpenGL texture filtering options.

textureQuality * minFilter value ** magFilter value *** Need Mipmaps Format
<= 0.5 GL_NEAREST GL_NEAREST false ExtendedFormats or CompressedFormats
<= 0.6 GL_LINEAR GL_NEAREST false ExtendedFormats or CompressedFormats
<= 0.7 GL_NEAREST_MIPMAP_NEAREST GL_NEAREST true ExtendedFormats or CompressedFormats
<= 0.8 GL_NEAREST_MIPMAP_LINEAR GL_LINEAR true InternalFormats or CompressedFormats
<= 0.9 GL_LINEAR_MIPMAP_NEAREST GL_LINEAR true InternalFormats or CompressedFormats
<= 1.0 GL_LINEAR_MIPMAP_LINEAR GL_LINEAR true InternalFormats or CompressedFormats

* The minFilter value can be set explicitly using the OIV.Inventor.Nodes.SoTexture.minFilter field of classes derived from OIV.Inventor.Nodes.SoTexture.

** If quality < 0.75, magFilter = GL_NEAREST, otherwise magFilter = GL_LINEAR. The magFilter value can be set explicitly using the OIV.Inventor.Nodes.SoTexture.magFilter field of classes derived from OIV.Inventor.Nodes.SoTexture.

*** Means that Open Inventor automatically generates mipmap textures. See the OpenGL Programming Guide for information on mipmap textures.

See Also