NAME

ilMirror() − mirror a pipe image about the X or Y axis

SYNOPSIS

ilBool
ilMirror (

ilPipe pipe,

int direction);

DESCRIPTION

ilMirror() adds a filter to the pipe to mirror or reflect the image about the X or Y axis. Mirroring around both axes at once can be accomplished by rotating the image 180 degrees, using ilRotate90(pipe, 2). 

pipe identifies a pipe created by ilCreatePipe(). 

direction specifies one of two ways to mirror the image: IL_MIRRORX mirrors the image vertically about the X axis; the top line becomes the bottom line.  To mirror the image about both axes, use the ilRotate90() to rotate the image 180 degrees.  IL_MIRRORY mirrors the image horizontally about the Y axis; the left column becomes the right column. 

RETURN VALUE

Upon successful completion, ilMirror() returns TRUE. 

ERRORS

If the call fails, context->error receives a non-zero error code. 

EXAMPLE

The following example adds to the pipe, pipe, a filter that mirrors the pipe image about the Y axis. 

ilPipe pipe;
.
.
.

if (!ilMirror (pipe, IL_MIRRORY))   return (pipe->context->error);

AUTHOR

ilMirror() was developed by HP. 

SEE ALSO

ilConvert(3X), ilCreatePipe(3X), ilCrop(3X), ilMirror(3X), ilScale(3X), ilRotate(3X). 

Using the Image Developer’s Kit. 

Hewlett-Packard Company  —  Image Library: February, 1995