< Previous | Contents | Manuals Home | Boris FX | Next >

Special Shot Routines

BeginShotChanges(sht) Use this version to begin an undo block that will modify the

settings of a shot, or its image preprocessor settings.

BeginStereoChanges(lsht, rsht) BeginShotChanges for stereo.

AcceptShotChanges(sht, titl) Wrap up changes to a shot or its image preprocessor

settings. Builtin redraw and reloadall.

AcceptStereoChanges(lsht, rsht, titl) Wrap up changes to a stereo shot. . Builtin redraw and reloadall.


PreValidate(sht) Creates an undo entry that will cause a shot's RAM cache

to be revalidated after an undo. Active ingredient in BeginShotChanges and BeginStereoChanges.

PostValidate(sht) Creates an undo entry that will cause a shot's RAM cache

to be revalidated after a redo, and validates the cache immediately. Active ingredient in AcceptShotChanges and Accept StereoChanges.

Validate(sht) Validates all frames in the RAM cache for this shot immediately, making sure they correspond to the current image preprocessor settings, and flushing them if not.

FlushShot(sht) Unconditional flush of all images in the RAM cache for this shot

SetShotAspect(sht, asp) Change the aspect ratio of a shot and update related

items. If you do this, you must also include a ShotAspectChanging call in the same undo block. Do not use shot.Set("aspect", 3.14159) to change the aspect of a shot!

ShotAspectChanging(sht, original_asp) Use this at the end of an undo block that

has included SetShotAspect. It must be given the original

aspect ratio, in order to adjust the splines correctly

ShotSingleImageName(sht, frm) Retrieve the full path name of the image for a specific

frame in an image sequence. Returns the empty string "" if the frame number is bad or the shot is a movie.

ApplyToTrackers(sht, mod) Apply image preprocessor effect to tracker positions, see

the Output tab in the image preprocessor and Shot.AdjustTrackers() in the Sizzle manual.

RenderShot(shot) Renders the shot (given by a SyObj), producing an image sequence or movie.


©2023 Boris FX, Inc. — UNOFFICIAL — Converted from original PDF.