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

---

// get color and check if it is selected if (group-> GetColor (c, color, &selected) && selected) { // create new material 材质 * const mat = Material::Alloc (); if (mat == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION );

// use color const 向量 rgb { color. r , color. g , color. b }; mat-> SetParameter ( MATERIAL_COLOR_COLOR , rgb, DESCFLAGS_SET::NONE ); doc-> InsertMaterial (mat); } } } }

Allocation/Deallocation

ColorSwatchData instances are created with the usual tools:

• ColorSwatchData::Alloc() : Creates a new ColorSwatchData object. If the second argument is set to true, the global group is loaded.
• ColorSwatchData::Free() : Destroys the given ColorSwatchData .

Document Colors

Color groups can be stored in a BaseDocument :

• ColorSwatchData::Load() : Loads the color groups from the given BaseDocument .
• ColorSwatchData::Save() : Saves the color groups to the given BaseDocument .

// load colors of the original if (!colorSwatchData-> Load (doc)) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION );

// select the scene file Filename sceneFile;

// open a dialog to select a file if (!sceneFile. FileSelect ( FILESELECTTYPE::SCENES , FILESELECT::LOAD , "Select File" _s)) return maxon::OK ;

// load the scene file BaseDocument * loadedDoc = LoadDocument (sceneFile, SCENEFILTER::NONE , nullptr ); if (loadedDoc == nullptr ) return maxon::IoError( MAXON_SOURCE_LOCATION , MaxonConvert (sceneFile, MAXONCONVERTMODE::NONE ), "Could not load document." _s);

// merge the scene file colors colorSwatchData-> Load (loadedDoc, true ); // store merged colors back into the BaseDocument colorSwatchData-> Save (doc); BaseDocument::Free (loadedDoc);

预置

Color swatches can also be stored in the preset library:

• ColorSwatchData::LoadPreset() : Loads the color groups from the given preset.
• ColorSwatchData::SavePreset() : Saves the color gorups to the given preset.

To make work with presets easier these utility functions exist:

• ColorSwatchData::PresetExists() : Returns true if the given preset name already exists.
• ColorSwatchData::ValidPreset() : Returns true if the given URL points to a valid preset.
• ColorSwatchData::GetPresetDirectory() : Returns the user's default Color Swatch Preset directory.
• ColorSwatchData::browserPresetType : The ID of color swatch preset objects.

// check if preset already exists if (! ColorSwatchData::PresetExists (presetName)) { // construct url SDKBrowserURL presetUrl = ColorSwatchData::GetPresetDirectory (); presetUrl += presetName;

// save preset if (!colorSwatchData-> SavePreset (presetUrl, "User" , "This is my preset" )) return maxon::UnknownError( MAXON_SOURCE_LOCATION ); }

Color Groups

The color swatches stored in a ColorSwatchData are stored in groups. These groups can either be stored with the document ( SWATCH_CATEGORY::DOCUMENT ) or with Cinema 4D itself ( SWATCH_CATEGORY::GLOBAL ).

• ColorSwatchData::GetGroupCount() : Returns the number of groups stored.
• ColorSwatchData::GetGroupAtIndex() : Returns the group stored at the given index.
• ColorSwatchData::AddGroup() : Adds a new group to the ColorSwatchData .
• ColorSwatchData::SetGroupAtIndex() : Replaces the group at given index.
• ColorSwatchData::InsertGroup() : Adds the given group.
• ColorSwatchData::RemoveGroup() : Removes the group with the given index.
• ColorSwatchData::RemoveSelectedItems() : Removes selected groups and colors.

Further utility functions are:

• ColorSwatchData::Merge() : Merges the groups with the groups stored in the given object.
• ColorSwatchData::CopyFrom() : Copies the data from the given ColorSwatchData 对象。
• ColorSwatchData::Reset() : Removes all stored groups and colors, including globals.

延伸阅读

• ColorSwatchGroup Manual
• Color Functions Manual
• BaseDocument Manual