Packageorg.papervision3d.materials
Classpublic class BitmapFileMaterial
InheritanceBitmapFileMaterial Inheritance BitmapMaterial Inheritance TriangleMaterial Inheritance MaterialObject3D Inheritance flash.events.EventDispatcher
ImplementsITriangleDrawer

The BitmapFileMaterial class creates a texture by loading a bitmap from an external file. Materials collect data about how objects appear when rendered.



Public Properties
 PropertyDefined by
 InheritedAUTO_MIP_MAPPING : Boolean = false
[static] Indicates if mip mapping is forced.
BitmapMaterial
 Inheritedbaked : Boolean = false
A Boolean value that determines whether the texture is cached, i.e.
MaterialObject3D
 Inheritedbitmap : BitmapData
A transparent or opaque BitmapData texture.
MaterialObject3D
  bitmapMaterials : Dictionary
[read-only]
BitmapFileMaterial
  callback : Function
[static] Function to call when the last image has loaded.
BitmapFileMaterial
  checkPolicyFile : Boolean = false
Sets to check for the policy file or not.
BitmapFileMaterial
 InheritedDEBUG : MaterialObject3D
[static]
MaterialObject3D
 InheritedDEBUG_COLOR : int = 0xFF00FF
[static] Color used for DEBUG material.
MaterialObject3D
 InheritedDEFAULT : MaterialObject3D
[static] Returns a MaterialObject3D object with the default magenta wireframe values.
MaterialObject3D
 InheritedDEFAULT_COLOR : int = 0x000000
[static] Color used for DEFAULT material.
MaterialObject3D
 InheriteddoubleSided : Boolean
A Boolean value that indicates whether the faces are double sided.
MaterialObject3D
  ERROR_COLOR : int
[static] The color to use for the lines when there is an error.
BitmapFileMaterial
 InheritedfillAlpha : Number = 0
An 8-bit alpha value fill the faces with.
MaterialObject3D
 InheritedfillColor : Number
A RGB color value to fill the faces with.
MaterialObject3D
 InheritedheightOffset : Number = 0
Holds the original size of the bitmap before it was resized by Automip mapping
MaterialObject3D
 Inheritedid : Number
[internal-use] [read-only] Unique id of this instance.
MaterialObject3D
 Inheritedinteractive : Boolean = false
Defines if this material will be interactive
MaterialObject3D
 Inheritedinvisible : Boolean = false
A Boolean value that indicates whether the faces are invisible (not drawn).
MaterialObject3D
 InheritedlineAlpha : Number = 0
An 8-bit alpha value for the faces outline.
MaterialObject3D
 InheritedlineColor : Number
A RGB color value to draw the faces outline.
MaterialObject3D
 InheritedlineThickness : Number = 1
An value for the thickness of the faces line.
MaterialObject3D
  loaded : Boolean
Whether or not the texture has been loaded.
BitmapFileMaterial
  loadingBitmap : BitmapData
[static] A temporary bitmap to use if the file hasn't loaded yet.
BitmapFileMaterial
  LOADING_COLOR : int
[static] The color to use in materials before loading has finished.
BitmapFileMaterial
 InheritedmaxU : Number
Internal use
MaterialObject3D
 InheritedmaxV : Number
Internal use
MaterialObject3D
 InheritedminimumRenderSize : Number = 4
BitmapMaterial
 InheritedMIP_MAP_DEPTH : Number = 8
[static] Levels of mip mapping to force.
BitmapMaterial
 Inheritedname : String
The name of the material.
MaterialObject3D
 InheritedoneSide : Boolean = true
A Boolean value that indicates whether the faces are single sided.
MaterialObject3D
 Inheritedopposite : Boolean = false
A Boolean value that indicates whether the face is flipped.
MaterialObject3D
 InheritedpixelPrecision : int
BitmapMaterial
 Inheritedprecise : Boolean
BitmapMaterial
 Inheritedprecision : int
BitmapMaterial
 InheritedprecisionMode : int
Precision mode indicates how triangles are created for precise texture render.
BitmapMaterial
 Inheritedsmooth : Boolean = false
A Boolean value that determines whether the BitmapData texture is smoothed when rendered.
MaterialObject3D
  subscribedMaterials : Object
[read-only]
BitmapFileMaterial
  texture : Object
A texture object.
BitmapFileMaterial
 Inheritedtiled : Boolean = false
A Boolean value that determines whether the texture is tiled when rendered.
MaterialObject3D
  url : String = ""
The URL that has been requested.
BitmapFileMaterial
 InheriteduvMatrices : Dictionary
BitmapMaterial
 InheritedwidthOffset : Number = 0
Holds the original size of the bitmap before it was resized by Automip mapping
MaterialObject3D
Protected Properties
 PropertyDefined by
 Inheritedax : Number
BitmapMaterial
 Inheriteday : Number
BitmapMaterial
 Inheritedaz : Number
BitmapMaterial
  bitmapLoader : Loader
BitmapFileMaterial
  _bitmapMaterials : Dictionary
[static]
BitmapFileMaterial
 Inheritedbx : Number
BitmapMaterial
 Inheritedby : Number
BitmapMaterial
 Inheritedbz : Number
BitmapMaterial
 InheritedcullRect : Rectangle
BitmapMaterial
 Inheritedcx : Number
BitmapMaterial
 Inheritedcy : Number
BitmapMaterial
 Inheritedcz : Number
BitmapMaterial
 Inheriteddabx : Number
BitmapMaterial
 Inheriteddaby : Number
BitmapMaterial
 Inheriteddbcx : Number
BitmapMaterial
 Inheriteddbcy : Number
BitmapMaterial
 Inheriteddcax : Number
BitmapMaterial
 Inheriteddcay : Number
BitmapMaterial
 Inheriteddmax : Number
BitmapMaterial
 Inheriteddsab : Number
BitmapMaterial
 Inheriteddsbc : Number
BitmapMaterial
 Inheriteddsca : Number
BitmapMaterial
  errorLoading : Boolean = false
Internal Used to define if the loading had failed.
BitmapFileMaterial
 Inheritedfaz : Number
BitmapMaterial
 Inheritedfbz : Number
BitmapMaterial
 Inheritedfcz : Number
BitmapMaterial
 Inheritedfocus : Number = 200
BitmapMaterial
 InheritedhitRect : Rectangle
[static]
BitmapMaterial
  _loaderUrls : Dictionary
[static]
BitmapFileMaterial
  _loadingIdle : Boolean = true
[static]
BitmapFileMaterial
 Inheritedmabx : Number
BitmapMaterial
 Inheritedmaby : Number
BitmapMaterial
 Inheritedmabz : Number
BitmapMaterial
 Inheritedmbcx : Number
BitmapMaterial
 Inheritedmbcy : Number
BitmapMaterial
 Inheritedmbcz : Number
BitmapMaterial
 Inheritedmcax : Number
BitmapMaterial
 Inheritedmcay : Number
BitmapMaterial
 Inheritedmcaz : Number
BitmapMaterial
 Inheritedobjects : Dictionary
Inventory of registered objects
MaterialObject3D
 Inherited_perPixelPrecision : int = 8
BitmapMaterial
 Inherited_precise : Boolean
BitmapMaterial
 Inherited_precision : int = 8
BitmapMaterial
 InheritedrenderRecStorage : Array
BitmapMaterial
  _subscribedMaterials : Object
[static]
BitmapFileMaterial
 InheritedtempPreBmp : BitmapData
BitmapMaterial
 InheritedtempPreGrp : Graphics
BitmapMaterial
 InheritedtempPreRSD : RenderSessionData
BitmapMaterial
 InheritedtempTriangleMatrix : Matrix
BitmapMaterial
 Inherited_texture : Object
BitmapMaterial
 Inherited_triMap : Matrix
[static]
BitmapMaterial
  _waitingBitmaps : Array
[static]
BitmapFileMaterial
Public Methods
 MethodDefined by
  
BitmapFileMaterial(url:String = "", precise:Boolean = false)
The BitmapFileMaterial class creates a texture by loading a bitmap from an external file.
BitmapFileMaterial
 Inherited
Creates a copy of the material.
BitmapMaterial
 Inherited
copy(material:MaterialObject3D):void
Copies the properties of a material.
BitmapMaterial
 Inherited
destroy():void
BitmapMaterial
 Inherited
drawRT(rt:RenderTriangle, graphics:Graphics, renderSessionData:RenderSessionData):void
TriangleMaterial
  
drawTriangle(tri:RenderTriangle, graphics:Graphics, renderSessionData:RenderSessionData, altBitmap:BitmapData = null, altUV:Matrix = null):void
drawFace3D
BitmapFileMaterial
 Inherited
getObjectList():Dictionary
Returns a list of DisplayObject3D objects registered with the material.
MaterialObject3D
 Inherited
isUpdateable():Boolean
MaterialObject3D
 Inherited
registerObject(displayObject3D:DisplayObject3D):void
Registers the DisplayObject3D
MaterialObject3D
 Inherited
resetMapping():void
Resets the mapping coordinates.
BitmapMaterial
 Inherited
resetUVS():void
resetUVMatrices(); Resets the precalculated uvmatrices, so they can be recalculated
BitmapMaterial
 Inherited
toString():String
Returns a string value representing the material properties in the specified BitmapMaterial object.
BitmapMaterial
 Inherited
transformUV(face3D:Triangle3D):Matrix
Applies the updated UV texture mapping values to the triangle.
BitmapMaterial
 Inherited
Applies the updated UV texture mapping values to the triangle.
BitmapMaterial
 Inherited
unregisterObject(displayObject3D:DisplayObject3D):void
MaterialObject3D
 Inherited
updateBitmap():void
Updates the BitmapData bitmap from the given texture.
MaterialObject3D
Protected Methods
 MethodDefined by
 Inherited
correctBitmap(bitmap:BitmapData):BitmapData
BitmapMaterial
 Inherited
createBitmap(asset:BitmapData):BitmapData
BitmapMaterial
  
createBitmapFromURL(asset:String):BitmapData
[internal-use]
BitmapFileMaterial
 Inherited
BitmapMaterial
  
dispatchAsyncLoadCompleteEvent(e:TimerEvent):void
BitmapFileMaterial
 Inherited
extendBitmapEdges(bmp:BitmapData, originalWidth:Number, originalHeight:Number):void
BitmapMaterial
  
getBitmapForFilename(filename:String):BitmapData
BitmapFileMaterial
  
BitmapFileMaterial
  
loadBitmapErrorHandler(e:IOErrorEvent):void
BitmapFileMaterial
  
loadBitmapProgressHandler(e:ProgressEvent):void
BitmapFileMaterial
  
loadComplete():void
BitmapFileMaterial
  
BitmapFileMaterial
  
BitmapFileMaterial
 Inherited
renderRec(emMap:Matrix, v0:Vertex3DInstance, v1:Vertex3DInstance, v2:Vertex3DInstance, index:Number):void
BitmapMaterial
  
BitmapFileMaterial
Protected Constants
 ConstantDefined by
 InheritedDEFAULT_FOCUS : Number = 200
[static]
BitmapMaterial
Property detail
bitmapLoaderproperty
protected var bitmapLoader:Loader
_bitmapMaterialsproperty 
protected static var _bitmapMaterials:Dictionary
bitmapMaterialsproperty 
bitmapMaterials:Dictionary  [read-only]Implementation
    public function get bitmapMaterials():Dictionary
callbackproperty 
public static var callback:Function

Function to call when the last image has loaded.

checkPolicyFileproperty 
public var checkPolicyFile:Boolean = false

Sets to check for the policy file or not.

ERROR_COLORproperty 
public static var ERROR_COLOR:int

The color to use for the lines when there is an error.

errorLoadingproperty 
protected var errorLoading:Boolean = false

Internal Used to define if the loading had failed.

loadedproperty 
public var loaded:Boolean

Whether or not the texture has been loaded.

_loaderUrlsproperty 
protected static var _loaderUrls:Dictionary
loadingBitmapproperty 
public static var loadingBitmap:BitmapData

A temporary bitmap to use if the file hasn't loaded yet.

LOADING_COLORproperty 
public static var LOADING_COLOR:int

The color to use in materials before loading has finished.

_loadingIdleproperty 
protected static var _loadingIdle:Boolean = true
_subscribedMaterialsproperty 
protected static var _subscribedMaterials:Object
subscribedMaterialsproperty 
subscribedMaterials:Object  [read-only]Implementation
    public function get subscribedMaterials():Object
textureproperty 
texture:Object  [read-write]

A texture object.

Implementation
    public function get texture():Object
    public function set texture(value:Object):void
urlproperty 
public var url:String = ""

The URL that has been requested.

_waitingBitmapsproperty 
protected static var _waitingBitmaps:Array
Constructor detail
BitmapFileMaterial()constructor
public function BitmapFileMaterial(url:String = "", precise:Boolean = false)

The BitmapFileMaterial class creates a texture by loading a bitmap from an external file.

Parameters
url:String (default = "") — The URL of the requested bitmap file.
 
precise:Boolean (default = false)
Method detail
createBitmapFromURL()method
protected function createBitmapFromURL(asset:String):BitmapData

[internal-use]

Parameters
asset:String

Returns
BitmapData
dispatchAsyncLoadCompleteEvent()method 
protected function dispatchAsyncLoadCompleteEvent(e:TimerEvent):voidParameters
e:TimerEvent
drawTriangle()method 
public override function drawTriangle(tri:RenderTriangle, graphics:Graphics, renderSessionData:RenderSessionData, altBitmap:BitmapData = null, altUV:Matrix = null):void

drawFace3D

Parameters
tri:RenderTriangle
 
graphics:Graphics
 
renderSessionData:RenderSessionData
 
altBitmap:BitmapData (default = null)
 
altUV:Matrix (default = null)
getBitmapForFilename()method 
protected function getBitmapForFilename(filename:String):BitmapDataParameters
filename:String

Returns
BitmapData
loadBitmapCompleteHandler()method 
protected function loadBitmapCompleteHandler(e:Event):voidParameters
e:Event
loadBitmapErrorHandler()method 
protected function loadBitmapErrorHandler(e:IOErrorEvent):voidParameters
e:IOErrorEvent
loadBitmapProgressHandler()method 
protected function loadBitmapProgressHandler(e:ProgressEvent):voidParameters
e:ProgressEvent
loadComplete()method 
protected function loadComplete():void
loadNextBitmap()method 
protected function loadNextBitmap():void
removeLoaderListeners()method 
protected function removeLoaderListeners():void
setupAsyncLoadCompleteCallback()method 
protected function setupAsyncLoadCompleteCallback():void