Material Instances

From HEWIKI
(Difference between revisions)
Jump to: navigation, search
(Overview)
(Serialization Format)
Line 14: Line 14:
 
== Serialization Format  ==
 
== Serialization Format  ==
  
Changes made through the Material Instance Properties dialogue are represented in a serialized override string. Values which differ from the base material appear in the string within the _MaterialOverrides property field in the [[Properties Panel]].  
+
Changes made through the Material Instance Properties dialogue are represented in a serialized override string. Values which differ from the base material will appear in the string within the _MaterialOverrides property field in the [[Properties Panel]].  
  
 
The serialization format is as follows.  
 
The serialization format is as follows.  
Line 24: Line 24:
 
<code>0%mushroom_demo6#82b311bfb05255ae1e9822a0c49b3aab[/techart/hill/grannyexport/textures/orange_utility.dds,1,,,,1,,0,0,1,1,1,0,0,0,0]</code>  
 
<code>0%mushroom_demo6#82b311bfb05255ae1e9822a0c49b3aab[/techart/hill/grannyexport/textures/orange_utility.dds,1,,,,1,,0,0,1,1,1,0,0,0,0]</code>  
  
[[Image:MaterialInstancePropertiesDialogueExample.png|center|MaterialInstancePropertiesDialogueExample.png]]  
+
[[Image:MaterialInstancePropertiesDialogueExample.png|center|MaterialInstancePropertiesDialogueExample.png]]
  
 
== An Example  ==
 
== An Example  ==

Revision as of 20:32, 2 November 2012

Contents

Overview

The Mateiral Instance System allows users to apply changes to the appearance of an object in the world by applying custom material properties to the asset instance directly.

Terminology

An Asset is a template from which things in the game world are made. An asset instance is an object with a unique ID number, created from an asset. Areas are mainly populated with asset instances instantiated from the Asset Library. Assets own meshes.

A mesh is a single set of geometry, and a reference to the material which it uses. There may be multiple meshes in a model -- for example, a barrel of apples may consist of a mesh for the wooden barrel and a mesh for the pile of apples.

A Material is a set of textures with defined roles (such as diffuse, normal/specular and macro) and associated properties. A material instance a unique combination of material properties which can be applied to one or more asset meshes. Material Instance Properties can be customized using the Material Instance Properties dialogue.

Serialization Format

Changes made through the Material Instance Properties dialogue are represented in a serialized override string. Values which differ from the base material will appear in the string within the _MaterialOverrides property field in the Properties Panel.

The serialization format is as follows.

<serialization format version number> % <instance name> # <hash string for this material instance> [ <diffuse map path>,<diffuse map alpha type>,<normal map path>,<normal map contains specular channel>,<macro map path>,<macro map UV multiplier>,<shader map path>,<shader translucency>,<shader reflectivity>,<texture address mode U>,<texture address mode V>,<polygon attributes>,<animated UVs U1>,<animated UVs V1>,<animated UVs U2>,<animated UVs V2>]

Here is an example of a material override string after changing the diffuse map path. Note that some values are empty and others contain default enumerations which are set by the system.

0%mushroom_demo6#82b311bfb05255ae1e9822a0c49b3aab[/techart/hill/grannyexport/textures/orange_utility.dds,1,,,,1,,0,0,1,1,1,0,0,0,0]

MaterialInstancePropertiesDialogueExample.png

An Example

  1. Log into any test area where changes won't be persisted (any play instance).
  2. Using the Asset Library, place two utility cubes in the area.
  3. Open the properties panel if it's not already visible.
  4. Select one of the cubes and navigate to the _MaterialOverrides property in the Properties Panel.
  5. Click on the empty space where the value for "_MaterialOverrides" would otherwise be. A "..." button will appear to the right. Click on that.
  6. The Material Instance Properties dialogue will appear. Click on the button with the diffuse map file name under "Diffuse/Alpha Map" and select any .dds file you like from the repository. The change you make will be immediately reflected in your viewport and to any other clients in your area instance.
  7. Press the close button and perform steps 4 - 6 on the other cube you placed in the area. Only, for the second cube, choose a different .dds file from the first. You'll notice that the two asset instances now have separate appearances due to their different material overrides.

Additional information about the dialogue and other customization options can be found on the Material Instance Properties wiki page.

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox