6.5.1.1. UTILITY TSTCOL (DOS/VGA VERSION)

next, previous Section / Table of Contents / Index The DOS/VGA version of TSTCOL is started from the DOS command line using the command tstcol2 [initfile] where initfile is the name of an optional initialization file (up to 72 characters, the default file name used by BALSAC is 'balsac2.ini' in the calling directory, see below). Note that this utility generates graphical output requiring a graphics interface (VGA graphics adapter) which must be installed. If no initialization file name is provided on the command line TSTCOL starts with the initial startup screen ========================================================= | | | T S T C O L | | | | Test adapter/color/mouse modes for BALSAC | | initialization files (default = balsac.ini) | | | | (C) Copyright 1992-6 K. Hermann. All Rights Reserved | | Fritz-Haber-Institut Berlin | | | | Version 2.00 February 1996 | | | | VGA graphics version | | | ========================================================= and prompts Select: [F]ile input [S]cratch [,]esc allowing you to continue with input from an initialization file (type [F], file name up to 72 characters is prompted), to start from scratch using default graphics options (type [S], defaults are given below), or to quit TSTCOL (type [,]). After an initialization file name fname (for example 'balsac2.ini') is given or default values are selected TSTCOL moves to its main option menu ========== TSTCOL MAIN MENU ============================================ File : [fname ] [W]indow : (Ox,Oy)= ( ox, oy) (Lwx,Lwy)= ( lwx,lwy) Qyx= qyx [A]dapter : Int= int, Colmx= colmx, Chx,Chy= chx xhy [P]aint : Basic colors= ncb, tones = nsh, gray= fgr B/W/LC= ib iw ilc, palette= nptot Diff,Lamb,Spec/Theta,Phi= qdiff, qlamb, qspec / thtsh, phish ste[R]eo : Distortion,shift= pu, deye, red/blue/white= isr isb isw [X]yscale [B]all [M]ouse c[T]abl [L]oad [S]ave [,]Quit ======================================================================== showing values of the most important parameters contained in Cards 1 - 5 of the initialization file as described in the following (see Sec. 6.4.10). The first line gives the name fname of the initialization file used for input when TSTCOL was started. If TSTCOL was started without an input file fname will be blanked. The line(s) starting with "[W]indow ..." gives the complete window definition. This includes the origin (upper left corner) of the graphics window (ox, oy) which is relevant only for the Unix/X.11 version of BALSAC. Further, (lwx, lwy) gives the x/y (graphics) window size in pixels and qyx shows the y/x pixel distortion for screens with pixel shapes other than square. "[A]dapter ..." gives the complete adapter information and is relevant mostly for the DOS version of BALSAC. Here int denotes the interrupt number used to choose the graphics mode of the PC graphics adapter, colmx is the maximum number of colors available from the adapter, and chx/chy define the pixel width/length used for characters in graphics mode. "[P]aint ..." gives the number of basic colors, ncb, used to paint atoms and nsh denotes the number of tones available for each basic color. The gray switch flag fgr reads "on" or "off" depending on whether screen colors are replaced by respective gray tones, see Sec. 5.4. Numbers ib, iw, ilc are the present color table entries of the base colors "black", "white" and of the default link color while nptot gives the number of entries in the color palette determining the sequence of paint colors used to paint atoms, see Sec. 5.4. Ball shading is determined by weights qdiff (diffuse background), qlamb (Lambert shading), qspec (specular reflection) which are relative values ranging between 0.0 and 1.0. Further, thtsh and phish give the incident light direction with respect to the screen normal used for shading, see Sec. 5.4. "ste[R]eo ..." shows parameters relevant for stereo viewing where pu, deye give the present values of the eye distance and picture shift parameters. Further, isr, isb, isw, are color codes referring to colors red, blue, and white used in red/blue stereo mode, see Sec. 6.2.7. Note that certain control parameter values can lead to unwanted results if defined incorrectly. Therefore, the choice of control parameters should be considered with care. All parameters are identical for BALSAC/LATTICE and BALSAC/CLUSTER sessions. [W] selected from the main option menu allows you to redefine size and position of the graphics screen/window as well as compensate for pixel shapes other than square on your screen. The prompt Window definition OX,OY,LX,LY,QYX (ox,oy,lwx,lwy,qyx |"/"=esc) : asks for five numbers, ox, oy, lwx, lwy, qyx, defining graphics window parameters after which TSTCOL returns to the main option menu. Here (ox, oy) denotes the window origin (upper left corner) on the screen, lwx, lwy are window width and height, and qyx gives the y/x pixel distortion for screens with pixel shapes other than square. The present window parameter values are shown in the above prompt in parentheses and are conserved with dummy input "/". A distortion value qyx = q assumes that a line of 100 pixels in y direction (up-down) is of the same length as one of 100*q pixels in x direction (left-right). Modifying qyx may be required to correct for y/x distortions in the graphics output if different monitors are used or if graphics output is to be saved for subsequent printing on a printer with an x/y pixel size ratio different from that of the screen. [A] selected from the main option menu allows you to reset the basic adapter definition of the graphics screen. The prompt Adapter definition INT,COLMX,CHX,CHY (int,colmx,chx,chy | "/"=esc) : asks for four numbers int, colmx, chx, chy, defining basic parameters of your PC graphics adapter after which TSTCOL moves to option [W] above allowing you to redefine size and position of the graphics screen. Here int denotes the interrupt number used to choose the graphics mode of the PC graphics adapter, colmx is the maximum number of colors available with the adapter, and chx/chy defines the pixel size (width/height) of characters used in graphics mode. The present adapter parameter values are shown in the above prompt in parentheses and are conserved with dummy input "/". Adapter parameters depend on each other and should be chosen with care. The following table gives standard values for the most common graphics modes which work with VGA adapters -------------------------------------------------- mode lwx lwy int colmx chx chy -------------------------------------------------- CGA 640 200 14 16 8 8 EGA 640 350 16 16 8 14 VGA 640 480 18 16 8 16 -------------------------------------------------- Apart from these standard settings graphics modes with higher resolution and more colors are available with enhanced VGA adapters. For respective interrupt and parameter settings consult your adapter manual. Note that some enhanced graphics modes may require special mouse drivers for the graphical mouse analysis to work. NOTE that false interrupt values may lead to strange graphics results and may even destroy your adapter. [P] selected from the main option menu allows you to redefine all basic parameters connected with color painting in plots which includes color selection and shading. The paint menu P reads ========== TSTCOL COLOR MENU ======================================= Basic color table: ncolb colors, nsh tones Shading (Diff,Lamb,Spec/Theta,Phi) = qdiff,qlamb,qspec / thtsh,phish B/W/LC= ib iw ilc, palette= nptot [B]ascol [S]hade [C]odes/palette [G]ray(off) c[T]abl [W]orkb [,]esc ==================================================================== Here ncolb is the total number of paint colors and nsh the number of tones of each paint color defined at present, see Sec. 5.4. Ball shading is determined by weights qdiff (diffuse background), qlamb (Lambert shading), qspec (specular reflection) which are relative values ranging between 0.0 and 1.0 with qdiff + qlam + qspc = 1.0. Further, thtsh and phish give the incident light direction with respect to the screen normal used for shading, see Sec. 5.4. The numbers ib, iw, ilc are the present color table entries of the base colors "black", "white" and of the default link color while nptot gives the number of entries in the color palette determining the sequence of paint colors used to paint atoms. The gray switch flag fgr reads "on" or "off" depending on whether screen colors are replaced by respective gray tones, see Sec. 5.4. > [B] selected from submenu P allows you to reset and list all basic paint color definitions. The basic paint color menu PB reads =============================================================== Basic color table: ncolb colors, nsh tones Basic colors: [N]ew [M]od [A]dd [D]el t[O]ne [R]gbmx [L]ist c[T]abl [,]esc =============================================================== where ncolb is the total number of paint colors and nsh the number of color tones of each paint color defined at present, see Sec. 5.4. > > [N] selected from submenu PB allows you to redefine all basic paint colors from scratch. The prompt No. of basic colors NCOLB ( <ncmax, 0=esc) : asks for the number ncolb of basic colors to be defined in the following where ncmax gives the maximum number of colors available. Dummy input ncolb = 0 returns to submenu PB without affecting the present color definitions while for ncolb > 0, the prompts Input ncolb basic colors : 1) NR,NG,NB/Qbot,Qbas,Qenh,Qtop/Qgam : ... ncolb) NR,NG,NB/Qbot,Qbas,Qenh,Qtop/Qgam : ask for ncolb sets of eight numbers, nr, ng, nb, qbot, qbas, qenh, qtop, qgam, defining each new paint color after which TSTCOL returns to submenu PB. Here (nr,ng,nb) gives the RGB definition of the generating color where all values must lie within the range [0, rgb] with rgb = 63 for DOS/VGA and = 65635 for Unix. Further, qbot, qbas, qenh, qtop are factors determining the darkest, default dark, default light, and lightest tone of the paint color where all values must lie within the range [0, 1]. Finally, qgam is the gamma factor determining the distribution of color tones between darkest and lightest tone used for continuous shading. The color definitions are discussed in detail in Sec. 5.4. Note that the above input of 8*ncolb numbers may be tedious and editing the respective initialization file, see Sec. 6.4.10, may be faster and safer. > > [M] selected from submenu PB allows you to modify a specific basic paint color from the present set. The prompt Modify selected basic color N (1- ncolb, 0=esc) : asks for the number n of a basic paint color within the range [1,ncolb] to be modified. Dummy input n = 0 returns to submenu PB without affecting the present color definitions while for n > 0, the prompt Color( n)= nr ng nb / qbot qbas qenh qtop / qgam Redefine NR,NG,NB/Qbot,Qbas,Qenh,Qtop/Qgam ("/"=esc) : shows the present definition of paint color n and asks for eight numbers, nr, ng, nb, qbot, qbas, qenh, qtop, qgam, defining the modified paint color after which TSTCOL returns to submenu PB. The color parameters are explained in option [N] above and in Sec. 5.4. Dummy input "/" will keep the original definition of paint color n. > > [A] selected from submenu PB allows you to add a basic paint color to the present set. The prompt Add basic color NR,NG,NB/Qbot,Qbas,Qenh,Qtop/Qgam ("8*0"=esc) : asks for eight numbers, nr, ng, nb, qbot, qbas, qenh, qtop, qgam, defining the new paint color to be added after which TSTCOL returns to submenu PB. The color parameters are explained in option [N] above and in Sec. 5.4. Dummy input "8*0" will return to submenu PPB without a color added. > > [D] selected from submenu PB allows you to remove a basic paint color from the present set. The prompt Remove basic color N (1-ncolb, 0=esc) : asks for the number n of a basic paint color within the range [1,ncolb] to be removed. Dummy input n = 0 returns to submenu PB without affecting the present color definitions while for n > 0 basic color no. n will be removed from the set after which TSTCOL returns to submenu PB. > > [O] selected from submenu PB allows you to change the number of color tones generated for each basic paint color and used for ball shading as well as for background painting in plots. The prompt No. of tones NSH (nsho, max=nshmax, 0=esc) asks for an integer defining the number of color tones to be generated for each basic paint color. Here nsho gives the present value and nshmax (= nctot/ncolb) denotes the largest available value determined by the total number of colors nctot and the number of paint colors ncolb. Dummy input nsh = 0 keeps the present definition while for nsh > 0 the internal color table is modified according to the new number of tones after which TSTCOL returns to submenu PB. Values nsh > nshmax will be truncated to nsh = nshmax. > > [R] selected from submenu PB allows you to change the global maximum value allowed for components (r, g, b) in RGB color settings. The prompt RGB maximum (rgbmaxo, 0=esc) : asks for an integer giving the new maximum value rgbmax where rgbmaxo in the prompt gives the old value. The input leads to a global rescaling of all RGB definitions by a factor rgbmax/rgbmaxo after which TSTCOL returns to submenu PB. Allowed values for rgbmax depend on the graphics adapter where the standard values are N = 63 (2**6-1) for DOS and N = 65535 (2**16-1) for Unix/X.11 Windows systems. RGB rescaling may become necessary if BALSAC output files of LATUSE or PLOT3D type include initialization information and are transferred between DOS and Unix systems. WARNING: RGB rescaling can result in strange color definitions and should generally be avoided. > > [L] selected from submenu PB allows you to list all basic paint color definitions of the present set. The prompt ncolb basic colors : list NA,NE : asks for a range [na, ne] of the set of ncolb basic paint colors to be listed. For < na <= ne <= ncolb the listing shows as NR NG NB / Qbot Qbas Qenh Qtop / Qgam na) nr ng nb / qbot qbas qenh qtop / qgam ... ne) nr ng nb / qbot qbas qenh qtop / qgam after which TSTCOL returns to submenu PB. The color parameters in this list are explained in option [N] above and in Sec. 5.4. > > [T] selected from submenu PB displays a color test table showing the present color definitions together with color numbers. This option is identical to option [T] of the main option menu described below. > > [,] selected from submenu PB returns to the paint menu P. > [S] selected from submenu P allows you to list and reset all parameters relevant for ball shading in plots. The shading menu PS reads ================================================= Shading: [W]eights [A]ngles c[T]abl [,]esc ================================================= > > [W] selected from submenu PS allows you to redefine the relative weights of different contributions to shading. The prompt Shading weights DIFF,LAMB,SPEC (qdiff qlamb qspec|"3*-1"=esc) : asks for three numbers, qdiff, qlamb, qspec, defining the relative weights of shading contributions due to the diffuse background, to Lambert shading, and to specular reflection as described in detail in Sec. 5.4. Meaningful values should range between 0 and 1 with qdiff + qlamb + qspec = 1 (defaults are qdiff = 0.1, qlamb = 0.35, qspec = 0.55). After the input TSTCOL returns to submenu PS. Dummy input "3*-1" will keep the present shading values. > > [A] selected from submenu PS allows you to redefine the direction of the incident light used for shading. The prompt Shading angles THETA,PHI (theta phi | "/"=esc) : asks for two numbers, theta, phi, defining the polar and azimuthal angles of the incident light. The angles are taken with respect to the screen normal direction where polar angle phi = 0 corresponds to the vertical y direction on the screen (defaults are theta = 65, phi = -25 degrees referring to light shining from the upper left front location relative to the viewer). For further details consult Sec. 5.4. After the input TSTCOL returns to submenu PS. Dummy input "/" will keep the present angle values. > > [T] selected from submenu PS displays a color test table showing the present color definitions together with color numbers. This option is identical to option [T] of the main option menu described below. > > [,] selected from submenu PS returns to the paint menu P. > [C] selected from submenu P allows you to redefine the default colors for "black", "white", and for links between atoms as well as all entries of the color palette which determines the sequence of colors used to paint atoms. The color palette menu PC reads =========================================================== Basic codes : B/W/LC= ib iw ilc gray= fgr Palette(nptot) : np(1) ... np(nptot) Colors: [B]lack/white/links [P]alette c[T]abl [,]esc =========================================================== where the numbers ib, iw, ilc give the color codes (color table entries, see Sec. 5.4) of default colors for "black", "white", and for links between atoms. The gray switch flag fgr reads "on" or "off" depending on whether screen colors are replaced by respective gray tones. The next line lists the complete color palette of nptot entries np(i), i=1...nptot defined at present which determines the sequence of basic paint colors used to paint atoms. > > [B] selected from submenu PC allows you to redefine the default colors used for "black", "white", and for links between atoms. The prompt Black/white/links color codes IB,IW,ILC ( ib, iw, ilc) : asks for three integers defining the color codes ib, iw, ilc (entries of the internal color table) used for default colors "black", "white", and for links between atoms where the values in parenthesis give the present settings. Colors "black" and "white" are used for circle/dot/ball drawings in graphics output, for the title line and for the wire frame about the lattice section or cluster. Lines/sticks connecting atoms are painted with default color ilc if not redefined by individual values, see Secs. 6.2.7.1, 6.3.5.1. Resetting these colors may improve the visibility or can achieve special color effects. After complete input TSTCOL returns to submenu PPC. > > [P] selected from submenu PC allows you to redefine the complete color palette which determines the sequence of basic paint colors used to paint atoms. The prompt Palette(nptot) : np(1) ... np(nptot) Input N, N color codes (0=esc) : gives a listing of the present color palette and asks for a new palette to be defined. The input starts with the palette size nptot (denoted N in the prompt) and is followed by nptot integers np(i), i=1,...nptot, defining the palette entries (pointing at basic paint colors). As an example, a palette of three entries (paint colors 7, 4, 11) would be input as " 3, 7, 4, 11 ". Different entries in the palette can have the same color code value thus allowing e.g. to show different lattice planes with the same color. After input of a new color palette TSTCOL returns to submenu PC. Dummy input nptot = 0 leaves the present palette definition unchanged. > > [T] selected from submenu PC displays a color test table showing the present color definitions together with color numbers. This option is identical to option [T] of the main option menu described below. > > [,] selected from submenu PC returns to the paint menu P. > [G] selected from submenu P switches the gray switch flag fgr between "on" and "off" and shows the updated submenu P. For fgr = "on" all screen colors are replaced by respective gray tones determined by the RGB transformation (r,g,b) -> (s,s,s) with s = 0.30*r + 0.59*g + 0.11*b after which plots will use gray tones rather than colors, see also Sec. 5.4. > [T] selected from submenu P displays a color test table showing the present color definitions together with color numbers. This option is identical to option [T] of the main option menu described below. > [W] selected from submenu P moves to the color/shading workbench switching to graphics mode (DOS) or opening a graphics window (Unix). This allows you to change all basic and paint colors as well as ball shading angles in a very intuitive way using the mouse or a graphics pointer. Further details are given in Sec. 6.2.15.2. > [,] selected from submenu P returns to the main option menu. [R] selected from the main option menu allows you to redefine distortion, plot shift and color codes used for stereo graphics of BALSAC. The stereo menu R reads ====================================================================== Stereo: [D]istortion/shift (pu, deye) [R]ed/blue/white (isr isb isw) [?,]esc ================================================================ 43 == where pu, deye give the present values of the eye distance and picture shift parameters explained below. Further, isr, isb, isw, are color codes referring to colors red, blue, and white used in red/blue stereo mode, see Sec. 6.2.7. Full color stereo mode allows you to get a more realistic 3-dimensional impression of the lattice section or cluster using optical stereo glasses, see Sec. 6.2.7. In this mode, a lattice section or cluster is shown by two pictures on the screen. The pictures are reduced to 50% in size (with respect to their mono equivalents), are horizontally displaced by a picture shift deye, and differ slightly in their projection geometry reflecting the viewer's eye distance and his distance from the object. Here the eye distance pu is measured in units of the diameter D of the lattice section or cluster where meaningful values of pu lie between 0.1 and 1.0 (pu = 0.3 is default). The picture shift deye which determines the shift between the centers of the two stereo pictures on the screen/window can assume positive and negative values where for deye > 0 the left (right) picture simulates the left (right) eye view required for viewing with optical stereo glasses. deye < 0 the left (right) picture simulates the right (left) eye view required for cross eyed stereo viewing without glasses. Meaningful values for |deye| lie between 100 and 600 (deye = -320 is default). Red/blue stereo mode allows you to get a 3-dimensional impression of the lattice section or cluster using red/blue stereo filter glasses, see Sec. 6.2.7. In this mode, the atoms of a lattice section or cluster are shown by two horizontally shifted circles of equal radius and of colors blue (left circle) and red (right circle). The distance between the circles (stereo distortion) is determined by the distance z of the center from the viewer and the eye distance of the viewer. Analogously, all lines of the plot are visualized as red and blue lines accounting for the stereo distortion. As in full color stereo mode the stereo impression is controlled, apart from the perspective projection, by the eye distance pu, see above. > [D] selected from submenu R allows you to redefine the eye distance and picture shift used for stereo views. The prompt Stereo distortion,shift PU,DEYE (pu, deye | "/"=esc) : asks for two numbers, pu, deye, defining new values of the eye distance and picture shift after which TSTCOL returns to submenu R. Dummy input "/" will keep the old values given with the prompt (in parenthesis). Note that parameter deye is ignored in red/blue stereo plots, see above. > [R] selected from submenu R allows you to redefine the color codes used for colors red, blue, and white in red/blue stereo mode. The prompt Stereo red/blue/white ISR,ISB,ISW ( isr, isb, isw | "/"=esc) : asks for three numbers, isr, isb, isw, defining new color codes for stereo red, blue, and white after which TSTCOL returns to submenu R. Dummy input "/" will keep the old values given with the prompt (in parenthesis). The stereo color codes refer to the full color table of nctot colors, see Sec. 5.4. However, only colors adjusted to the stereo filter glasses are meaningful. Otherwise, the plot looks very confusing and can even lead to headaches if viewed for an extended time. > [,] selected from submenu R returns to the main option menu. [X] selected from the main option menu moves to the monitor screen distortion test allowing you to inspect and adjust the distortion. The graphics screen shows two lines X/Y PIXEL DISTORTION TEST : [up] [down] [left] [right] [,]esc LY/LX = ly / lx QXY = qyx at the top of the screen where lx, ly are the present lengths (in pixels) of the rectangle shown below and qyx gives the y/x pixel ratio of the rectangle. The shape of the rectangle can be varied using the cursor keys [up], [down], [left], [right]. If the rectangle becomes square shaped the respective qyx value can be read off giving the correct pixel ratio of the screen to be used in the initialization file. Pressing [,] returns to the main option menu. [B] selected from the main option menu moves to the ball shading test allowing you to modify the different shading weights and incident light directions interactively. The graphics screen shows three lines BALL SHADE TEST : [udlr+-] [cC]ol q[dD]iff q[lL]amb q[sS]pec [,]esc Color/tones= ic / nsh Diff, Lamb, Spec/ Theta, Phi = qdiff, qlamb, qspec / theta, phi at the top of the screen where ic is the present basic color number, nsh the number of tones per color. Parameters qdiff, qlamb, qspec determine the present shading weights and theta, phi define the incident light direction, see above and Sec. 5.4. The numerical values will be updated by any of the options below. Further, the graphics screen shows a glossy-shaded ball in the center which illustrates all above listed color and shading values. The ball is surrounded by a larger circle and a "+" inside the circle area which serves as a graphical pointer. The pointer position (x,y) with respect to the ball/circle center defines the incident light direction theta, phi where x = Rc * sin(theta) * sin(phi) y = Rc * sin(theta) * cos(phi) with Rc being the radius of the outer circle. Selecting > [up], [down], [left], [right] allows you to move the graphical pointer "+" up/down/left/right on the screen. If the graphics pointer lies inside the circle pressing [enter] evaluates the incident light direction theta, phi from the pointer position and redraws the shaded ball. This allows you to test different shading directions. > [+]/[-] increases/decreases the step size of the pointer movement by a factor 2 which can speed up the pointing process. > [c]/[C] decreases / increases the basic color number ic by 1 (with periodic continuation if ic reaches the maximum ncolb of allowed paint colors) after which the shaded ball is redrawn. > [d]/[D] decreases / increases the present weight of the diffuse background qdiff by 0.03 within the range [0.0, 1.0] after which the shaded ball is redrawn. > [l]/[L] decreases / increases the present weight of Lambert shading qlamb by 0.03 within the range [0.0, 1.0] after which the shaded ball is redrawn. > [s]/[S] decreases / increases the present weight of specular reflection qspec by 0.03 within the range [0.0, 1.0] after which the shaded ball is redrawn. > [,] returns to the main option menu. [M] selected from the main option menu moves to the mouse interface test showing the title line MOUSE POINTER TEST : L-click R-click [,]esc at the top of the graphics screen and framing the screen with a white line indicating the present window size settings. If a mouse device is correctly connected the mouse graphics pointer (white arrow) shows on the screen and can be moved by moving the mouse. Clicking the left mouse button (L-click) draws a glossy-shaded ball at the present pointer position showing its pixel position (x, y) and the paint color nc by "x y (nc)" at the top left of the screen. Clicking the right mouse button (R-click) or pressing [,] returns to the main option menu. > > [T] selected from submenu PC displays a color test table showing the present color definitions together with color numbers. This option is identical to option [T] of the main option menu described below. [T] selected from the main option menu displays a color test table showing the present color definitions together with color numbers. The numerical information on all colors can be inspected and changed inside the paint menu described above. The first line from the top of the table shows color blocks of the four base colors "black", "white", "stereo red", "stereo blue" indicated by a line black white (st)red (st)blue to the left. Then the dark and light tones of all paint colors in the sequence of the palette definition are shown together with a line colors: palette= nptot, total= nctot where nptot is the number of entries in the color palette and nctot is the total number of RGB colors defined at present. Next for each of the ncolb paint colors the sequence of nsh tones, see Sec. 5.4, is displayed by a row of blocks going from darkest to lightest tones. The line to the right of each block sequence reads j ( def.dark(j) , def.light(j) ) ns(j)+1 - ns(j)+nsh where j is the paint color index (to be used in the palette for painting (shaded) balls), def.dark(j) and def.light(j) are color table entries of the default dark and light tones, and ns(j)+1 denotes the darkest, ns(j)+nsh the lightest tone of paint color j. In addition the two default color tones are marked by crossing lines in the respective color blocks (def.dark = white lines, def.light = black lines). Pressing any key clears the window and returns to the previous menu. [L] selected from the main option menu allows you to load an external initialization file replacing all basic parameter values by those contained in the file. The prompt Init file name for input ("+"=def,"-"=esc): asks for a character string fname (up to 72 characters) which defines the file name of an external initialization file, see Sec. 6.4.10. Here the one-character filename "+" denotes the default initialization file on-line help file 'balsac2.ini', while dummy input "-" returns to the main option menu without file input. [S] selected from the main option menu allows you to save all basic parameter values of the present TSTCOL session in an external initialization file. The prompt Init file name for output ("-"=esc): asks for a character string fname (up to 72 characters) which defines the file name of an external initialization file, see Sec. 6.4.10. Note that choosing the name 'balsac2.ini' in the above prompt defines the default initialization file for output which should be avoided. For a valid file name TSTCOL stores all control parameter values of the present session in the file and returns to the main option menu. The one-character dummy filename "-" returns without file output. [,] selected from the main option menu allows you to quit TSTCOL which has to be confirmed in the prompt Confirm quit: [Q]uit [,]Remain where pressing [Q] moves to the DOS command line while [,] returns to the TSTCOL main option menu. NOTE that all parameter values modified inside TSTCOL are valid only for the present session unless they are saved on separate initialization files. next, previous Section / Table of Contents / Index