Packageaway3d.materials
Classpublic class CompositeMaterial
InheritanceCompositeMaterial Inheritance BitmapMaterial Inheritance LayerMaterial Inheritance ColorMaterial Inheritance WireColorMaterial Inheritance WireframeMaterial Inheritance Material Inheritance flash.events.EventDispatcher
SubclassesDepthBitmapMaterial, Dot3BitmapMaterial, Dot3MovieMaterial, EnviroBitmapMaterial, PhongBitmapMaterial, PhongColorMaterial, PhongMovieMaterial

Container for caching multiple bitmapmaterial objects. Renders each material by caching a bitmapData surface object for each face. For continually updating materials, use CompositeMaterial.

See also

away3d.materials.CompositeMaterial
Public Properties
 PropertyDefined by
 Inheritedalpha : Number
Defines an alpha value for the texture bitmap.
BitmapMaterial
 Inheritedbitmap : BitmapData
Defines the bitmapData object being used as the material texture.
BitmapMaterial
 InheritedblendMode : String
Defines a blendMode value for the texture bitmap.
BitmapMaterial
 Inheritedcolor : uint
Defines a colored tint for the texture bitmap.
BitmapMaterial
 InheritedcolorTransform : ColorTransform
Defines a colortransform for the texture bitmap.
BitmapMaterial
 Inheriteddebug : Boolean
Toggles debug mode: textured triangles are drawn with white outlines, precision correction triangles are drawn with blue outlines.
ColorMaterial
  height : Number
Returns the height of the bitmapData being used as the material texture.
CompositeMaterial
 Inheritedid : int
Unique identifier
Material
 Inheritedprecision : Number
Corrects distortion caused by the affine transformation (non-perspective) of textures.
BitmapMaterial
 Inheritedrepeat : Boolean
Determines if texture bitmap will tile in uv-space
BitmapMaterial
 InheritedshowNormals : Boolean
Displays the normals per face in pink lines.
BitmapMaterial
 Inheritedsmooth : Boolean
Determines if texture bitmap is smoothed (bilinearly filtered) when drawn to screen.
BitmapMaterial
  surfaceCache : Boolean
CompositeMaterial
 Inheritedthickness : Number
Determines the thickness value of the wire
WireframeMaterial
  transparent : Boolean
Defines whether the caching bitmapData objects are transparent
CompositeMaterial
 Inheritedvisible : Boolean
Indicates whether the material is visible
WireColorMaterial
  width : Number
Returns the width of the bitmapData being used as the material texture.
CompositeMaterial
 InheritedwireAlpha : Number
Determines the alpha value of the wire
WireframeMaterial
 InheritedwireColor : uint
24 bit color value representing the wire color
WireframeMaterial
Protected Properties
 PropertyDefined by
 Inherited_alpha : Number
WireColorMaterial
 Inherited_color : uint
WireColorMaterial
 Inherited_commands : Array
BitmapMaterial
 Inherited_debug : Boolean
ColorMaterial
 Inheritedini : Init
Instance of the Init object used to hold and parse default property values specified by the initialiser object in the 3d object constructor.
WireframeMaterial
 Inherited_invtexmapping : Matrix
BitmapMaterial
  materials : Array
An array of bitmapmaterial objects to be overlayed sequentially.
CompositeMaterial
 Inherited_screenIndices : Array
BitmapMaterial
 Inherited_screenVertices : Array
BitmapMaterial
 Inherited_thickness : Number
WireframeMaterial
 Inherited_u0 : Number
BitmapMaterial
 Inherited_u1 : Number
BitmapMaterial
 Inherited_u2 : Number
BitmapMaterial
 Inherited_v0 : Number
BitmapMaterial
 Inherited_v1 : Number
BitmapMaterial
 Inherited_v2 : Number
BitmapMaterial
 Inherited_wireAlpha : Number
WireframeMaterial
 Inherited_wireColor : uint = 0x0
WireframeMaterial
Public Methods
 MethodDefined by
  
CompositeMaterial
(init:Object = null)
Creates a new CompositeMaterial object.
CompositeMaterial
  
addMaterial(material:LayerMaterial):void
CompositeMaterial
 Inherited
addOnMaterialUpdate(listener:Function):void
Default method for adding a materialupdated event listener
Material
  
CompositeMaterial
 Inherited
clone(material:Material = null):Material
Duplicates the material properties to another material object.
ColorMaterial
 Inherited
getPixel32(u:Number, v:Number):uint
Returns the argb value of the bitmapData pixel at the given u v coordinate.
BitmapMaterial
  
removeMaterial(material:LayerMaterial):void
CompositeMaterial
 Inherited
removeOnMaterialUpdate(listener:Function):void
Default method for removing a materialupdated event listener
Material
Protected Methods
 MethodDefined by
 Inherited
WireframeMaterial
  
getMapping(priIndex:uint, viewSourceObject:ViewSourceObject, renderer:Renderer):Matrix
Calculates the mapping matrix required to draw the triangle texture to screen.
CompositeMaterial
 Inherited
invalidateFaces(source:Object3D = null, view:View3D = null):void
BitmapMaterial
 Inherited
renderSource(source:Object3D, containerRect:Rectangle, mapping:Matrix):void
BitmapMaterial
  
transformUV(faceVO:FaceVO):Matrix
CompositeMaterial
 Inherited
Updates the colortransform object applied to the texture from the color and alpha properties.
BitmapMaterial
 Inherited
updateFaces(source:Object3D = null, view:View3D = null):void
BitmapMaterial
  
Updates the texture bitmapData with the colortransform determined from the color and alpha properties.
CompositeMaterial
Events
 EventSummaryDefined by
 Inherited Dispatched when the any visual aspect of the material changes.Material
Property detail
heightproperty
height:Number  [read-write]

Returns the height of the bitmapData being used as the material texture.

Implementation
    public function get height():Number
    public function set height(value:Number):void
materialsproperty 
protected var materials:Array

An array of bitmapmaterial objects to be overlayed sequentially.

surfaceCacheproperty 
surfaceCache:Boolean  [read-write]Implementation
    public function get surfaceCache():Boolean
    public function set surfaceCache(value:Boolean):void
transparentproperty 
public var transparent:Boolean

Defines whether the caching bitmapData objects are transparent

widthproperty 
width:Number  [read-write]

Returns the width of the bitmapData being used as the material texture.

Implementation
    public function get width():Number
    public function set width(value:Number):void
Constructor detail
CompositeMaterial()constructor
public function CompositeMaterial(init:Object = null)Parameters
init:Object (default = null) — [optional] An initialisation object for specifying default instance properties.
Init Parameters
 width:Number (default = 128)
 height:Number (default = 128)
 materials:Array
 transparent:Boolean (default = true)
 surfaceCache:Boolean (default = false)
Method detail
addMaterial()method
public function addMaterial(material:LayerMaterial):void Parameters
material:LayerMaterial
clearMaterials()method 
public function clearMaterials():void
getMapping()method 
protected override function getMapping(priIndex:uint, viewSourceObject:ViewSourceObject, renderer:Renderer):Matrix

Calculates the mapping matrix required to draw the triangle texture to screen.

Parameters
priIndex:uint — The data object holding all information about the triangle to be drawn.
 
viewSourceObject:ViewSourceObject
 
renderer:Renderer

Returns
Matrix — The required matrix object.
removeMaterial()method 
public function removeMaterial(material:LayerMaterial):void Parameters
material:LayerMaterial
transformUV()method 
protected override function transformUV(faceVO:FaceVO):Matrix Parameters
faceVO:FaceVO

Returns
Matrix
updateRenderBitmap()method 
protected override function updateRenderBitmap():void

Updates the texture bitmapData with the colortransform determined from the color and alpha properties.

Wiki link
Click to go to the wiki page for 'away3d.materials.CompositeMaterial'

Code examples

Comments