CollisionManager

November 7, 2023 ยท View on GitHub

from tdw.add_ons.collision_manager import CollisionManager

Manager add-on for all collisions on this frame.


Fields

  • obj_collisions All collisions between two objects that occurred on the frame.

  • env_collisions All collisions between an object and the environment that occurred on the frame.

  • commands These commands will be appended to the commands of the next communicate() call.

  • initialized If True, this module has been initialized.


Functions

__init__

CollisionManager()

CollisionManager(enter=True, stay=False, exit=False, objects=True, environment=True)

ParameterTypeDefaultDescription
enterboolTrueIf True, listen for collision enter events.
stayboolFalseIf True, listen for collision stay events.
exitboolFalseIf True, listen for collision exit events.
objectsboolTrueIf True, listen for collisions between objects.
environmentboolTrueIf True, listen for collisions between an object and the environment.

get_initialization_commands

self.get_initialization_commands()

This function gets called exactly once per add-on. To re-initialize, set self.initialized = False.

Returns: A list of commands that will initialize this add-on.

on_send

self.on_send(resp)

This is called within Controller.communicate(commands) after commands are sent to the build and a response is received.

Use this function to send commands to the build on the next Controller.communicate(commands) call, given the resp response. Any commands in the self.commands list will be sent on the next Controller.communicate(commands) call.

ParameterTypeDefaultDescription
respList[bytes]The response from the build.

before_send

self.before_send(commands)

This is called within Controller.communicate(commands) before sending commands to the build. By default, this function doesn't do anything.

ParameterTypeDefaultDescription
commandsList[dict]The commands that are about to be sent to the build.

get_early_initialization_commands

self.get_early_initialization_commands()

This function gets called exactly once per add-on. To re-initialize, set self.initialized = False.

These commands are added to the list being sent on communicate() before any other commands, including those added by the user and by other add-ons.

Usually, you shouldn't override this function. It is useful for a small number of add-ons, such as loading screens, which should initialize before anything else.

Returns: A list of commands that will initialize this add-on.