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

---

Access

CKey objects are accessed via the host CCurve :

• CCurve::GetKeyCount() : Returns the number of keys.
• CCurve::GetKey() ：返回 CKey at the given index.
• CCurve::FindKey() : Returns the (next) CKey at the given time.
• CCurve::FindNextUnmuted() : Returns the next unmuted key searching from the given index.
• CCurve::FindPrevUnmuted() : Returns the previous unmuted key searching from the given index.

见 CCurve Manual .

The host objects are accessed with:

• CKey::GetCurve() ：返回 CCurve of the key.
• CKey::GetTrack() ：返回 CTrack of the key.

Allocation/Deallocation

A CKey object can be created with the usual tools:

• CKey::Alloc() : Creates a new CKey .
• CKey::Free() : Deletes the given CKey .
• CCurve::InsertKey() : Inserts a key into the CCurve 。 CCurve takes ownership.

But typically keys are created using the host CCurve :

• CCurve::AddKey() : Adds a new key to the CCurve .
• CCurve::AddKeyAdaptTangent() : Adds a new key to the CCurve but retains the curve's current curvature.

Keys can also be created using auto key functionality of the BaseDocument :

• BaseDocument::RecordKey() : Creates a key at the given time for the given parameter.
• BaseDocument::AutoKey() : Creates keys automatically if auto key mode is enabled.
• BaseDocument::Record() : Creates keyframes for all selected objects. Parameters must be added to the keyframe selection.

The default settings of a key are defined in the BaseDocument :

• BaseDocument::GetDefaultKey() : Returns the default key template.
• BaseDocument::SetDefaultKey() : Sets the default key template.

另请参阅 BaseDocument 动画 .

Handle

CKey objects are manipulated with the host CCurve 对象。

• CCurve::DelKey() : Deletes the key at the given index.
• CCurve::MoveKey() : Moves the key at the given index.
• CCurve::FlushKeys() : Removes all keys from the curve.
• CCurve::SetKeyDirty() : Sets the keys dirty.
• CCurve::SetKeyDefault() : Sets the default settings for the key at the given index.
• CTrack::FillKey() : Fills the given key with default values.

特性

参数

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

注意

The boolean parameters of a key are stored internally as bits, see Bits .

Selection

在 Cinema 4D there can be up to four Timeline windows. A key 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.

时间

An animation key is defined by its position in time:

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

另请参阅 BaseTime 手册 .

值

An animation key defines a certain value at a certain time:

• CKey::GetValue() : Returns the float value of the key.
• CKey::SetValue() : Sets the float value of the key.
• CKey::GetGeData() : Returns the generic data of the key (see also GeData Manual ).
• CKey::SetGeData() : Sets the generic data of the key.

注意

Data of special tracks can be read and set using C4DAtom::GetParameter() and C4DAtom::SetParameter() .

To set the keyframe for a Vector parameter one must define tracks and keyframes for each vector component.

// check if the track is "value" track (float) if (track-> GetTrackCategory () == CTRACK_CATEGORY_VALUE ) { Float value = key-> GetValue (); value = value + 1.0; key-> SetValue (curve, value); } // check if the track is "data" track else if (track-> GetTrackCategory () == CTRACK_CATEGORY_DATA ) { GeData data = key-> GetGeData (); // handle GeData key-> SetGeData (curve, data); }

另请参阅 CTrack Read-Only Properties and CCurve 动画 .

Tangents

A key also defines the local tangents. These tangents influence the interpolation between the keys.

• CKey::GetAutomaticTangentMode() : Returns the AutoTangent mode of the key.
• CKey::SetAutomaticTangentMode() : Sets the AutoTangent mode of the key.

The modes are:

• CAUTOMODE::CLASSIC : AutoTangent first implementation.
• CAUTOMODE::FIXEDSLOPE : AutoTangent with fixed slope for given time.

The left and right tangents are defined by two points. These two points are defined by time and value.

The time property of the tangents can be accessed with:

• CKey::GetTimeLeft() : Returns the time of the left tangent.
• CKey::SetTimeLeft() : Sets the time of the left tangent.
• CKey::GetTimeRight() : Returns the time of the right tangent.
• CKey::SetTimeRight() : Sets the time of the right tangent.

The value property of the tangents can be accessed with:

• CKey::GetValueLeft() : Returns the value of the left tangent.
• CKey::SetValueLeft() : Sets the value of the left tangent.
• CKey::GetValueRight() : Returns the value of the right tangent.
• CKey::SetValueRight() : Sets the value of the right tangent.

The left and right tangent can be adjusted with:

• CKey::SetTimeLeftAdjustValue() : Sets time of the left tangent and adjusts the value so the angle stays the same.
• CKey::SetTimeRightAdjustValue() : Sets time of the right tangent and adjusts the value so the angle stays the same.

Interpolation

There are different ways to interpolate between the values of the animation keys. The interpolation from one key to the next is defined per key:

• CKey::GetInterpolation() : Returns the interpolation.
• CKey::SetInterpolation() : Sets the interpolation.

Interpolation modes are:

• CINTERPOLATION::SPLINE : Spline interpolation.
• CINTERPOLATION::LINEAR : Linear interpolation.
• CINTERPOLATION::STEP : Step interpolation.

Quaternion Interpolation

Quaternion interpolation can be used on the rotation of a BaseObject . The kind of interpolation can be refined per key.

• CKey::GetQuatInterpolation() : Returns the interpolation mode.
• CKey::SetQuatInterpolation() : Sets the interpolation mode.
• ROTATIONINTERPOLATION_QUATERNION : The rotation interpolation mode.
  • ::SLERP: Quaternion Spherical LERP Interpolation (Linear)
  • ::CUBIC: Quaternion Smooth Cubic Interpolation (formerly known as Losch)

另请参阅 BaseObject Quaternion Rotation Mode .

预置

Several presets exist to manage the clamp, slope and overshoot behaviour of a key.

• CKey::GetKeyPreset() : Return the preset mode of the key.
• CKey::SetKeyPreset() : Sets the preset mode of the key.

The preset modes are:

• CKEYPRESET::CLASSICAUTO : Auto, Classical, Clamp.
• CKEYPRESET::NEWAUTO : Auto, Classical, remove Overshooting.
• CKEYPRESET::NEWAUTOWEIGHTED : Auto, Fixed Slope, remove Overshooting.
• CKEYPRESET::CUSTOM : User Defined.

拷贝

A new CKey can be created by copying an existing one.

• CKey::CopyDataTo() : Copies the data of the key into the given CKey .
• CKey::GetClone() : Returns a copy of the CKey .

Functionality

The data stored in a key can easily be flushed.

• CKey::FlushData() : Empties and resets data of the key.

Bits

The boolean parameters of a key are stored internally as bits. These bits can be edited directly.

• NBIT::CKEY_LOCK_T : Lock key time.
• NBIT::CKEY_LOCK_V : Lock key value.
• NBIT::CKEY_MUTE : Mute key.
• NBIT::CKEY_CLAMP : Clamp key tangents.
• NBIT::CKEY_BREAK : Break key tangents.
• NBIT::CKEY_KEEPVISUALANGLE : Keep visual angle.
• NBIT::CKEY_LOCK_O : Lock key tangents angles.
• NBIT::CKEY_LOCK_L : Lock key tangents length.
• NBIT::CKEY_AUTO : Key auto tangents
• NBIT::CKEY_WEIGHTEDTANGENT : Weighted Tangent .
• NBIT::CKEY_REMOVEOVERSHOOT : Remove Overshooting.
• NBIT::CKEY_AUTOWEIGHT : Automatic Weighting.

另请参阅 参数 .

延伸阅读

• 动画概述
• CTrack Manual
• CCurve Manual
• BaseList2D Manual
• BaseTime 手册
• GeData Manual