Core Command Line
From IRIDAS Online Documentation
Contents |
Overview
The basic command line syntax is identical for all IRIDAS applications. To get an overview of the specifics for each product, please see the Command Line Overview page.
The Anatomy of a Command
The core command line for all IRIDAS products consists of two parts:
[SequenceName] [Range/Offset Options]
For Example
FrameCycler C:\footage\frame#.dpx 1-100 –sC:\footage\test.aiff
The SequenceName is the fully qualified path to a frame in the sequence – or an abbreviated name such as seq#.tga. The application automatically detects all frames in a sequence and treats it as a whole.
Range refers to the number of frames which will be affected by the command. It is specified as FirstFrame-Lastframe. For example 10-100 will affect the sequence from frame 10 through to frame 100.
Note: If you specify just one number, the application will interpret this as the first frame and the command will affect the rest of the sequence from that point on.
If you specify a range that extends beyond the actual number of frames, or if frames are missing, you will see the “failed to decode frame” image displayed as a placeholder for these frames.
To reverse a clip, simply specify a reverse range:
FrameCycler C:\footage\frame#.dpx 100-1
An Offset can also be specified using -o followed by a positive or negative number denoting the desired frame offset. The frames will be moved in the time line by the specified offset. Negative offsets cut the specified number of frames from the beginning of the sequence.
Options refers to any number of commands (see the list at the end of this document).
Examples
Playback
Playback of sequence source: #.iff
MetaRender Source.#.iff
A/B Channels
Playback of sequence in A/B channels
FrameCycler A[ SourceA.#.iff ]A B[ SourceB.#.iff ]B
Resample and Crop
To resample a sequence you enter the command -r and then input the changes to the current resolution (horizontal followed by vertical with a space in between). For example, resampling to 50% would be
MetaRender Source.mov -r 50% 50%
Resampling to 640 x 480 is
FrameCycler Source.#.cin -r 640 480
Crop, resample, and playback sequence:
MetaRender Source#.iff -c10% 10% 80% 80% -r1024 768
Queing
Queue 3 sequences specifying frame ranges:
FrameCycler Q[ A#.pic 5-300 ]Q Q[ B#.tga 400-410 ]Q Q[ B#.tga 10-20 ]Q
Queue 2 sequences specifying offset and frame range:
FrameCycler Q[ A#.pic -o -500 ]Q Q[ B#.tga 400-410 ]Q
Quick Compositing Layers
IRIDAS products can create “quick composites” using the alpha channel of each sequence. To specify quick compositing layers, use the following syntax:
L[ SequenceBottom Range/Offset ]L L[ SequenceTop Range/Offset ]L
Note: Leave a space between each command and on the inside of each square bracket.
The last frame sequence specified (SequenceTop) will be superimposed over SequenceBottom.
You can specify multiple layers using the L command. The first one named will always appear at the bottom of the stack, subsequent layers appearing in order above it.
Note: Load times will increase when using the layering features because more than one frame needs to be loaded from disk. Cached playback times will not be affected.
Combining A/B Channels with Quick Compositing
A/B channels and Quick Compositing can be combined as this example shows:
A[ seq#.iff ]A B[ L[ seq#.iff ]L L[ fore#.pic -o -10 ]L L[ char#.tga 50-100 ]L ]B
Note: The spaces between the A[ ]A and B[ ]B identifiers are required.
In this example the A channel is loaded with the seq#.iff sequence.
The B channel is loaded with the same sequence as a background and the foreground layer (fore#.pic) is superimposed over it. The first ten frames of the fore#.pic sequence are skipped and frames 50 through 100 of the char#.tga sequence are superimposed over both of these layers.
Available Commands
Crop (-c)
Crop by specifying the top left point and the width and height of the crop area:
-c5 200 320 240
This example specifies a crop area that starts at 5/200 and stretches over an area of 320 x 240 pixels.
Crop by specifying top left point and bottom right point of the crop area:
-c100 100 R100 B100
By prefixing the last two values with R and B respectively, you can indicate that the values specify the Right and Bottom coordinates of the crop area. The above example crops a border of 100 pixels on each side of the frame.
You can also specify percentages instead of pixel values:
-c20% 15% 50% 80%
This would specify a crop area that start at 20% from the right side of the image and 15% from the top border. The width of the crop area is 50% of the original width and the height is 80% of the original height.
Resample (-r)
You can resample your sequence to a different resolution by specifying “-r.” For example
-r320 240
This resamples the current sequence to 320 x 240 resolution. The following example resamples both horizontally and vertically to 50% of the previous resolution.
-r50% 50%
You can also specify partial values:
-r90%
This resamples the width to 90% of the previous value and leaves the height unchanged.
If you want to change the aspect ratio of a sequence you can do so by giving appropriate percentages
-r90% 100%
This changes the aspect ratio of the image to 0.9 : 1.0
.looks and LUTs (-lut)
To specify a .look or a Look Up Table use the “-lut” option
-lut Cineon.lut
If no -lut parameter is specified, the application does not use a .look or look up table.
The parameter specified after -lut can be either the file name, in which case the program looks for that file in the LUTs folder(s), or an absolute path to the LUT file.
Depending on where -lut is used, it has the following functions:
- after a sequence name / inside a Q[ ]Q block the LUT is applied as a base LUT in the grading for the resulting clip
- before the first sequence, inside A[ ]A, but outside any Q[ ]Q or L[ ]L blocks, or if no Q/L blocks are used, before the sequence in the A[ ]A block: the LUT is applied as a base LUT in the global grading for the resulting timeline
- if used together with an IRCP file has the same function as -calibration
Calibration LUT (-calibration)
The parameter specified after -calibration can be either the file name, in which case the program looks for that file in the LUTs folder(s), or an absolute path to the LUT file.
- When used with normal sequences/
- quick comp., this option sets the calibration LUT of the current timeline (e.g. different LUTs can be specified in A[ ]A and B[ ]B)
- when used with an IRCP file this parameter replaces the calibration LUTs of all timelines in that IRCP file with this LUT
- when -calibration is used in MetaRender, the added LUT is rendered (normal calibration LUTs specified inside of IRCPs are not rendered)