c4d.threading.C4DThread¶

class c4d.threading.C4DThread¶

Here you see a very simple example how to create code which runs in another thread.

import c4d

class UserThread(c4d.threading.C4DThread):

    def Main():
        # Put in your code here
        # which you want to run
        # in another thread
        pass


thread = UserThread()
thread.Start()
# Do some other operations here
thread.Wait(True) # Wait until the main method is done

Warning

Ensure that every thread created by C4DThread is closed by the user on exit.

PluginMessage() can be used for that purpose, intercepting C4DPL_ENDACTIVITY message.

See also

Threading Manual for important information about threads.

Methods Signatures

Methods to Override

`C4DThread.Main(self)`	Override with your thread main code.
`C4DThread.TestDBreak(self)`	Override this to add user breaks such as pressing ESC. This function is called by `TestBreak()`.

Methods to Call

`C4DThread.End(self[, wait])`	End the thread.
`C4DThread.Get(self)`	Get the `BaseThread` for this thread.
`C4DThread.IsRunning(self)`	Checks if the thread is running.
`C4DThread.Start(self[, mode, priority])`	Start the thread running.
`C4DThread.TestBreak(self)`	Checks if the thread received a break command to stop processing.
`C4DThread.Wait(self, checkevents)`	Waits until the thread has finished.

Methods Documentation

C4DThread.Main(self)¶: Override with your thread main code.

Note

Remember that a scope might be done even the threaded code is still executed.

In this situation you have to use Wait() to wait until the code is finished or you should create an instance of your thread class into a scope which is longer alive than the code needs to run.

C4DThread.TestDBreak(self)¶

Override this to add user breaks such as pressing ESC. This function is called by TestBreak().

Return type: bool
Returns: True if processing should be terminated, otherwise False.

C4DThread.End(self, wait=True)¶

End the thread.

Note

If the thread does not check for TestBreak() then this function will not return and you will get a deadlock.

Parameters: wait (bool) – This parameter determines if thread termination is synchronous or asynchronous. If True the function will not return until the thread is finished. If False the function returns immediately although the thread will still run until it is finished.

C4DThread.Get(self)¶

Get the BaseThread for this thread.

Return type: c4d.threading.BaseThread
Returns: The BaseThread of this thread.

C4DThread.IsRunning(self)¶

Checks if the thread is running.

Return type: bool
Returns: True if the thread is running, otherwise False.

C4DThread.Start(self, mode=THREADMODE_ASYNC, priority=THREADPRIORITYEX_NORMAL)¶

Start the thread running.

Parameters

mode (int) –
Thread mode:

THREADMODE_DEPRECATED_SYNCHRONOUS

Synchronous thread. Deprecated.

THREADMODE_ASYNC

Asynchronous thread.

THREADMODE_PRIVATE_OPENGL

New in version R18: Private
priority (int) –
Thread priority:

Symbol ID

Description

THREADPRIORITYEX_NORMAL

Normal.

THREADPRIORITYEX_ABOVE

Above.

THREADPRIORITYEX_BELOW

Below.

THREADPRIORITYEX_LOWEST

Lowest.

Return type

bool

Returns

True if the thread was started, otherwise False.

C4DThread.TestBreak(self)¶

Checks if the thread received a break command to stop processing.

Normally this is only True when Cinema 4D is closing, or when End() has been called.

Note

You can add more break conditions, such as if ESC has been pressed, in TestDBreak().

Return type: bool
Returns: True if processing should be terminated, otherwise False.

C4DThread.Wait(self, checkevents)¶

Waits until the thread has finished.

Parameters: checkevents (bool) – If False then wait until the thread has finished. If True then additionally return if a Cinema 4D event occurred.

THREADMODE_DEPRECATED_SYNCHRONOUS	Synchronous thread. Deprecated.
THREADMODE_ASYNC	Asynchronous thread.
THREADMODE_PRIVATE_OPENGL	New in version R18: Private

Symbol ID	Description
THREADPRIORITYEX_NORMAL	Normal.
THREADPRIORITYEX_ABOVE	Above.
THREADPRIORITYEX_BELOW	Below.
THREADPRIORITYEX_LOWEST	Lowest.