Home Screenshots Documentation Credits Legal

The djv_convert application is a command line tool for batch processing images and movies. Common uses include resizing images and converting sequences of images to a QuickTime movie.

Here is an example of how to resize a sequence of images:

> djv_convert input.1-100.tga output.1.tga -resize 2048 1556

Note that only the first frame of the output sequence needs to be specified, the remaining frames will be added automatically. See below for more examples.

Note also that the djv_convert application uses OpenGL for image processing so it needs to be run on a machine with graphics resources.

Command Line

Usage:

djv_convert (input) (output) [option]...
inputInput image, image sequence, or movie
outputOutput image, image sequence, or movie
optionAdditional options (see below)

Conversion options:

-mirror_hMirror the image horizontally.
-mirror_vMirror the image vertically.
-scale (value)Scale the image width and height using a floating point value (1.0 = 100%).
-scale_separate (width) (height)Scale the image width and height separately using a floating point value (1.0 = 100%).
-resize (width) (height)Resize the image width and height to the given resolution.
-width (value)Resize the image width to the given resolution maintaining the aspect ratio.
-height (value)Resize the image height to the given resolution maintaining the aspect ratio.
-crop (x) (y) (width) (height)Crop the image.
-crop_percent (x) (y) (width) (height)Crop the image using floating point values (1.0 = 100%).
-channel (value)Show only specific image channels. Options = Default, Red, Green, Blue, Alpha. Default = Default.
-seq (value)Set whether file sequencing is enabled. Options = False, True. Default = True.

Input options:

-layer (value)Set the input layer.
-proxy (value)Set the proxy scale. Options = None, 1/2, 1/4, 1/8. Default = None.
-time (start) (end)Set the start and end time.
-slate (input) (frames)Set the slate.
-timeout (value)Set the maximum number of seconds to wait for each input frame. Default = 0.

Output options:

-pixel (value)Convert the pixel type. Options = L U8, L U16, L F16, L F32, LA U8, LA U16, LA F16, LA F32, RGB U8, RGB U10, RGB U16, RGB F16, RGB F32, RGBA U8, RGBA U16, RGBA F16, RGBA F32.
-speed (value)Set the speed. Options = 1, 3, 6, 12, 15, 16, 18, 23.98, 24, 25, 29.97, 30, 50, 59.94, 60, 120.
-tag (name) (value)Set an image tag.
-tag_auto (value)Automatically generate image tags (e.g., timecode). Options = False, True. Default = True.

Documentation for image I/O command line options is available here.

Documentation for general command line options is available here.

Examples

Convert an image:

> djv_convert input.sgi output.tga

Convert an image sequence. Note that only the first frame of the output sequence needs to be specified, the remaining frames will be added automatically:

> djv_convert input.1-100.sgi output.1.tga

Create an RLE compressed image sequence:

> djv_convert input.1-100.sgi output.1.tga -targa_compression RLE

Convert an image sequence to a movie:

> djv_convert input.0001-0100.dpx output.m4v

Convert a movie to an image sequence:

> djv_convert input.m4v output.1.tga

Convert the pixel type. Note the use of the quotes around the pixel type option:

> djv_convert input.sgi output.sgi -pixel "RGB U16"

Scale an image by half:

> djv_convert input.tga output.tga -scale 0.5

Resize an image:

> djv_convert input.tga output.tga -resize 2048 1556

Convert a Cineon file to a linear format using the default settings:

> djv_convert input.cin output.tga

Convert a Cineon file to a linear format using custom print settings (black point, white point, gamma, and soft clip):

> djv_convert input.cin output.tga -cineon_input_film_print 95 685 2.2 2