SoComplexitytextureQuality Property |
Hint about texture quality.
Namespace: OIV.Inventor.Nodes
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.