maxon::MATERIAL::PORTBUNDLE::GLTF Namespace Reference

Detailed Description

glTF defines materials using a common set of parameters that are based on widely used material representations from Physically-Based Rendering (PBR). Specifically, glTF uses the metallic-roughness material model. Using this declarative representation of materials enables a glTF file to be rendered consistently across platforms.

Functions
	MAXON_RESOURCE_DATABASE_SCOPE ("net.maxon.material.portbundle.gltf")
	MAXON_ATTRIBUTE (ColorA, BASECOLORFACTOR, "baseColorFactor")
	MAXON_ATTRIBUTE (ColorA, BASECOLORTEXTURE, "baseColorTexture")
	MAXON_ATTRIBUTE (Float, METALLICFACTOR, "metallicFactor")
	MAXON_ATTRIBUTE (Float, ROUGHNESSFACTOR, "roughnessFactor")
	MAXON_ATTRIBUTE (Color, METALLICROUGHNESSTEXTURE, "metallicRoughnessTexture")
	MAXON_ATTRIBUTE (Float, NORMALSCALE, "normalScale")
	MAXON_ATTRIBUTE (Color, NORMALTEXTURE, "normalTexture")
	MAXON_ATTRIBUTE (Color, EMISSIVEFACTOR, "emissiveFactor")
	MAXON_ATTRIBUTE (Color, EMISSIVETEXTURE, "emissiveTexture")
	MAXON_ATTRIBUTE (Float, OCCLUSIONSTRENGTH, "occlusionStrength")
	MAXON_ATTRIBUTE (Color, OCCLUSIONTEXTURE, "occlusionTexture")
	MAXON_ATTRIBUTE (Id, ALPHAMODE, "alphaMode", RESOURCE_DEFINE(ENUM_BLEND, LiteralId("BLEND")))
	MAXON_ATTRIBUTE (Float, ALPHACUTOFF, "alphaCutoff")
	MAXON_ATTRIBUTE (Bool, DOUBLESIDED, "doubleSided")
	MAXON_ATTRIBUTE (Group, GROUP_BASIC, "group.basic")
	MAXON_ATTRIBUTE (Group, GROUP_PBR_METALLIC_ROUGHNESS, "group.pbr_metallic_roughness")

Function Documentation

MAXON_RESOURCE_DATABASE_SCOPE()

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_RESOURCE_DATABASE_SCOPE

(

"net.maxon.material.portbundle.gltf"

)

MAXON_ATTRIBUTE() [1/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	ColorA	,
		BASECOLORFACTOR	,
		"baseColorFactor"
	)

The base color of the material. Default: [1,1,1,1].

MAXON_ATTRIBUTE() [2/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	ColorA	,
		BASECOLORTEXTURE	,
		"baseColorTexture"
	)

The base color texture in sRGB space.

MAXON_ATTRIBUTE() [3/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Float	,
		METALLICFACTOR	,
		"metallicFactor"
	)

The metalness of the material. Default: 1.

MAXON_ATTRIBUTE() [4/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Float	,
		ROUGHNESSFACTOR	,
		"roughnessFactor"
	)

The roughness of the material. Default: 1.

MAXON_ATTRIBUTE() [5/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Color	,
		METALLICROUGHNESSTEXTURE	,
		"metallicRoughnessTexture"
	)

A single map for metalness and roughness! The metalness values are in the "b" and the roughness in the "g" color channels. Values must not be encoded, i.e. in linear space.

MAXON_ATTRIBUTE() [6/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Float	,
		NORMALSCALE	,
		"normalScale"
	)

The scale for X and Y components of normal map. Default: 1.

MAXON_ATTRIBUTE() [7/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Color	,
		NORMALTEXTURE	,
		"normalTexture"
	)

The tangent space normal map. Values must not be encoded, i.e. in linear space. R [0 .. 1] -> X [-1 .. 1] G [0 .. 1] -> Y [-1 .. 1] B (.5 .. 1] -> Z (0 .. 1]

MAXON_ATTRIBUTE() [8/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Color	,
		EMISSIVEFACTOR	,
		"emissiveFactor"
	)

The emissive color of the material. Default: [0,0,0].

MAXON_ATTRIBUTE() [9/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Color	,
		EMISSIVETEXTURE	,
		"emissiveTexture"
	)

The emissive map controls the color and intensity of the light being emitted by the material. Values in sRGB space are expected.

MAXON_ATTRIBUTE() [10/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Float	,
		OCCLUSIONSTRENGTH	,
		"occlusionStrength"
	)

Amount of occlusion from the occlusion map. Default: 1 Strength formula: <final_occlusion_value> = 1.0 + strength * (<occlusion_texture_value> - 1.0)

MAXON_ATTRIBUTE() [11/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Color	,
		OCCLUSIONTEXTURE	,
		"occlusionTexture"
	)

The occlusion map indicating areas of indirect lighting. Values are sampled only from R channel of the texture. Values must not be encoded, i.e. in linear space.

MAXON_ATTRIBUTE() [12/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Id	,
		ALPHAMODE	,
		"alphaMode"	,
		RESOURCE_DEFINE(ENUM_BLEND, LiteralId("BLEND"))
	)

The alphaMpde defines how the alpha value of the main factor and texture should be interpreted. Default: "OPAQUE" Can be: "OPAQUE" - alpha values are ignored "MASK" - fully opaque if alpha >= alphaCutoff, fully transparent otherwise "BLEND" - the actual alpha value is used

MAXON_ATTRIBUTE() [13/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Float	,
		ALPHACUTOFF	,
		"alphaCutoff"
	)

The cutoff threshold. This value is only used with alpha mode "MASK". Default: 0.5.

MAXON_ATTRIBUTE() [14/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Bool	,
		DOUBLESIDED	,
		"doubleSided"
	)

Specifies whether the material is double sided. Default: false.

MAXON_ATTRIBUTE() [15/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Group	,
		GROUP_BASIC	,
		"group.basic"
	)

MAXON_ATTRIBUTE() [16/16]

maxon::MATERIAL::PORTBUNDLE::GLTF::MAXON_ATTRIBUTE	(	Group	,
		GROUP_PBR_METALLIC_ROUGHNESS	,
		"group.pbr_metallic_roughness"
	)