Summary

Usage

pdf( image, hash( src,    image_path,
                [ width,  image_width,    ]
                [ height, image_height,   ]
                [ align,  justification,  ]
                [ x,      x_position,     ]
                [ y,      y_position,     ]
                [ dpi,    resolution,     ]
                [ static, flow_properties ] ) )

Parameters

Description

This function makes it possible to insert an image. The image location or image source points to the root directory of the eZ publish installation. The image location is relative to this directory. Currently, the supported image types are "jpg" and "png" without alpha channel.

The width and height of the image can be specified using the "width" and "height" parameters. If these parameters are omitted, the image will be scaled to 100 by 100 dots. The "align" parameter can be used to specify the horizontal position of the image. Possible alignments are "left", "right", and "center" - the default is "left". The "x" and "y" parameter makes it possible to place the image at an exact location. These parameters will override the settings from the image alignment ("align") and float properties ("static").

If the image is too sharp, the dots-per-inch can be decreased using the "dpi" parameter. (It is not possible to make the image sharper than the original.)

The "static" parameter can be used to specify whether the content around the image will float around the image or not. When the "static" parameter is set to TRUE, additional content will not float around and may actually overlap the image.

Examples

Example 1

{pdf( 'text', 'The logo is on the right hand side of this text.'|wash( 'pdf' ) )}
{pdf( 'image', hash( 'src', 'design/mysite/images/company_logo.png',
                     'width', 200,
                     'height', 200,
                     'align', 'right' ) )}

This example displays an image with some text on the left hand side.

Example 2

{pdf( 'image', hash( 'src', $image.full_path, 'width', $image.width, 'height', $image.height ) )}

This example adds the image assigned to the $image variable.