Click or drag to resize
DigitalRuneCascadedShadow Class
Defines a cascaded shadow that can be used for DirectionalLights.
Inheritance Hierarchy

Namespace: DigitalRune.Graphics
Assembly: DigitalRune.Graphics (in DigitalRune.Graphics.dll) Version: 1.2.0.0 (1.2.1.14562)
Syntax
public class CascadedShadow : Shadow

The CascadedShadow type exposes the following members.

Constructors
  NameDescription
Public methodCascadedShadow
Initializes a new instance of the CascadedShadow class.
Top
Methods
  NameDescription
Public methodClone
Creates a new Shadow that is a clone (deep copy) of the current instance.
(Inherited from Shadow.)
Protected methodCloneCore
Makes the instance a clone (deep copy) of the specified Shadow.
(Overrides ShadowCloneCore(Shadow).)
Public methodStatic memberComputeSplitDistances
Computes the Distances for a CascadedShadow.
Protected methodCreateInstanceCore
When implemented in a derived class, creates a new instance of the Shadow derived class.
(Overrides ShadowCreateInstanceCore.)
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Properties
  NameDescription
Public propertyCascadeSelection
Gets or sets the cascade selection mode.
Public propertyDepthBias
Gets or sets the depth bias used to remove "surface acne".
Public propertyDepthBiasOffset Obsolete.
Gets or sets the depth bias offset of each cascade used to remove surface acne.
Public propertyDepthBiasScale Obsolete.
Gets or sets the depth bias scale of each cascade used to remove surface acne.
Public propertyDistances
Gets or sets the cascade split distances.
Public propertyFadeOutDistance Obsolete.
Gets or sets the distance from the camera where the shadow starts to fade out.
Public propertyFadeOutRange
Gets or sets the relative distance over which shadows are faded out.
Public propertyFilterRadius
Gets or sets the filter radius.
Public propertyIsCascadeLocked
Gets or sets the flags which determine if a cascade is locked.
Public propertyJitterResolution
Gets or sets the jitter resolution (for jitter sampling).
Public propertyMaxDistance Obsolete.
Gets or sets the maximum distance from the camera up to which shadows are rendered.
Public propertyMinLightDistance
Gets or sets the minimal distance of the light projection to the camera frustum of a cascade.
Public propertyNormalOffset
Gets or sets the normal offset used to remove "surface acne".
Public propertyNumberOfCascades
Gets or sets the number of cascades.
Public propertyNumberOfSamples
Gets or sets the number of filter samples.
Public propertyPrefer16Bit
Gets or sets a value indicating whether the shadow map should use a 16-bit format to store depth.
(Inherited from Shadow.)
Public propertyPreferredSize
Gets or sets the size of the desired size of the shadow map in texels.
(Inherited from Shadow.)
Public propertyShadowFog
Gets or sets the shadow factor that is used beyond the max shadow distance.
Public propertyShadowMap
Gets or sets the shadow map.
Public propertyShadowMask
Gets or sets the shadow mask.
(Inherited from Shadow.)
Public propertyShadowMaskChannel
Gets or sets the shadow mask channel.
(Inherited from Shadow.)
Public propertySplitDistribution Obsolete.
Gets or sets the split distribution parameter.
Public propertyVisualizeCascades
Gets or sets a value indicating whether cascades are visualized for debugging.
Top
Remarks

A cascaded shadow map splits the camera frustum into separate slices (up to 4). For each slice a shadow map is computed.

A "slice" is also called "cascade interval", "sub-frustum" or simply "cascade". The word "cascade" actually means "a series of stages" - however, it is common to use the term "cascade" to describe an individual slice and this term is used here too.

The term "split" could refer to the border between two slices (4 cascades = 3 splits) or to the slices (cascade = split). Therefore, the term "split" has to be used with care.

Distances defines the cascade split distances and the maximum shadow distance.

PreferredSize defines the size of a single cascade of the cascaded shadow map.

See Also