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.