RenderSettings Class

Initialize a new instance of the RenderSettings class.

Initialize new instance of the RenderSettings class.

Gets or sets the ambient light color used in rendering.

Gets or sets anti-alias level, used for render quality

Gets or sets the background bottom color used in rendering.

Gets or sets the background top color used in rendering.

Sets also the background color if a solid background color is set.

How the viewport's background should be filled.

Gets or sets a value indicating whether to render using depth cues.

These are clues to help the perception of position and orientation of objects in the image.

Indicates if this object has been disposed or the document it originally belonged to has been disposed.

If this object is associated with a document, this gets the document dithering. If this object is associated with a File3dm, this gets the File3dm's dithering. Otherwise it gets a 'free-floating' dithering object.

Gets or sets a value indicating whether to render using flat shading.

If this object is associated with a document, this gets the document ground plane. If this object is associated with a File3dm, this gets the File3dm's ground plane. Otherwise it gets a 'free-floating' ground plane object.

Gets true if this class has any custom information attached to it through UserData.

Number of dots/inch (dots=pixels) to use when printing and saving bitmaps. The default is 72.0 dots/inch.

Gets or sets a value indicating the size of the rendering result if UseViewportSize is set to false. If UseViewportSize is set to true, then this value is ignored.

unit system to use when converting image pixel size and DPI information into a print size. Default = inches

If true this object may not be modified. Any properties or functions that attempt to modify this object when it is set to "IsReadOnly" will throw a NotSupportedException.

Tests an object to see if it is valid.

If this object is associated with a document, this gets the document linear workflow. If this object is associated with a File3dm, this gets the File3dm's linear workflow. Otherwise it gets a 'free-floating' linear workflow object.

Get or set the given named view

If this object is associated with a document, this gets the document post effect data collection. If this object is associated with a File3dm, this gets the File3dm's post effect data collection. Otherwise it gets a 'free-floating' post effect data collection object.

Gets or sets a value indicating whether to instruct the rendering engine to show annotations, such as linear dimensions or angular dimensions.

Gets or sets a value indicating whether to render back faces.

If this object is associated with a document, this gets the document render channels. Otherwise it gets a 'free-floating' render channels object.

Gets or sets a value indicating whether to instruct the rendering engine to show curves.

Gets or sets a value indicating whether to instruct the rendering engine to show isocurves.

Gets or sets a value indicating whether to instruct the rendering engine to show mesh edges.

Gets or sets a value indicating whether to instruct the rendering engine to show points.

Gets or sets the render source RenderSettingsRenderingSources enumeration.

If this object is associated with a document, this gets the document safe-frame. If this object is associated with a File3dm, this gets the File3dm's safe-frame. Otherwise it gets a 'free-floating' safe-frame object.

Gets or sets a value indicating whether to scale the wallpaper in the background or not. This is meaningful only if the viewport has a wallpaper and render settings are set to render Wallpaper into the background.

0=none, 1=normal, 2=best.

If this object is associated with a document, this gets the document skylight. If this object is associated with a File3dm, this gets the File3dm's skylight. Otherwise it gets a 'free-floating' skylight object.

Set or get the given snapshot view

Set or get the given specific viewport

If this object is associated with a document, this gets the document sun. If this object is associated with a File3dm, this gets the File3dm's sun. Otherwise it gets a 'free-floating' sun object.

Gets or sets whether rendering should be done with transparent background.

Gets or sets a value indicating whether to render using lights that are on layers that are off.

List of custom information that is attached to this class.

Dictionary of custom information attached to this class. The dictionary is actually user data provided as an easy to use shareable set of information.

Gets or sets a value indicating whether to use the resolution of the viewport being rendered or ImageSize when rendering

Assigns a parent object and a sub-object index to this.

Actively reclaims unmanaged resources that this instance uses.

For derived class implementers.

This method is called with argument true when class user calls Dispose(), while with argument false when the Garbage Collector invokes the finalizer, or Finalize() method.

You must reclaim all used unmanaged resources in both cases, and can use this chance to call Dispose on disposable fields if the argument is true.

Also, you must call the base virtual method within your overriding method.

Makes a free-floating copy of the object.

If you want to keep a copy of this class around by holding onto it in a variable after a command completes, call EnsurePrivateCopy to make sure that this class is not tied to the document. You can call this function as many times as you want.

Determines whether the specified object is equal to the current object.

Passively reclaims unmanaged resources when the class user did not explicitly call Dispose().

Serves as the default hash function.

Populates a System.Runtime.Serialization.SerializationInfo with the data needed to serialize the target object.

Gets the Type of the current instance.

Determines if an object is valid. Also provides a report on errors if this object happens not to be valid.

Creates a shallow copy of the current Object.

For derived classes implementers.

Defines the necessary implementation to free the instance from being constant.

Is called when a non-constant operation first occurs.

Get the render environment for a particular usage. Only works if this render settings is in a document. If usage is Background and the background mode is set to 'Solid Color' or 'Gradient' (i.e., not 'Environment'), then null will be returned.

Get the id of the render environment for a particular usage. If usage is Background and the background mode is set to 'Solid Color' or 'Gradient' (i.e., not 'Environment'), then Guid.Empty will be returned.

For usage background, this checks if the background style is set to 'Environment'. For reflection and skylighting, it checks if the relevant custom override is enabled.

Set the render environment for a particular usage. Passing null for usage Skylighting or Reflection will turn the override for that usage off.

Set the id of the render environment for a particular usage. Passing Guid.Empty for usage Skylighting or Reflection will turn the override for that usage off.

Set the given environment override on/off. Only works for usage Reflection and Skylighting.

Create a JSON string representation of this object

Returns a string that represents the current object.