c4d.plugins.BaseDrawHelp¶

class c4d.plugins.BaseDrawHelp¶: Contains useful data for drawing objects into a BaseDraw view.

Methods Signatures

BaseDrawHelp.__init__()

Create a new help object for base draw bd.

`BaseDrawHelp.GetDocument()`	Returns the relevant document for the current draw operation, i.e. the currently active document. Never returns None.
`BaseDrawHelp.GetActiveTag()`	Returns the currently active tag, or None if no tag is active (similar to `BaseDocument.GetActiveTag()` but more efficient since the active tag is cached).
`BaseDrawHelp.GetMg()`	Returns the global matrix of the object to be drawn (similar to `BaseObject.GetMg()` but more efficient since the matrix is cached).
`BaseDrawHelp.SetMg()`	Sets the matrix returned by `GetMg()`.
`BaseDrawHelp.GetDisplay()`	Retrieves a container with the display mode for the object to be drawn. See Tdisplay.h for values.
`BaseDrawHelp.SetDisplay()`	Sets the display mode for the object to be drawn. See Tdisplay.h for values.
`BaseDrawHelp.GetViewSchedulerFlags()`	Returns the flags which have been passed to `DrawViews()`.
`BaseDrawHelp.IsActive()`	Checks if the current object is active.
`BaseDrawHelp.IsHighlight()`	Checks if the current object is highlighted (i.e. when the user has moved the mouse over it).

Methods Documentation

BaseDrawHelp.__init__(self, bd, doc)¶

Create a new help object for base draw bd.

Parameters

bd (c4d.BaseDraw) – The base draw the BaseDrawHelp is assigned to.
doc (c4d.documents.BaseDocument) – The document of the base draw bd.

BaseDrawHelp.GetDocument(self)¶

Returns the relevant document for the current draw operation, i.e. the currently active document. Never returns None.

Return type: c4d.documents.BaseDocument
Returns: The relevant document.

BaseDrawHelp.GetActiveTag(self)¶

Returns the currently active tag, or None if no tag is active (similar to BaseDocument.GetActiveTag() but more efficient since the active tag is cached).

Return type: Optional[c4d.BaseTag]
Returns: The active tag.

BaseDrawHelp.GetMg(self)¶

Returns the global matrix of the object to be drawn (similar to BaseObject.GetMg() but more efficient since the matrix is cached).

Return type: c4d.Matrix
Returns: The global matrix.

BaseDrawHelp.SetMg(self, mg)¶

Sets the matrix returned by GetMg().

Parameters: mg (c4d.Matrix) – New matrix.

BaseDrawHelp.GetDisplay(self)¶

Retrieves a container with the display mode for the object to be drawn. See Tdisplay.h for values.

Return type: c4d.BaseContainer
Returns: The display mode container.

BaseDrawHelp.SetDisplay(self, bc)¶

Sets the display mode for the object to be drawn. See Tdisplay.h for values.

New in version R19.

Parameters: bc (c4d.BaseContainer) – The new display mode container.

BaseDrawHelp.GetViewSchedulerFlags(self)¶

Returns the flags which have been passed to DrawViews().

Return type

int

Returns

Flags:

DRAWFLAGS_NONE	None.
DRAWFLAGS_NO_THREAD	Synchronous call.
DRAWFLAGS_NO_ANIMATION	Ignore all animation.
DRAWFLAGS_ONLY_ACTIVE_VIEW	Only redraw the active view.
DRAWFLAGS_NO_EXPRESSIONS	Ignore expressions.
DRAWFLAGS_INDRAG	In drag.
DRAWFLAGS_NO_HIGHLIGHT_PLANE	The entire view is drawn, not just the highlight plane.
DRAWFLAGS_FORCEFULLREDRAW	Force full redraw.
DRAWFLAGS_ONLY_CAMERAEXPRESSION	Camera expression.
DRAWFLAGS_INMOVE	In move.
DRAWFLAGS_ONLY_BASEDRAW	Draw specific base draw only.
DRAWFLAGS_ONLY_HIGHLIGHT	Only highlights.
DRAWFLAGS_STATICBREAK	If the display is done in the main thread (Cinema 4D only does this during animation playback) this allows that a special thread is used that polls the escape key. Note: Use only in combination with DRAWFLAGS_NO_THREAD.
DRAWFLAGS_PRIVATE_NO_WAIT_GL_FINISHED	Private.
DRAWFLAGS_PRIVATE_ONLYBACKGROUND	Private.
DRAWFLAGS_PRIVATE_NOBLIT	Private.
DRAWFLAGS_PRIVATE_OPENGLHACK	Private.
DRAWFLAGS_PRIVATE_ONLY_PREPARE	Private.
DRAWFLAGS_PRIVATE_NO_DCLIPPING	Private.
DRAWFLAGS_NO_PRESENT	New in version S24: \| Prevents the drawport from swapping buffers.. \| Use only in combination with DRAWFLAGS_NO_THREAD.

BaseDrawHelp.IsActive(self)¶

Checks if the current object is active.

New in version R14.014.

Return type: bool
Returns: True if the current object is active.

BaseDrawHelp.IsHighlight(self)¶

Checks if the current object is highlighted (i.e. when the user has moved the mouse over it).

New in version R14.014.

Return type: bool
Returns: True if the current object is highlighted.