User Tools

Site Tools


gamedev:texturepropertylist

This is an old revision of the document!


This list contains all approved texture properties. If you implement a graphic, audio or physics module you should stick to this list. You are not required to support all texture properties mentioned here but if you support them stick to the definition below. Artist rely on the same list to produce their content. For testing new texture properties you can of course define new properties and propose them for inclusion.

The properties are listed with their name as title. Property names typically compose of one or more names with optional dots in between. Color components and gray scale values are written in the range from 0 to 1 with 0 equal to an RGB value of 0 and 1 equal to an RGB value of 255. The brief below the description indicates the used data type and the default value if the property is not specified. Values in round brackets indicate a color with in the form ( red, green, blue ) or ( red, green, blue, alpha ).

Note: Boolean Value is the same as Single Value just indicating that only the values 0 and 1 have a meaning.

Property NameDescriptionSourceDefaultAffected ModulesLinked Properties
ambient.occlusionAmbient occlusion.image1Graphic-
colorAlbedo color.image(0,0,0)Graphiccolor.gamma, color.tint
color_alphaAlbedo color with transparency.image(0,0,0,1)Graphiccolor.gamma, color.tint
color.gammaGamma correction for the color and color_alpha texture property.value2.2Graphiccolor, color_alpha
color.tintTint for the color and color_alpha texture property.value(1,1,1)Graphiccolor, color_alpha
transparencyTransparency.image1Graphictransparency.type
transparency.typeTransparency type (full or masked).value0 (masked)Graphictransparency
normalSurface normal.image(0.5,0.5,1.0)Graphic, Physicsnormal.strength
normal.strengthStrength of normal property influence.value1Graphic, Physicsnormal
heightHeight of surface point.value0.5Graphicheight.scale
height.scaleScale of height texture property.value1Graphicheight
refraction.distortDistortion behind transparent object.image(0.5,0.5)Graphicrefraction.distort.strength
refraction.distort.strengthStrength of the distortion behind transparent object effect.value0.01Graphicrefraction.distort
reflectivityPer-color reflectivity/reflectance.image3Graphicreflectivity.gamma
reflectivity.gammaGamma correction for the reflectivity texture property.value1Graphicreflectivity
roughnessSurface roughness.image(1,1)Graphic, Physicsroughness.remap.lower, roughness.remap.upper, roughness.gamma
roughness.remap.lowerLower remap value for the roughness texture property.value0Graphic, Physicsroughness
roughness.remap.upperUpper remap value for the roughness texture property.value1Graphic, Physicsroughness
roughness.gammaGamma correction for the roughness texture property.value1Graphic, Physicsroughness
environmentmapDefines a custom environmentmap to use for reflections.image(1,1,1,0)Graphic-
mirrorDefines if the material is fully mirroring.value0Graphic-
emissivityDefines the emissivity.image(0,0,0)Graphicemissivity.intensity
emissivity.intensityDefines the emissivity intensity.value1Graphicemissivity
shadow.noneDefines if the material casts shadows.value1Graphic-
shadow.importanceDefines how important shadow casting is for this material.value1Graphic-

Graphic Properties

These properties are understood in general only by the Graphic Module. Some might also be understood by other modules but this is not the default behavior.

shadeless

Defines if a texture is insensitive to all lighting. This property is designed for editor applications requiring control objects to be shown even if they are in total darkness. Since this is not meant for actual games the speed of rendering shadeless objects is not required to be high. For actual games you should use the emissive.* texture properties instead disabling all other light sources ( setting their color to (0,0,0) ). A value of 0 equals to this texture being lit properly. A value of 1 marks this texture as shadeless ignoring all lighting. This is a single value with default 0.
Boolean value, default 0

hint.nocompression

Defines if hardware textures can be compressed or not. Graphic modules can decide to compress textures to conserve memory. Compression though tends to have a more or less negative impact on the visual quality depending on the kind of texture. Usually diffuse textures are compressed while normal textures are not. If you have a special texture which has to keep the full quality you can use this property to tell the Graphic Module to not compress this texture. As this is a hint the Graphic Module is not required to respect it. A value of 0 indicates that this texture can be compressed. A value of 1 indicates that this texture should not be compressed if possible. This is a single value with default 0.
Boolean value, default 0

mirror

Defines that this material is a fully reflective ( perfect ) flat mirror. All pixels covered by mesh faces with this texture reflect the world totally. Transparency effects like refraction distortion can be applied to mirrors. Use this property only on flat or nearly flat geometry. For curved geometry use the reflection.* properties. Mirror reflections tend to be faster than reflection.* reflections and should be used if the geometry is flat. A value of 0 equals to no mirror reflection. A value of 1 equals to full mirror reflections. This is a single value wit default 0.
Boolean value, default 0

Physics Properties

These properties are understood by the Physics Module.

bounciness

Defines the bounciness of a surface. This is used by the physics module to determine with what fraction of the incoming force an object is repelled from a surface. A value of 0 equals to no bounciness in which case an object hitting this surface is not repelled at all whereas 1 equals to full bounciness in which case an object bounces off this surface with the force it arrived. This has to be a single value.
Single value, default 0.2

Audio Properties

These properties are understood by the Audio Module.

Note: There are not accepted audio properties yet but some in testing.

You could leave a comment if you were logged in.
gamedev/texturepropertylist.1354465225.txt.gz · Last modified: 2012/12/02 16:20 by dragonlord