Working with Shots

Shots are a mechanism for capturing a camera position and adding optional cinematographic movements around it to create moving shots (like those used in car commercials). The Python Shot module contains a number of functions and useful helper classes for setting up shots and setting up the paths for a camera:

• Shot.BezierCameraPath
• Shot.CameraPath
• Shot.LinearCameraPath
• Shot.Lookcalculuator
• Shot.ShotHotkeyTarget
• Shot.ShotKeyframed
• Shot.ShotParametric
• Shot.ShotRecorded
• Shot.ShotStill
• Shot.ShotTransition

The following are some useful messages for creating and managing shots:

• SAVE_SHOT_AS_MOVIE_AT_RESOLUTION - Save a movie to the specified location from a specified shot.
• SHOT_CHANGE_TYPE - Changes the type of the shot to be newType carrying over as many common parameters as possible.
• SHOT_CREATE - Creates a named shot of the specified type with default parameters.
• SHOT_DELETE - Deletes the named shot.
• SHOT_EDIT - Opens the Shot Properties dialog for the named shot.
• SHOT_MOVE_TO_KEYFRAME - Moves the current view to the keyframe of the named shot.
• SHOT_PAUSE_PLAYBACK - Pauses playback of queued shots.
• SHOT_PLAY - Begins playback of a series of named shots.
• SHOT_PLAY_ALL - Begins playback of all the shots in the scene.
• SHOT_PLAY_BYLABEL - Allows a SHOT_PLAY message to be issued by specifying labels instead of names.
• SHOT_PLAY_SINGLE - Begins playback of a single named shot.
• SHOT_PLAY_SINGLE_BYLABEL - Allows a SHOT_PLAY_SINGLE message to be issued by specifying a label instead of a name.
• SHOT_POSITION_AFTER - Places the named shot after prevShotName in the shot list.
• SHOT_REFRESH_THUMBNAIL - Resnaps and saves the thumbnail image at the original snap location.
• SHOT_RENAME - Changes the label of an existing shot.
• SHOT_REQUEST_LIST - Requests that a new SHOT_LIST message be issued.
• SHOT_REQUEST_LOOP_MODE - Requests a SHOT_LOOP_MODE notification message.
• SHOT_RESUME_PLAYBACK - Resumes playback of queued shots after pause.
• SHOT_SAVE_THUMBNAIL - Saves a thumbnail image of a shot-parameter pair.
• SHOT_SET_LOOP_MODE - Sets the loop mode.
• SHOT_SET_PARAMETERS - Modifies the parameters of the named shot.
• SHOT_SHOW_STAGESHOTS - Shows shots based on the specified stage (compare scene view) ID.
• SHOT_START_PLAYING - Initiates the playback of the queued list of shots to play.
• SHOT_START_TRANSITION - Initiates a cinematic transition of the specified type for the specified duartion.
• SHOT_STOP_PLAYING - Stops the playback of shots.
• SHOT_UI_SET_MODE - Shows or hides the Shot user interface.
• SHOT_UPDATE_DIALOG_DATA - Updates the Shot Properties dialog with data from the named shot.