Class PointerSurfaceMapping

Namespace: Icy.Input.Devices

Assembly: IcyUI.dll

Maps pointer positions reported against a pointer surface onto the back-buffer viewport, for engine connectors whose pointer surface and presented image differ.

public static class PointerSurfaceMapping

Inheritance: object

PointerSurfaceMapping

Inherited Members: object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

A pointer device may measure positions against its own surface - for a touch screen, the whole touch area - while the game presents its back buffer aspect-fit and centered on that surface: letterboxed (bars above and below) when the surface is taller than the back buffer, pillarboxed (bars left and right) when it is wider. Stride does this in fullscreen when the back buffer keeps its windowed aspect ratio.

The mapping works on normalized positions and aspect ratios only, so the surface size may be in any unit. When the aspect ratios match (e.g. in windowed mode), it reduces to a plain scale.

Methods

ToViewport(Vector2, SizeF, Size)

Converts a normalized pointer position on a pointer surface into back-buffer pixels, assuming the back buffer is presented aspect-fit and centered on that surface.

public static Point ToViewport(Vector2 normalized, SizeF surfaceSize, Size viewportSize)

Parameters

normalized Vector2: The pointer position on the surface, where (0, 0) is the top-left and (1, 1) the bottom-right corner.
surfaceSize SizeF: The pointer surface size, in any unit.
viewportSize Size: The back-buffer size, in physical pixels.

Returns