c4d.HandleInfo

class c4d.HandleInfo

Attributes

HandleInfo.position

The current handle position.

Type: Vector

HandleInfo.direction

The normal used for the handle travel. For linear handle constraints it is the line on which a handle can travel. For planar and radial constraints it is the normal of the plane/disc. Otherwise it is not needed.

Type: Vector

HandleInfo.center

Handle constraint center, for radial and spherical handle constraints.

Type: Vector

HandleInfo.radius

Handle constraint radius, for radial and spherical handle constraints.

Type: float

HandleInfo.type

Handle constraint type. One of these types:

HANDLECONSTRAINTTYPE_INVALID Invalid handle constraint type, used to temporarily ignore handles (e.g. in the Camera Object with the Front/Back DOF handles).
HANDLECONSTRAINTTYPE_LINEAR Linear handle constraint.
HANDLECONSTRAINTTYPE_PLANAR Planar handle constraint.
HANDLECONSTRAINTTYPE_FREE No constraint.
HANDLECONSTRAINTTYPE_RADIAL Radial handle constraint.
HANDLECONSTRAINTTYPE_SPHERICAL Spherical handle constraint.

Methods Signatures

HandleInfo.__init__(self) Constructor.
HandleInfo.CalculateNewPosition(self, bd, mg, mouse_pos) Calculates a handle position for a given mouse position.

Methods Documentation

HandleInfo.__init__(self)

Constructor.

HandleInfo.CalculateNewPosition(self, bd, mg, mouse_pos)

Calculates a handle position for a given mouse position.

Parameters:
  • bd (c4d.BaseDraw) – The active viewport.
  • mg (c4d.Matrix) – The global matrix of the handle’s parent object.
  • mouse_pos (c4d.Vector) – The mouse coordinates for which to calculate the handle position.
Return type:

c4d.Vector

Returns:

The new handle position.