---
name: "PS_place_image"
section: "3"
platform: "linux"
package: "pslib-dev"
version: "0.4.8-1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/PS_place_image"
---

# PS\_place\_image(3)

Places image on the page

## 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)](/PS_open_image/3.md)** or  **[PS\_open\_image\_file(3)](/PS_open_image_file/3.md)**. Later calls of  **[PS\_place\_image(3)](/PS_place_image/3.md)** just replay the image.  This behaviour can be turned off by setting the parameter \`imagereuse'  to false with **[PS\_set\_parameter(3)](/PS_set_parameter/3.md)**.

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

## SEE ALSO

[PS\_open\_image(3)](/PS_open_image/3.md), [PS\_open\_image\_file(3)](/PS_open_image_file/3.md)

## AUTHOR

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