CONTENTS.
Montreux is mainly configured by altering the configurationfile montreux.cfg. Some html related configuration is done in the html code calling the applet; read readme.html for details on this. The config file may have a different name (see details in readme.html), this does not affect the way of configuring. However in this document I will sometimes assume the name montreux.cfg for the configurationfile.
Montreux.cfg may be edited, but should never be renamed or deleted! Montreux will fail to start if it cannot find it's configuration file.
All characters in montreux.cfg following either a semicolon ';' or a hash '#' upto the end of the line are considered comment and are ignored by Montreux. Lines in an invalid section are discarded.
No line, not even a comment line, should exceed 250 characters in length. Tabs should not be used in montreux.cfg! Ignoring these limitations may cause Montreux to malfunction.
The config file consists of several sections. A section is started with a section header, of the form [SECTIONNAME]. Sectionnames should not contain any whitespace. Valid sections currently are [DATABASES], [OPTIONS], [BROWSER] and [OS]. All sections are described in the rest of this document.
2. DATABASES SECTION.
The [DATABASES] section lists all the databases Montreux should be able to view. The first word in a line in the database section is supposed to be a database path name. The rest of the line is the database description that will be used by Montreux in the database selection window.
Database names should not contain any of the following symbols:
If the database name contains a comma symbol then the string behind this comma is considered to be the piece letter setting to use with the database. The format of these pieceletters is identical to the format described with the DisplaySymbols option. This option is useful when some database are in a different language than the other ones. Watch to use no spaces around the comma!
Some examples:
3. OPTIONS SECTIONS.
The [OPTIONS] section lists all general options Montreux should use.
All options below have one of the following two forms:
Some useful sections are:
Please note that the configuration file is read sequentially and that options that occur more than once are overwritten. This means that you must specify your general options first, and your OS or BROWSER specific options last. For instance, you want FontSizeLabel to be 14, but it should be 15 for Internet Explorer, then the [OPTIONS] section must come first with a line "FontSizeLabel=14", and the [BROWSER Microsoft] section, containing a line "FontSizeLabel=15", must come later.
The rest of this document describes all options available for the Options, BROWSER and OS sections in the montreux.cfg file. Note that any undefined option will be ignored.
4. USER RELATED OPTIONS.
License = licensename
Key = keyvalue
5. DATABASE RELATED OPTIONS.
FastParsing
Please note that Montreux may work improperly when FastParsing is enabled and the PGN source contains move errors. Move buttons may appear to do nothing (when an invalid move is about to be played/withdrawn) and the move list may not be synchronized correctly with the game. There is no problem with correct PGN sources; good advise is to check all PGN games with Secureparsing or MDCP and correct it until it is errorfree.
PgnParseSymbols = value
Note that PgnGenerateSymbols is only used by MDCP.
PgnNotation = value
< > | ; = ! ? @ # $ * & [ ] ' " ` { } ~ ,
as well as any whitespace character. Good advise is to only use letters, digits and underscores and a dot symbol to separate the extension (pgn,mdf) from the filename. The first database found is taken as the default database, unless a default database is defined with the DefaultDBase option. This database will initially be loaded by Montreux.
corus2001.pgn Games of the Corus 2001 tournament
lasvegas.mdf Fide WC 1999
mygames.mdf Some of my best games
carokann.mdf A collection of Caro Kann games
lautier.pgn,PCFTDR Lautier collection (French source)
OPTION
OPTION = Value
The optionname is case insensitive, the value may be (usually is) case sensitive. When an option needs a value the documentation below shows the second form. The "Value" part must then in montreux.cfg be replaced by a numerical or a string value. Colors need hexadecimal arguments. Boolean options (yes/no options) are usually set to false (no) with 0, and to true (yes) with any nonzero value. Typically, 1 should be used to set an option to true. No quoting should be used for the value, but the '=' is compulsory. One option must be completely in one line, and no more than one option may be in a line.
Some correct examples:
License = Gary Kasparov
DefaultDBase = corus2001.pgn
FastParsing
ImgButtons = 1
DisplaySymbols = PCATDR
ListwinYSize = 250
BGColActiveButton = 80D8F0
Some errors:
ImgButtons = 1 Buttons = mybuttons.gif ; too many options in a line
DisplaySymbols =
PCBTDR ; option may not be split in more than one line
PgnSuppressTags = WhiteElo, BlackElo, WhiteTitle, BlackTitle,
WhiteCountry, BlackCountry, Annotator ; option may not be split in two lines
Options specified in the OPTIONS section are always used. You can also define sections of options for specific platforms and for specific Browsers. Sections of the form [BROWSER browser_name] check the Java property "java vendor". If the virtual machine name matches the start of the java vendor string the options in this section are used, otherwise they are ignored. Similarly sections of the form [OS os_name] check the Java property "java.os". If the os_name matches the start of the java os string the options in this section are used, otherwise they are ignored. The ability to use options per OS or BROWSER is useful as Java Implementations may slightly differ, for instance in the use of fonts. Especially Microsoft differs often from other implementations.
[BROWSER Microsoft] # Internet Explorer specific options
[BROWSER Netscape] # Netscape specific options
[BROWSER Sun] # Sun Appletviewer, HotJava and Opera specific options
[OS Windows] # Microsoft Windows 95/98 specific options
[OS Solaris] # Sun Solaris specific options
Instead of BROWSER you can also use JRE as a section name. The meaning of these keywords is identical. (The first is better understood, the latter is more correct.)
Licence = licencename
Defines your licensename. Only valid with a correct key. When no License is specified (default) Montreux and MDCP will display "Anonymous license". If an incorrect license,key pair is specified Montreux will display "invalid
license". Montreux will display your license name in case of a correct License,key pair. Montreux is still fully functional in case of a bad or missing
license.
Keyvalue for your license name. See License.
Secureparsing
Fastparsing will parse PGN sources much faster but does not check the validity of the moves. Validation will be done upon the first execution of the move. Errors in the PGN file are less easy detected but loading is much faster. The >>var button may sometimes work slower, because many moves may be validated at that time. Secureparsing is the opposite to fastparsing. It offers complete move validation during database parsing, but is much slower. These options have no effect on MDF sources. MDCP overrides this option and always uses secureparsing.
PgnGenerateSymbols = value
These options can be used for localized PGN sources. The value is a six character uppercase string representing the piece letters used in the source or to be generated into the target file. Pieces are in the order Pawn, Knight, Bishop, Rook, Queen, King. Pawns must be included for error messages and FEN's. Please use six different uppercase characters only; Montreux does not work properly if any other character is used. Default is "PNBRQK" for english sources. Example:
PgnParseSymbols=PCFTDR
will enable the PGN parser to read PGN source based on french piece letters. Read the DisplaySymbols section for piece letter suggestions for several languages.
This setting determines de type of PGN code generation.
0 | Short notation. |
1 | Long notation. |
2 | Long notation for the main variation, Short elsewhere. |
PgnNestedComments = value
When set to a nonzero value, the PGN parser will treat nested {} brackets as nested move comments, if set to zero, which is default, it will not, which is conform PGN specs.
PgnSuppressTags = value
This option prevents MDCP from generating any tags in the argument. This is useful if your target PGN reader does not accept all tags generated by MDCP. Default value is "", meaning no tags are suppressed. Tags must be separated by spaces and/or comma's. Examples:
PgnSuppressTags = WhiteCountry BlackCountry PgnSuppressTags = WhiteElo, BlackElo, WhiteCountry, BlackCountryBe very careful using this option with important tags like FEN and Result. The result may be incorrect. This tag is only in use by MDCP.
PgnWidth = value
This option determines the maximum width of generated PGN sources. Default set to 77. The value should be between 32 and 255; if it isn't is will be rounded to the nearest value in this range. Used by MDCP only and when generating PGN.
PgnNewline = value
This option sets the newlines that MDCP will generate. Options:
SYSTEM | Generate the newlines of the system MDCP is currently running on (default). |
UNIX | Generate Unix/Linux type newlines (LF). |
MAC | Generate Apple Mac type newlines (CR). |
DOS | Generate MSDos/MS Windows type newlines (CR/LF). |
VerboseParser = value
This option, when set to any nonzero value, makes the PGN parser generate more verbose error messages. Default is 0.
VerboseLoader = value
This option, when set to any nonzero value, makes loading and refreshing sources more verbose. Default is 0.
MdcpText = value
This option will generate the argument value as a comment near the start of MDF or PGN sources. This option is only used by MDCP.
NoDefaultDBase
Montreux will be fired up without initially loading a database when this option is used. Equivalent to DefaultDBase=$NONE
DefaultDBase = dbase
The argument dbase will be loaded at startup. You can use any database you specify in the database section of your montreux.cfg file. Special values are:
$FIRST | load the first database in the database section. |
$LAST | load the last database in the database section. |
$NONE | load no database initially (equivalent to the NoDefaultDBase option). |
RefreshAction
This option determines the action taken after a succesful refresh. The argument is a four digit value, each of which influences the refresh behaviour. Add all values to determine the complete behaviour:
xxx1 | Go to the first move of the game selected. |
xxx2 | Go to the current move of the game selected. |
xxx3 | Go to the last move of the game selected. |
xx1x | Select the first game in the database. |
xx2x | Select the current game in the database. |
xx3x | Select the last game in the database. |
x0xx | Do not do any refresh action after manual database/game select. |
x1xx | Apply the refresh action also after manual database/game select. |
0xxx | Always do an automatic refresh. |
1xxx | An automatic refresh will only take place on unfinished games. Games are considered unfinished if the result equals "*" or if there is no result available. |
2xxx | An automatic refresh will only take place on unfinished games, and the user is currently viewing the last move. |
RefreshInterval = value
This option defines the interval after which an auto refresh is performed by Montreux. The value is in seconds. Use 0 to disable auto refresh. Default is 0.
This option should probably be left to 0 unless you're planning to support "live" updates through Montreux. Depending on the RefreshAction option auto refresh can be very annoying. If auto refresh is used the RefreshAction option should probably be left to 22, and care should be taken that the order of the games in the databases is preserved, and new games are appended only.
AlwaysRefresh = value
This option forces to reread the data, regardless if the document was modified or not since the previous refresh. Default set to zero.
6. GRAPHICS RELATED OPTIONS.
Buttons = imagefile
Button image files should contain 16 subimages in a 4x4 grid layout. The subimages should be equal in size and contain the following icons:
Buttons defines the imagefile that will be used by Montreux for displaying the various buttons. If this option is skipped the default buttons in "buttons.gif" will be used.
Previous move | Next move | Unused | Unused |
Previous game | Next game | Previous variation | Next variation |
Databases | Refresh | Games | Flip board |
Select | Close | Print database | Unused |
ImgButtons = value
When set to any nonzero value Montreux will run with image buttons, if set to zero it will run with text buttons. If Montreux is run with image buttons, the imagefile specified with the Buttons option (default buttons.gif) should be present.
ButtonEnlargement = value
This option takes a positive value, which possibly can have a fraction. It determines the Enlargement factor of the buttonimages. E.g. When the button has a 40x40 size in the imagefile, and ButtonEnlargement is set to 0.8 then the button displayed will be 32x32 pixels in size. Default is 1. The option does not apply to textbuttons.
ButtonSpace = value
This option controls the number of pixel lefts and right of the button. The space between two buttons is two times this value. Default value is 2.
NoRefresh
Do not supply the refresh button. Auto refresh can still take place, depending on the RefreshInterval option setting.
PrintButton = value
If set to any nonzero value, a button is added to the display that prints the current
game database to the Java Console. If set to zero, no such button is available. Default 0.
FlipButton = value
If set to any nonzero value, a button is added to the display that flips the board. If set to zero, no such button is available. Default 1.
Pieces = imagefile
Pieces defines the imagefile that will be used by Montreux for displaying the various chess pieces. If this option is skipped the default pieces in "pieces.gif" will be used.
ImgLineLayout
ImgLineLayout defines the layout of the piecesfile. The piecesfile contains 28 "subimages", each having exactly the same size in pixels. The piecesfile has a height of four subimages and a width of 7 subimages. The subimages should have the following contents:
Empty white square | White king, white square | White queen, white square | White rook, white square | White bishop, white square | White knight, white square | White pawn, white square |
Empty black square | White king, black square | White queen, black square | White rook, black square | White bishop, black square | White knight, black square | White pawn, black square |
Unused | Black king, white square | Black queen, white square | Black rook, white square | Black bishop, white square | Black knight, white square | Black pawn, white square |
Unused | Black king, black square | Black queen, black square | Black rook, black square | Black bishop, black square | Black knight, black square | Black pawn, black square |
ImgBoardLayout
ImgBoardLayout defines the layout of the piecesfile. The piecesfile contains 28 "subimages", each having exactly the same size in pixels. The piecesfile has a height of four subimages and a width of 7 subimages. The subimages should have the following contents:
Empty black square | White king, white square | White queen, black square | White rook, white square | White bishop, black square | White knight, white square | White pawn, black square |
Empty white square | White king, black square | White queen, white square | White rook, black square | White bishop, white square | White knight, black square | White pawn, white square |
Unused | Black king, white square | Black queen, black square | Black rook, white square | Black bishop, black square | Black knight, white square | Black pawn, black square |
Unused | Black king, black square | Black queen, white square | Black rook, black square | Black bishop, white square | Black knight, black square | Black pawn, white square |
Piece images can be generated from "printscreens" of the setup-position feature of chess programs, pasted into an image editor. By copying a rectangle consisting of 28 (correct) squares of this printscreen, new images can be very easily generated.
ImgTransLayout
ImgTransLayout defines the layout of the piecesfile. The piecesfile contains 14 "subimages", each having exactly the same size in pixels. The piecesfile has a height of two subimages and a width of seven subimages. The subimages should have the following contents:
Empty | White king | White queen | White rook | White bishop | White knight | White pawn |
Unused | Black king | Black queen | Black rook | Black bishop | Black knight | Black pawn |
This option is useful when using transparant piece images, and controlling the square colors with the BGColBlackSquare and BGColWhiteSquare options. This layout is the default layout.
ImgFilterLayout
ImgFilterLayout defines the layout of the piecesfile. The layout is the same as ImgTransLayout
but the way the images are displayed is different. This is useful because some version
of IE do not handle ImgTransLayout correctly.
7. WINDOWS AND LAYOUT RELATED OPTIONS.
Detach = value
MenuBar = value
ShowMoveList = value
AutoTabSelect = value
If set to any non-zero value Montreux will run detached as an applet. This means it will run in it's own window. Defaultvalue is 0.
If set to any non-zero value Montreux will add a Menu bar. This does not work for undetached applets. Defaultvalue is 0.
If set to a nonzero value, a movelist will appear, if set to zero it won't. When this value is set to zero, some movelist related options will be ignored.
Configures the automatic selection of tabs. Various effects are possible by adding the basic effect values below.
0 | No automatic tab selection is done. |
1 | Automatic selection is done whenever a move is played, withdrawn or a new game is loaded. The move tab is selected if the current move is at a variation point or the current move has a comment. The list tab is selected otherwise. Automatic selection is done only if the move or list tab are already selected. |
2 | As 1, but selection is done only when gamelist or dbaselist tab are selected. |
4 | Reserved. | 8 | Reserved. |
16 | As 1, but selection is done regardless of the current tab. | 32 | Reserved. |
64 | The game list tab will be shown when a database is selected. |
GraphicalMoveList = value
This option will, if set to any nonzero value, use a Scrollpane based move list implementation. If the option is set to zero it will use a List Component based move list. List based lists are faster, and might operate smoother on slower systems. Scrollpane based lists look better, because any move can be selected; not only a pair of moves, as is the case with a listbased list. Also they can be nicer configured with non proportional fonts. Default is 0.
GrMoveWidth = width
GrMoveNrWidth = width
ListMoveWidth = width
ListMoveNrWidth = width
These options control the width of the move and move numbers in the Move Lists. Use the ListMoveWidth and ListMoveNrWidth options if you are using a List based move list (default 8 and 3). Use the GrMoveWidth and GrMoveNrWidth options if you are using a Scrollpane based move list (default 9 and 4). You probably might want to alter this settings if you enable Nags in movelists (see NagDisplayInMoveList).
GrMoveListHAdj = factor
GrMoveListVAdj = factor
These options influence the size of moves in a graphical move list. The bigger the value, the more space between moves. GrMoveListHAdj controls the space between moves in the same row, GrMoveListVAdj controls the space in the same column.
ShowMovesInNextList = value
When set to any nonzero value, the next move options will be shown in the next move list. If set to zero, the next move list remains blank when no variations exist for the next move, and just shows variation numbers if they do.
ShowLongnotation = value
When set to any nonzero value, this option causes moves, movelists and nextlists to be displayed in long notation, like e2-e4. When set to zero, it forces display of moves, movelists and nextlists in short notation, like e4. Default 1.
DisplaySymbols = value
This option can be used for a localized look. The value is a six character uppercase string representing the piece letters to be used for move display. Pieces are in the order Pawn, Knight, Bishop, Rook, Queen, King. Pawns must be included. Default is "PNBRQK" for english display. Example:
DisplaySymbols=PCFTDRwill create a french move representation.
PRLTDK ; Afrikaans BSLTDK ; Croatian PJSVDK ; Czech BSLTDK ; Danish OPLTDK ; Dutch PNBRQK ; English PROVLK ; Estonian SRLTDK ; Finnish (PRLTDK ?) PCFTDR ; French BHFSDK ; Frisian BSLTDK ; German GHFBVK ; Hungarian PRBHDK ; Icelandic PCATDR ; Italian BHLSDK ; Norwegian (BSLTDK ?) PSGWHK ; Polish PCBTDR ; Portuguese PCNTDR ; Romanian OSLTDK ; Slavonic PCATDR ; Spanish BSLTDK ; Swedish
Thank you Armando, Ewa, Mamma, Nelis, Steven and Tom. If your favorite language is incorrect or missing here, I would appreciate you to mail me the correct settings so I can add it to the list (as long as the alphabet is Western - Cyrillic, Greek, Hebrew, Arab, Chinese, Japanese etc can just not be supported, sorry.).
You might like to try the option value $CHESS. If your browser supports the complete Unicode character set chess figurines will be displayed. Unfortunately no browser supporting the chess figurines is known to me. Don't use $CHESS for PgnParseSymbols and PgnGenerateSymbols!
NagDisplayInMoveList = value
NagDisplayInLastMove = value
This options set the appearance of NAG's in Montreux' last move or move and next list. Various effects are possible by adding the basic effect values below.
0 | No NAG display. |
1 | Nags 1-6 are displayed with ! and ?. |
2 | Nags 1-6 are displayed with $nr. If 1 is set too, this option is ignored. |
4 | Nags 7 and up are displayed with $nr. |
NagDisplayInComment = value
This options set the appearance of NAG's in Montreux' comment window. By using a non-zero value, the Nags are expanded into easy to read text. See the table below.
0 | No NAG expansion in comment window. |
1 | Nags 1 to 6 are expanded in text and added to comment. The description is taken from the file defined by the NagFile option and is expanded only if it is available in this file. You need to make the NagFile (nags.txt) available in order to view descriptions. | 2 | Nags 7 and up are expanded in text and added to comment. The description is taken from the file defined by the NagFile option and is expanded only if it is available in this file. You need to make the NagFile (nags.txt) available in order to view descriptions. |
4 | Nag expansion is done before any comment. If this is not set, Nag expansion is done behind the normal comment. This value has no effect if no Nag expansion is selected. |
NagFile = nagfilename
This option defines the file containing the NAG descriptions. Default is nags.txt. Also see NagDisplayInComment.
VarationMark = variationchar
This option defines the symbol for variation display in the move list. Default this is set to "<".
ListWindowDocked = value
When set to zero, the list windows will be normally available and a button is present to open the windows. When set to nonzero, the windows will be docked into the tabpane. The lists are not available anymore in a window and buttons to open the windows have disappeared. When nonzero, several listwindow related options are ignored. Default set to zero.
RememberWindowPos
ForgetWindowPos
RememberWindowPos (default) will cause Montreux to remember the position of the game/database windows when closing, en restore this position the next time such a window is opened. ForgetWindowPos will not remember the previous window position.
RememberWindowSize
ForgetWindowSize
RememberWindowSize (default) will cause Montreux to remember the size of the game/database windows when closing, en restore this size the next time such a window is opened. ForgetWindowSize will not remember the previous window size.
MainWindowXPos = pos
MainWindowYPos = pos
Define the default X,Y position of the main window. Keep this value inside usual display limits (0,0),(639,479) otherwise the window may not appear at all on some displays. Default = 0,0. These options are ignored if Montreux is run as an undetached applet.
ListWindowXPos = pos
ListWindowYPos = pos
Define the default X,Y position of game and database windows. Keep this value inside usual display limits (0,0),(639,479) otherwise the window may not appear at all on some displays. Default = 0,0.
AppletXSize = size
AppletYSize = size
Define the default X,Y size of the applet. Keep this size at least (300,200) otherwise the applet may not be visible at all. These options, when not equal to zero, overwrite the height and width attributes of the Applet tag. These options are useful mainly for browser specific configuration. They are used only for detached applets and may be not supported by all browsers. In any case you use these options, you are advised to take the widest and highest settings possible as values for the width and height attributes of the Applet tag. Default 0.
MainWindowXSize = size
MainWindowYSize = size
Define the default X,Y size of the main window. Keep this size at least (300,200) otherwise the window may not be visible at all. These options are ignored if Montreux is run as an undetached applet.
ListWindowXSize = size
ListWindowYSize = size
Define the default X,Y size of game and database windows. Keep this size at least (100,100) otherwise the window may not be visible at all. Default is 200,150.
AutoCloseGameWin = value
AutoCloseDBaseWin = value
This option set the automatic close option for the Game/DBase windows. If this option is set to any non-zero value, the Selectbutton will select and close. If set to zero the selectbutton will not close the window. Default set to 0 for the gamewindow and set to 1 for the DBase window.
AutoPopUp = value
This option sets the window that is automatically opened at startup.
0 | None |
1 | Game window |
2 | Database window |
SelectAction = value
This option determines the mouse requirements on Listbased movelists, nextlists en game and database lists. Valid options are:
0 | No action. This value causes the lists not to work. Although supported this will only disable various shortcutting functions. |
1 | Action Events. This means single clicking will select and double clicking will take action. This option is the most reliable. Default. |
2 | Item Events. This means single clicking will both select and take action. This is usually faster and more user friendly. Using this value is reported to cause problems with jview and internet explorer, due to ItemEvent problems. Be careful using this option. |
3 | Mouse Events. This option also means single clicking will both select and take action. Mouse Events are slightly less efficient than Item Events. |
AdvanceOnVarSelect = value
If set to a nonzero value, when a variation is selected Montreux will automatically play the first move of this variation. If set to zero, it will just select the variation. Default 1.
CommentWidth = widthvalue
CommentHeight = heightvalue
This options can somewhat influence the size of the comment window. The effect depends heavily on the initial main window (or applet) size. The value of CommentWidth may influence the width of the tools area. The CommentHeight option is included for completeness but will usually have little effect.
VarListSize = nrofelements
This controls the visible number of variations in the variationList. Default is 3.
8. COLOR OPTIONS.
FGColProgInfo = color
FGColDBaseName = color
FGColEventInfo = color
FGColGameInfo = color
BGColProgInfo = color
This defines the foreground and background color for the program information area. The color is defined as a 6 digit hexadecimal RGB value. The first two digits define the amount of red in the color, the middle two digits the amount of green and the last two digits the amount of blue. The lower the hexadecimal value, the less the color component is present. For instance:
BGColProgInfo = 2000E0
will create a background with very few red, no green at all and quite a lot of blue. Use 000000 for black, use FFFFFF for white.
BGColDBaseName = color
This defines the foreground and background color for database name area. See description under FGColProgInfo.
BGColEventInfo = color
This defines the foreground and background color for the event information area. See description under FGColProgInfo.
BGColGameInfo = color
This defines the foreground and background color for the game players and result information area. See description under FGColProgInfo.
FGColTab = color
BGColTab = color
This defines the foreground and background color for the tab card tabs. See description under FGColProgInfo.
FGColSelTab = color
BGColSelTab = color
This defines the foreground and background color for the currently selected tab card tab. See description under FGColProgInfo.
FGColLastMove = color
BGColLastMove = color
This defines the foreground and background color for the last move played area. See description under FGColProgInfo.
FGColNext = color
BGColNext = color
This defines the foreground and background color for the word "Next", left of the available variations list. See description under FGColProgInfo.
FGColVarList = color
BGColVarList = color
This defines the foreground and background color for the variation area. See description under FGColProgInfo.
FGColComment = color
BGColComment = color
This defines the foreground and background color for the comment area. These color settings are also used for the game summary tab. See description under FGColProgInfo.
FGColMoveList = color
BGColMoveList = color
This defines the foreground and background color for the move list area. See description under FGColProgInfo.
FGColMoveListSel = color
BGColMoveListSel = color
This defines the foreground and background color for the selected move list item. This option does not work when GraphicalMoveList is set to zero. See description under FGColProgInfo.
FGColWindowList = color
BGColWindowList = color
This defines the foreground and background color for the list of games in the game window and the list of available databases in the database window. See description under FGColProgInfo.
FGColActiveButton = color
BGColActiveButton = color
This defines the foreground and background color for active buttons. See description under FGColProgInfo.
FGColInactiveButton = color
BGColInactiveButton = color
This defines the foreground and background color for inactive buttons. See description under FGColProgInfo.
BGColWhiteSquare = color
BGColBlackSquare = color
This options define the Background colors of white and black squares on the board. This is using when using a transparant file for pieces.gif.
These options are functional only with ImgTransLayout and ImgFilterLayout type piece graphics.
SquareBorderColor = color
SquareBorderWidth = width
SquareBorderColor defines the color of the borders between squares. The width of the border is set by the SquareBorderWidth option. The width is in pixels. If the option SquareBorderWidth is set to zero (default), no square border will be seen.
When ImgTransLayout is used, part of the transparant pice image may be drawn over the border; with ImgLineLayout or ImgBoardLayout the piece image is drawn entirily inside the border. When ImgLineLayout or ImgBoardLayout are used, you probably should configure SquareBorderWidth, LastMoveFromSquareBorderWidth and LastMoveToSquareBorderWidth to the same value.
LastMoveFromSquareBorderColor = color
LastMoveFromSquareBorderWidth = width
LastMoveFromSquareBorderColor defines the color of the border of the start square concerning the last move played. The width of the border is set by the LastMoveFromSquareBorderWidth option. The width is in pixels. If the option LastMoveFromSquareBorderWidth is set to zero (default), no border will be seen.
LastMoveToSquareBorderColor = color
LastMoveToSquareBorderWidth = width
LastMoveToSquareBorderColor defines the color of the border of the target square concerning the last move played. The width of the border is set by the LastMoveToSquareBorderWidth option. The width is in pixels. If the option LastMoveToSquareBorderWidth is set to zero (default), no border will be seen.
9. TEXT OPTIONS.
GameListFormat = format
You can insert both constant text and variable game features. The format entered here is displayed in the gamelist, but items eclosed by square brackets [ and ] will be replaced by tag values, thereby obeying PGN tag names like [White], [Result] and [Annotator].
You may specify first choice and second choice items by adding tags seperated by pipes |. Montreux will try to use the first tag but displays the second tag if the first one is not available. E.g. [Event|Site] will be substituted by the event name, but in case the event is unknown the site name will be substituted instead. Items starting with '!' will be replaced by the rest of the item string.
To elaborate you may examine this example PGN game header and formats:
This option controls the layout of game information in the gamelist. You can adjust the contents of the games in the game list almost anyway you want, by changing this format.
[Event "Hoogovens"]
[Site "De Moriaan, Wijk aan Zee"]
[Date "1999.??.??"]
[Round "04"]
[White "Kasparov, G."]
[Black "Topalov, V."]
[Result "1-0"]
[ECO "B07"]
[WhiteElo "2810"]
[BlackElo "2700"]
The following formats left give the results to the right:
[White] [Black] | Kasparov, G. Topalov, V. |
[White] ([WhiteElo])-[Black] ([BlackElo]) | Kasparov, G. (2810)-Topalov, V. (2700) |
A match between [White] and [Black] | A match between Kasparov, G. and Topalov, V. |
[Event|Site] | Hoogovens |
[Opening|ECO] | B07 |
[Event] round [Round] | Hoogovens round 04 |
[Opening|!Opening unknown] | Opening unknown |
Please notice that square brackets should not be used for constant text. Default format is "[White|!Unknown] [Result|!*] [Black|!Unknown]"
The following PGN tags are currently supported by Montreux and can be used in formats: Annotator, Black, BlackCountry, BlackElo, BlackTeam, BlackTitle, Board, Date, ECO, Event, Mode, NIC, Opening, PlyCount, Remark, Result, Round, Section, Site, Stage, Subvariation, TimeControl, Variation, White, WhiteCountry, WhiteElo, WhiteTeam and WhiteTitle. The FEN and SetUp tags are also supported by Montreux but will not generate any useful result in formats.
PlayersFormat = format
This option controls the layout of information of the players text area on the screen. You can adjust the contents of this area almost anyway you want, by changing this format. Please refer to the GameListFormat option for formatting details.
Default is "[White|!Unknown] [Result|!*] [Black|!Unknown]"
EventFormat = format
This option controls the layout of information of the event text area on the screen. You can adjust the contents of this area almost anyway you want, by changing this format. Please refer to the GameListFormat option for formatting details.
Default is "[Event|Site|!Event unknown]"
ResultFormat = format
This option controls the layout of information added to the bottom of the move list. You can adjust the contents of this line almost anyway you want, by changing this format. Please refer to the GameListFormat option for formatting details.
Default is "" in which case no result line is added. You might want to set it to "[Result|!*]" to produce a "normal" result or an asterisk in case no result is known.
WhiteFormat = format
This option controls the layout of information added to the white side of the board. You can adjust the contents of this line almost anyway you want, by changing this format. Please refer to the GameListFormat option for formatting details.
Default is "White: [White|!Unknown]". If the string is empty ("WhiteFormat=") no line is added.
BlackFormat = format
This option controls the layout of information added to the black side of the board. You can adjust the contents of this line almost anyway you want, by changing this format. Please refer to the GameListFormat option for formatting details.
Default is "Black: [Black|!Unknown]". If the string is empty ("BlackFormat=") no line is added.
TxtNextMove = text
TxtNextMoveMenuOpt = text
Set the text of the Next move button/menu option to value. Default = "> Move".
TxtPrevMove = text
TxtPrevMoveMenuOpt = text
Set the text of the Previous move button/menu option to value. Default = "< Move".
TxtNextVar = text
TxtNextVarMenuOpt = text
Set the text of the Next variation button/menu option to value. Default = ">> Var".
TxtPrevVar = text
TxtPrevVarMenuOpt = text
Set the text of the Previous variation button/menu option to value. Default = "<< Var".
TxtNextGame = text
TxtNextGameMenuOpt = text
Set the text of the Next game button/menu option to value. Default = ">> Game".
TxtPrevGame = text
TxtPrevGameMenuOpt = text
Set the text of the Previous game button/menu option to value. Default = "<< Game"
TxtStartGameMenuOpt = text
Set the text of the Start of game menu option to value. Default = "Start Game".
TxtEndGameMenuOpt = text
Set the text of the End of game menu option to value. Default = "End Game"
TxtDatabases = text
TxtDatabasesMenuOpt = text
Set the text of the Databases button/menu option to value. Default="Databases". If the database window is docked TxtDatabases applies to the Database tab.
TxtRefresh = text
TxtRefreshMenuOpt = text
Set the text of the Refresh button/menu option to value. Default = "Refresh".
TxtFlip = text
TxtFlipMenuOpt = text
Set the text of the Flip button/menu option to value. Default = "Flip".
TxtGames = text
TxtGamesMenuOpt = text
Set the text of the games button/menu option to value. Default = "Games". If the game window is docked TxtGames applies to the games tab.
TxtPrintDb = text
TxtPrintDbMenuOpt = text
Set the text of the Print DB button/menu option to value. Default = "Print DB".
TxtExitMenuOpt = text
Set the text of the Exit menu option to value. Default = "Exit". Not available for applets.
TxtSelect = text
Set the text of the select button in the games and databases windows to value. Default = "Select".
TxtClose = text
Set the text of the close button in the games and databases windows to value. Default = "Close".
TxtNext = text
Set the text left of the next move list to value. Default = "Next:".
TxtFileMenu = text
Set the text of the File menu to value. Default = "File"
TxtMoveMenu = text
Set the text of the Move menu to value. Default = "Moves"
TxtViewMenu = text
Set the text of the View menu to value. Default = "View"
TxtMoveTab = text
TxtMoveTabMenuOpt = text
Set the text of the Move tabcard tab/menu option. Default = "Cmnt".
TxtMoveListTab = text
TxtMoveListTabMenuOpt = text
Set the text of the Movelist tabcard tab/menu option. Default = "Moves".
TxtGameTab = text
TxtGameTabMenuOpt = text
Set the text of the Game summary tabcard tab/menu option. Default = "Data".
TxtAboutTab = text
TxtAboutTabMenuOpt = text
Set the text of the About tab/menu option. Default = "About".
TxtStartPos = text
Set the text indicating the start position in the movelist to value. Default = "Start Position".
TxtMontreux = text
Set the text of the main window to value. This option only can be altered by licensed users. This option is ignored by undetached applets. Default = "Montreux".
TxtAbout = text
Set the text to appear in the about tab. This option only can be altered by licensed users. This option can be used more than once. In that case the values are concatenated. Default empty.
10. FONT OPTIONS.
FontMove = font
FontMoveList = font
FontVarList = font
FontComment = font
FontList = font
FontLabel = font
FontTab = font
FontButton = font
11. MISC OPTIONS.
PrintSettings = value
StartupDelay = delay
This option was introduced as a test for use on NC's and now probably is pretty useless.
WorkAroundBugs = value
At this moment the option avoids the use of ItemEvents on Microsoft Java platforms (like IE), because of a bug in the MS JVM. (How to create platform dependant Java apps.)
WaitForImageLoading = value
12. MDCP OPTIONS.
MDCP needs a config file but ignores most options. It only uses the following options:
13. OPTION INDEX.
FontSizeMove = fontsize
Define the font and the fontsize of the last move played. Defaults are "Courier" and 12.
FontSizeMoveList = fontsize
Define the font and the fontsize of the move list. Defaults are "Courier" and 12.
FontSizeVarList = fontsize
Define the font and the fontsize of the variation list (next moves). Defaults are "Courier" and 12.
FontSizeComment = fontsize
Define the font and the fontsize of the comment window. Defaults are "Dialog" and 12.
FontSizeList = fontsize
Define the font and the fontsize of the game and database window lists. Defaults are "Dialog" and 12.
FontSizeLabel = fontsize
Define the font and the fontsize of the various labels displayed, e.g. the current game information, de program name and the database name. Defaults are "Dialog" and 12.
FontSizeTab = fontsize
Define the font and the fontsize of the tab card headers. Defaults are "Dialog" and 12.
FontSizeButton = fontsize
Define the font and the fontsize of the botton labels. Defaults are "Dialog" and 12.
When set to any nonzero value all option values are printed on the console window upon completion of reading the configuration file. Default value is 0.
This option causes Montreux to wait some time before showing the main window. The argument is the delay time in milliseconds. The default value is 0. The option is not used for undetached applets.
If set to zero, Montreux will run in standard mode and not try to avoid bugs. If set to any nonzero value, Montreux tries to workaround bugs, possibly at the cost of some functionality, with the benefit of stability. The bugs that are worked around may vary per version. Default set to 1.
WaitForImageCropping = value
These options are expirimental options that cause Montreux to wait for Image loading or Image cropping (the process of splitting a big image into tiny ones) to complete. Montreux will wait if the options are set to any nonzero value, otherwise Montreux continues. Default set to 1, and they should not be changed unless Montreux does not properly startup or shows improper Image buttons.
MDCP currently ignores the entire Database section.