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

---

// get FieldList CustomDataType * const customData = data. GetCustomDataType ( CUSTOMDATATYPE_FIELDLIST ); FieldList * const fieldList = static_cast< FieldList * > (customData); if (fieldList == nullptr ) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION );

// prepare arrays maxon::BaseArray<maxon::Vector> positions; positions. Resize (sampleCnt) iferr_return ; maxon::BaseArray<maxon::Vector> uvws; uvws. Resize (sampleCnt) iferr_return ; maxon::BaseArray<maxon::Vector> directions; directions. Resize (sampleCnt) iferr_return ;

// set positions Float64 xOffset = 0.0; for ( maxon::Vector & pos : positions) { pos. x = xOffset; xOffset += stepSize; }

// define points to sample FieldInput points(positions.GetFirst(), directions. GetFirst (), uvws. GetFirst (), sampleCnt, 矩阵 ());

// sample FieldOutput results = fieldList-> SampleListSimple (*plainEffector, points) iferr_return ;

层

The layers stored in the FieldList are accessed through:

• FieldList::GetCount() : Returns the number of fields and groups.
• FieldList::InsertLayer() : Inserts the given layer into the list.
• FieldList::GetLayersRoot() ：返回 GeListHead of the layers.
• FieldList::GetSelected() : Gets a list of all selected layers.
• FieldList::FindByReference() : Gets the layers that match the given FieldLayerLink .

设置

FIELDLIST_FLAGS : are accessed through:

• FieldList::GetFlags() : Returns the flags.
• FieldList::SetFlags() : Sets the flags.
• FieldList::CheckFlag() : Returns true if the given flag is set.

Further functions are:

• FieldList::GetDirty() : Returns the dirty state of the GUI and the host object.
• FieldList::Flush() : Frees the internal memory.
• FieldList::HasContent() : Returns true if the list has any content.

FieldLayer

A FieldLayer represents a certain function or is referencing a FieldObject . To implement custom layers see FieldLayerData Manual .

类型

Existing layer types are:

• FLplugin : FieldLayer 插件。
• FLfolder : Folder.
• FLbase : FieldLayer base.
• FLfield : Field object based layer.
• FLsolid : Solid value/color layer.
• FLdescid : DescID based layer.
• FLnoise : Noise remapping layer.
• FLclamp : Clamping remapping layer.
• FLremap : Between values remapping layer.
• FLcurve : Curve remapping layer.
• FLgradient : 渐变 remapping layer.
• FLquantize : Quantize remapping layer.
• FLinvert : Invert remapping layer.
• FLcolorize : Colorize remapping layer.
• FLrangemap : Colorize remapping layer.
• FLspline : Spline mapping layer.
• FLdelay : Delay layer.
• FLdecay : Decay layer.
• FLstep : Step layer.
• FLweight : Weight layer.
• FLproximity : Proximity layer.
• FLformula : Formula Layer.
• FLtime : Time layer.
• FLpython : Python layer.
• FLmograph : MoGraph layer.
• FLpolygonobject : Polygon object.
• FLvolumeobject : Volume object, see VolumeObject Manual .

Creation

A new layer is created with:

• FieldLayer::Alloc() : Returns a new FieldLayer .
• FieldLayer::Free() : Deletes the given FieldLayer .

The FieldLayer tree can be navigated with:

• FieldLayer::GetUp() : Returns the parent layer.
• FieldLayer::GetDown() : Returns the child layer.
• FieldLayer::GetNext() : Returns the next layer in the list.
• FieldLayer::GetPred() : Returns the previous layer in the list.
• FieldLayer::GetDownLast() : Returns the last layer.

// get FieldList CustomDataType * const customData = data. GetCustomDataType ( CUSTOMDATATYPE_FIELDLIST ); FieldList * const fieldList = static_cast< FieldList * > (customData); if (fieldList == nullptr ) return maxon::UnexpectedError( MAXON_SOURCE_LOCATION );

// create new "Quantize" layer FieldLayer * const layer = FieldLayer::Alloc ( FLquantize ); if (layer == nullptr ) return maxon::OutOfMemoryError( MAXON_SOURCE_LOCATION );

// configure new layer layer-> SetParameter ( FIELDLAYER_QUANTIZE_STEPS , 10, DESCFLAGS_SET::NONE ); layer-> SetStrength (0.5);

// insert layer fieldList-> InsertLayer (layer, nullptr , nullptr ) iferr_return ;

// store data plainEffector->SetParameter(fieldParameterID, data, DESCFLAGS_SET::NONE );

特性

If the layer links to another element in the scene this element can be accessed through:

• FieldLayer::GetLinkedObject() ：返回 FieldLayerLink to the scene element.
• FieldLayer::SetLinkedObject() : Set the reference to the scene element.

The strength of a layer is defined by:

• FieldLayer::GetStrength() : Returns the strength applied to the layer.
• FieldLayer::SetStrength() : Sets the strength applied to the layer.

The blending mode (see flbase.h ) is set/get by:

• FieldLayer::SetBlendingMode() : Sets the current blending mode.
• FieldLayer::GetBlendingMode() : Returns the current blending mode.

The channel flags ( FIELDLAYER_CHANNELFLAG ) are accessed through:

• FieldLayer::GetChannelFlags() : Returns the channel flags.
• FieldLayer::SetChannelFlags() : Sets the channel flags.
• FieldLayer::GetChannelFlag() : Returns true if the given flag is set.
• FieldLayer::SetChannelFlag() : Sets the state of the given flag.

The channel flags are:

• FIELDLAYER_CHANNELFLAG::ENABLE : Layer enabled.
• FIELDLAYER_CHANNELFLAG::VALUE : Value sampling enabled.
• FIELDLAYER_CHANNELFLAG::COLOR : Color sampling enabled.
• FIELDLAYER_CHANNELFLAG::DIRECTION : Slope sampling enabled.

The layer flags ( FIELDLAYER_FLAG ) are set/get by:

• FieldLayer::SetLayerFlags() : Sets the layer flags.
• FieldLayer::GetLayerFlags() : Returns the layer flags.

The layer flags are:

• FIELDLAYER_FLAG::NONE : Default state.
• FIELDLAYER_FLAG::SKIP : Layer calculation is disabled, e.g. the linked object on a standard layer's deform mode is false.
• FIELDLAYER_FLAG::ERRORSKIP : Layer calculation is disabled due to a non critical error in InitializeSampling or as user specified in GetFieldLayerFalgs.
• FIELDLAYER_FLAG::HIDE : Layer should be completely ignored from both calculation and GUI display, e.g. the linked object has been deleted.
• FIELDLAYER_FLAG::MODIFYDATA : The layer modifies existing data and needs the values from layers beneath it in the layer list in the "results" array inside of Sample.
• FIELDLAYER_FLAG::PRESERVEALPHA : The layer does not change the alpha value.
• FIELDLAYER_FLAG::NOCHILDVALUE : Children's layer won't output their value.
• FIELDLAYER_FLAG::NOCHILDCOLOR : Children's layer won't output their color.
• FIELDLAYER_FLAG::NOCHILDDIRECTION : Children's layer won't output their slope.
• FIELDLAYER_FLAG::NOCHILDROTATION : Children's layer won't output their rotation.
• FIELDLAYER_FLAG::TEMPORARY : This layer should not be saved or copied.

Mask layers are handled with:

• FieldLayer::GetMaskHead() ：返回 GeListHead containing the mask layers.
• FieldLayer::AddMask() : Adds a mask.
• FieldLayer::RemoveMask() : Removes the mask.

采样

A layer can directly be sampled by these functions:

• FieldLayer::InitSampling() : Initializes the sampling
• FieldLayer::Sample() : Samples the layer.
• FieldLayer::Aggregate() : Used to call FieldLayerData::Aggregate() .
• FieldLayer::FreeSampling() : Frees internal data after sampling.

FieldListGui

FieldListGui is the custom GUI element to display FieldList data. The GUI ID is CUSTOMGUI_FIELDLIST .

延伸阅读

• MoGraph 概述
• FieldObject Manual
• GeListHead Manual