Packageaway3d.materials.methods
Classpublic class CompositeSpecularMethod
InheritanceCompositeSpecularMethod Inheritance BasicSpecularMethod Inheritance LightingMethodBase Inheritance ShadingMethodBase Inheritance NamedAssetBase Inheritance flash.events.EventDispatcher
Subclasses CelSpecularMethod, FresnelSpecularMethod

CompositeSpecularMethod provides a base class for specular methods that wrap a specular method to alter the calculated specular reflection strength.



Public Properties
 PropertyDefined By
 InheritedassetFullPath : Array
[read-only]
NamedAssetBase
 InheritedassetNamespace : String
[read-only]
NamedAssetBase
  baseMethod : BasicSpecularMethod
The base specular method on which this method's shading is based.
CompositeSpecularMethod
  gloss : Number
[override] The sharpness of the specular highlight.
CompositeSpecularMethod
 Inheritedid : String
NamedAssetBase
 Inheritedname : String
NamedAssetBase
 InheritedoriginalName : String
[read-only] The original name used for this asset in the resource (e.g.
NamedAssetBase
  passes : Vector.<MaterialPassBase>
[override] [read-only] Any passes required that render to a texture used by this method.
CompositeSpecularMethod
  specular : Number
[override] The overall strength of the specular highlights.
CompositeSpecularMethod
 InheritedspecularColor : uint
The colour of the specular reflection of the surface.
BasicSpecularMethod
  texture : Texture2DBase
[override] The bitmapData that encodes the specular highlight strength per texel in the red channel, and the sharpness in the green channel.
CompositeSpecularMethod
Protected Properties
 PropertyDefined By
 Inherited_isFirstLight : Boolean
BasicSpecularMethod
 Inherited_passes : Vector.<MaterialPassBase>
ShadingMethodBase
 Inherited_sharedRegisters : ShaderRegisterData
ShadingMethodBase
 Inherited_specularDataRegister : ShaderRegisterElement
BasicSpecularMethod
 Inherited_specularTexData : ShaderRegisterElement
BasicSpecularMethod
 Inherited_specularTextureRegister : ShaderRegisterElement
BasicSpecularMethod
 Inherited_totalLightColorReg : ShaderRegisterElement
BasicSpecularMethod
 Inherited_useTexture : Boolean
BasicSpecularMethod
Public Methods
 MethodDefined By
  
CompositeSpecularMethod(modulateMethod:Function, baseSpecularMethod:BasicSpecularMethod = null)
Creates a new WrapSpecularMethod object.
CompositeSpecularMethod
 Inherited
assetPathEquals(name:String, ns:String):Boolean
NamedAssetBase
 Inherited
[override] Copies the state from a ShadingMethodBase object into the current object.
BasicSpecularMethod
  
dispose():void
[override] Cleans up any resources used by the current object.
CompositeSpecularMethod
 Inherited
resetAssetPath(name:String, ns:String = null, overrideOriginal:Boolean = true):void
NamedAssetBase
Protected Methods
 MethodDefined By
 Inherited
getTex2DSampleCode(vo:MethodVO, targetReg:ShaderRegisterElement, inputReg:ShaderRegisterElement, texture:TextureProxyBase, uvReg:ShaderRegisterElement = null, forceWrap:String = null):String
A helper method that generates standard code for sampling from a texture using the normal uv coordinates.
ShadingMethodBase
 Inherited
A helper method that generates standard code for sampling from a cube texture.
ShadingMethodBase
 Inherited
Marks the shader program as invalid, so it will be recompiled before the next render.
ShadingMethodBase
Public Constants
 ConstantDefined By
 InheritedDEFAULT_NAMESPACE : String = default
[static]
NamedAssetBase
Property Detail
baseMethodproperty
baseMethod:BasicSpecularMethod

The base specular method on which this method's shading is based.


Implementation
    public function get baseMethod():BasicSpecularMethod
    public function set baseMethod(value:BasicSpecularMethod):void
glossproperty 
gloss:Number[override]

The sharpness of the specular highlight.


Implementation
    public function get gloss():Number
    public function set gloss(value:Number):void
passesproperty 
passes:Vector.<MaterialPassBase>  [read-only] [override]

Any passes required that render to a texture used by this method.


Implementation
    public function get passes():Vector.<MaterialPassBase>
shadowRegisterproperty 
shadowRegister:ShaderRegisterElement  [write-only] [override]

Set internally by the compiler, so the method knows the register containing the shadow calculation.


Implementation
    arcane function set shadowRegister(value:ShaderRegisterElement):void
sharedRegistersproperty 
sharedRegisters:ShaderRegisterData[override]

The shared registers created by the compiler and possibly used by methods.


Implementation
    arcane function get sharedRegisters():ShaderRegisterData
    arcane function set sharedRegisters(value:ShaderRegisterData):void
specularproperty 
specular:Number[override]

The overall strength of the specular highlights.


Implementation
    public function get specular():Number
    public function set specular(value:Number):void
textureproperty 
texture:Texture2DBase[override]

The bitmapData that encodes the specular highlight strength per texel in the red channel, and the sharpness in the green channel. You can use SpecularBitmapTexture if you want to easily set specular and gloss maps from grayscale images, but prepared images are preferred.


Implementation
    public function get texture():Texture2DBase
    public function set texture(value:Texture2DBase):void
Constructor Detail
CompositeSpecularMethod()Constructor
public function CompositeSpecularMethod(modulateMethod:Function, baseSpecularMethod:BasicSpecularMethod = null)

Creates a new WrapSpecularMethod object.

Parameters
modulateMethod:Function — The method which will add the code to alter the base method's strength. It needs to have the signature modSpecular(t : ShaderRegisterElement, regCache : ShaderRegisterCache) : String, in which t.w will contain the specular strength and t.xyz will contain the half-vector or the reflection vector.
 
baseSpecularMethod:BasicSpecularMethod (default = null) — The base specular method on which this method's shading is based.
Method Detail
activate()method
override arcane function activate(vo:MethodVO, stage3DProxy:Stage3DProxy):void

Parameters

vo:MethodVO
 
stage3DProxy:Stage3DProxy

cleanCompilationData()method 
override arcane function cleanCompilationData():void

deactivate()method 
override arcane function deactivate(vo:MethodVO, stage3DProxy:Stage3DProxy):void

Clears the render state for this method.

Parameters

vo:MethodVO — The MethodVO object linking this method with the pass currently being compiled.
 
stage3DProxy:Stage3DProxy — The Stage3DProxy object currently used for rendering.

dispose()method 
override public function dispose():void

Cleans up any resources used by the current object.

getFragmentCodePerLight()method 
override arcane function getFragmentCodePerLight(vo:MethodVO, lightDirReg:ShaderRegisterElement, lightColReg:ShaderRegisterElement, regCache:ShaderRegisterCache):String

Get the fragment shader code that will generate the code relevant to a single light.

Parameters

vo:MethodVO — The MethodVO object containing the method data for the currently compiled material pass.
 
lightDirReg:ShaderRegisterElement — The register containing the light direction vector.
 
lightColReg:ShaderRegisterElement — The register containing the light colour.
 
regCache:ShaderRegisterCache — The register cache used during the compilation.

Returns
String
getFragmentCodePerProbe()method 
override arcane function getFragmentCodePerProbe(vo:MethodVO, cubeMapReg:ShaderRegisterElement, weightRegister:String, regCache:ShaderRegisterCache):String

Get the fragment shader code that will generate the code relevant to a single light probe object.

Parameters

vo:MethodVO — The MethodVO object containing the method data for the currently compiled material pass.
 
cubeMapReg:ShaderRegisterElement — The register containing the cube map for the current probe
 
weightRegister:String — A string representation of the register + component containing the current weight
 
regCache:ShaderRegisterCache — The register cache providing any necessary registers to the shader

Returns
String
getFragmentPostLightingCode()method 
override arcane function getFragmentPostLightingCode(vo:MethodVO, regCache:ShaderRegisterCache, targetReg:ShaderRegisterElement):String

Parameters

vo:MethodVO
 
regCache:ShaderRegisterCache
 
targetReg:ShaderRegisterElement

Returns
String
getFragmentPreLightingCode()method 
override arcane function getFragmentPreLightingCode(vo:MethodVO, regCache:ShaderRegisterCache):String

Parameters

vo:MethodVO
 
regCache:ShaderRegisterCache

Returns
String
getVertexCode()method 
override arcane function getVertexCode(vo:MethodVO, regCache:ShaderRegisterCache):String

Parameters

vo:MethodVO
 
regCache:ShaderRegisterCache

Returns
String
initConstants()method 
override arcane function initConstants(vo:MethodVO):void

Initializes unchanging shader constants using the data from a MethodVO.

Parameters

vo:MethodVO — The MethodVO object linking this method with the pass currently being compiled.

initVO()method 
override arcane function initVO(vo:MethodVO):void

Initializes the properties for a MethodVO, including register and texture indices.

Parameters

vo:MethodVO — The MethodVO object linking this method with the pass currently being compiled.

reset()method 
override arcane function reset():void

Resets the compilation state of the method.