Synopsis
Records, plays back, and encodes collections of images in AVI or MPEG formats
Input Ports
|
LGDView |
GDview_ref_templ |
|
LInputFrameBuffer |
Mesh_Unif+Node_Data |
Parameters
The following table lists amimator's public parameters stored in the imcapParam subobject. They carry data and flags used by other objects in the macro. They are set by UI controls defined in the imcapUI subobject.
|
Name |
Type |
UI panel control |
|
reset |
int |
UIbutton:
|
|
reset back |
int |
UIbutton:
|
|
run |
int |
UI button:
|
|
int |
UIbutton
| |
|
step |
int |
UIbutton
|
|
step back |
int |
UIbutton
|
|
run options |
int |
UIoptionMenu
|
|
mode |
int |
UIoptionMenu
|
|
capture mode |
int |
UIoptionMenu
|
|
clear |
int |
UIbutton:
|
|
record |
int |
UIbutton:
|
|
delete |
int |
UIbutton:
|
|
movie mode |
int |
UIoptionMenu
|
|
filename |
string |
VUIFileSelector
|
|
gen movie |
int |
UIbutton:
|
|
current image |
int |
UIlabel
|
|
total images |
int |
UIlabel
|
Output Ports
|
LFrameBuffer |
Mesh_Unif+Node_Data |
Subobjects
The following table lists the immediate subobjects of the image capture macro.
|
imcapParam |
A group that collects the public parameters used by image capture . |
|
imcapCompute |
A macro that encapsulates the processing done by the image capture to create the animation sequence. |
|
imcapUI |
A macro that encapsulates the user interface controls displayed in the default UImodpanel. |
|
UImod panel |
A group representing the default UI panel. |
|
instancer |
A module |
Records, plays back, and encodes collections of images in AVI or MPEG formats
AVS/Express recognizes an environment variable, XP_MPEG_PARAM_FILE , identifying the file containing the parameters to be used in MPEG encoding by the image_capture macro. If the specified file does not exist, it will be created during the encoding process. If it does exist, the parameter values it contains are used for encoding. This allows you to let AVS/Express define the parameters in the file initially and then edit the parameters in that file as desired. The XP_MPEG_STATS environment variable can be used to define a file to hold data from the encoding process.
Windows users who are experiencing problems with AVS/Express MPEG encoding may wish to create an AVI file with AVS/Express and use a third party tool to convert it to MPEG.
Input Ports
LDGView
GDview_ref_templ. Connection to a view.
LInputFrameBuffer
Mesh_Unif+Node_Data. Connection to a frame buffer.
Parameters
reset
When reset is set to nonzero, the animation is set to the first frame. If the animation is running, it continues from the first frame. reset is automatically reset to 0 after the reset is done.
reset back
UIbutton:intWhen reset_back is set to nonzero, the animation is set to the last frame. If the animation is running, it continues from the first frame. reset_back is automatically reset to 0 after the reset is done.
run
UIbutton. When nonzero, the animation runs. When the animation reaches the end, the run parameter is automatically set to zero unless the cycle parameter is nonzero. If run is set to zero while the loop is running, it stops at the current value until run is set to one.
run back
int While run back is set to a non-zero value, the currrent sequence of frames is displayed backwards, from last to first, according to the mode set in the run options parameter. When the animated sequence is complete, run back is automatically reset to 0.
The run back parameter is set to 1 by the Run Backwards UIbutton control, and to 0 by the Stop control.
step
int When step is set to a non-zero value, the current frame is advanced to the next frame forwards in the animation sequence. When the new frame is set, step is automatically reset to 0.
The step parameter is set by the StepForward UIbutton control in animUI.PlaybackControls.
step back
int When step back is set to a non-zero value, the current frame is set to the previous frame in the animation sequence. When the new frame is set, step back is automatically reset to 0.
The step parameter is set by the StepBack UIbutton control in animUI.PlaybackControls.
run options
int The run options parameter specifies one of three modes for running the animation:
· 0 = Once
· 1 = Cycle
· 2 = Bounce
The run options parameter is set by the RunOptions UIoptionMenu control in animUI.PlaybackControls
Mode option menu to one of the capture options:
0 = Inactive
1 = Capture from View
Records images from the view connected to the LGDview port on the image capture object.
2 = Capture from Framebuffer
Records images from the view connected to the LInputFrameBuffer port on the image capture object.
3 = Playback to view
Plays back the images to the view connected to the LGDview port on the image capture object.
4 = Playback to Framebuffer
Plays back the images to the LFrameBuffer output port on the image capture object.
capture mode
0 = Disk
Saves the images to temporary files in the directory specified by filename.
1 = Memory saves the images to your computer's memory.
clear
Clears all frames in the current animation.
record
Forces the creation of a frame for the current view.
delete
Deletes the current frame.
movie mode
Specifies the type of movie to be created: