libcucul canvas transformation(3caca)

NAME
libcucul canvas transformation -

  Functions
int cucul_invert (cucul_canvas_t *)
Invert a canvas' colours.
int cucul_flip (cucul_canvas_t *)
Flip a canvas horizontally.
int cucul_flop (cucul_canvas_t *)
Flip a canvas vertically.
int cucul_rotate (cucul_canvas_t *)
Rotate a canvas.

Detailed Description

These functions perform horizontal and vertical canvas flipping.

Function Documentation

  int cucul_invert (cucul_canvas_t * cv)

Invert a canvas' colours (black becomes white, red becomes cyan, etc.) without changing the characters in it.

This function never fails.

Parameters:
    cv The canvas to invert.

Returns:
    This function always returns 0.

  int cucul_flip (cucul_canvas_t * cv)

Flip a canvas horizontally, choosing characters that look like the mirrored version wherever possible. Some characters will stay unchanged by the process, but the operation is guaranteed to be involutive: performing it again gives back the original canvas.

This function never fails.

Parameters:
    cv The canvas to flip.

Returns:
    This function always returns 0.

  int cucul_flop (cucul_canvas_t * cv)

Flip a canvas vertically, choosing characters that look like the mirrored version wherever possible. Some characters will stay unchanged by the process, but the operation is guaranteed to be involutive: performing it again gives back the original canvas.

This function never fails.

Parameters:
    cv The canvas to flop.

Returns:
    This function always returns 0.

  int cucul_rotate (cucul_canvas_t * cv)

Apply a 180-degree transformation to a canvas, choosing characters that look like the upside-down version wherever possible. Some characters will stay unchanged by the process, but the operation is guaranteed to be involutive: performing it again gives back the original canvas.

This function never fails.

Parameters:
    cv The canvas to rotate.

Returns:
    This function always returns 0.