User Tools

Site Tools


DzRenderOptions

This class manages the inclusion/exclusion of render options.

More...

Inherits :

Inherited By : textureconvertoroptions_dz

Enumerations

Properties

Constructors

DAZ Script
DzRenderOptions ()

Methods

DAZ Script
voidapplyChanges ()
voidcopyFrom ( DzRenderOptions opt )
DzFloatColorgammaCorrectColor ( DzFloatColor color )
voidresetOptions ()
voidrestoreDefaultSettings ()
voidsetAspectRatio ( Number widthRatio, Number heightRatio )
voidsetToDefaults ()

Signals

voidaspectChanged ( Number val )
voidaspectChanged ( Number w, Number h )
voidaspectConstrainChanged ( Boolean onOff )
voiddefaultsRestored ()
voiddoubleSidedChanged ( Boolean onOff )
voidendTimeChanged ( DzTime time )
voidgainChanged ( Number gain )
voidgammaChanged ( Number gamma )
voidgammaCorrectionChanged ( DzRenderOptions::GammaCorrection gc )
voidimageSizeChanged ( Size size )
voidmotionBlurOffsetChanged ( Number offset )
voidmotionBlurPctChanged ( Number pct )
voidmotionBlurSamplesChanged ( Number samples )
voidopenGLPassesChanged ( Number passes )
voidpixelFilterChanged ( DzRenderOptions::PixelFilter filter )
voidrayTraceDepthChanged ( Number depth )
voidrenderCurrentFrameChanged ( Boolean onOff )
voidrenderImgFilenameChanged ( String filename )
voidrenderImgTargetChanged ( DzRenderOptions::RenderImgTarget id )
voidrenderMovFilenameChanged ( String filename )
voidrenderMovTargetChanged ( DzRenderOptions::RenderMovTarget id )
voidrenderSerFilenameChanged ( String filename )
voidrenderStyleChanged ( DzRenderOptions::RenderStyle style )
voidrenderTypeChanged ( DzRenderOptions::RenderType type )
voidrenderViewportChanged ( Boolean onOff )
voidsettingsChanged ()
voidshadingRateChanged ( Number rate )
voidshadowSamplesChanged ( Number samples )
voidshowPreviewChanged ( Boolean onoff )
voidstartTimeChanged ( DzTime time )
voiduseGLSLChanged ( Boolean onOff )
voiduseMotionBlurChanged ( Boolean onOff )
voidxFilterWidthChanged ( Number width )
voidxPixelSamplesChanged ( Number samples )
voidyFilterWidthChanged ( Number width )
voidyPixelSamplesChanged ( Number samples )

Detailed Description

The RenderOptions class is responsible for the inclusion/exclusion of certain aspects of a render.

Enumerations


: GammaCorrection

States for gamma correction.

  • GCOff - Gamma correction off.
  • GCOn - Gamma correction on.

—–

: PixelFilter

The types of pixel filters available for RenderMan renders.

  • Box - The Box filter.
  • Triangle - The triangle filter.
  • CatmullRom - The Catmull-Rom filter.
  • Gaussian - The Gaussian filter.
  • Sinc - The Sinc filter.

—–

: RenderImgTarget

Types of Render Destinations

  • ActiveView - Renders the image in the active viewport.
  • NewWindow - Renders the image in a new window.
  • DirectToFile - Renders the image directly to a file.

—–

: RenderMovTarget

The Types of Movies that can be rendered

  • MovieFile - A video file created/compressed by system specific video API's.
  • ImageSeries - A series of image files, one for each frame in the movie.

—–

: RenderStyle

The style of the render

  • Normal - The shaders/materials for the objects will be used to render.
  • Cartoon - The entire scene will be rendered with a cartoon style shader.

—–

: RenderType

Types of Render Operations

  • ScreenShot - Performs a 'viewport' render, grabbing a frame from the interactive viewport. See Also: DzDrawStyle
  • HardwareAssisted - Performs a 'multi-pass' OpenGL render to produce a higher quality image.
  • Software - Performs an 'offline' render with the active software renderer. See Also: DzRenderer

Properties


Number : aspect

Holds the currently set aspect ratio (w / h). (Read Only)


Number : aspectHeight

Holds the currently set aspect ratio height. (Read Only)


Number : aspectWidth

Holds the currently set aspect ratio width. (Read Only)


Boolean : doubleSided

Holds whether or not to render polygons as double sided.


DzTime : endTime

Holds the scene time of the last frame to render.


Number : gain

Holds the gain value.


Number : gamma

Holds the gamma value.


GammaCorrection : gammaCorrection

Holds whether or not gamma correction is enabled.


Size : imageSize

Holds the size of the image to render.


Boolean : isAspectConstrained

Holds whether or not to constrain the pixel dimensions of the render to the aspect ratio.


Boolean : isCurrentFrameRender

Holds whether or not to render only the current frame.


String : lastRenderImgFilename

Holds the filename of the last image rendered. (Read Only)


String : lastRenderMovFilename

Holds the filename of the last movie rendered. (Read Only)


String : lastRenderSerFilename

Holds the base filename of the image series rendered. (Read Only)


Number : motionBlurOffset

Holds the time offset for blurring.


Number : motionBlurPct

Holds the amount of time between frames to blur across (0.0 - 1.0).


Number : motionBlurSamples

Holds the number of samples for motion blur.


Number : openGLPasses

Holds the number of passes for rendering in OpenGL.


PixelFilter : pixelFilter

Holds the pixel filter to use.


Number : rayTraceDepth

Holds the raytrace depth.


String : renderImgFilename

Holds the filename to save individual images to.


RenderImgTarget : renderImgToId

Holds the target for rendering individual images.


String : renderMovFilename

Holds the filename to save movies to.


RenderMovTarget : renderMovToId

Holds the target for rendering animations.


String : renderSerFilename

Holds the base filename to use when saving image series.


RenderStyle : renderStyle

Holds the style of the render.


RenderType : renderType

Holds the type of the render.


Boolean : renderViewport

Holds whether or not to use the aspect and size of the current viewport for the render.


Number : shadingRate

Holds the shading rate.


Number : shadowSamples

Holds the number of samples when rendering shadows.


Boolean : showPreview

Holds whether or not to show a preview.


DzTime : startTime

Holds the scene time of the first frame to render.


Boolean : useGLSL

Holds whether or not to use shaders when rendering in OpenGL.


Boolean : useMotionBlur

Holds whether or not to use motion blur.


Number : xFilterWidth

Holds the width of the pixel filter in x.


Number : xPixelSamples

Holds the number of samples per pixel in x.


Number : yFilterWidth

Holds the width of the pixel filter in y.


Number : yPixelSamples

Holds the number of samples per pixel in y.

Constructors


DzRenderOptions()

Default Constructor. Initializes render options.

Since:

  • 4.9.3.57

Methods


void : applyChanges()

Writes render options via the settings manager.


void : copyFrom( DzRenderOptions opt )

Copies the settings from another render options object.

Since:

  • 4.9.3.57

DzFloatColor : gammaCorrectColor( DzFloatColor color )

Parameter(s):

  • color - The color to gamma correct.

Return Value:

  • If gamma correction is enabled, a linearized version of color. If gamma correction is off, color is returned unchanged.

void : resetOptions()

Sets values for render options found in the stored settings.


void : restoreDefaultSettings()

Restores the applications default settings and replaces the stored values.


void : setAspectRatio( Number widthRatio, Number heightRatio )

Set current aspect width for this render. Represented as widthRatio : heightRatio.


void : setToDefaults()

Sets all options to the default values, but does not affect values of stored/remembered settings. Also, no “changed” signals are emitted when calling this method.

Signals


void : aspectChanged( Number val )

Signature:“aspectChanged(double)”

Emitted when the aspect for the render has changed, or the viewport render status has changed.


void : aspectChanged( Number w, Number h )

Signature:“aspectChanged(float,float)”

Emitted when the aspect for the render has changed, or the viewport render status has changed.


void : aspectConstrainChanged( Boolean onOff )

Signature:“aspectConstrainChanged(bool)”

Emitted when the constrain aspect ratio setting has changed.


void : defaultsRestored()

Signature:“defaultsRestored()”

Emitted when the default options have been restored.


void : doubleSidedChanged( Boolean onOff )

Signature:“doubleSidedChanged(bool)”

Emitted when the double sided setting has changed.


void : endTimeChanged( DzTime time )

Signature:“endTimeChanged(DzTime)”

Emitted when the end time has changed.


void : gainChanged( Number gain )

Signature:“gainChanged(double)”

Emitted when the gain value has changed.


void : gammaChanged( Number gamma )

Signature:“gammaChanged(double)”

Emitted when the gamma value has changed.


void : gammaCorrectionChanged( DzRenderOptions::GammaCorrection gc )

Signature:“gammaCorrectionChanged(DzRenderOptions::GammaCorrection)”

Emitted when gamma correction state has changed.


void : imageSizeChanged( Size size )

Signature:“imageSizeChanged(const QSize&)”

Emitted when the image size has changed.


void : motionBlurOffsetChanged( Number offset )

Signature:“motionBlurOffsetChanged(double)”

Emitted when the motion blur offset has changed.


void : motionBlurPctChanged( Number pct )

Signature:“motionBlurPctChanged(int)”

Emitted when the motion blur percentage has changed.


void : motionBlurSamplesChanged( Number samples )

Signature:“motionBlurSamplesChanged(int)”

Emitted when the motion blur samples has changed.


void : openGLPassesChanged( Number passes )

Signature:“openGLPassesChanged(int)”

Emitted when the number of OpenGL passes has changed.


void : pixelFilterChanged( DzRenderOptions::PixelFilter filter )

Signature:“pixelFilterChanged(DzRenderOptions::PixelFilter)”

Emitted when the pixel filter has changed.


void : rayTraceDepthChanged( Number depth )

Signature:“rayTraceDepthChanged(int)”

Emitted when the ray trace depth has changed.


void : renderCurrentFrameChanged( Boolean onOff )

Signature:“renderCurrentFrameChanged(bool)”

Emitted when the render current frame setting has changed.


void : renderImgFilenameChanged( String filename )

Signature:“renderImgFilenameChanged(const QString&)”

Emitted when the image filename for the render has changed.


void : renderImgTargetChanged( DzRenderOptions::RenderImgTarget id )

Signature:“renderImgTargetChanged(DzRenderOptions::RenderImgTarget)”

Emitted when the image target type for the render has changed.


void : renderMovFilenameChanged( String filename )

Signature:“renderMovFilenameChanged(const QString&)”

Emitted when the movie filename for the render has changed.


void : renderMovTargetChanged( DzRenderOptions::RenderMovTarget id )

Signature:“renderMovTargetChanged(DzRenderOptions::RenderMovTarget)”

Emitted when the movie target type for the render has changed.


void : renderSerFilenameChanged( String filename )

Signature:“renderSerFilenameChanged(const QString&)”

Emitted when the image series filename for the render has changed.


void : renderStyleChanged( DzRenderOptions::RenderStyle style )

Signature:“renderStyleChanged(DzRenderOptions::RenderStyle)”

Emitted when the render type has changed.


void : renderTypeChanged( DzRenderOptions::RenderType type )

Signature:“renderTypeChanged(DzRenderOptions::RenderType)”

Emitted when the render type has changed.


void : renderViewportChanged( Boolean onOff )

Signature:“renderViewportChanged(bool)”

Emitted when the render to viewport setting has changed.


void : settingsChanged()

Signature:“settingsChanged()”

Emitted when any of the settings has changed.


void : shadingRateChanged( Number rate )

Signature:“shadingRateChanged(double)”

Emitted when the shading rate has changed.


void : shadowSamplesChanged( Number samples )

Signature:“shadowSamplesChanged(int)”

Emitted when the number of shadow samples has changed.


void : showPreviewChanged( Boolean onoff )

Signature:“showPreviewChanged(bool)”

Emitted when the show preview setting has changed.


void : startTimeChanged( DzTime time )

Signature:“startTimeChanged(DzTime)”

Emitted when the start time has changed.


void : useGLSLChanged( Boolean onOff )

Signature:“useGLSLChanged(bool)”

Emitted when the use GLSL setting has changed.


void : useMotionBlurChanged( Boolean onOff )

Signature:“useMotionBlurChanged(bool)”

Emitted when the motion blur setting has changed.


void : xFilterWidthChanged( Number width )

Signature:“xFilterWidthChanged(double)”

Emitted when the X-axis filter width has changed.


void : xPixelSamplesChanged( Number samples )

Signature:“xPixelSamplesChanged(int)”

Emitted when the number of X-axis pixel samples has changed.


void : yFilterWidthChanged( Number width )

Signature:“yFilterWidthChanged(double)”

Emitted when the Y-axis filter width has changed.


void : yPixelSamplesChanged( Number samples )

Signature:“yPixelSamplesChanged(int)”

Emitted when the number of Y-axis pixel samples has changed.