psychos.visual.units.CMUnit#

class psychos.visual.units.CMUnit(window: Window)[source]#

Bases: Unit

Centimeter (cm) unit system.

This unit system converts coordinates and sizes between centimeters and pixels using the screen’s physical dimensions and resolution (DPI).

  • 1 cm corresponds to a specific number of pixels based on the screen’s DPI.

__init__(window: Window)#

Methods

__init__(window)

from_name(name, window)

Instantiate a unit system class by name or return the instance if already provided.

inverse_transform(x, y)

Convert coordinates from pixel values to units.

inverse_transform_size(width, height)

Convert size from pixel values to units.

transform(x, y)

Convert coordinates from units to pixel values.

transform_size(width, height)

Convert size from units to pixel values.

Attributes

pixels_per_cm

Calculate pixels per centimeter based on the current screen DPI.
inverse_transform(x: int, y: int) → Tuple[float, float][source]#

Convert coordinates from pixel values to units.

Parameters:

  • x (int) – The x-coordinate in pixels.

  • y (int) – The y-coordinate in pixels.

Returns:

The coordinates in the unit system.

Return type:

Tuple[float, float]

inverse_transform_size(width: int, height: int) → Tuple[float, float][source]#

Convert size from pixel values to units.

Parameters:

  • width (int) – The width in pixels.

  • height (int) – The height in pixels.

Returns:

The width and height in the unit system.

Return type:

Tuple[float, float]

property pixels_per_cm: float#

Calculate pixels per centimeter based on the current screen DPI.

transform(x: float, y: float) → Tuple[int, int][source]#

Convert coordinates from units to pixel values.

Parameters:

  • x (float) – The x-coordinate.

  • y (float) – The y-coordinate.

Returns:

The pixel coordinates.

Return type:

Tuple[int, int]

transform_size(width: float, height: float) → Tuple[int, int][source]#

Convert size from units to pixel values.

Parameters:

  • width (float) – The width in the unit system.

  • height (float) – The height in the unit system.

Returns:

The width and height in pixel values.

Return type:

Tuple[int, int]