Hello @bentraje,
Thank you for reaching out to us. Could you elaborate what you mean by description in this context?
For clarification: Description has a reserved meaning in the Cinema 4D API, and I assume you are somewhat aware of that, but at least I cannot connect the dots how you mean that.
All C4DAtom
instances have a description (some are empty though). A description is primarily represented by *.res, *.h
and *.str
files on disk, e.g., this is the resource file for the cube object.
CONTAINER Ocube
{
NAME Ocube;
INCLUDE Obase;
GROUP ID_OBJECTPROPERTIES
{
GROUP
{
VECTOR PRIM_CUBE_LEN { MIN 0 0 0; UNIT METER; CUSTOMGUI SUBDESCRIPTION; }
LONG PRIM_CUBE_SUBX { MIN 1; MAX 1000; CUSTOMGUI LONGSLIDER; STEP 1; MINSLIDER 1; MAXSLIDER 20; }
LONG PRIM_CUBE_SUBY { MIN 1; MAX 1000; CUSTOMGUI LONGSLIDER; STEP 1; MINSLIDER 1; MAXSLIDER 20; }
LONG PRIM_CUBE_SUBZ { MIN 1; MAX 1000; CUSTOMGUI LONGSLIDER; STEP 1; MINSLIDER 1; MAXSLIDER 20; }
SEPARATOR { }
BOOL PRIM_CUBE_SEP { }
BOOL PRIM_CUBE_DOFILLET { }
REAL PRIM_CUBE_FRAD { PARENTID PRIM_CUBE_DOFILLET; MIN 0; UNIT METER; CUSTOMGUI REALSLIDER; STEP 1; MINSLIDER 0; MAXSLIDER 20; }
LONG PRIM_CUBE_SUBF { PARENTID PRIM_CUBE_DOFILLET; MIN 1; MAX 1000; CUSTOMGUI LONGSLIDER; STEP 1; MINSLIDER 1; MAXSLIDER 10; }
}
}
}
In the Python API, descriptions are represented by c4d.Description instances, which are accessible for every atom via C4DAtom.GetDescription
. Such description then contains the content of the files mentioned above. In the Python documentation descriptions are documented, you can find the Ocube
description for example here.
BaseObject.GetRad()
is however not part of descriptions, as this information is simply not stored there. Dcoumented is the base description for all objects, Obase
but this just contains all the entry points for accessing the transform(s) of an object among other things.
So, could you please clarify what you mean? I am not saying that this might not be a reasonable request, I am just struggling a bit with what you want to be done here.
But the bounding box radius of an object cannot be found in its description, and while everything is possible with enough dedication, I do not see the direct benfit of exposing this value as a description parameter.
Cheers,
Ferdinand