Interfaces > Core Interfaces > NitrousGraphicsManager |
NEW in 3ds Max 2012: This Core Interface exposes the Nitrous Graphics Manager to MAXScript.
Returns true if the Nitrous Graphics system is enabled, false otherwise.
Starts collecting performance profiling data. For internal use only.
Ends collecting performance profiling data. For internal use only.
Writes the current Nitrous Graphics system memory usage to a default file in the root of the 3ds Max installation.
Writes the current Nitrous Graphics system memory usage to the log file specified by the second argument. The first argument is the name of the 3ds Max scene.
Creates a number of dummy objects in memory using the class name provided as first argument and the count provided as second argument.
Returns a <IObject:ViewportViewSettingImpl> object which exposes the settings of the active viewport. See below for details.
Returns a <IObject:ViewportViewSettingImpl> object which exposes the settings of the specified indexed viewport. See below for details.
Viewport Settings IObject Interfaces:
This interface exposes the viewport settings as seen in the "Visual Style & Appearance" tab of the "Viewport Configuration" dialog. In addition, it provides scripted access to the parameters of the Non-Photorealistic Rendering styles which are not exposed to the User Interface of 3ds Max 2012.
Visual Style group of controls
<ViewportViewSettingImpl>.VisualStyleMode : enum : Read|Write VisualStyleMode enums: { #Realistic | #Shaded | #Facets | #ConsistentColors | #HiddenLine | #Wireframe | #BoundingBox | #Ink | #ColorInk | #Acrylic | #Tech | #Graphite | #ColorPencil | #Pastel }
Get/set the Viewport's Visual Style, including realistic, shaded and non-photorealistic modes. The property can be set as enum name or integer value. When getting, it will return the enum name.
Numeric Value | Enum Name | |
---|---|---|
0 | #Realistic |
![]() |
1 | #Shaded |
![]() |
2 | #Facets |
![]() |
3 | #ConsistentColors |
![]() |
4 | #HiddenLine |
![]() |
5 | #Wireframe |
![]() |
6 | #BoundingBox |
![]() |
7 | #Ink |
![]() |
8 | #ColorInk |
![]() |
9 | #Acrylic |
![]() |
10 | #Tech |
![]() |
11 | #Graphite |
![]() |
12 | #ColorPencil |
![]() |
13 | #Pastel |
![]() |
Get/set the state of the "Edged Faces" viewport option.
When set to false (default), no edged faces will be displayed.
When set to true, a wireframe representation of the geometry faces will be overlayed on top of shaded faces.
Get/set the state of the "Textures" viewport option.
When set to true (default), texture maps will be displayed in the viewports if enabled at material or map level.
When set to false, texture maps will never be shown regardless of the Show Map In Viewport settings.
Get/set the state of the "Transparency" viewport option.
When set to true (default), transparency will be displayed in the viewports.
When set to false, transparency will be ignored and all objects will be displayed using solid shading.
Get/set the state of the "Use Environment Background Color" viewport option.
When set to false (default), the viewport background color will be taken from the corresponding value in the Customize User Interface > Color tab dialog.
When set to true, the viewport background color will be taken from the Environment Background color found in the "Environment and Effects" dialog > "Environment" tab > "Common Parameters" rollout > "Background" group of controls.
Get/set the state of the "Selection Brackets" option.
When set to true (default), selected objects will show selection brackets in shaded mode to denote their selected state.
When set to false, selected objects will not show selection brackets - you could enable the .SelectedEdgeFacesEnabled mode to visualize the selected state.
Get/set the state of the "Display Selected With Edged Faces" option.
When set to true, selected objects will be displayed with edged faces if the scene is set to shaded mode.
When set to false (default), all objects will be displayed in the current style.
Get/set the state of the "Shade Selected Faces" option.
When set to true (default), selected faces in sub-object level will be shaded in a solid color.
When set to false, selected faces will be highlighted using colored edges.
Get/set the state of the "Shade Selected Objects" option.
When set to true, selected objects will be displayed in shaded mode even if the scene is set to wireframe mode.
When set to false (default), all objects will be displayed in the current style.
Get/set the state of the "Disable" option.
When set to false (default), the viewport will be enabled and will redraw as needed.
When set to true, the viewport will be disabled and will only redraw when manually enforced.
<ViewportViewSettingImpl>.LightOption : enum : Read|Write LightOption enums: { #DefaultLight | #SceneLight }
Get/set the state of the "Lighting" > "Illuminate With..." radio buttons.
#DefaultLight - illuminates the scene with one or two default lights according to the .DefaultLightMode property.
#SceneLight - illuminates using the scene lights, unless there are no scene lights in which case the illumination will fall back to the default lighting.
<ViewportViewSettingImpl>.DefaultLightMode : enum : Read|Write DefaultLightMode enums: { #OneLight | #TwoLights }
Get/set the state of the "Default Lights" radio buttons.
#OneLight - illuminates the scene with one "headlight" placed behind the camera.
#TwoLights - illuminates the scene with two fixed lights.
Get/set the state of the "Highlights" option.
When set to true (default), specular highlights will be calculated in the viewports.
Get/set the state of the "Ambient Occlusion" option.
When set to false (default), no ambient occlusion will be calculated.
When set to true, a screen-space ambient occlusion effect will be calculated using the settings described below:
Get/set the "Ambient Occlusion" > "Radius" value.
Get/set the "Ambient Occlusion" > "Intensity/Fade" value.
Get/set the state of the "Shadows" option.
When set to false (default), no shadows will be displayed in the viewports.
When set to true, lights with shadow casting enabled will also show shadows in the viewport using the quality settings described below:
<ViewportViewSettingImpl>.ShadowMode : enum : Read|Write ShadowMode enums: { #HardShadow | #SoftShadow | #LightSettingShadow }
Get/set the Shadows Style - Hard Shadows, Soft Shadows or the Shadow type defined by the light source itself.
Get/set the value of the "Shadows" > "Intensity/Fade" option.Prints information about the NPR mode to the Listener including Parameter Name, Type, Value and Range. Returns OK.
Returns a string value containing information about the NPR mode including Parameter Name, Type, Value and Range. Similar to ShowNPRParameters(), but returns the info as a string value instead of printing to the Listener.
Returns the number of parameters in the current NPR mode.
Returns the name of the indexed parameter. The index is zero-based. If the index is out of range, the value of "No Parameter" is returned.
<enum><ViewportViewSettingImpl>.GetNPRParameterType <integer>index GetNPRParameterType enums: { #Unknown | #Bool | #Int | #Float | #Float4 | #String }
Returns the type of the indexed parameter. The index is zero-based. If the index is out of range, the value of #Unknown is returned.
Returns the value of the named boolean parameter of the current NPR mode.
Sets the value of the named boolean parameter of the current NPR mode to the boolean value passed as second argument.
Returns the value of the named integer parameter of the current NPR mode.
Returns the minimum value of the named integer parameter of the current NPR mode.
Returns the maximum value of the named integer parameter of the current NPR mode.
Sets the value of the named integer parameter of the current NPR mode to the integer value passed as second argument.
Returns the value of the named float parameter of the current NPR mode.
Returns the minimum value of the named float parameter of the current NPR mode.
Returns the maximum value of the named float parameter of the current NPR mode.
Sets the value of the named float parameter of the current NPR mode to the float value passed as second argument.
Returns the value of the named float4 parameter of the current NPR mode.
Returns the minimum value of the named float4 parameter of the current NPR mode.
Returns the maximum value of the named float4 parameter of the current NPR mode.
Sets the value of the named float4 parameter of the current NPR mode to the Point4 value passed as second argument.
The following scripted dialog exposes all parameters of the current Viewport Style Mode (if any) in a dynamic rollout for interactive tweaking. It also supports the NPR settings of the Quicksilver renderer and allows you to set the viewport and the renderer at the same time, thus giving an instant preview of the Quicksilver settings in the active viewport: