就业培训     下载中心     Wiki     联络 登录   注册

---

// add track to stage object stage->InsertTrackSorted(track); } CCurve * const curve = track-> GetCurve (); if (curve == nullptr ) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION );

// Create first key CKey * const key1 = curve-> AddKey ( BaseTime (0.0)); if (key1 == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION ); MAXON_SCOPE { GeData data; data. SetBaseList2D (camera1); key1-> SetGeData (curve, data); }

// Create second key CKey * const key2 = curve-> AddKey ( BaseTime (1.0)); if (key2 == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION ); MAXON_SCOPE { GeData data; data. SetBaseList2D (camera2); key2-> SetGeData (curve, data); }

Access

The animation tracks of an object's parameters are stored with the object itself:

• BaseList2D::GetFirstCTrack() : Returns the first CTrack stored with the object.
• BaseList2D::FindCTrack() : Returns the track associated with the given DescID . See example above.

注意

The keyframe selection is defined with the BaseList2D class, see BaseList2D Manual .

Allocation/Deallocation

A CTrack can be created with the usual tools:

• CTrack::Alloc() : Creates a new CTrack .
• CTrack::Free() : Deletes the given CTrack .

A newly created CTrack must be added to a host object:

• BaseList2D::InsertTrackSorted() : Adds the track to the object. The object takes ownership.
• CTrack::GetObject() : Returns the object that owns the CTrack .

To create special tracks the ID of that special track must be used. The special tracks are:

• CTpla : Point Level Animation Track.
• CTsound : Sound Track.
• CTmorph : Morph Track.
• CTtime : Time Track.

// This example adds a PLA track to the polygon object. const DescID plaID = DescLevel ( CTpla , CTpla , 0); CTrack * const plaTrack = CTrack::Alloc (polyObject, plaID); if (plaTrack == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION ); polyObject-> InsertTrackSorted (plaTrack); CCurve * curve = plaTrack-> GetCurve (); if (curve == nullptr ) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION );

// set first key CKey * const key1 = curve-> AddKey ( BaseTime (0.0)); if (key1 == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION ); plaTrack-> FillKey (doc, polyObject, key1);

// change polygon object randomly Random random; for ( Int32 i = 0; i < count; ++i) points[i] = points[i] + 向量 (0, 100.0 * random. Get01 (), 0.0); polyObject-> 消息 ( MSG_UPDATE );

// set second key CKey * const key2 = curve-> AddKey ( BaseTime (1.0)); if (key2 == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION ); plaTrack-> FillKey (doc, polyObject, key2);

导航

CTrack objects are stored in a list:

• CTrack::GetNext() : Returns the previous CTrack in the list or nullptr .
• CTrack::GetPred() : Returns the next CTrack in the list or nullptr .

注意

The GeListHead object that is the parent of the tracks can be obtained with BaseList2D::GetCTrackRoot() .

Read-Only Properties

Several values can be read from a CTrack :

• CTrack::GetTrackCategory() : Returns the track category.
• CTrack::GetValue() : Returns the track value for the given time.
• CTrack::GetUnit() : Returns the value unit and step size. These are the settings used with DESC_UNIT and DESC_STEP .

The track categories are:

• CTRACK_CATEGORY_VALUE : A track handling a floating point value (see Float ).
• CTRACK_CATEGORY_DATA : A track handling generic data (see GeData Manual ).
• CTRACK_CATEGORY_PLUGIN : A plugin track, for example a sound or PLA track.

// check if the track is "value" track (float) if (track-> GetTrackCategory () == CTRACK_CATEGORY_VALUE ) { const BaseTime now = doc-> GetTime (); const Float value = track-> GetValue (doc, now); ApplicationOutput ( "Value: " + String::FloatToString (value)); }

另请参阅 CKey 值 .

特性

参数

The parameters of a track can be edited as usual with C4DAtom::SetParameter() and C4DAtom::GetParameter() . The parameter IDs are defined in ctbase.h .

Selection

在 Cinema 4D there can be up to four timeline windows. An animation track can be selected in one or multiple of these windows. The selection state is stored as a bit:

• NBIT::TL1_SELECT : Selection bit for Timeline window 1.
• NBIT::TL2_SELECT : Selection bit for Timeline window 2.
• NBIT::TL3_SELECT : Selection bit for Timeline window 3.
• NBIT::TL4_SELECT : Selection bit for Timeline window 4.

另请参阅 CKey Selection .

Description ID

The parameter animated using a certain track is defined with its DescID . This DescID can be accessed:

• CTrack::GetDescriptionID() ：返回 DescID of the track.
• CTrack::SetDescriptionID() : Sets the DescID of the track.

// find track CTrack * const track = obj-> FindCTrack (ID); if (track == nullptr ) return maxon::IllegalArgumentError( MAXON_SOURCE_LOCATION );

// get track root GeListHead * const trackRoot = obj->GetCTrackRoot(); if (trackRoot == nullptr ) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION );

// clone track CTrack * const clone = static_cast< CTrack * > (track-> GetClone ( COPYFLAGS::NONE , nullptr )); if (clone == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION );

// insert and set new ID const DescLevel vectorYLevel( VECTOR_Y , DTYPE_REAL , 0); const DescID targetID = DescID (relPosLevel, vectorYLevel); trackRoot-> InsertLast (clone); clone-> SetDescriptionID (obj, targetID);

Loop Settings

The loop settings define how an animation track should behave before the first key and after the last key.

• CTrack::GetBefore() : Returns the pre-track loop type.
• CTrack::SetBefore() : Sets the pre-track loop type.
• CTrack::GetAfter() : Returns the post-track loop type.
• CTrack::SetAfter() : Sets the post-track loop type.

The loop types are:

• CLOOP::OFF : No loop.
• CLOOP::CONSTANT : Constant.
• CLOOP::CONTINUE : Continue.
• CLOOP::REPEAT : Repeat.
• CLOOP::OFFSETREPEAT : Offset repeat.
• CLOOP::OSCILLATE : Oscillate.

Points in time beyond the defined animation track can be mapped into time inside the track.

• CTrack::Remap() : Remaps the given time into a position inside the animation track.

// loop from 0.0 to 1.0 for ( Float64 t = 0.0; t < 10.0; t = t + 0.1) { Float64 remapTime; Int32 cycle; track-> Remap (t, &remapTime, &cycle); ApplicationOutput ( "Remap Time: " + String::FloatToString (remapTime)); }

Time Track

The behavior of an animation track depends on the current time which is typically the current time of the BaseDocument . But the time that controls a track can be also defined with a time track.

• CTrack::GetTimeTrack() : Returns the assigned time track.
• CTrack::SetTimeTrack() : Sets the assigned time track.

// serach for time track CTrack * const timeTrack = obj-> FindCTrack ( CTtime ); if (timeTrack == nullptr ) return maxon::IllegalArgumentError( MAXON_SOURCE_LOCATION );

// apply time track to other tracks CTrack * track = obj-> GetFirstCTrack (); while (track != nullptr ) { const DescID id = track-> GetDescriptionID ();

// check if the track is not a "Time" track if ( id [0]. id != CTtime ) track-> SetTimeTrack (timeTrack); track = track-> GetNext (); }

Timeline Height

An animation track can be displayed in a Timeline window.

• CTrack::GetHeight() : Returns the height of the track.
• CTrack::GetTLHeight() : Returns the height of the mini F-Curves in the Timeline.
• CTrack::SetTLHeight() : Sets the height of the mini F-Curves in the Timeline.

Track Information

An animation track can provide additional information for each key or the current time in form of a String .

• CTrack::TrackInformation() : Returns or sets the information.

Synchronisation

Multiple tracks can be synchronized. Typically this applies to tracks of the components of a 向量 参数。

• CTrack::IsSynchronized() : Returns true if the track is synchronized.
• CTrack::SetSynchronized() : Sets the synchronization status.

Functionality

Since a track might be displayed in the GUI (Timeline window) it can draw an image:

• CTrack::GuiMessage() : Sends GUI messages to the track.
• CTrack::Draw() : Fills the given GeClipMap 。见 GeClipMap Manual .

Further utility functions are:

• CTrack::FillKey() : Fills the given key with default values.
• CTrack::FlushData() : Flushes the track data.
• CTrack::GetCurve() : Returns the curve stored in with the track.

另请参阅 CCurve Manual .

延伸阅读

• 动画概述
• CCurve Manual
• CKey Manual
• BaseList2D Manual
• BaseTime 手册
• GeData Manual
• DescID Manual
• GeClipMap Manual