Helper class to store rendering parameters. More...

#include <Graphic3d_RenderingParams.hxx>

Public Types
enum	Anaglyph { Anaglyph_RedCyan_Simple, Anaglyph_RedCyan_Optimized, Anaglyph_YellowBlue_Simple, Anaglyph_YellowBlue_Optimized, Anaglyph_GreenMagenta_Simple, Anaglyph_UserDefined }
	Anaglyph filter presets. More...

Public Member Functions
	Graphic3d_RenderingParams ()
	Creates default rendering parameters. More...

Standard_ShortReal	ResolutionRatio () const
	Returns resolution ratio. More...

Data Fields
Graphic3d_RenderingMode	Method
	specifies rendering mode, Graphic3d_RM_RASTERIZATION by default More...

Graphic3d_RenderTransparentMethod	TransparencyMethod
	specifies rendering method for transparent graphics More...

Standard_ShortReal	OitDepthFactor
	scalar factor [0-1] controlling influence of depth of a fragment to its final coverage More...

Standard_Integer	NbMsaaSamples
	number of MSAA samples (should be within 0..GL_MAX_SAMPLES, power-of-two number), 0 by default More...

Standard_ShortReal	RenderResolutionScale
	rendering resolution scale factor, 1 by default; incompatible with MSAA (e.g. NbMsaaSamples should be set to 0) More...

Standard_Boolean	IsGlobalIlluminationEnabled
	enables/disables global illumination effects (path tracing) More...

Standard_Integer	SamplesPerPixel
	number of samples per pixel (SPP) More...

Standard_Integer	RaytracingDepth
	maximum ray-tracing depth, 3 by default More...

Standard_Boolean	IsShadowEnabled
	enables/disables shadows rendering, True by default More...

Standard_Boolean	IsReflectionEnabled
	enables/disables specular reflections, False by default More...

Standard_Boolean	IsAntialiasingEnabled
	enables/disables adaptive anti-aliasing, False by default More...

Standard_Boolean	IsTransparentShadowEnabled
	enables/disables light propagation through transparent media, False by default More...

Standard_Boolean	UseEnvironmentMapBackground
	enables/disables environment map background More...

Standard_Boolean	CoherentPathTracingMode
	enables/disables 'coherent' tracing mode (single RNG seed within 16x16 image blocks) More...

Standard_Boolean	AdaptiveScreenSampling
	enables/disables adaptive screen sampling mode for path tracing, FALSE by default More...

Standard_Boolean	ShowSamplingTiles
	enables/disables debug mode for adaptive screen sampling, FALSE by default More...

Standard_Boolean	TwoSidedBsdfModels
	forces path tracing to use two-sided versions of original one-sided scattering models More...

Standard_ShortReal	RadianceClampingValue
	maximum radiance value used for clamping radiance estimation. More...

Standard_Boolean	RebuildRayTracingShaders
	forces rebuilding ray tracing shaders at the next frame More...

Standard_Integer	NbRayTracingTiles
	total number of screen tiles used in adaptive sampling mode (PT only) More...

Standard_ShortReal	CameraApertureRadius
	aperture radius of perspective camera used for depth-of-field, 0.0 by default (no DOF) (path tracing only) More...

Standard_ShortReal	CameraFocalPlaneDist
	focal distance of perspective camera used for depth-of field, 1.0 by default (path tracing only) More...

Graphic3d_ToneMappingMethod	ToneMappingMethod
	specifies tone mapping method for path tracing, Graphic3d_ToneMappingMethod_Disabled by default More...

Standard_ShortReal	Exposure
	exposure value used for tone mapping (path tracing), 0.0 by default More...

Standard_ShortReal	WhitePoint
	white point value used in filmic tone mapping (path tracing), 1.0 by default More...

Graphic3d_StereoMode	StereoMode
	stereoscopic output mode, Graphic3d_StereoMode_QuadBuffer by default More...

Anaglyph	AnaglyphFilter
	filter for anaglyph output, Anaglyph_RedCyan_Optimized by default More...

Graphic3d_Mat4	AnaglyphLeft
	left anaglyph filter (in normalized colorspace), Color = AnaglyphRight * theColorRight + AnaglyphLeft * theColorLeft; More...

Graphic3d_Mat4	AnaglyphRight
	right anaglyph filter (in normalized colorspace), Color = AnaglyphRight * theColorRight + AnaglyphLeft * theColorLeft; More...

Standard_Boolean	ToReverseStereo
	flag to reverse stereo pair, FALSE by default More...

unsigned int	Resolution
	Pixels density (PPI), defines scaling factor for parameters like text size (when defined in screen-space units rather than in 3D) to be properly displayed on device (screen / printer). 72 is default value. Note that using difference resolution in different Views in same Viewer will lead to performance regression (for example, text will be recreated every time). More...

Static Public Attributes
static const unsigned int	THE_DEFAULT_RESOLUTION = 72u
	Default pixels density. More...

static const Standard_Integer	THE_DEFAULT_DEPTH = 3
	Default ray-tracing depth. More...

Detailed Description

Helper class to store rendering parameters.

Member Enumeration Documentation

◆ Anaglyph

enum Graphic3d_RenderingParams::Anaglyph

Anaglyph filter presets.

Enumerator
Anaglyph_RedCyan_Simple	simple filter for Red-Cyan glasses (R+GB)
Anaglyph_RedCyan_Optimized	optimized filter for Red-Cyan glasses (R+GB)
Anaglyph_YellowBlue_Simple	simple filter for Yellow-Blue glasses (RG+B)
Anaglyph_YellowBlue_Optimized	optimized filter for Yellow-Blue glasses (RG+B)
Anaglyph_GreenMagenta_Simple	simple filter for Green-Magenta glasses (G+RB)
Anaglyph_UserDefined	use externally specified matrices

Constructor & Destructor Documentation

◆ Graphic3d_RenderingParams()

Graphic3d_RenderingParams::Graphic3d_RenderingParams ( )

inline

Creates default rendering parameters.

Member Function Documentation

◆ ResolutionRatio()

Standard_ShortReal Graphic3d_RenderingParams::ResolutionRatio ( ) const

inline

Returns resolution ratio.

Field Documentation

◆ AdaptiveScreenSampling

Standard_Boolean Graphic3d_RenderingParams::AdaptiveScreenSampling

enables/disables adaptive screen sampling mode for path tracing, FALSE by default

◆ AnaglyphFilter

Anaglyph Graphic3d_RenderingParams::AnaglyphFilter

filter for anaglyph output, Anaglyph_RedCyan_Optimized by default

◆ AnaglyphLeft

Graphic3d_Mat4 Graphic3d_RenderingParams::AnaglyphLeft

left anaglyph filter (in normalized colorspace), Color = AnaglyphRight * theColorRight + AnaglyphLeft * theColorLeft;

◆ AnaglyphRight

Graphic3d_Mat4 Graphic3d_RenderingParams::AnaglyphRight

right anaglyph filter (in normalized colorspace), Color = AnaglyphRight * theColorRight + AnaglyphLeft * theColorLeft;

◆ CameraApertureRadius

Standard_ShortReal Graphic3d_RenderingParams::CameraApertureRadius

aperture radius of perspective camera used for depth-of-field, 0.0 by default (no DOF) (path tracing only)

◆ CameraFocalPlaneDist

Standard_ShortReal Graphic3d_RenderingParams::CameraFocalPlaneDist

focal distance of perspective camera used for depth-of field, 1.0 by default (path tracing only)

◆ CoherentPathTracingMode

Standard_Boolean Graphic3d_RenderingParams::CoherentPathTracingMode

enables/disables 'coherent' tracing mode (single RNG seed within 16x16 image blocks)

◆ Exposure

Standard_ShortReal Graphic3d_RenderingParams::Exposure

exposure value used for tone mapping (path tracing), 0.0 by default

◆ IsAntialiasingEnabled

Standard_Boolean Graphic3d_RenderingParams::IsAntialiasingEnabled

enables/disables adaptive anti-aliasing, False by default

◆ IsGlobalIlluminationEnabled

Standard_Boolean Graphic3d_RenderingParams::IsGlobalIlluminationEnabled

enables/disables global illumination effects (path tracing)

◆ IsReflectionEnabled

Standard_Boolean Graphic3d_RenderingParams::IsReflectionEnabled

enables/disables specular reflections, False by default

◆ IsShadowEnabled

Standard_Boolean Graphic3d_RenderingParams::IsShadowEnabled

enables/disables shadows rendering, True by default

◆ IsTransparentShadowEnabled

Standard_Boolean Graphic3d_RenderingParams::IsTransparentShadowEnabled

enables/disables light propagation through transparent media, False by default

◆ Method

Graphic3d_RenderingMode Graphic3d_RenderingParams::Method

specifies rendering mode, Graphic3d_RM_RASTERIZATION by default

◆ NbMsaaSamples

Standard_Integer Graphic3d_RenderingParams::NbMsaaSamples

number of MSAA samples (should be within 0..GL_MAX_SAMPLES, power-of-two number), 0 by default

◆ NbRayTracingTiles

Standard_Integer Graphic3d_RenderingParams::NbRayTracingTiles

total number of screen tiles used in adaptive sampling mode (PT only)

◆ OitDepthFactor

Standard_ShortReal Graphic3d_RenderingParams::OitDepthFactor

scalar factor [0-1] controlling influence of depth of a fragment to its final coverage

◆ RadianceClampingValue

Standard_ShortReal Graphic3d_RenderingParams::RadianceClampingValue

maximum radiance value used for clamping radiance estimation.

◆ RaytracingDepth

Standard_Integer Graphic3d_RenderingParams::RaytracingDepth

maximum ray-tracing depth, 3 by default

◆ RebuildRayTracingShaders

Standard_Boolean Graphic3d_RenderingParams::RebuildRayTracingShaders

forces rebuilding ray tracing shaders at the next frame

◆ RenderResolutionScale

Standard_ShortReal Graphic3d_RenderingParams::RenderResolutionScale

rendering resolution scale factor, 1 by default; incompatible with MSAA (e.g. NbMsaaSamples should be set to 0)

◆ Resolution

unsigned int Graphic3d_RenderingParams::Resolution

Pixels density (PPI), defines scaling factor for parameters like text size (when defined in screen-space units rather than in 3D) to be properly displayed on device (screen / printer). 72 is default value. Note that using difference resolution in different Views in same Viewer will lead to performance regression (for example, text will be recreated every time).

◆ SamplesPerPixel

Standard_Integer Graphic3d_RenderingParams::SamplesPerPixel

number of samples per pixel (SPP)

◆ ShowSamplingTiles

Standard_Boolean Graphic3d_RenderingParams::ShowSamplingTiles

enables/disables debug mode for adaptive screen sampling, FALSE by default

◆ StereoMode

Graphic3d_StereoMode Graphic3d_RenderingParams::StereoMode

stereoscopic output mode, Graphic3d_StereoMode_QuadBuffer by default

◆ THE_DEFAULT_DEPTH

const Standard_Integer Graphic3d_RenderingParams::THE_DEFAULT_DEPTH = 3

static

Default ray-tracing depth.

◆ THE_DEFAULT_RESOLUTION

const unsigned int Graphic3d_RenderingParams::THE_DEFAULT_RESOLUTION = 72u

static

Default pixels density.

◆ ToneMappingMethod

Graphic3d_ToneMappingMethod Graphic3d_RenderingParams::ToneMappingMethod

specifies tone mapping method for path tracing, Graphic3d_ToneMappingMethod_Disabled by default

◆ ToReverseStereo

Standard_Boolean Graphic3d_RenderingParams::ToReverseStereo

flag to reverse stereo pair, FALSE by default

◆ TransparencyMethod

Graphic3d_RenderTransparentMethod Graphic3d_RenderingParams::TransparencyMethod

specifies rendering method for transparent graphics

◆ TwoSidedBsdfModels

Standard_Boolean Graphic3d_RenderingParams::TwoSidedBsdfModels

forces path tracing to use two-sided versions of original one-sided scattering models

◆ UseEnvironmentMapBackground

Standard_Boolean Graphic3d_RenderingParams::UseEnvironmentMapBackground

enables/disables environment map background

◆ WhitePoint

Standard_ShortReal Graphic3d_RenderingParams::WhitePoint

white point value used in filmic tone mapping (path tracing), 1.0 by default

The documentation for this class was generated from the following file:

Graphic3d_RenderingParams.hxx

Graphic3d_RenderingParams Class Reference

Public Types

Public Member Functions

Data Fields

Static Public Attributes