NAME

       PS_place_image — Places image on the page

SYNOPSIS

       #include <pslib.h>

       void PS_place_image(PSDoc *psdoc, int imageid, float x, float y, float scale)

DESCRIPTION

       Places  a  formerly  loaded  image at the current point on the page.  The image is scaled if x and y have
       values unequal to 1.

       The image data is ascii85 encoding which is only 20 percent larger than the raw binary data of the  image
       (The  binary  data  is not equal to the file size but somewhat smaller, because the file also contains an
       image header.). You can turn on hex encoding by setting  the  parameter  `imageencoding'  to  `hex'.  Hex
       encoding doubles the size of the image data.

       Since  version  0.4.5  of pslib images are fully read and saved into the output postscript file when they
       are opened with PS_open_image(3) or PS_open_image_file(3). Later calls of PS_place_image(3)  just  replay
       the  image.   This  behaviour  can  be  turned  off  by  setting the parameter `imagereuse' to false with
       PS_set_parameter(3).

       If image reuse is not turned of, this function may be called within a template.

SEE ALSO

       PS_open_image(3), PS_open_image_file(3)

AUTHOR

       This manual page was written by Uwe Steinmann uwe@steinmann.cx.

                                                                                               PS_PLACE_IMAGE(3)