iprEngine

Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

iprEngine [-copy string] [-defineTemplate string] [-estimatedMemory] [-exists] [-iprImage string] [-motionVectorFile] [-object name] [-region int int int int] [-relatedFiles] [-releaseIprImage] [-resolution] [-scanlineIncrement string] [-showProgressBar boolean] [-startTuning] [-stopTuning] [-underPixel int int] [-update] [-updateDepthOfField] [-updateLightGlow boolean] [-updateMotionBlur boolean] [-updatePort string] [-updateShaderGlow boolean] [-updateShading boolean] [-updateShadowMaps] [-useTemplate string]

iprEngine is undoable, queryable, and editable.

Return value

In query mode, return type is based on queried flag.

Flags

Long name (short name)	Argument types	Properties
-exists(-ex)
Returns true|false depending upon whether the specified object exists. Other flags are ignored.
-defineTemplate(-dt)	string
Puts a command in a mode where any other flags and args are parsed and added to the command template specified in the argument. They will be used as default arguments in any subsequent invocations of the command when templateName is set as the current template.
-useTemplate(-ut)	string
Force the command to use a command template other than the current one.
-iprImage(-ipr)	string
Specify the ipr image to use.
-releaseIprImage(-rii)
The ipr image should be released and memory should be freed.
-object(-obj)	name
The objects to be tuned.
-region(-r)	int int int int
The coordinates of the region to be tuned. The integers are in the sequence left bottom right top or x1,y2 x2,y2
-resolution(-res)
The width and height of the ipr file.
-updatePort(-up)	string
The name of the port that is to be updated when pixel values are recomputed. (not currently supported)
-update(-u)
Force an update.
-updateShading(-us)	boolean
Automatically update shading.
-updateShaderGlow(-usg)	boolean
Automatically update when shader glow changes.
-updateLightGlow(-ulg)	boolean
Automatically update when light glow changes.
-updateMotionBlur(-umb)	boolean
Automatically update when 2.5D motion blur changes.
-updateDepthOfField(-udf)
Force a refresh of depth-of-field.
-updateShadowMaps(-usm)
Force the shadow maps to be generated and an update to occur.
-startTuning(-st)
An ipr image has been specified and now changes to shading networks should force an image to be produced.
-stopTuning(-spt)
Tuning should cease but ipr image should not be closed.
-underPixel(-un)	int int
Get list of objects under the pixel sprcified.
-scanlineIncrement(-sli)	string
Set the scanline increment percentage. If the height of the region being update is 240 pixels, and the scanlineIncrement is 10% then the image will refresh blocks of 24 scanlines.
-estimatedMemory(-mem)
Displays the estimated memory being used by IPR.
-motionVectorFile(-mvf)
Returns the name of the motion vector file used by IPR.
-showProgressBar(-spb)	boolean
Show progress bar during tuning.
-relatedFiles(-rel)
Returns the names for the related files, e.g, the non-glow-non-blur image, the motion vector file, and the depth-map files.
-copy(-cp)	string
Copies the deep raster file, as well as its related files, to the new location.

Flag can appear in Create mode of command	Flag can appear in Edit mode of command
Flag can appear in Query mode of command	Flag can be used more than once in a command.

MEL examples

// Create a iprEngine and tell it about an already created ipr image.
iprEngine -ipr "iprImages/persp_scene1_ipr.iff"

// Tell the iprEngine about the region to update.
iprEngine -e -region 10 10 100 100 iprEngine1;

// Tell the iprEngine to watch changes and update pixels.
iprEngine -e -startTuning iprEngine1;