win_magnification.types

Aug 11, 2023

Type hints

ColorMatrix

Matrix 5x5 affect color like so:

Red	Green	Blue	Alpha	T
r *= x	g += x*r	b += x*r	a += x*r	0
r += x*g	g *= x	b += x*g	a += x*g	0
r += x*b	g += x*b	b *= x	a += x*b	0
r += x*a	g += x*a	b += x*a	a *= x	0
r += x	g += x	b += x	a += x	1

T is Affine transformation

TransformationMatrix

Describes a transformation matrix that a magnifier control uses to magnify screen content.

The transformation matrix is

T is Affine transformation

N is the magnification factor.

Tip

it’s not mentioned in docs, but I noticed this:

X Offset from left to right 
Y Offset from up to down 
Where (0, 0) is  upper-left corner of magnifier window

SimpleTransform: Tuple of (scale, offset)

scale: (x, y)

offset: (x, y)

Hint

Offset starts from upper-left corner of magnification window

alias of Tuple[Tuple[float, float], Tuple[float, float]]

FullscreenTransform: Tuple of magnification factor and offset for the full-screen magnifier:

magnification factor = 1.0 |=> screen content is not being magnified.

1.0 < magnification factor <= 4096.0 |=> scale factor for magnification.

magnification factor < 1.0 is not valid.

The offset is relative to the upper-left corner of the primary monitor, in unmagnified coordinates.

-262144 <= offset(x, y) <= 262144.

alias of Tuple[float, Tuple[int, int]]

Rectangle

Tuple of ints: ( left, top, right, bottom)

alias of Tuple[int, int, int, int]

InputTransform

Tuple of is_enabled, source and destination:

is_enabled: True if input translation is enabled.
source: The source rectangle, in unmagnified screen coordinates, that defines the area of the screen that is magnified.
destination: The destination rectangle, in screen coordinates, that defines the area of the screen where the magnified screen content is displayed.

Pen and touch input in this rectangle is mapped to the source rectangle.

alias of Tuple[bool, Tuple[int, int, int, int], Tuple[int, int, int, int]]