Input and output

Source pattern

%location

%location.extension

%location[morecharacters].extension

Specify the input image search pattern. Legal inputs for location are camera and workspace—photohack will look for input images in the Camera and Workspace directories respectively. If specified, the extension tells photohack to only look for files with that extension; typical values are .PSD, .TIFF, and .JPG. The morecharacters can be used to tell photohack to look for a file that has those characters added to the filename; for example, %workspace[-update].PSD will look for a file like Workspace/1002c-0019-update.PSD

%-

Clear the source pattern.

The source pattern can be provided as an argument to the following commands: generate, options and variant.

Output format and style

@format

@format+style

Specify the image output format, and optionally, an output decoration style. The specified format will be looked up in the file formats.txt to get the image output size and output processing options. The specified style will be looked up in the configuration file styles.txt to get decorations and borders to put around the generated image.

@-

Clear the output format.

The output format can be provided in the following configuration files: outputs.txt. In this case, only the second format makes any sense, and the style value override any existing style value. It can be provided as an arguments to the following commands: generate, options and variant.

Output size and resolution

6×4in

15x10cm

150x100mm

1800x1200px

Specify the output size of the image, when it is viewed in “landscape” orientation. If in, cm, or mm is specified, then this represents the size of the printed page, and is rotated for “portrait” images. If px is specified then this represents a screen output size and it is not rotated. The final generate image will be sized to fit within the specified dimensions; it will not use up this full area if its aspect ratio does not match that of the output size. (To ensure that the image fits exactly, you will need to also provide an aspect ratio such as [6:4].)

300dpi

Specify the resolution of the output image. This option takes effect only if an output size with dimensions (in, cm, mm) has been specified. The default is 300dpi.

The size and resolution parameters can be provided in the following configuration files: outputs.txt. They can be provided as arguments to the following commands: generate, options and variant.

Output processing

This processing is the final step performed before writing the image.

unsharp=0x3+1+.4

FIXME

quality=95%

FIXME