About

NodeData based classic plugin classes can implement NodeData::GetDParameter(). This allows to define the values of parameters accessed with C4DAtom::GetParameter(). This is done to handle data that is not stored in the object's BaseContainer. It is also used to create parameters that depend on the value of other parameters or element properties.

NodeData::GetDParameter() corresponds to C4DAtom::GetParameter().

Note
In most cases, when implementing NodeData::GetDParameter(), one will also need to implement NodeData::SetDParameter(). For example, if the value is stored in a member variable.

Usage

NodeData::GetDParameter() is called when the value of a parameter is accessed with C4DAtom::GetParameter(). It is possible to define or change the returned value.

Bool GetDParameter(GeListNode* node, const DescID& id, GeData& t_data, DESCFLAGS_GET& flags)
{
if (node == nullptr)
return false;
// check parameter ID
switch (id[0].id)
{
// This parameter is not stored in the BaseContainer
case EXAMPLE_GENERATOR_PARAMETER_NOT_BC:
{
// set the value from a member variable
t_data.SetInt32(_value);
// Parameter retrieved.
return true;
}
}
return SUPER::GetDParameter(node, id, t_data, flags);
}
Note
Such member variables must also be handled in NodeData::Read(), NodeData::Write(), NodeData::CopyTo() and NodeData::SetDParameter().

The arguments of the function are:

Certain cases have to be handled with special functions:

Further Examples

// This example of a TagData plugin defines the value of the
// Tag's parameter by calculating the volume of the host object.
Bool GetDParameter(GeListNode* node, const DescID& id, GeData& t_data, DESCFLAGS_GET& flags)
{
if (node == nullptr)
return false;
// check parameter ID
switch (id[0].id)
{
case EXAMPLE_TAG_VOLUME:
{
Float volume = 0.0;
GeData data;
BaseTag* const tag = static_cast<BaseTag*>(node);
if (tag != nullptr)
{
BaseObject* const hostObject = tag->GetObject();
if (hostObject != nullptr)
{
// check the object type
switch (hostObject->GetType())
{
// calculate volume of sphere primitive
case Osphere:
{
const Float radius = data.GetFloat();
volume = (4.0 / 3.0) * maxon::PI * radius * radius * radius;
break;
}
// calculate volume of cylinder primitive
case Ocylinder:
{
const Float radius = data.GetFloat();
const Float height = data.GetFloat();
volume = maxon::PI * radius * radius * height;
break;
}
// etc.
default: break;
}
}
}
t_data.SetFloat(volume);
flags |= DESCFLAGS_GET::PARAM_GET; // don't forget to set this flag
return true;
}
}
return SUPER::GetDParameter(node, id, t_data, flags);
}

Further Reading

PRIM_CYLINDER_HEIGHT
@ PRIM_CYLINDER_HEIGHT
Definition: ocylinder.h:13
BaseObject
Definition: c4d_baseobject.h:220
DescID
Definition: lib_description.h:315
Float
maxon::Float Float
Definition: ge_sys_math.h:51
BaseTag
Definition: c4d_basetag.h:42
Ocylinder
#define Ocylinder
Cylinder.
Definition: ge_prepass.h:1048
maxon::PI
static const Float64 PI
floating point constant: PI
Definition: apibasemath.h:156
DESCFLAGS_GET
DESCFLAGS_GET
Definition: ge_prepass.h:3059
GeListNode
Represents a C4DAtom that resides in a 4D list.
Definition: c4d_baselist.h:1762
Osphere
#define Osphere
Sphere.
Definition: ge_prepass.h:1038
PRIM_SPHERE_RAD
@ PRIM_SPHERE_RAD
Definition: osphere.h:6
GeData::SetFloat
void SetFloat(Float v)
Definition: c4d_gedata.h:545
GeData
Definition: c4d_gedata.h:77
GeData::SetInt32
void SetInt32(Int32 v)
Definition: c4d_gedata.h:551
DESCFLAGS_GET::NONE
@ NONE
None.
BaseTag::GetObject
BaseObject * GetObject(void)
Definition: c4d_basetag.h:91
Bool
maxon::Bool Bool
Definition: ge_sys_math.h:40
DESCFLAGS_GET::PARAM_GET
@ PARAM_GET
Parameter retrieved.
C4DAtom::GetType
Int32 GetType() const
Definition: c4d_baselist.h:1343
PRIM_CYLINDER_RADIUS
@ PRIM_CYLINDER_RADIUS
Definition: ocylinder.h:8
C4DAtom::GetParameter
Bool GetParameter(const DescID &id, GeData &t_data, DESCFLAGS_GET flags)
GeData::GetFloat
Float GetFloat(void) const
Definition: c4d_gedata.h:423