This reference page is linked to from the following overview topics: MotionBuilder 2014, Story.
Story Clip class.
Clips represents media, at a specific time, for a specific duration, in a track.
Clip offset is depending on Traveling node and Traveling node function. First we compute clip transformation matrix, where scaling is always 1, 1, 1. Translation is in position of Traveling node at clip first frame. Rotation is based on vector from first to last frame position of Traveling node. On top of that we apply offset and expose that as Clip Offset T & R. When you change clip offset T or R we extract clip offset based on current clip transformation matrix. Clip transformation matrix can change when Traveling node change or Traveling node function change.
#include <fbstory.h>
Public Member Functions | |
FBStoryClip (FBComponent *pClipObject, FBStoryTrack *pTrack, FBTime pTime, HIObject pObject=NULL) | |
Constructor. | |
FBStoryClip (const char *pFilePath, FBStoryTrack *pTrack, FBTime pTime, HIObject pObject=NULL) | |
Constructor. | |
virtual void | FBDelete () |
Virtual FBDelete function. | |
FBStoryClip * | Clone () |
Clone the clip. | |
FBTime | Move (FBTime pDelta, bool pForce=true) |
Move. | |
FBTime | MoveTo (FBTime pTime, bool pForce=true) |
MoveTo. | |
FBStoryClip * | Razor (FBTime pTime) |
Razor. | |
void | Match () |
Match. | |
bool | ExportToFile (FBString pOutputFile) |
ExportToFile. | |
bool | MakeWritable () |
MakeWritable. | |
void | GetAffectedObjects (FBArrayTemplate< FBComponent * > *pAffectedObjects) |
GetAffectedObjects. | |
void | GetAffectedAnimationNodes (FBArrayTemplate< FBAnimationNode * > *pAffectedAnimationNodes, FBComponent *pClipObject) |
GetAffectedAnimationNodes. | |
FBXSDK_NAMESPACE::FbxScene * | GetFbxScene () |
Get KFbxScene. | |
Public Attributes | |
FBPropertyColor | Color |
Read Write Property: Color of the clip. | |
FBPropertyTime | Start |
Read Write Property: Start time of the clip local to its track. | |
FBPropertyTime | Stop |
Read Write Property: Stop time of the clip local to its track. | |
FBPropertyTime | MarkIn |
Read Write Property: Start time inside the clip. | |
FBPropertyTime | MarkOut |
Read Write Property: Stop time inside the clip. | |
FBPropertyTimeSpan | PreBlend |
Read Write Property: Start/Stop time of the pre-blend phase. | |
FBPropertyTimeSpan | PostBlend |
Read Write Property: Start/Stop time of the post-blend phase. | |
FBPropertyTime | Offset |
Read Write Property: First loop time offset. | |
FBPropertyDouble | Speed |
Read Write Property: Speed of the clip. | |
FBPropertyCamera | ShotCamera |
Read Write Property: The camera used for that specific shot. | |
FBPropertyVideo | ShotBackplate |
Read Write Property: The backplate used for that specific shot. | |
FBPropertyVideo | ShotFrontplate |
Read Write Property: The frontplate used for that specific shot. | |
FBPropertyBool | ShowBackplate |
Read Write Property: Enable/Disable the shot backplate. | |
FBPropertyBool | ShowFrontplate |
Read Write Property: Enable/Disable the shot frontplate. | |
FBPropertyTime | ShotActionStart |
Read Write Property: If not in locked shot mode (time discontinuity enabled), this time can be different from the Clip->Start property. | |
FBPropertyTime | ShotActionStop |
Read Write Property: If not in locked shot mode (time discontinuity enabled), this time can be different from the Clip->Start property. | |
FBPropertyAudioClip | AudioClip |
Read Only Property: The audio clip used by this StoryClip. | |
FBPropertyBool | ImageSequence |
Read Write Property: Whether is a image sequence. | |
FBPropertyBool | UseSystemFrameRate |
Read Write Property: Whether always use system frame rate. | |
FBPropertyDouble | FrameRate |
Read Write Property: Frame rate value. | |
FBPropertyDouble | Scale |
Read Write Property: Animation clip's scaling (some don't support this property) | |
FBPropertyVector3d | Translation |
Read Write Property: Animation clip's translation offset. | |
FBPropertyVector3d | Rotation |
Read Write Property: Animation clip's rotation offset. | |
FBPropertyVector3d | LoopTranslation |
Read Write Property: Animation clip's loop translation. | |
FBPropertyBool | AutoLoop |
Read Write Property: If true, clip will automatically loop | |
FBPropertyBool | Loop |
Read Write Property: If true, loop clip's animation | |
FBPropertyBool | Ghost |
Read Write Property: Show ghosts | |
FBPropertyBool | GhostModel |
Read Write Property: Show ghost of models | |
FBPropertyBool | GhostTravelling |
Read Write Property: Show ghost of clip vector or traveling node | |
FBPropertyBool | GhostPivot |
Read Write Property: Show ghost of match object | |
FBPropertyStoryClipShowGhostMode | ShowGhostClipMode |
Read Write Property: Show the ghost depending on the time. | |
FBPropertyAnimationNode | PreBlendData |
Read Only Property: To get the animation of the Pre blend curve | |
FBPropertyAnimationNode | PostBlendData |
Read Only Property: To get the animation of the Post blend curve | |
FBPropertyListPivot | Pivots |
List: Pivots models (Generally, only one model is necessary) | |
FBPropertyBool | Loaded |
Read Write Property: If true, clip file is loaded into memory and can be evaluated (will affect track content). | |
FBPropertyStoryClipSolveMode | SolvingMode |
Read Write Property: Solve Modes for story character clips. |
FBStoryClip | ( | FBComponent * | pClipObject, |
FBStoryTrack * | pTrack, | ||
FBTime | pTime, | ||
HIObject | pObject = NULL |
||
) |
Constructor.
pClipObject | Object (media data) for the clip. |
pTrack | The track in which we create the clip. |
pTime | Time where the clip should begin. |
pObject | For internal use only. |
FBStoryClip | ( | const char * | pFilePath, |
FBStoryTrack * | pTrack, | ||
FBTime | pTime, | ||
HIObject | pObject = NULL |
||
) |
Constructor.
pFilePath | Media file path to create clip with. |
pTrack | The track in which we create the clip. |
pTime | Time where the clip should begin. |
pObject | For internal use only. |
virtual void FBDelete | ( | ) | [virtual] |
FBStoryClip* Clone | ( | ) |
Clone the clip.
Move.
Move the clip of a delta offset.
pDelta | Delta time to apply to the clip. |
pForce | Force clip to find the nearest position if the move fail. |
MoveTo.
Move the clip to the specified time.
pTime | Time where to put the clip. |
pForce | Force clip to find the nearest position if the move fail. |
FBStoryClip* Razor | ( | FBTime | pTime | ) |
Razor.
Cut (razor) the clip at the specified time.
pTime | Time where to cut. This time is local to the track, not to the clip. |
void Match | ( | ) |
bool ExportToFile | ( | FBString | pOutputFile | ) |
ExportToFile.
Export animation clip to disk file.
pOutputFile | Output file path name. |
bool MakeWritable | ( | ) |
MakeWritable.
Imports FCurves from story clip scene making them accessible for the user.
void GetAffectedObjects | ( | FBArrayTemplate< FBComponent * > * | pAffectedObjects | ) |
GetAffectedObjects.
Get the list of objects affected by this story clip.
pAffectedObjects | Array of affected objects, will be filled by the function. |
void GetAffectedAnimationNodes | ( | FBArrayTemplate< FBAnimationNode * > * | pAffectedAnimationNodes, |
FBComponent * | pClipObject | ||
) |
GetAffectedAnimationNodes.
Get the list of animation nodes affected by this story clip, for a specific object.
pAffectedAnimationNodes | Array of affected animation nodes, will be filled by the function. |
pClipObject | The object for which we search for affected animation nodes. |
FBXSDK_NAMESPACE::FbxScene* GetFbxScene | ( | ) |
Get KFbxScene.
Will only return valid pointer to KFbxScene for readonly animation clip.
Read Write Property: Color of the clip.
Read Write Property: Start time of the clip local to its track.
Read Write Property: Stop time of the clip local to its track.
Read Write Property: Start time inside the clip.
Read Write Property: Stop time inside the clip.
Read Write Property: Start/Stop time of the pre-blend phase.
Read Write Property: Start/Stop time of the post-blend phase.
Read Write Property: First loop time offset.
Read Write Property: Speed of the clip.
FBPropertyCamera ShotCamera |
Read Write Property: The camera used for that specific shot.
FBPropertyVideo ShotBackplate |
Read Write Property: The backplate used for that specific shot.
FBPropertyVideo ShotFrontplate |
Read Write Property: The frontplate used for that specific shot.
Read Write Property: Enable/Disable the shot backplate.
Read Write Property: Enable/Disable the shot frontplate.
Read Write Property: If not in locked shot mode (time discontinuity enabled), this time can be different from the Clip->Start property.
Read Write Property: If not in locked shot mode (time discontinuity enabled), this time can be different from the Clip->Start property.
FBPropertyAudioClip AudioClip |
Read Only Property: The audio clip used by this StoryClip.
Read Write Property: Whether is a image sequence.
Read Write Property: Whether always use system frame rate.
Read Write Property: Frame rate value.
Only effective when UseSystemFrameRate is false.
Read Write Property: Animation clip's scaling (some don't support this property)
Read Write Property: Animation clip's translation offset.
Refer to class notes to learn more about how this is applied.
Read Write Property: Animation clip's rotation offset.
Refer to class notes to learn more about how this is applied.
Read Write Property: Animation clip's loop translation.
Read Write Property: If true, clip will automatically loop
Read Write Property: If true, loop clip's animation
Read Write Property: Show ghosts
Read Write Property: Show ghost of models
Read Write Property: Show ghost of clip vector or traveling node
Read Write Property: Show ghost of match object
FBPropertyStoryClipShowGhostMode ShowGhostClipMode |
Read Write Property: Show the ghost depending on the time.
See FBStoryClipShowGhostMode
FBPropertyAnimationNode PreBlendData |
Read Only Property: To get the animation of the Pre blend curve
FBPropertyAnimationNode PostBlendData |
Read Only Property: To get the animation of the Post blend curve
List: Pivots models (Generally, only one model is necessary)
Read Write Property: If true, clip file is loaded into memory and can be evaluated (will affect track content).
FBPropertyStoryClipSolveMode SolvingMode |
Read Write Property: Solve Modes for story character clips.
See FBStoryClipSolveMode