mini_arcade_core.spaces.d2.kinematics2d
=======================================

.. py:module:: mini_arcade_core.spaces.d2.kinematics2d

.. autoapi-nested-parse::

   Kinematic helpers for mini_arcade_core (position + size + velocity).



Classes
-------

.. autoapisummary::

   mini_arcade_core.spaces.d2.kinematics2d.KinematicData


Module Contents
---------------

.. py:class:: KinematicData

   Simple data structure to hold position, size, and velocity.

   :ivar position (Position2D): Top-left position of the object.
   :ivar size (Size2D): Size of the object.
   :ivar velocity (Velocity2D): Velocity of the object.
   :ivar color (Optional[Color]): Optional color for rendering.


   .. py:attribute:: position
      :type:  mini_arcade_core.spaces.geometry.bounds.Position2D


   .. py:attribute:: size
      :type:  mini_arcade_core.spaces.geometry.bounds.Size2D


   .. py:attribute:: velocity
      :type:  mini_arcade_core.spaces.d2.physics2d.Velocity2D


   .. py:attribute:: time_scale
      :type:  float
      :value: 1.0



   .. py:attribute:: collider
      :type:  Optional[mini_arcade_core.spaces.d2.collision2d.Collider2D]
      :value: None



   .. py:method:: rect(x: float, y: float, width: int, height: int, vx: float = 0.0, vy: float = 0.0, time_scale: float = 1.0) -> KinematicData
      :classmethod:


      Convenience factory for rectangular kinematic data.

      :param x: Top-left X position.
      :type x: float

      :param y: Top-left Y position.
      :type y: float

      :param width: Width of the object.
      :type width: int

      :param height: Height of the object.
      :type height: int

      :param vx: Velocity in the X direction.
      :type vx: float

      :param vy: Velocity in the Y direction.
      :type vy: float

      :return: KinematicData instance with the specified parameters.
      :rtype: KinematicData