C# 클래스 Axiom.Graphics.Pass

Adds the passed in TextureUnitState, to the existing Pass.

Method for cloning a Pass object.

Copy the details of this pass to the target pass.

Overloaded method.

Overloaded method.

Inserts a new TextureUnitState object into the Pass.

This unit is is added on top of all previous texture units.

Applies to both fixed-function and programmable passes.

Mark the hash for this pass as dirty.

Gets the 'hash' of this pass, ie a precomputed number to use for sorting.

This hash is used to sort passes, and for this reason the pass is hashed using firstly its index (so that all passes are rendered in order), then by the textures which it's TextureUnitState instances are using.

Gets a reference to the TextureUnitState for this pass at the specified indx.

Default constructor.

Process all dirty and pending deletion passes.

Queue this pass for deletion when appropriate.

Removes all texture unit settings from this pass.

Removes the specified TextureUnitState from this pass.

Removes the specified TextureUnitState from this pass.

Sets the way the pass will have use alpha to totally reject pixels from the pipeline.

The default is i.e. alpha is not used to reject pixels.

This option applies in both the fixed function and the programmable pipeline.

Sets the depth bias to be used for this Pass.

When polygons are coplanar, you can get problems with 'depth fighting' (or 'z fighting') where the pixels from the two polys compete for the same screen pixel. This is particularly a problem for decals (polys attached to another surface to represent details such as bulletholes etc.).

A way to combat this problem is to use a depth bias to adjust the depth buffer value used for the decal such that it is slightly higher than the true value, ensuring that the decal appears on top. There are two aspects to the biasing, a constant bias value and a slope-relative biasing value, which varies according to the maximum depth slope relative to the camera, ie:

finalBias = maxSlope * slopeScaleBias + constantBias

Overloaded method.

Overloaded method.

Overloaded method.

Overloaded method.

Sets the fogging mode applied to this pass.

Fogging is an effect that is applied as polys are rendered. Sometimes, you want fog to be applied to an entire scene. Other times, you want it to be applied to a few polygons only. This pass-level specification of fog parameters lets you easily manage both.

The SceneManager class also has a SetFog method which applies scene-level fog. This method lets you change the fog behavior for this pass compared to the standard scene-level fog.

Sets whether or not this pass should be run once per light which can affect the object being rendered.

The default behavior for a pass (when this option is 'false'), is for a pass to be rendered only once, with all the lights which could affect this object set at the same time (up to the maximum lights allowed in the render system, which is typically 8).

Setting this option to 'true' changes this behavior, such that instead of trying to issue render this pass once per object, it is run once per light which can affect this object. In this case, only light index 0 is ever used, and is a different light every time the pass is issued, up to the total number of lights which is affecting this object. This has 2 advantages:

• There is no limit on the number of lights which can be supported
• It's easier to write vertex / fragment programs for this because a single program can be used for any number of lights

Note: The number of times this pass runs is still limited by the maximum number of lights allowed as set in MaxLights, so you will never get more passes than this.

Allows very fine control of blending this Pass with the existing contents of the scene.

Wheras the texture blending operations seen in the TextureUnitState class are concerned with blending between texture layers, this blending is about combining the output of the material as a whole with the existing contents of the rendering target. This blending therefore allows object transparency and other special effects.

This version of the method allows complete control over the blending operation, by specifying the source and destination blending factors. The result of the blending operation is: final = (texture * sourceFactor) + (pixel * destFactor)

Each of the factors is specified as one of a number of options, as specified in the SceneBlendFactor enumerated type.

This method is applicable for both the fixed-function and programmable pipelines.

Sets the kind of blending this pass has with the existing contents of the scene.

Whereas the texture blending operations seen in the TextureUnitState class are concerned with blending between texture layers, this blending is about combining the output of the Pass as a whole with the existing contents of the rendering target. This blending therefore allows object transparency and other special effects. If all passes in a technique have a scene blend, then the whole technique is considered to be transparent.

This method allows you to select one of a number of predefined blending types. If you require more control than this, use the alternative version of this method which allows you to specify source and destination blend factors.

This method is applicable for both the fixed-function and programmable pipelines.

Splits this Pass to one which can be handled in the number of texture units specified.

Update any automatic light parameters on this pass.

Update any automatic parameters (except lights) on this pass.

Internal method for loading this pass.

Tells the pass that it needs recompilation.

Internal method for recalculating the hash code used for sorting passes.

Internal method for unloaded this pass.