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(const GeListNode* node, const DescID& id, GeData& t_data, DESCFLAGS_GET& flags) const
{
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);
}
PyCompilerFlags * flags
Definition: ast.h:14
Definition: lib_description.h:355
Definition: c4d_gedata.h:83
void SetInt32(Int32 v)
Definition: c4d_gedata.h:645
Represents a C4DAtom that resides in a 4D list.
Definition: c4d_baselist.h:1976
maxon::Bool Bool
Definition: ge_sys_math.h:51
DESCFLAGS_GET
Definition: ge_prepass.h:3354
@ PARAM_GET
Parameter retrieved.
Definition: node.h:10
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(const GeListNode* node, const DescID& id, GeData& t_data, DESCFLAGS_GET& flags) const
{
if (node == nullptr)
return false;
// check parameter ID
switch (id[0].id)
{
case EXAMPLE_TAG_VOLUME:
{
Float volume = 0.0;
GeData data;
const BaseTag* const tag = static_cast<const BaseTag*>(node);
if (tag != nullptr)
{
const 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);
}
Definition: c4d_baseobject.h:248
Definition: c4d_basetag.h:52
const BaseObject * GetObject() const
Definition: c4d_basetag.h:102
Bool GetParameter(const DescID &id, GeData &t_data, DESCFLAGS_GET flags) const
Int32 GetType() const
Definition: c4d_baselist.h:1537
void SetFloat(Float v)
Definition: c4d_gedata.h:639
Float GetFloat() const
Definition: c4d_gedata.h:468
maxon::Float Float
Definition: ge_sys_math.h:62
static constexpr Float64 PI
floating point constant: PI
Definition: apibasemath.h:139
#define Ocylinder
Cylinder.
Definition: ge_prepass.h:1130
#define Osphere
Sphere.
Definition: ge_prepass.h:1120
#define ConstDescID(...)
Definition: lib_description.h:594
struct _node node
@ PRIM_CYLINDER_HEIGHT
Definition: ocylinder.h:13
@ PRIM_CYLINDER_RADIUS
Definition: ocylinder.h:8
@ PRIM_SPHERE_RAD
Definition: osphere.h:6
Represents a level within a DescID.
Definition: lib_description.h:298

Further Reading