Animation Options¶

This method modifies the AVIOptions object.

Parameters:¶

compressionMethod=RLE8¶

A SymbolicConstant specifying the compression method for the AVI format. Possible values are:

• RAW8, specifying an uncompressed format of 8 bits per pixel.

• RAW32, specifying an uncompressed format of 32 bits per pixel.

• RLE8, specifying a run length encoded format of 8 bits per pixel.

• CODEC, specifying a format defined by CODEC (encoder/decoder). The availability of theCODEC is system dependent

The default value is RLE8.

compressionQuality=None¶

An Int specifying the quality of the compression as a percentage when the compressionMethod is set to CODEC.

codecOptions=''¶

A String specifying the system specific options defining the CODEC when the compressionMethod is set to CODEC.

sizeDefinition=SIZE_ON_SCREEN¶

A SymbolicConstant specifying how the width and height of the image are specified. Possible values are SIZE_ON_SCREEN and USER_DEFINED. The default value is SIZE_ON_SCREEN.

imageSize=None¶

A pair of Ints specifying the width and height of the image in pixels when sizeDefinition = USER_DEFINED. Possible values are Ints in the range (minWidth, minHeight) ≤ (width, height) ≤ (maxWidth, maxHeight). The default value is the screen size. Note:The values of the minimum width (minWidth) and height (minHeight) depend on the following:viewport font size,whether decorations are printed,decoration size, andscreen resolution.The minimum width and height are normally < 50 pixels. The values of the maximum width (maxWidth) and height (maxHeight) depend on the graphics capabilities of the system. The maximum width and height will be at least as large as the screen dimensions.

This method decrements the animation frame.

This method increments the animation frame.

This method begins the animation.

Parameters:¶

duration=UNLIMITED¶

The SymbolicConstant UNLIMITED or an Int specifying how many seconds to play the animation. The default value is UNLIMITED.

Raises:¶

AnimationError – animationType not set, If animationType = NONE:

This method modifies the AnimationController object.

Parameters:¶

animationType=NONE¶

A SymbolicConstant specifying the type of movie to play. Possible values are SCALE_FACTOR, HARMONIC, TIME_HISTORY, and NONE. The default value is NONE.

Raises:¶

RangeError –

This method renders the first frame of the animation.

This method renders the specified frame of the animation.

Parameters:¶

frame=None¶

An Int specifying the frame number.

value=None¶

A Float specifying the frame: for animationType = TIME_HISTORY the frame with the time nearest to this value, for animationType = HARMONIC the frame with the angle nearest to this value, for animationType = SCALE_FACTOR the frame with the scale value nearest to this value.

This method renders the last frame of the animation.

This method stops the animation.

This method modifies the AnimationOptions object.

Parameters:¶

mode=LOOP¶

A SymbolicConstant specifying the animation mode. Possible values are PLAY_ONCE, LOOP, LOOP_BACKWARD, and SWING. The default value is LOOP.

frameRate=50¶

An Int specifying the animation rate in frames/second. Possible values are 1 ≤ frameRate ≤ 100. The default value is 50.

frameCounter=1¶

A Boolean specifying whether to show the frame counter. The default value is ON.

relativeScaling=HALF_CYCLE¶

A SymbolicConstant specifying the relative scaling when the AnimationController object’s animationType = SCALE_FACTOR or HARMONIC. Possible values are FULL_CYCLE and HALF_CYCLE. The default value is HALF_CYCLE.

numScaleFactorFrames=7¶

An Int specifying the number of frames to be used when the AnimationController object’s animationType = SCALE_FACTOR or HARMONIC. The default value is 7.

timeHistoryMode=FRAME_BASED¶

A SymbolicConstant specifying whether the time history animation is time based or frame based. Possible values are FRAME_BASED and TIME_BASED. The default value is FRAME_BASED.

maxTime=None¶

A Float specifying the maximum time for time based time history animation when maxTimeAutoCompute = False.

maxTimeAutoCompute=1¶

A Boolean specifying whether the animation maximum time value should be computed from the active frames when timeHistoryMode is set to TIME_BASED. The default value is ON.

minTime=None¶

A Float specifying the minimum time for time based time history animation when minTimeAutoCompute = False.

minTimeAutoCompute=1¶

A Boolean specifying whether the animation minimum time value should be computed from the active frames when timeHistoryMode is set to TIME_BASED. The default value is ON.

timeIncrement=None¶

A Float specifying the time increment for frame selection when timeHistoryMode is set to TIME_BASED.

xyUseHighlightMethod=1¶

A Boolean specifying whether to use the highlight method to draw the time tracker line and symbols. The default value is ON.

xyShowLine=1¶

A Boolean specifying whether to show the time tracker line. The default value is ON.

xyLineStyle=SOLID¶

A SymbolicConstant specifying the X - Y time tracker line style. Possible values are SOLID, DASHED, DOTTED, and DOT_DASH. The default value is SOLID.

xyLineThickness=MEDIUM¶

A SymbolicConstant specifying the X - Y time tracker line thickness. Possible values are VERY_THIN, THIN, MEDIUM, and THICK. The default value is MEDIUM.

xyLineColor=''¶

A String specifying the color used to plot the X - Y time tracker line when xyUseHighlightMethod = False. The default value is “Yellow”.

xyShowSymbol=1¶

A Boolean specifying whether to show the time tracker symbols. The default value is ON.

xySymbolMarker=DEFAULT¶

A SymbolicConstant specifying the marker type to be used for all animation capable X - Y curve or the SymbolicConstant DEFAULT specifying that the system will take the marker associated to each curve Possible values are:

• FILLED_CIRCLE

• FILLED_SQUARE

• FILLED_DIAMOND

• FILLED_TRI

• HOLLOW_CIRCLE

• HOLLOW_SQUARE

• HOLLOW_DIAMOND

• HOLLOW_TRI

• CROSS

• XMARKER

• DEFAULT

The default value is DEFAULT.

xySymbolSize=MEDIUM¶

A SymbolicConstant specifying the size of the markers. Possible values are SMALL, MEDIUM, and LARGE. The default value is MEDIUM.

xySymbolColor=''¶

A String specifying the color used to plot X - Y time tracker symbols when xyUseHighlightMethod = False. When setting the color to ‘Default’ the system will take the color associated to each curve. The default value is “Default”.

This method creates a Movie object from the contents of the specified file.

session.Movie

Parameters:¶

name¶

A String specifying the repository name for the movie.

fileName¶

A String specifying the file from which the movie is to be read. The file extension must be specified and indicates the movie format (.avi, .mov, .mpeg, or .wmv).

startFrame=0¶

An Int specifying the first frame to be displayed from this movie. The default value is 0.

endFrame=None¶

An Int specifying the last frame to be displayed from this movie. A negative number will indicate reverse numbering: -1 is the last frame of the movie. The default value is −1.

timelineStartFrame=0¶

An Int specifying the global timeline frame number that corresponds to startFrame. A value of 0 will indicate the first frame to be displayed in the viewport. The default value is 0.

timelineEndFrame=None¶

An Int specifying the global timeline frame number that corresponds to endFrame. A negative number will indicate reverse numbering: -1 indicates the last frame to be displayed in the viewport. The default value is −1.

timelineStartTime=0¶

A Float specifying the global timeline time that corresponds to the time of startFrame. The default value is 0.0.

timelineEndTime=END_FRAME_TIME¶

The SymbolicConstant END_FRAME_TIME or a Float specifying the global timeline time that corresponds to the time of endFrame. The SymbolicConstant END_FRAME_TIME indicates the time in this movie corresponding to endFrame. The default value is END_FRAME_TIME.

Returns:¶

A Movie object.

Return type:¶

Movie

Raises:¶

• ValueError – Unable to open movie file, If fileName does not exist or can not be read.

• ValueError – Unsupported movie format, If fileName references an unsupported movie file format

• ValueError – Unable to decode movie file, If the contents of fileName are corrupt or can not be decoded.

This method writes the animations present in the list of canvas objects to a file. It generates an animation file using the given file name and file format and uses the values in the appropriate options object.

Parameters:¶

fileName¶

A String specifying the name of the animation file to generate.

format¶

A SymbolicConstant specifying the format of the generated file. Possible values are AVI, QUICKTIME, VRML, and COMPRESSED_VRML.

canvasObjects=()¶

A sequence specifying the canvas objects to capture. The default behavior is to capture all canvas objects.

This method modifies the Movie object.

Parameters:¶

startFrame=0¶

An Int specifying the first frame to be displayed from this movie. The default value is 0.

endFrame=None¶

An Int specifying the last frame to be displayed from this movie. A negative number will indicate reverse numbering: -1 is the last frame of the movie. The default value is −1.

timelineStartFrame=0¶

An Int specifying the global timeline frame number that corresponds to startFrame. A value of 0 will indicate the first frame to be displayed in the viewport. The default value is 0.

timelineEndFrame=None¶

An Int specifying the global timeline frame number that corresponds to endFrame. A negative number will indicate reverse numbering: -1 indicates the last frame to be displayed in the viewport. The default value is −1.

timelineStartTime=0¶

A Float specifying the global timeline time that corresponds to the time of startFrame. The default value is 0.0.

timelineEndTime=END_FRAME_TIME¶

The SymbolicConstant END_FRAME_TIME or a Float specifying the global timeline time that corresponds to the time of endFrame. The SymbolicConstant END_FRAME_TIME indicates the time in this movie corresponding to endFrame. The default value is END_FRAME_TIME.

Raises:¶

RangeError – If startFrame,*endFrame*,*timelineStartFrame*,*timelineEndFrame*,*timelineStartTime*, or*timelineEndTime* are outside their respective valid range.

This method closes the ImageAnimation object.

This method indicates if the ImageAnimation is open or closed for writing animation frames.

This method adds a frame to the ImageAnimation object.

Parameters:¶

canvasObjects=()¶

A sequence specifying the canvas objects to capture. The default is to capture all canvas objects.

This method modifies the ImageAnimationOptions object.

Parameters:¶

frameRate=None¶

An Int specifying the frame rate to record on the saved animation file. The effective frame rate in frames per second will be obtained by dividing the given frame rate by the time scale.

timeScale=None¶

An Int specifying the time scale to apply to the frame rate.

vpDecorations=1¶

A Boolean specifying whether to capture the viewport border and title. The default value is ON.

vpBackground=0¶

A Boolean specifying whether to capture viewport backgrounds. The default value is OFF.

compass=0¶

A Boolean specifying whether to capture the view compass. The default value is OFF.

This method modifies the QuickTimeOptions object.

Parameters:¶

compressionMethod=RLE24¶

A SymbolicConstant specifying the compression method for the QuickTime format. Possible values are:

• RAW24, specifying an uncompressed format of 24 bits per pixel.

• RLE24, specifying a run length encoded format of 24 bits per pixel.

The default value is RLE24.

sizeDefinition=SIZE_ON_SCREEN¶

A SymbolicConstant specifying how the width and height of the image are specified. Possible values are SIZE_ON_SCREEN and USER_DEFINED. The default value is SIZE_ON_SCREEN.

imageSize=None¶

A pair of Ints specifying the width and height of the image in pixels when sizeDefinition = USER_DEFINED. Possible values are Ints in the range (minWidth, minHeight) ≤ (width, height) ≤ (maxWidth, maxHeight). The default value is the screen size. Note: The values of the minimum width (minWidth) and height (minHeight) depend on the following:viewport font size,whether decorations are printed,decoration size, and screen resolution.The minimum width and height are normally < 50 pixels. The values of the maximum width (maxWidth) and height (maxHeight) depend on the graphics capabilities of the system. The maximum width and height will be at least as large as the screen dimensions.