Crate cuadra 

Layout

Several primitives are defined for Position, Size and their combination as a Zone.

Types have 8, 16, 32 and 64 bit sizes implementations, and they are limited to values of just half the range of an equivalent bit-size signed integer, leaving 1/4th of the range for positive values.

Positions can have negative values, while Sizes can only be positive.

For example, a Position8 can hold values between -64,-64 and 63,63, while a Size16 can have values of between 1,1 and 16_383,16_383.

The non-negative range from 0 to the clamped maximum is always 1/4th of the primitive’s maximum. This allows to have a safety margin around which allows to move the biggest size to the furthest position, and still be able to represent all its points with the same inner bit-size.

The following diagram shows the example range of values of a Position8, around the inner centered square, with the outer safety margin around it, and the maximum positive clamped size filled with +.

      -128,127       0,127     127,127
          .-----|-----|-----|-----·
          |                       |
          |  -64,63       63,63   |
          |     .-----------.     --
          |     |     |+++++|     |
          |     |     |+++++|     |
  -128,0 --     |----0,0----|     -- 127,0
          |     |     |     |     |
          |     |     |     |     |
          |     .-----------.     --
          |  -64,-64      63,-64  |
          |                       |
          .-----|-----|-----|-----.
      -128,-128      0,-128    127,-128

Structs

Clamper8

Clamps a distance to half the range of an i8.

Clamper16

Clamps a distance to half the range of an i16.

Clamper32

Clamps a distance to half the range of an i32.

Clamper64

Clamps a distance to half the range of an i64.

Position8

A 2D position using a clamped i8.

Position16

A 2D position using a clamped i16.

Position32

A 2D position using a clamped i32.

Position64

A 2D position using a clamped i64.

Size8

A 2D size using a positive clamped i8.

Size16

A 2D size using a positive clamped i16.

Size32

A 2D size using a positive clamped i32.

Size64

A 2D size using a positive clamped i64.

Zone8

A 2D zone combines a Position8 with a Size8.

Zone16

A 2D zone combines a Position16 with a Size16.

Zone32

A 2D zone combines a Position32 with a Size32.

Zone64

A 2D zone combines a Position64 with a Size64.