Bookshelf Contents Previous Next Glossary Index Search

Tips for Cineon files

The following tips apply to Cineon files.

Correcting specific sequences

The Cineon environment variable settings apply to all Cineon image sequences being processed. If you want to apply a different density offset, orientation, or correction to each image sequence, you must set environment variables according to specific sequences.

To specify correction on a sequence-specific basis, first assign:

setenv WF_IMF_CIN_CORRECTION specific
For each sequence, also assign the correction type using the root 
name of the images:
setenv WF_IMF_CIN_CORRECTION_sourceA in 
setenv WF_IMF_CIN_CORRECTION_MyBackgrnd off

For the above settings, the images sourceA.*.cin will be film corrected only on input. If a sequence sourceA.*.cin is also output, it will not be corrected. The sequence MyBackgrnd is not corrected and the values are loaded and processed in logarithmic space. If other Cineon sequences are used without a sequence-specific environment variable being defined, an error is generated when attempting to open the file.

If you define a density offset (WF_IMF_CIN_OFFSET), the offset is applied to all sequences requesting film correction that are not overridden by specific density settings. Continuing the above example:

setenv WF_IMF_CIN_OFFSET -180# global setting

These settings define the density offset as -180 (lower by two stops on input and raise by two stops on output) for all sequences requesting film correction with the exception of sourceA.

Finally, if image rotation for a specific sequence is required, it is specified in a similar way:

setenv WF_IMF_CIN_ORIENTATION_MyBackgrnd off

This controls the rotation of vertical images whose filenames start with MyBackgrnd which are either input or output.

For all other files, the setting of WF_IMF_CIN_ORIENTATION defines the orientation. If WF_IMF_CIN_ORIENTATION is not set, the default is to rotate vertical images on input only. Since orientation is independent of correction, WF_IMF_CIN_CORRECTION need not be set to specific if you just want to use a specific orientation.

Cineon examples

Default mode

If none of the environment variables are set, the defaults are:

Process a single sequence

This example reads a Cineon sequence, converts the data to linear RGB space on input with a density correction, and outputs a Cineon sequence with the same density correction:

Since WF_IMF_CIN_ORIENTATION was not set, the default value (in) is assumed if vertical images are encountered.

Combine two sequences with different density corrections

This example uses two input sequences A.*.cin, B.*.cin, and the output sequence OUT.*.cin. The images of the A sequence are overexposed by two stops, so we must lower their values on input. The values of the B sequence are underexposed half a stop, so we must raise their values.

Since the default density offset is zero, we could have omitted WF_IMF_CIN_OFFSET_OUT, or we could have instead set WF_IMF_CIN_OFFSET to 0.

Combine two sequences and output to vertical orientation

Given the sequences A, B, and OUT from the previous example, and wanting to process both in horizontal orientation and output to vertical orientation, we can simply:

setenv WF_IMF_CIN_ORIENTATION both

Sequences A and B will be rotated if already in vertical format. The result will then be rotated for output, resulting in a vertically oriented output file.

Work exclusively in vertical orientation

If all images are vertical, to save the overhead of image rotation we can simply:

setenv WF_IMF_CIN_ORIENTATION off

This mode will not rotate vertical images on input (allowing them to be processed sideways), and will not rotate them on output.



Bookshelf Contents Previous Next Glossary Index Search

[email protected]
Copyright © 1998, Alias|Wavefront, a division of Silicon Graphics Limited. All rights reserved.