The image configuration file syntax

This section describes the various statements in the image configuration file that are relevant to VizPaint2D.

Syntax

clr__default_red_primary

clr__default_green_primary

clr__default_blue_primary

clr__default_white_point

These are used by Advanced Visualizer only, not VizPaint2D.

clr__default_samples

This is used by Advanced Visualizer only, not VizPaint2D.

fb__default

This is used by Advanced Visualizer only, not VizPaint2D.

fmt__aspect_default

This is the default image format selected from the format table defined next. The format defines both the resolution and the aspect ratio of the image.

fmt__aspect_table

This table is used to define various formats in which you may need to create images. The format defines both the resolution and the aspect ratio of the image. Each format is defined by a name, the resolution in both X and Y, and the aspect ratio of the image. You only need to define those resolutions which you anticipate using. For example, a 525-line D1 format might be:

	 ccir_601 720 486 1.3333

These formats are important when reading existing image files. There are three basic means in which the aspect type is deduced from an input image file:

• The format name, ratio, and size are stored explicitly in the image file. Upon reading, all of this information is extracted and returned to VizPaint2D. If the format name is not one that is found in the fmt__aspect_table, Unknown is returned.

  Wavefront .rla and .rlb files are an example of this category. Such images will maintain the correct aspect ratio.

• If the file type stores the aspect ratio and image size, but not the name, VizPaint2D searches the table for an entry with the given aspect ratio and image size. Only table entries whose name begins with the file type identifier (such as "si" for Softimage files) are checked.

  An entry for CCIR-601 resolution Softimage images might look like:

si_ccir_601 720 486 1.333

Note that the name prefix, size, and aspect ratio are checked. If a match is found, that format are returned to VizPaint2D. If no match is found, the name Unknown, along with the extracted aspect ratio and size, are returned. Images of this category will maintain the correct aspect ratio.

• If the file type stores only the size and neither the format name nor aspect ratio is stored, VizPaint2D also searches the format table looking for entries with the size which was extracted from the image file and whose name begins with the file type identifier (such as tdi for TDI image files.)

  An entry for CCIR-601 resolution TDI images might look like:

tdi_ccir_601 720 486 1.333

Note that only the name prefix and size are checked. The first matching entry is returned, and this supplies the aspect ratio used for the image. If no match is found, the name Unknown is returned and square pixels are assumed. 

See fmt__key_default for more information on file types.

fmt__chan_default

This is the default image storage configuration. This should be rgb for VizPaint2D, indicating that the images are stored using their red, green, and blue components. (The matte channel is implicitly stored.)

fmt__dominance

This is not used by VizPaint2D.

fmt__frame_rate

This is not used by VizPaint2D.

fmt__gamma_default

This is the default gamma correction value that is applied to all newly created images. (If this is not specified, 2.2 is used for the default; this is the NTSC standard.)

fmt__gamma_table_res

This is used by Advanced Visualizer only, not VizPaint2D.

fmt__key_default

This specifies the default file type to use when reading and writing image files anywhere in VizPaint2D. The file type specified here is typically a two- or three-character acronym, such as rla for Wavefront .rla image files, als for Alias image files, and si for Softimage .pic image files.

File types that do not have extensions display the identifier in parentheses in the File Type pulldown in the file browser, FileIn, and FileOut panels. For example, the entry for the Softimage type is Softimage (si).

fmt__name_default

This is used by Advanced Visualizer only, not VizPaint2D.

fmt__swatch_size

This is used by Advanced Visualizer only, not VizPaint2D.

framebuffer

This is used by Advanced Visualizer only, not VizPaint2D.

Sample image configuration file

Figure 1 shows a sample image configuration file. It lists many aspect formats, from which you can choose the ones that you are likely to use.

For D1 users, comment out the NTSC 1951 primaries and uncomment the SMPTE 1987 primaries.

Figure 1. Sample .imfrc file (Sheet 1 of 4)

clr__default_samples 3

#

# Define 1951 NTSC Standard Primaries

#

clr__default_red_primary 0.6700 0.3300 0.0000

clr__default_green_primary 0.2100 0.7100 0.0800

clr__default_blue_primary 0.1400 0.0800 0.7800

clr__default_white_point 0.3100 0.3160 0.3740

#

# Define SMPTE RP 145-1987 Standard Primaries

#

#clr__default_red_primary 0.6300 0.3400 0.0300

#clr__default_green_primary 0.3100 0.5950 0.0950

#clr__default_blue_primary 0.1550 0.0700 0.7750

#clr__default_white_point 0.3127 0.3291 0.3582

#

# DEFINE FRAMEBUFFERS

#

fb__default full

framebuffer full

resolution 1280 1024

aspect 1.33

gamma 2.2

red_primary 0.6700 0.3300 0.0000

green_primary 0.2100 0.7100 0.0800

blue_primary 0.1400 0.0800 0.7800

white_point 0.3100 0.3160 0.3740

end_framebuffer

#

# DEFINE FORMATS #

fmt__name_default im fmt__key_default rla

fmt__aspect_default ntsc_4d

fmt__dominance odd

fmt__gamma_table_res 4096

fmt__gamma_default 2.2

fmt__chan_default rgb

fmt__swatch_size none

fmt__frame_rate 30

fmt__aspect_table

# name width height aspect ratio

#

1k_square 1024 1024 1.00

2k_square 2048 2048 1.00

3k_square 072 3072 1.00

4k_square 4096 4096 1.00

5k_square 5120 5120 1.00

6k_square 6144 6144 1.00

7k_square 7168 7168 1.00

8k_square 8192 8192 1.00

A_1280 1280 960 1.33

Creator 640 484 1.33

T1_1024_133 1024 768 1.33

T1_1024_166 1024 617 1.659

T1_1024_175 1024 585 1.75

T1_1024_185 1024 554 1.848

T1_1280_133 1280 960 1.33

T1_1280_166 1280 771 1.66

T1_1280_175 1280 731 1.751

T1_1280_185 1280 692 1.85

T1_512_133 512 384 1.33

T1_512_166 512 308 1.662

T1_512_175 512 293 1.747

T1_512_185 512 277 1.848

T1_640_133 640 480 1.33

T1_640_166 640 386 1.658

T1_640_175 640 366 1.749

T1_640_185 640 346 1.85

T2_1024 1024 871 2.35

T2_1280 1280 1089 2.35

T2_512 512 437 2.35

T2_640 640 545 2.35

T3_1024 1024 436 2.349

T3_1280 1280 545 2.349

T3_512 512 218 2.349

T3_640 640 273 2.344

T4_1024 1024 654 2.35

T4_1280 1280 817 2.35

T4_512 512 327 2.35

T4_640 640 409 2.35

ccir_601 720 486 1.33

ccir_pal 720 576 1.33

full_1024 1024 768 1.33

full_1280 1280 1024 1.33

iris_1400 1022 768 1.33

iris_2400 1024 768 1.33

iris_ntsc 636 484 1.33

iris_pal 768 576 1.33

matrix_2k 2048 1366 1.50

matrix_2k_ntsc 1821 1366 1.33

matrix_4k 4096 2732 1.50

matrix_4k_ntsc 3642 2732 1.33

nps 512 400 1.28

ntsc_4d 646 485 1.33

ntsc_512 512 484 1.33

ntsc_512_fld 512 242 1.33

ntsc_636 636 484 1.33

ntsc_636_fld 636 242 1.33

ntsc_640 640 486 1.33

ntsc_640_fld 640 243 1.33

pal_768 7 68 576 1.33

pal_780 780 576 1.33

pixar 1024 768 1.33

pixar_ntsc 640 486 1.33

pv_2k 2048 1638 1.25

pv_3k 3072 2457 1.25

pv_ntsc 646 486 1.33

pv_pal 768 576 1.33

qnt_pal 720 576 1.33

qtl_ntsc 720 486 1.33

screen 1280 1024 1.25

shiba_soku 1600 1045 1.33

sony_hdtv 1920 1035 1.855

tek_ntsc 720 486 1.33

tek_pal 720 576 1.33

tga_486 512 486 1.33

tga_ntsc 512 482 1.33

vc_ntsc 640 486 1.33

vfr_comp 768 486 1.33

vfr_rgb 720 486 1.33

vst_hires 1024 768 1.33

vst_ntsc 756 486 1.33

vst_pal 738 576 1.33

vst_pal2 740 578 1.33

vst_targa 512 486 1.33

vtc_mvbhm 1440 1200 1.33

vte_720 720 576 1.33

window 1024 820 1.25

end_aspect_table