---
name: "pfsinimgmagick"
section: "1"
platform: "linux"
package: "pfstools"
version: "2.2.0-9"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pfsinimgmagick"
---

# pfsinimgmagick(1)

Load images or frames using ImageMagick++ library

## NAME

pfsinimgmagick - Load images or frames using ImageMagick++ library

## SYNOPSIS

**pfsinimgmagick** (\<file\> \[--linear\] \[--absolute \<max\_lum\>\] \[--frames \<range\>\] \[--skip-missing\])  \[\<file\>...\]

## DESCRIPTION

This command can load images or frames in the multitude of image formats supported by the ImageMagick library. This includes but is not limited to: BMP, JPG, PNG, GIF, EPS, TIFF, DPX. See the manual page of ImageMagick for the full list of available formats.

**pfsinimgmagick** reads images or frames from files and writes *pfs* stream to the Standard Output. The *pfs* stream is usually piped to another program for further processing. To detect the format automatically based on the extension, use *pfsin* command.

The output of **pfsinimgmagick** is scaled to 0-1 range, unless '--absolute' option is specified. By default, the 'LUMINANCE' tag is set to 'DISPLAY' contents. Using the '--linear' switch you can force the inverse sRGB transformation to provide linear data. In this case the 'LUMINANCE' tag is set to 'RELATIVE' contents. '--absolute' switch can be used to convert pixels to absolute luminance values.

This command handles properly 'alpha' channel (transparency) stored in images.

Each file can contain a %d pattern, which is substituted with frame numbers. The pattern has the same syntax as C *printf* command. For example, you can use %04d to make the frame number four digit with proceedings zeros. You can select the frames using the following options (the options must be always given after the file name):

- **--frames \<range\>**

  Range is given in mathlab / octave format:

  **startframe:step:endframe**

  Frame numbers start with **startframe** (default 0), are increased by **step** (default 1) and stop at **endframe** You can skip one of those values, for example *1:100* for frames 1,2,...,100 and *0:2:* for frame 0,2,4,... up to the last file that exists.

- **--skip-missing**

  Skip up to ten frames in a row if corresponding files are missing. Otherwise the program stops reading sequence at the first file that does not exists. This switch does not apply to the first frame in a sequence. This switch can be useful if there is a rendered animation where some of the frame has not been generated.

- **--linear, -l**

  Converts pixel values to linear luminance (XYZ), assuming the sRGB color space for the input image. The maximum pixel value (255,255,255) is mapped to Y=1. *LUMINANCE* tag is set to RELATIVE.

- **--absolute \<max\_lum\>, -a \<max\_lum\>**

  **--absolute** converts pixel values to an absolute linear luminance (XYZ), that is the color space, in which channel Y contains luminance given in cd/m^2. The sRGB color space is assumed for the input image. The maximum pixel value (255,255,255) is mapped to Y=*\<max\_lum\>*. *\<max\_lum\>* is typically set to 80 \[cd/m^2\] for a CRT monitor. *LUMINANCE* tag is set to ABSOLUTE. **--absolute** process images almost the same as **--relative**, but additionally it scales all pixels by *\<max\_lum\>*.

## EXAMPLES

- pfsinimgmagick frame%04d.dpx --frames 0:10 \| pfsview

  Read frames from files frame0000.dpx, frame0001.dpx, ..., frame0010.dpx and show them using pfsview.

## BUGS

pfsinimgmagick can not read frames from the Standard Input.

Please report bugs and comments on implementation to  the discussion group http://groups.google.com/group/pfstools

## SEE ALSO

[**pfsin**(1)](/pfsin/1.md), [**pfsout**(1)](/pfsout/1.md) [**ImageMagick**(1)](/ImageMagick/1.md)