PS_PLACE_IMAGE(3)

      uwe@steinmann.cx
UWE STEINMANN 2003-2011Uwe SteinmannMarch 28, 2011;

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.