psychos.visual.units.NormalizedUnits#

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

Bases: Unit

A unit system that normalizes coordinates and sizes with respect to the window dimensions.

In this normalized system: - (1, 1) represents the top-right corner of the window. - (-1, -1) represents the bottom-left corner of the window. - (0, 0) represents the center of the window. - (-1, 1) represents the top-left corner of the window. - (1, -1) represents the bottom-right corner of the window.

__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.
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]

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]