NAME

placeholder - generate placeholder images

SYNOPSIS

placeholder [-b col] [-l col] [-t col] [-f font] [-x pixels] [-y pixels] [size] [text]

placeholder [--long-options ...] [size] [text]

DESCRIPTION

placeholder generates a PNG which can be used as a placeholder, most commonly when designing a document or website which will accept images with fixed dimensions, but that imagery is not yet available.

OPTIONS

-b colour, --background_colour=colour

The colour that the background of the image should be painted. Accepts a colour value (see "Valid colour values"). Defaults to ddd.

-f font, --font font

The font to use for the text in the image. Requires fontconfig support in your GD library. Defaults to Museo Sans, which is available free from http://www.josbuivenga.demon.nl/museosans.html.

-l colour, --line_colour=colour

The colour that the border and cross lines should be painted in. Accepts either a colour value or none to suppress them. Defaults to 444.

-t colour, --text_colour=colour

The colour that the text should be painted in. Accepts either a colour value or none to suppress the text. Defaults to 36f.

-a, --transparent

Makes the background transparent.

-x pixels, --width=pixels

The width of the image in pixels. Defaults to 300.

-y pixels, --height=pixels

The height of the image in pixels. Defaults to the same value as the width.

size

A text alternative to supplying the width and height separately; of the form '300x250'.

text

The text to use across the image. Defaults to the size of the image, expressed in the form '300x250'.

Valid colour values

Colour values are specified as the red, green and blue channels in hexadecimal, where 00 is the least and FF is the most. So black is 000000 and white is FFFFFF.

CSS-style 3-character shorthand is also accepted where the three channels are repeating characters. So black is also 000 and white FFF. All three values have to be repeating, so a value such as 080808 cannot be shorted.

SEE ALSO

perldoc Image::Placeholder

perl module that this script uses

http://ima.gs/

hosted version of this code

AUTHOR

Mark Norman Francis, norm@cackhanded.net.

COPYRIGHT AND LICENCE

Copyright 2010 Mark Norman Francis.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.