Enum aiTextureType

Source

#[repr(i32)]pub enum aiTextureType {
Show 29 variants    aiTextureType_NONE = 0,
    aiTextureType_DIFFUSE = 1,
    aiTextureType_SPECULAR = 2,
    aiTextureType_AMBIENT = 3,
    aiTextureType_EMISSIVE = 4,
    aiTextureType_HEIGHT = 5,
    aiTextureType_NORMALS = 6,
    aiTextureType_SHININESS = 7,
    aiTextureType_OPACITY = 8,
    aiTextureType_DISPLACEMENT = 9,
    aiTextureType_LIGHTMAP = 10,
    aiTextureType_REFLECTION = 11,
    aiTextureType_BASE_COLOR = 12,
    aiTextureType_NORMAL_CAMERA = 13,
    aiTextureType_EMISSION_COLOR = 14,
    aiTextureType_METALNESS = 15,
    aiTextureType_DIFFUSE_ROUGHNESS = 16,
    aiTextureType_AMBIENT_OCCLUSION = 17,
    aiTextureType_UNKNOWN = 18,
    aiTextureType_SHEEN = 19,
    aiTextureType_CLEARCOAT = 20,
    aiTextureType_TRANSMISSION = 21,
    aiTextureType_MAYA_BASE = 22,
    aiTextureType_MAYA_SPECULAR = 23,
    aiTextureType_MAYA_SPECULAR_COLOR = 24,
    aiTextureType_MAYA_SPECULAR_ROUGHNESS = 25,
    aiTextureType_ANISOTROPY = 26,
    aiTextureType_GLTF_METALLIC_ROUGHNESS = 27,
    _aiTextureType_Force32Bit = 2_147_483_647,
}

Expand description

@brief Defines the purpose of a texture

This is a very difficult topic. Different 3D packages support different kinds of textures. For very common texture types, such as bumpmaps, the rendering results depend on implementation details in the rendering pipelines of these applications. Assimp loads all texture references from the model file and tries to determine which of the predefined texture types below is the best choice to match the original use of the texture as closely as possible.

In content pipelines you’ll usually define how textures have to be handled, and the artists working on models have to conform to this specification, regardless which 3D tool they’re using.

Variants§

§

aiTextureType_NONE = 0

Dummy value.

No texture, but the value to be used as ‘texture semantic’ (#aiMaterialProperty::mSemantic) for all material properties not related to textures.

§

aiTextureType_DIFFUSE = 1

The texture is combined with the result of the diffuse lighting equation. OR PBR Specular/Glossiness

§

aiTextureType_SPECULAR = 2

The texture is combined with the result of the specular lighting equation. OR PBR Specular/Glossiness

§

aiTextureType_AMBIENT = 3

The texture is combined with the result of the ambient lighting equation.

§

aiTextureType_EMISSIVE = 4

The texture is added to the result of the lighting calculation. It isn’t influenced by incoming light.

§

aiTextureType_HEIGHT = 5

The texture is a height map.

By convention, higher gray-scale values stand for higher elevations from the base height.

§

aiTextureType_NORMALS = 6

The texture is a (tangent space) normal-map.

Again, there are several conventions for tangent-space normal maps. Assimp does (intentionally) not distinguish here.

§

aiTextureType_SHININESS = 7

The texture defines the glossiness of the material.

The glossiness is in fact the exponent of the specular (phong) lighting equation. Usually there is a conversion function defined to map the linear color values in the texture to a suitable exponent. Have fun.

§

aiTextureType_OPACITY = 8

The texture defines per-pixel opacity.

Usually ‘white’ means opaque and ‘black’ means ‘transparency’. Or quite the opposite. Have fun.

§

aiTextureType_DISPLACEMENT = 9

Displacement texture

The exact purpose and format is application-dependent. Higher color values stand for higher vertex displacements.

§

aiTextureType_LIGHTMAP = 10

Lightmap texture (aka Ambient Occlusion)

Both ‘Lightmaps’ and dedicated ‘ambient occlusion maps’ are covered by this material property. The texture contains a scaling value for the final color value of a pixel. Its intensity is not affected by incoming light.

§

aiTextureType_REFLECTION = 11

Reflection texture

Contains the color of a perfect mirror reflection. Rarely used, almost never for real-time applications.

§