内容表

• 关于
• Access
• Time and Frame
• 特性
  • Set Time
  • Numerator/Denominator
• 比较
• Disc I/O
• 延伸阅读

关于

A BaseTime object is used to define a point in time in a BaseDocument . If only frame numbers were used, changing the frame rate would cause keys either to overlap or disappear. If only float values (seconds) were used instead, there would be problems because of the limited data precision. For instance when using 30 fps the frame 29 = 29/30 could easily be misinterpreted as frame 28.

BaseTime internally stores the time values as exact fractions independent of the frame rate. For example frame 29 is stored as fraction with nominator 29 and denominator 30. The class always tries to keep the nominator and denominator as small as possible. Hence 15/30 is stored as 1/2, so if using 30 fps BaseTime::GetFrame() would return 15, but if using 24 fps it would return frame 12.

Access

The current time of a BaseDocument can be handled using:

• BaseDocument::GetTime() : Returns a BaseTime storing the current time.
• BaseDocument::SetTime() : Sets the current time of the document using a BaseTime 对象。
• SetDocumentTime() : Sets the given document's time.

For timeline dimensions, preview time and used time see BaseDocument Manual .

To retrieve and modify BaseTime objects stored in a BaseContainer respectively use:

• BaseContainer::GetTime() ：返回 BaseTime stored at the given ID.
• BaseContainer::SetTime() : Sets the BaseTime stored at the given ID.

另请参阅 BaseContainer Manual .

To retrieve and modify BaseTime objects stored in a GeData object ( GeData type is DA_TIME ) respectively use:

• GeData::GetTime() : Return the BaseTime 对象。
• GeData::SetBaseTime() : Stores the BaseTime 对象。

另请参阅 GeData Manual .

Please notice that Cinema 4D can only handle a limited number of frames:

• MAXTIME : The maximum number of frames Cinema 4D can handle in a timeline.

Animation keys are placed at certain frames. These frames can be respectively retrieved and modified using:

• CKey::GetTime() : Returns the time of the key.
• CKey::SetTime() : Sets the time of the key.

// This example checks if the given object is a particle emitter. // If so, the emission start time is read and the current document time is set.