Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Corona Rendering Core

Most render settings can be set using the Maxscript. You can list the settings usingshow renderers.current command. They are also listed here: Render Settings. 

...

Statistic IDMeaning
0Number of elapsed passes
1Number of primitives in the scene, not counting instances
2Number of primitives in the scene with instancing
3Average number of rays processed per second
4Average number of rays processed for each image sample
5Total render time in milliseconds
6Total time spent in the rendering phase (in milliseconds). This time is used for deciding when to stop progressive rendering with a time limit set.
7Estimated noise amount in the picture, in percents. Returns 0 if no estimate is available.
8Estimated remaining rendering time (in milliseconds). Returns 0 if no estimate is available.
9Memory currently allocated by Corona.
10Peak memory allocated by Corona during the last rendering.
11Virtual memory currently used by the process.
12Peak virtual memory currently used by the process.
13Virtual memory used by the system.
14Scene parsing time in ms.
15Displacement primitives.

Corona Proxy API

To invoke a method on proxy object [proxy], use CProxy.ProxyFp.[method_name] [proxy] [optional further args]

FunctionParametersdescription
getOriginalObjectName<node>proxyReturns string containing the name of the original object from which the proxy was created.
getOriginalMaterialName<node>proxyReturns string containing the name of material of the original object from which the proxy was created.
fromScene<node>proxy <node>source <filename>filenameCreates a proxy from scene object source, and saves it to file specified by filename
fromSceneAnimated<node>proxy <node>source <filename>filename <integer>frameFrom <integer>frameTo <integer>pointCloudSize <integer>samplesPerFrameSame as the other fromScene, but allows to specify additional parameters - animation range (frameFrom - frameTo), size of viewport display point cloud to precompute and store in the file, and number of motion blur samples to take
duplicateToMesh<node>proxyCreates a 3ds Max Editable Mesh from the proxy (does not delete the proxy). Same as clicking the Duplicate to mesh button in the UI.


Corona Material Library API

There are several published functions that can be invoked using the CoronaMaterialLibrary.MaterialLibraryFp interface. You can list them by executing showInterface CoronaMaterialLibrary.MaterialLibraryFp.

FunctionParametersdescription
isInstalled
Returns TRUE if the library is currently installed. Returns FALSE otherwise (user de-selected it during Corona installation).
showBrowserIfPossible<boolean>showDisplays or hides the browser window for the library, if possible. Returns 0 if it has succeeded, non-zero if it has failed.


Corona Scatter API

Valid until version 8 in which Corona Scatter has been replaced with more advanced Chaos Scatter with its own API.

...

FunctionParametersdescription
getVersionNumber
Returns current plugin version encoded as a single comparable 64-bit integer version number. Version numbers returned in earlier builds are always lower than those returned in later builds.
getVersionString
Returns current plugin version formatted as a human-readable string. It is suitable to be presented to the user.


Example scripts

CoronaRenderer.CoronaFp.showvfb true

...

- converts my_proxy back to mesh.


Corona 8 New Tone Mapping Pipeline Examples

Getting last operator:

getProperty renderers.current "colorMap.pipeline"

...

Main paramblock (renderers.current):
T_BOOL, PARAM_COLORMAP_ENABLED, "colorMap.enabled"
T_FLOAT, PARAM_COLORMAP_GAMMA, "colorMap.gamma"
TYPE_REFTARG, PARAM_COLORMAP_PIPELINE, "colorMap.pipeline"

ACES
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_ACES_OT_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_ACES_OT_OP_OPACITY, TYPE_FLOAT, _T("colorMappingOperator.opacity"),

CONTRAST
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_CONTRAST_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_CONTRAST_OP_CONTRAST, TYPE_FLOAT, _T("colorMappingOperator.contrast"),

CURVES
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_CURVES_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_CURVES_OP_MASTER_NODES, TYPE_POINT3_TAB, _T("colorMappingOperator.master.nodes"),
PARAM_CURVES_OP_MASTER_INTERPOL, TYPE_INT, _T("colorMappingOperator.master.interpol"),
PARAM_CURVES_OP_RED_NODES, TYPE_POINT3_TAB, _T("colorMappingOperator.r.nodes"),
PARAM_CURVES_OP_RED_INTERPOL, TYPE_INT, _T("colorMappingOperator.r.interpol"),
PARAM_CURVES_OP_GREEN_NODES, TYPE_POINT3_TAB, _T("colorMappingOperator.g.nodes"),
PARAM_CURVES_OP_GREEN_INTERPOL, TYPE_INT, _T("colorMappingOperator.g.interpol"),
PARAM_CURVES_OP_BLUE_NODES, TYPE_POINT3_TAB, _T("colorMappingOperator.b.nodes"),
PARAM_CURVES_OP_BLUE_INTERPOL, TYPE_INT, _T("colorMappingOperator.b.interpol"),

FILMIC
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_FILMIC_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_FILMIC_OP_HIGHLIGHTS_COMPRESSION, TYPE_FLOAT, _T("colorMappingOperator.highlightCompression"),
PARAM_FILMIC_OP_RICH_SHADOWS, TYPE_FLOAT, _T("colorMappingOperator.richShadows"),

ADV FILMIC
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_FILMIC_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_ADVANCED_FILMIC_OP_TOE_STRENGTH, TYPE_FLOAT, _T("colorMappingOperator.toeStrength"),
PARAM_ADVANCED_FILMIC_OP_TOE_LENGTH, TYPE_FLOAT, _T("colorMappingOperator.toeLength"),
PARAM_ADVANCED_FILMIC_OP_SHOULDER_STRENGTH, TYPE_FLOAT, _T("colorMappingOperator.shoulderStrength"),
PARAM_ADVANCED_FILMIC_OP_SHOULDER_LENGTH, TYPE_FLOAT, _T("colorMappingOperator.shoulderLength"),
PARAM_ADVANCED_FILMIC_OP_SHOULDER_ANGLE, TYPE_FLOAT, _T("colorMappingOperator.shoulderAngle"),

GM TINT
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_GMTINT_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_GMTINT_OP_GREEN_MAGENTA_TINT, TYPE_FLOAT, _T("colorMappingOperator.greenMagentaTint"),

LUT
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_LUT_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_LUT_OP_PATH, TYPE_FILENAME, _T("colorMappingOperator.path"),
PARAM_LUT_OP_OPACITY, TYPE_FLOAT, _T("colorMappingOperator.opacity"),
PARAM_LUT_OP_LOGARITHMIC, TYPE_BOOL, _T("colorMappingOperator.logarithmic"),

PHOTOGRAPHIC EXPOSURE
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_EXPOSURE_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),

REINHARD
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_REINHARD_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_REINHARD_OP_HIGHLIGHT_COMPRESSION, TYPE_FLOAT, _T("colorMappingOperator.highlightCompression"),

SATURATION
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_SATURATION_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_SATURATION_OP_SATURATION, TYPE_FLOAT, _T("colorMappingOperator.saturation"),

SIMPLE EXPOSURE
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_EXPOSURE_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_EXPOSURE_OP_SIMPLE_EXPOSURE, TYPE_FLOAT,_T("colorMappingOperator.simpleExposure"),

TINT
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_TINT_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_TINT_OP_TINT, TYPE_RGBA, _T("colorMappingOperator.tint"),

TONE CURVE
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_TONE_CURVE_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_TONE_CURVE_OP_HIGHLIGHTS, TYPE_FLOAT, _T("colorMappingOperator.highlights"),
PARAM_TONE_CURVE_OP_LIGHTS, TYPE_FLOAT, _T("colorMappingOperator.lights"),
PARAM_TONE_CURVE_OP_DARKS, TYPE_FLOAT, _T("colorMappingOperator.darks"),
PARAM_TONE_CURVE_OP_SHADOWS, TYPE_FLOAT, _T("colorMappingOperator.shadows"),

VIGNETTE
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_VIGNETTE_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_VIGNETTE_OP_INTENSITY, TYPE_FLOAT, _T("colorMappingOperator.intensity"),
PARAM_VIGNETTE_OP_FALLOFF, TYPE_FLOAT, _T("colorMappingOperator.falloff"),

WHITE BALANCE
PARAM_COLOR_MAP_PREDECESSOR, TYPE_REFTARG, _T("colorMappingOperator.nextOperator"),
PARAM_WHITE_BALANCE_OP_ENABLED, TYPE_BOOL, _T("colorMappingOperator.enabled"),
PARAM_WHITE_BALANCE_OP_COLOR_TEMPERATURE, TYPE_FLOAT, _T("colorMappingOperator.colorTemperature"),


Chaos Scatter MAXScript API

There are several published methods callable for every Chaos Scatter object. You can list them all by executing showInterface ChaosScatter.FpInterface (check out MAXScript Listener output).

...