Component¶

Description¶

Base class for all components attached to GameObjects.

description

Component is the base class for all built-in C++ components in InfEngine, including Transform, Camera, Light, and MeshRenderer. Components are attached to a GameObject and provide specific functionality.

You do not instantiate Component directly. Instead, use GameObject.add_component() to attach a built-in component by its type name. Every Component holds a reference back to its owning game_object and its transform, giving convenient access to the object hierarchy.

For custom gameplay logic written in Python, derive from InfComponent rather than Component. InfComponent extends Component with lifecycle callbacks such as start(), update(), and event methods.

Properties¶

properties

Public Methods¶

public_methods

Example¶

example

from InfEngine import InfComponent

class ComponentQuery(InfComponent):
    def start(self):
        # Every component can access its owning GameObject
        owner = self.game_object
        print(f"Attached to: {owner.name}")

        # Access the Transform through the component shortcut
        pos = self.transform.position
        print(f"Position: {pos}")

        # Get a sibling C++ component
        renderer = owner.get_cpp_component("MeshRenderer")
        if renderer:
            print("MeshRenderer found")

        # List all components on this object
        for comp in owner.get_components():
            print(f"Component: {type(comp).__name__}")

See Also¶

see_also

• GameObject
• Transform
• InfComponent