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

---

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

// prepare results FieldOutput results; results. Resize (sampleCnt, FIELDSAMPLE_FLAG::VALUE ) iferr_return ; FieldOutputBlock block = results. GetBlock ();

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

// context const FieldInfo info = FieldInfo::Create (caller, points, FIELDSAMPLE_FLAG::VALUE ) iferr_return ;

// shared data FieldShared shared;

// sample the object fieldObject-> InitSampling (info, shared) iferr_return ; fieldObject-> Sample (points, block, info) iferr_return ; fieldObject-> FreeSampling (info, shared);

FieldInfo

A FieldInfo object provides information on the context of the sampling operation.

A FieldInfo object is created with:

• FieldInfo::Create() : Creates a new FieldInfo 对象。
• FieldInfo::CopyFrom() : Copies the data from the given FieldInfo .

Members:

• FieldInfo::_flags : FIELDSAMPLE_FLAG flags.
• FieldInfo::_threadIndex : Index of the current thread.
• FieldInfo::_totalThreadCount : Number of threads.
• FieldInfo::_callerThread : Calling thread.
• FieldInfo::_doc : Calling document.
• FieldInfo::_inputData : FieldInput input data.
• FieldInfo::_callerStack : Calling BaseList2D 对象。

Flags FIELDSAMPLE_FLAG :

• FIELDSAMPLE_FLAG::VALUE : Samples only the value.
• FIELDSAMPLE_FLAG::DIRECTION : Samples only the direction.
• FIELDSAMPLE_FLAG::COLOR : Samples only the color.
• FIELDSAMPLE_FLAG::ALL : Samples all properties.

FieldShared

FieldShared is the object reponsible to share data between fields.

• FieldShared::Flush() : Flushes the data.
• FieldShared::CopyFrom() : Copies the data from the given FieldShared 对象。
• FieldShared::ResetDirty() : Resets the dirty count.

The public members are:

• FieldShared::_finalOutput
• FieldShared::_finalOutputDirty
• FieldShared::_customData : Custom data ( BaseContainer ) to be used.
• FieldShared::_customDataDirty : Dirty state of the custom data.

FieldInput

A FieldInput object defines points in space that should be sampled. Optionally further data like directions or UV-coordinates can be added.

• FieldInput::CopyFromRaw() : Copies the data from the given FieldInput .
• FieldInput::GetSubBlock() : Returns a FieldInput filled with a subset of the original data.

The public members are:

• FieldInput::_position : An array of points.
• FieldInput::_direction : An array of directions.
• FieldInput::_uvw : An array of UVW coordinates.
• FieldInput::_blockCount : The number of elements to be processed.
• FieldInput::_blockOffset : The offset of the elements to be processed.
• FieldInput::_fullArraySize : The size of the source data.
• FieldInput::_transform : Transformation matrix into world space.

FieldOutput

A FieldOutput object stores the data generated by the sampling process.

A FieldOutput can be created with:

• FieldOutput::Alloc() : Creates a new FieldOutput 对象。
• FieldOutput::Free() : Deletes the given FieldOutput 对象。
• FieldOutput::Create() : Creates a new FieldOutput 对象。
• FieldOutput::Resize() : Resizes the object.
• FieldOutput::CopyFrom() : Copies the data from the given FieldOutput 对象。
• FieldOutput::CopyArrayContentFrom() : Copies from the array content from given source.

These functions are provided:

• FieldOutput::GetBlock() ：返回 FieldOutputBlock .
• FieldOutput::GetSubBlock() : Returns a FieldOutputBlock filled with a subset of the data.
• FieldOutput::Flush() : Flushes all data.
• FieldOutput::GetCount() : Returns the number of elements.
• FieldOutput::ClearDeactivated() : Clears the deactivated array.
• FieldOutput::ClearMemory() : Resets the data.
• FieldOutput::CalculateCrc() : Returns a maxon::Crc32C for the internal data.
• FieldOutput::Reset() : Resets the object to an empty state.
• FieldOutput::IsValid() : Returns true if allocations and sizes are valid.

The public members are:

• FieldOutput::_value : An array of weights.
• FieldOutput::_alpha : An array of alpha values.
• FieldOutput::_color : An array of colors.
• FieldOutput::_direction : An array of directions.
• FieldOutput::_deactivated : An array of activation states.
• FieldOutput::_rotation : An array of directions.
• FieldOutput::_pivot : The rotational velocity.

FieldCallerStack

The FieldCallerStack defines the list of BaseList2D objects calling the sampling function. If no object is calling the sampling function, an unique ID (UInt) must be provided.

• FieldCallerStack::FieldCallerStack() : Default constructor.
• FieldCallerStack::Create() : Creates a new FieldCallerStack 对象。
• FieldCallerStack::Add() : Adds a BaseList2D object to the caller stack.
• FieldCallerStack::CopyFrom() : Copies the data of the given FieldCallerStack 对象。

The stack data is accessed with:

• FieldCallerStack::GetCount() : Returns the number of stack elements.
• FieldCallerStack::operator[]() : Accesses the stack at the given index.
• FieldCallerStack::operator const UInt &() : Returns the value of the stack.
• FieldCallerStack::RecalcValue() : Calculates the ID of the caller stack.
• FieldCallerStack::UpdateValue() : Updates the ID of the caller stack.
• FieldCallerStack::GetValue() : Returns the stack ID.
• FieldCallerStack::IsValid() : Returns is true if the stack is not empty.

Public members are:

• FieldCallerStack::_value : Value.
• FieldCallerStack::_callers : Array of BaseList2D 元素。

延伸阅读

• MoGraph 概述
• BaseList2D Manual