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

---

// access PRIM_SPHERE_RAD parameter if (!object-> GetParameter ( DescID ( PRIM_SPHERE_RAD ), data, DESCFLAGS_GET::NONE )) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION );

// check if container contains a float value if (data. GetType () != DA_REAL ) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION ); const Float radius = data. GetFloat (); ApplicationOutput ( "Radius: " + String::FloatToString (radius));

数据

类型

A GeData object stores data of a certain type.

• GeData::SetDefault() : Sets the default value for the given data type.
• DEFAULTVALUE : Dummy value for the constructor to initialize the object with the default value.

• GeData::GetType() : Returns the type of the stored data.

注意

If the type is not set, GeData::GetType() returns DA_NIL .

// check type if (data. GetType () != DA_REAL ) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION ); const Float radius = data. GetFloat ();

Access

The GeData class offers access functions for all supported data types. "Set" functions set the value and also change the data type if needed. "Get" functions return the value and are only allowed to be used if the data type matches.

Int32 and Bool data (data type DA_LONG ):

• GeData::GetBool() ：返回 Bool 值。
• GeData::GetInt32() ：返回 Int32 值。
• GeData::SetInt32() : Sets a Int32 值。

Int64 data (data type DA_LLONG ):

• GeData::GetInt64() ：返回 Int64 值。
• GeData::SetInt64() : Sets the Int64 值。

Float data (data type DA_REAL ):

• GeData::GetFloat() ：返回 Float 值。
• GeData::SetFloat() : Sets the Float 值。

另请参阅 Primitive Data Types Manual (Classic) .

Void pointers (data type DA_VOID ):

• GeData::GetVoid() : Returns the void pointer.
• GeData::SetVoid() : Stores the void pointer.

// ... SomeObject* const obj = static_cast< SomeObject* > (data. GetVoid ());

注意

In general it is not recommended to use "raw" pointers, instead see BaseLink Manual .

Raw memory (data type DA_BYTEARRAY ):

• GeData::GetMemoryAndRelease() : Returns a pointer to the stored memory and hands over the ownership.
• GeData::GetMemory() : Returns a pointer to the stored memory.
• GeData::SetMemory() : Stores the raw memory.

向量 objects (data type DA_VECTOR ):

• GeData::GetVector() ：返回 向量 对象。
• GeData::SetVector() : Stores the 向量 对象。

另请参阅 Vector Manual (Classic) .

矩阵 objects (data type DA_MATRIX ):

• GeData::GetMatrix() ：返回 矩阵 对象。
• GeData::SetMatrix() : Stores the 矩阵 对象。

另请参阅 Matrix Manual (Classic) .

String objects and C4DUuid objects (data type DA_STRING ):

• GeData::GetString() ：返回 String 对象。
• GeData::SetString() : Stores the String 对象。

另请参阅 String Manual (Classic) .

Filename objects (data type DA_FILENAME ):

• GeData::GetFilename() ：返回 Filename 对象。
• GeData::SetFilename() : Stores the Filename 对象。

另请参阅 Filename Manual .

C4DUuid objects: (data type DA_UUID ):

• GeData::GetUuid() ：返回 C4DUuid 对象。
• GeData::SetUuid() : Stores the C4DUuid 对象。

BaseTime objects (data type DA_TIME ):

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

另请参阅 BaseTime 手册 .

Tristate (data type DA_TRISTATE ):

• GeData::SetTristate()

另请参阅 TriState Manual .

BaseContainer objects (data type DA_CONTAINER ):

• GeData::GetContainer() ：返回 BaseContainer .
• GeData::SetContainer() : Stores the BaseContainer .

另请参阅 BaseContainer Manual .

BaseLink objects (data type DA_ALIASLINK ):

• GeData::GetBaseLink() ：返回 BaseLink 对象。
• GeData::GetLink() ：返回 BaseList2D object referenced by the stored BaseLink 对象。
• GeData::GetLinkAtom() ：返回 C4DAtomGoal object referenced by the stored BaseLink 对象。
• GeData::SetBaseLink() : Stores the BaseLink 对象。
• GeData::SetBaseList2D() : Stores a BaseLink object referencing a given BaseList2D 对象。

另请参阅 BaseLink Manual .

Custom data types:

• GeData::GetCustomDataType() : Returns the custom data type object.
• GeData::SetCustomDataType() : Stores a custom data type object.

// get data GeData data; if (!activeTag->GetParameter( DescLevel ( EXPRESSION_PRIORITY ), data, DESCFLAGS_GET::NONE )) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION );

// get custom data type value CustomDataType * const customData = data. GetCustomDataType ( CUSTOMGUI_PRIORITY_DATA ); PriorityData * const priorityData = static_cast< PriorityData * > (customData); if (priorityData == nullptr ) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION );

// edit data priorityData-> SetPriorityValue ( PRIORITYVALUE_CAMERADEPENDENT , GeData { true }); activeTag->SetParameter( DescLevel ( EXPRESSION_PRIORITY ), data, DESCFLAGS_SET::NONE );

拷贝

The data of one GeData object can easily be copied to another object:

• GeData::CopyData() : Copies the data to the given target GeData 对象。
• GeData::operator= : Copies the GeData 对象。

// check if container contains a String if (intData.GetType() == DA_STRING ) ApplicationOutput ( "Data: " + intData.GetString());

清零

A GeData object can be cleared.

• GeData::Free() : Deletes all internal data and sets the type to DA_NIL .

// check if container contains a String if (data. GetType () == DA_STRING ) ApplicationOutput ( "data contains a string" _s); data. Free ();

// check if data has no type (data is not set) if (data. GetType () == DA_NIL ) ApplicationOutput ( "data is empty" _s);

比较

Two GeData objects can be compared with the usual operators:

• GeData::operator== : Returns true if two GeData objects are equal.
• GeData::operator!= : Returns true if two GeData objects are not equal.

Disc I/O

A GeData object can be stored in a HyperFile :

• HyperFile::ReadGeData() : Reads the GeData object from the HyperFile .
• HyperFile::WriteGeData() : Writes the GeData object to the HyperFile .

// open HyperFile to write if (hf-> Open (456, filename, FILEOPEN::WRITE , FILEDIALOG::ANY )) { hf-> WriteGeData (data); hf-> 关闭 (); } else { return maxon::IoError( MAXON_SOURCE_LOCATION , MaxonConvert (filename, MAXONCONVERTMODE::NONE ), "Could not open file." _s); }

// This example reads a GeData value from a HyperFile stored on disc. AutoAlloc<HyperFile> hf; if (hf == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION );

// open HyperFile to read if (hf-> Open (456, filename, FILEOPEN::READ , FILEDIALOG::ANY )) { GeData data; hf-> ReadGeData (&data);

// check if container contains a String if (data. GetType () == DA_STRING ) ApplicationOutput ( "Loaded GeData String: " + data. GetString ()); hf-> 关闭 (); } else { return maxon::IoError( MAXON_SOURCE_LOCATION , MaxonConvert (filename, MAXONCONVERTMODE::NONE ), "Could not open file." _s); }

延伸阅读

• Data Containers & Collections
• Classic API Containers
• BaseContainer Manual
• Primitive Data Types Manual (Classic)
• Vector Manual (Classic)
• Matrix Manual (Classic)
• String Manual (Classic)
• Filename Manual
• BaseLink Manual
• BaseTime 手册
• Data Manual