toio.position module

Utility functions for cube position and cube location.

class toio.position.Point(x: int = 0, y: int = 0)

Bases: object

A point on 2 dimensions

x: int = 0

y: int = 0

static new() → Point

distance(other: Point) → float

flatten()

__init__(x: int = 0, y: int = 0) → None

class toio.position.CubeLocation(point: Point, angle: int = 0)

Bases: object

A Position and angle of a cube on 2 dimensions

point: Point

Point of a cube

angle: int = 0

Angle of a cube (degree)

static from_int(x: int = 0, y: int = 0, angle: int = 0)

static new() → CubeLocation

get_boundary_point(target: CubeLocation) → CubeLocation

Obtains the point where a line passing through two points intersects the coordinate axis in the first quadrant.

flatten()

__init__(point: Point, angle: int = 0) → None

class toio.position.MatRect(top_left: Point, bottom_right: Point, name: str | None = None)

Bases: object

A toio mat

top_left: Point

Top-left point of a mat

bottom_right: Point

Bottom-right point of a mat

name: str | None = None

Mat name

static from_int(x_top_left: int = 0, y_top_left: int = 0, x_bottom_right: int = 0, y_bottom_right: int = 0, name: str | None = None)

static new() → MatRect

center() → Point

__str__() → str

Return str(self).

flatten()

__init__(top_left: Point, bottom_right: Point, name: str | None = None) → None

class toio.position.CoordinateSystemABC(origin: Point = Point(x=0, y=0))

Bases: object

abstract __init__(origin: Point = Point(x=0, y=0))

abstract set_origin(origin: Point) → None

abstract to_native_angle(angle: int | float) → int | float

abstract to_native_x(x: int | float) → int | float

abstract to_native_y(y: int | float) → int | float

abstract from_native_angle(angle: int | float) → int | float

abstract from_native_x(x: int | float) → int | float

abstract from_native_y(y: int | float) → int | float

to_native_point(pos: Point) → Point

to_native_location(location: CubeLocation) → CubeLocation

from_native_point(pos: Point) → Point

from_native_location(location: CubeLocation) → CubeLocation

class toio.position.DefaultCoordinateSystem(origin: Point)

Bases: CoordinateSystemABC

Default coordinate system

No coordinate transformation No angle transformation

__init__(origin: Point)

set_origin(origin: Point) → None

to_native_angle(angle: int | float) → int | float

to_native_x(x: int | float) → int | float

to_native_y(y: int | float) → int | float

from_native_angle(angle: int | float) → int | float

from_native_x(x: int | float) → int | float

from_native_y(y: int | float) → int | float

class toio.position.RelativeCubeLocation(relative_location: CubeLocation, coordinate_system: CoordinateSystemABC)

Bases: object

Location of the cube in the relative coordinate system

relative_location: CubeLocation

Relative location of a cube

coordinate_system: CoordinateSystemABC

Coordinate system

static new() → RelativeCubeLocation

Create new RelativeCubeLocation

Returns:

new relative cube location instance

Return type:

RelativeCubeLocation

to_absolute_point() → Point

Get the point of the cube on the absolute coordinate system

Returns:

Point of the absolute coordinate system

Return type:

Point

to_absolute_location() → CubeLocation

Get the location of the cube on the absolute coordinate system

Returns:

CubeLocation of the absolute coordinate system

Return type:

CubeLocation

from_absolute_point(abs_point: Point) → Point

Set the relative point from the absolute point

Parameters:

abs_point (CubePoint) – Point on the absolute coordinate system

Returns:

Point on the relative coordinate system

Return type:

Point

from_absolute_location(abs_location: CubeLocation) → CubeLocation

Set the relative location from the absolute location

Parameters:

abs_location (CubeLocation) – Location on the absolute coordinate system

Returns:

Location on the relative coordinate system

Return type:

CubeLocation

change_coordinate_system(new_coordinate_system: CoordinateSystemABC) → None

Change the coordinate system The location is updated to the coordinates in the new coordinate system

__init__(relative_location: CubeLocation, coordinate_system: CoordinateSystemABC) → None

class toio.position.ToioMat

Bases: object

Definitions of official toio mats

ToioCollectionMatRing = MatRect(top_left=Point(x=45, y=45), bottom_right=Point(x=455, y=455), name='Toio Collection (ring)')

ToioCollectionMatColoredTiles = MatRect(top_left=Point(x=545, y=45), bottom_right=Point(x=955, y=455), name='Toio Collection (colored tiles)')

PicotonsPlayMatFront = MatRect(top_left=Point(x=59, y=2088), bottom_right=Point(x=437, y=2285), name='Picotons (front)')

PicotonsPlayMatBack = MatRect(top_left=Point(x=59, y=2303), bottom_right=Point(x=437, y=2499), name='Picotons (back)')

PicotonsControlMat = MatRect(top_left=Point(x=764, y=2093), bottom_right=Point(x=953, y=2290), name='Picotons (control)')

PicotonsAutoplayMat = MatRect(top_left=Point(x=554, y=2093), bottom_right=Point(x=742, y=2290), name='Picotons (auto play)')

SimpleMat = MatRect(top_left=Point(x=98, y=142), bottom_right=Point(x=402, y=358), name='Simple mat')

GesundroidMat = MatRect(top_left=Point(x=1050, y=45), bottom_right=Point(x=1460, y=455), name='Gesundroid')

mats = (MatRect(top_left=Point(x=45, y=45), bottom_right=Point(x=455, y=455), name='Toio Collection (ring)'), MatRect(top_left=Point(x=545, y=45), bottom_right=Point(x=955, y=455), name='Toio Collection (colored tiles)'), MatRect(top_left=Point(x=59, y=2088), bottom_right=Point(x=437, y=2285), name='Picotons (front)'), MatRect(top_left=Point(x=59, y=2303), bottom_right=Point(x=437, y=2499), name='Picotons (back)'), MatRect(top_left=Point(x=764, y=2093), bottom_right=Point(x=953, y=2290), name='Picotons (control)'), MatRect(top_left=Point(x=554, y=2093), bottom_right=Point(x=742, y=2290), name='Picotons (auto play)'), MatRect(top_left=Point(x=98, y=142), bottom_right=Point(x=402, y=358), name='Simple mat'), MatRect(top_left=Point(x=1050, y=45), bottom_right=Point(x=1460, y=455), name='Gesundroid'))