PS_PLACE_IMAGE(3)					     Library Functions Manual						 PS_PLACE_IMAGE(3)

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)