6.4.10. FORMAT OF INITIALIZATION FILES

next, previous Section / Table of Contents / Index Running BALSAC requires an initialization file with its name provided on the command line or defaulted to 'balsac2.ini', see Sec. 6.1. This file is loaded at the beginning of each session or with the basic parameter option and contains basic parameter values used to initialize graphics windows, colors, and shading. All parameters are described in detail in Sec. 5.4 and may be changed interactively using the parameter option menu, see Sec. 6.2.15. The file is defined by 5 Cards given as follows: Card 1. (4I5,F10.4,I10,6I5) LOWINX,LOWINY,LWINX,LWINY,QYX,MXRGB,NCOLB, NTONE,INTRPT,NCOLMX,LXCH,LYCH LOWINX,LOWINY := Absolute pixel position of the upper left corner of the graphics window. These parameters allow you to reposition the graphics window (Unix/X.11 version) but are ignored in the DOS/VGA version of BALSAC. Default values are (230, 0) to avoid overlap with the menu window at (0, 0). LWINX,LWINY := Size of the graphics window in pixels. Default values are (640, 480) for both DOS/VGA and Unix/X.11 versions. QYX := Pixel ratio y/x. This defines the ratio of numbers of pixels corresponding to the same length in y (up-down) and x (left-right) direction on the screen. QYX can be used to adjust graphic distortions on monitors of different screen size. The default value (1.00) assumes square shaped pixels. MXRGB := Maximum of allowed RGB values used to rescale basic colors, see below. This parameter depends on the type of graphics adapter where default values rgb = 63 (DOS/VGA version), = 65535 (Unix/X.11 version) are meaningful. NCOLB := Total number of paint colors defined below, see Sec. 5.4. Default values are ncolb = 4 (DOS/VGA), = 16 (Unix/X.11 version) respectively. NTONE := Number of tones (nsh tones, see Sec. 5.4) to be generated for each paint color. The total number of different tones defined inside BALSAC, nsh*ncolb, may not exceed 12 (DOS/VGA version) or 240 (Unix/X.11 version). Default values are nsh = 3 (DOS/VGA), = 15 (Unix/X.11 version) respectively. INTRPT := Interrupt code of the graphics mode used in the DOS/VGA version of BALSAC, see below. In the Unix/X.11 version this parameter is ignored. NCOLMX := Maximum number of different colors allowed by different graphics modes and adapters, see below. LXCH,LYCH := Numbers of pixels per character along x and y used in the DOS/VGA version of BALSAC, see below. In the Unix/X.11 version this parameter is ignored. With the DOS version of BALSAC different graphics modes and resolutions are available depending on the graphics adapter. The parameters INTRPT, LWINX, LWINY, NCOLMX, LXCH, LYCH are dependent and may lead to unpredictable results if set without consideration. The following table gives standard values for the most common modes which have been found to work with typical VGA adapters. ----------------------------------------------------------- mode INTRPT LWINX, LWINY NCOLMX LXCH, LYCH ----------------------------------------------------------- CGA 14 640, 200 16 8, 8 EGA 16 640, 350 16 8, 14 VGA 18 640, 480 16 8, 16 ----------------------------------------------------------- Apart from these standard settings graphics modes with higher resolution and larger color palettes may be available with enhanced VGA adapters but are not officially supported by BALSAC. For appropriate interrupt settings consult your adapter manual. Note that some enhanced graphics modes may require special mouse drivers for mouse use in the graphic analysis. The Unix/X.11 version of BALSAC does not use different graphics modes and definitions of INTRPT, NCOLMX, LXCH, LYCH are ignored. Card 2. (7F10.4) QDIFF,QLAMB,QSPEC,THTSH,PHISH,PU,DEYE QDIFF,QLAM,QSPEC := Shading weights for diffuse background (qdiff), Lambert shading (qlamb), and specular reflection (qspec). These weights determine the relative amounts of the shading contributions where qdiff+qlamb+qspec=1, see Sec. 5.4. Default values are qdiff = 0.1, qlamb = 0.35, qspec = 0.55. THTSH, PHISH := Direction of the incident light (polar angle thtsh, azimuthal angle phish) used for ball shading. Default values are thtsh = 50, phish = -35 degrees, see Sec. 5.4. PU := Eye distance factor used in red/blue and full color stereo mode. Default is pu = 0.3, see Sec. 6.2.15. Larger pu values reduce the stereo impression. DEYE := Distance between the centers of the two pictures in full color stereo mode (given in pixels). Positive values result in left/right eye positioned pictures (use optical stereo glasses). Negative values result in a reversed picture order (stereo view by cross-eyed viewing). The default setting is shift = -lwinx/2 = 320, see Sec. 6.2.15. Card 3. (24I3) NPTOT,(NP(I),I=1,NPTOT) NPTOT := Number of entries, nptot, of the color palette which determines the sequence of paint colors used to paint atoms differently according to element or layer. The palette size nptot must not exceed 32. NP(I) := entries np(i), i=1,...nptot defining the color palette. Each entry np(i) points at a paint color j (np(i) = j) within the range [1,ncolb]. The natural sequence np(i) = i (default definition) uses paint colors in the sequence given by the paint color definition on Cards 5. The color palette can redefined interactively with the basic parameter option, see Sec. 6.2.15, and with the graphic analysis, see Secs. 6.2.14.2, 6.3.12.2. Cards 4. (15I5/9I5,A30) ((IBRGB(I,J),I=1,3),J=1,8),FONTNM IBRGB(I,J) := RGB definitions of the elementary colors used by BALSAC with IBRGB(1-3,1) := R, G, B values of color "black" IBRGB(1-3,2) := R, G, B values of color "white" IBRGB(1-3,3) := R, G, B values of background color IBRGB(1-3,4) := R, G, B values of graphics text color IBRGB(1-3,5) := R, G, B values of default link color IBRGB(1-3,6) := R, G, B values of stereo red color IBRGB(1-3,7) := R, G, B values of stereo blue color IBRGB(1-3,8) := R, G, B values of stereo white color The DOS/VGA version of BALSAC uses only color definitions IBRGB(1-3,1), IBRGB(1-3,2), IBRGB(1-3,6), IBRGB(1-3,7) and sets IBRGB(1-3,3)= IBRGB(1-3,1), IBRGB(1-3,4)= IBRGB(1-3,1), IBRGB(1-3,5)= IBRGB(1-3,2), IBRGB(1-3,8)= IBRGB(1-3,2). FONTNM := Font name for text output inside X.11 graphics windows (used only with Unix/X.11 version, ignored in DOS/VGA version). Valid names follow the X.11 Windows standard and depend also on the output device. Examples are "8x13bold", "courb10" (typed without ""). Card(s) 5. (3I5,5F10.4) ((IRGB(I,J),I=1,3),CBT(J),CBS(J),CEN(J),CTP(J),GAM(J),J=1,NPTOT) IRGB(I,J) := RGB definition used to determine paint color J with NTONE different tones, see Sec. 5.4. Up to 72 definitions are allowed. CBT(J) := Color factor of the darkest tone of paint color J. CBS(J) := Color factor of the default dark tone of paint color J. CEN(J) := Color factor of the default light tone of paint color J. CTP(J) := Color factor of the lightest tone of paint color J. GAM(J) := Gamma factor for tone distribution of paint color J. The following listings show the default files 'balsac2.ini' for the DOS/VGA and the Unix/X.11 versions of BALSAC. (A) DOS/VGA version ----------------------------------------------------------------------------- 0 0 640 480 1.0000 63 4 3 18 16 8 16 0.1000 0.3500 0.5500 50.0000 -35.0000 0.3000 -320.0000 4 1 2 3 4 0 0 0 63 63 63 0 0 0 63 63 63 63 63 63 63 0 0 0 0 63 63 63 638x13bold 0 0 50 0.3000 0.4000 0.7000 0.8000 1.0000 0 63 0 0.2000 0.3000 0.7000 0.8000 1.0000 0 63 50 0.3000 0.4000 0.7000 0.8000 1.0000 63 0 0 0.2000 0.3000 0.7000 0.8000 1.0000 ----------------------------------------------------------------------------- (B) Unix/X.11 version ----------------------------------------------------------------------------- 230 0 640 480 1.0000 65535 16 15 18 256 8 16 .1000 .3500 .5500 50.0000 -35.0000 .3000 -320.0000 16 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 0 0 0652806528065280 0 0 0652806528065280394176553544830 65280 0 0 0 0652806528065280652808x13bold 0 060000 .4500 .5500 .7750 .8800 1.0000 671858264 7012 .3000 .3500 .7250 .8300 1.7200 31683354834206 .2400 .3600 .7000 .8250 1.1600 55403 8874 8494 .3100 .3300 .6950 .8400 1.0000 596603429612278 .5500 .5600 .7000 .8750 1.0000 6243862613 8995 .5250 .5600 .7000 .7050 .9000 634426343465499 .2500 .4700 .8350 .8850 1.0000 482385159265535 .4000 .5000 .7000 .9000 1.0000 572175765165396 .7650 .9000 .9200 .9900 1.0000 650006500065000 .2000 .3000 .5000 .6550 1.0000 650006500065000 .4000 .5000 .7000 .9000 1.0000 650006500065000 .3000 .4000 .8000 .9900 1.0000 650006500065000 .5000 .6000 .8000 .9900 1.0000 650006500065000 .6000 .7000 .9000 .9900 1.0000 650006500065000 .7700 .8600 .9500 .9900 .8100 650006500065000 .9800 .9900 .9900 .9900 1.0000 ----------------------------------------------------------------------------- next, previous Section / Table of Contents / Index