Class RasterizerState


#include <Source/Falcor/Core/API/RasterizerState.h>

class dlldecl RasterizerState : public std::enable_shared_from_this<RasterizerState>


Rasterizer state

Mentioned in


Ancestors: std::enable_shared_from_this< RasterizerState >


DescRasterizer state descriptor


createCreate a new rasterizer state.
getApiHandleGet the API handle
getCullModeGet the cull mode
getDepthBiasGet the depth bias
getFillModeGet the fill mode
getForcedSampleCountGet the forced sample count
getSlopeScaledDepthBiasGet the slope-scaled depth bias
isConservativeRasterizationEnabledCheck if conservative rasterization is enabled
isDepthClampEnabledCheck if depth clamp is enabled
isFrontCounterCWCheck what is the winding order for triangles to be considered front-facing
isLineAntiAliasingEnabledCheck if anti-aliased lines are enabled
isScissorTestEnabledCheck if scissor test is enabled


Lines 34-167 in Source/Falcor/Core/API/RasterizerState.h.

class dlldecl RasterizerState : public std::enable_shared_from_this<RasterizerState>
    using SharedPtr = std::shared_ptr<RasterizerState>;
    using SharedConstPtr = std::shared_ptr<const RasterizerState>;
    /** Cull mode
    enum class CullMode
        None,   ///< No culling
        Front,  ///< Cull front-facing primitives
        Back,   ///< Cull back-facing primitives
    /** Polygon fill mode
    enum class FillMode
        Wireframe,   ///< Wireframe
        Solid        ///< Solid
    /** Rasterizer state descriptor
    class dlldecl Desc
        friend class RasterizerState;
        /** Set the cull mode
        Desc& setCullMode(CullMode mode) { mCullMode = mode; return *this; }
        /** Set the fill mode
        Desc& setFillMode(FillMode mode) { mFillMode = mode; return *this; }
        /** Determines how to interpret triangle direction.
            \param isFrontCCW If true, a triangle is front-facing if is vertices are counter-clockwise. If false, the opposite.
        Desc& setFrontCounterCW(bool isFrontCCW) { mIsFrontCcw = isFrontCCW; return *this; }
        /** Set the depth-bias. The depth bias is calculated as
            bias = (float)depthBias * r + slopeScaledBias * maxDepthSlope
            where r is the minimum representable value in the depth buffer and maxDepthSlope is the maximum of the horizontal and vertical slopes of the depth value in the pixel.\n
            See <a href="">the DX documentation</a> for depth bias explanation.
        Desc& setDepthBias(int32_t depthBias, float slopeScaledBias) { mSlopeScaledDepthBias = slopeScaledBias; mDepthBias = depthBias; return *this; }
        /** Determines weather to clip or cull the vertices based on depth
            \param clampDepth If true, clamp depth value to the viewport extent. If false, clip primitives to near/far Z-planes
        Desc& setDepthClamp(bool clampDepth) { mClampDepth = clampDepth; return *this; }
        /** Enable/disable anti-aliased lines. Actual anti-aliasing algorithm is implementation dependent, but usually uses quadrilateral lines.
        Desc& setLineAntiAliasing(bool enableLineAA) { mEnableLinesAA = enableLineAA; return *this; };
        /** Enable/disable scissor test
        Desc& setScissorTest(bool enabled) {mScissorEnabled = enabled ; return *this;}
        /** Enable/disable conservative rasterization
        Desc& setConservativeRasterization(bool enabled) { mConservativeRaster = enabled; return *this; }
        /** Set the forced sample count. Useful when using UAV
        Desc& setForcedSampleCount(uint32_t samples) { mForcedSampleCount = samples; return *this; }
        CullMode mCullMode = CullMode::Back;
        FillMode mFillMode = FillMode::Solid;
        bool     mIsFrontCcw = true;
        float    mSlopeScaledDepthBias = 0;
        int32_t  mDepthBias = 0;
        bool     mClampDepth = false;
        bool     mScissorEnabled = false;
        bool     mEnableLinesAA = true;
        uint32_t mForcedSampleCount = 0;
        bool     mConservativeRaster = false;
    /** Create a new rasterizer state.
        \param[in] desc Rasterizer state descriptor.
        \return A new object, or throws an exception if creation failed.
    static SharedPtr create(const Desc& desc);
    /** Get the cull mode
    CullMode getCullMode() const { return mDesc.mCullMode; }
    /** Get the fill mode
    FillMode getFillMode() const { return mDesc.mFillMode; }
    /** Check what is the winding order for triangles to be considered front-facing
    bool isFrontCounterCW() const{ return mDesc.mIsFrontCcw; }
    /** Get the slope-scaled depth bias
    float getSlopeScaledDepthBias() const { return mDesc.mSlopeScaledDepthBias; }
    /** Get the depth bias
    int32_t getDepthBias() const { return mDesc.mDepthBias; }
    /** Check if depth clamp is enabled
    bool isDepthClampEnabled() const { return mDesc.mClampDepth; }
    /** Check if scissor test is enabled
    bool isScissorTestEnabled() const { return mDesc.mScissorEnabled; }
    /** Check if anti-aliased lines are enabled
    bool isLineAntiAliasingEnabled() const { return mDesc.mEnableLinesAA; }
    /** Check if conservative rasterization is enabled
    bool isConservativeRasterizationEnabled() const { return mDesc.mConservativeRaster; }
    /** Get the forced sample count
    uint32_t getForcedSampleCount() const { return mDesc.mForcedSampleCount; }
    /** Get the API handle
    const RasterizerStateHandle& getApiHandle() const;
    RasterizerStateHandle mApiHandle;
    RasterizerState(const Desc& Desc) : mDesc(Desc) {}
    Desc mDesc;

Add Discussion as Guest

Log in