Contents


1. Features
2. Program control
  2.1 Hotkeys setup
  2.2 Mouse support
  2.3 Command Line
  2.4 Other
3. Slideshow
  3.1 Small slideshow
  3.2 Total slideshow
  3.3 Slideshow scripts
  3.4 Common slideshow commands
4. CD Creation
  4.1 Photo preparation
  4.2 Macros
  4.3 Tags
  4.4 PhotoCDBrowser setup
  4.5 Autorun
5. Interface setup
  5.1 Default files
  5.2 PhotoCDBrowser.ini setup
  5.3 Configuration files - redefining
  5.4 Multilanguage support
6. About version
 
Appendix A. Glossary
Appendix B. Ini-file parameters
Appendix C. Effects numbers

Program development history

   To see features of a particular version click "select". Descriptions of the features for that version will then be highlighted in yellow.

^  1. Features

   PhotoCDBrowser displays photos and images - graphic files on compact discs or in folders on a hard disk drive.
   The basic program features are described below:

^  2. Program control

   All program commands are available by means of hotkeys. For help with hotkeys press F2. Most of the useful program commands are explained in the main menu - press F10. There is a context menu available within the navigator window. It allows you to access the upper level folders quickly. To access this context menu right click the mouse button in the navigator window.

^  2.1 Hotkeys setup

       All hotkey settings may be stored in a text file. Such text files must have a ".keys.txt" extension. There are some hotkey files in the program archive. The rules for writing hotkey files are very simple. Read the header of any of these files for details. If your new hotkey file contains errors after the program begins running a new section will appear called [Diagnostics] with detailed error descriptions to help you.

^  2.2 Mouse support

   If an image falls outside the limits of the screen, it can be repositioned with the mouse. Position the pointer, press the left mouse button and without releasing it, move the mouse cursor in the direction you wish to move the image then release the mouse button.
   As you zoom in on an image, the outer area of the image will at some point exceed the limits of the screen. When this occurs the mouse cursor changes from the ordinary pointer to this: , and by pressing the left mouse button the cursor will show all the possible directions for moving the image such as this: .    If your mouse supports them, PhotoCDBrowser is compatible with the scaling and scrolling modes of MS Office 97-2000. If your mouse is an IntelliMouse or compatible, the program gives you additional capabilities. You can use the mouse wheel to either zoom in or out on the current mage or change to the next image within the current folder. To switch between these modes use the following command::
 Alt + Z - switches the IntelliMouse wheel button function between zooming and navigation.
This setting is kept in the configuration file parameter IntelliMouseMode.

^  2.3 Command Line

   PhotoCDBrowser can process a command line. You can pass in command lines for various files:

^  2.4 Other

   If you do not want the PhotoCDBrowser.wav file to play during start, press the Ctrl key. This is true for the sound comments too.

^  3. Slideshow

   The following are the slideshow modes of PhotoCDBrowser.

^  3.1 Small slideshow

   The small slideshow displays all files in the current folder only. The current folder is the folder displayed in the navigator window.
   During a small slideshow the mouse cursor looks like this:
   The small slideshow can be activated from the menu by choosing "Slideshow Small", or by pressing the F12 key. To leave the small slideshow mode just press any key or the right mouse button.

^  3.2 Total slideshow

   The total slideshow differs from the small slide show in that it displays all image files in the current folder and all subdirectories of the current folder.
   During the search for these files the mouse cursor looks like: , after the search it looks like: , and in pause mode it looks like:
   To start a total slideshow click the left mouse button and choose Slideshow Total from the menu or use the following keys from the keyboard:
 F9  - begin or stop total slideshow
 Pause  - stop or continue total slideshow

^  3.3 Slideshow scripts

   If a slideshow script is placed in the same folder where the PhotoCDBrowser program is located, Total Slideshow will display an intermediate menu that will allow you to choose between a slideshow composed of the files listed in the script or composed of the files in the current folder (as listed in the navigator window). A simple method for creating a script is to run the following command during a Total Slideshow:
 Ctrl + S - to create the script for the current total slideshow.
   This command will create a slideshow script file in the same directory where the PhotoCDBrowser program is located. After the slideshow has completed, this file can be renamed and edited. This command is useful in the planning stages of designing a CD for your photos. It is no longer useful once the CD has been created. The parameter SlideShowAbsolutePathes from the configuration file determines what type of file path (absolute or relative) will be written to the script.

^  3.4 Common slideshow commands

 *  - accelerates a slideshow. The transition period between the display of photos is increased by 50 %. After executing this command there is a transition to the next photo.
 /  - slows down a slideshow. The period between the display of photos decreases by one third.
After the acceleration or delay of a slideshow, the duration of the last transition is written to the SlideShowDelay parameter in the configuration file.

^  4. CD Creation

   To create a CD of your favorite photos you must of course have a CD-Writer, CD writing software and CDR or CDRW discs.
   First make a list of all the photos you wish to have on your CD and be sure to acquaint yourself with how to setup PhotoCDBrowser correctly.
   Next design the structure of the folders you want on your CD. Let's assume that in the root directory of your CD you will create 2 subdirectories; one named Archive and one named Browser. In the first directory you arrange all your photo files and in the second directory you place all the PhotoCDBrowser program files. Now you can prepare the photos and setup the PhotoCDBrowser program.

^  4.1 Photo preparation

   Only place image file types in your Archive folder that can be recognized by the PhotoCDBrowser program.
  The formats it recognizes are: *.tif *.jpg *.bmp *.pcx *.tga *.eps.
  If desired you can add comments to your photos:    For saving comments to your photos in TIFF or JPEG format, it is necessary to create a graphics file in Adobe Photoshop.
   In Adobe Photoshop, from the menu choose File then File Info... and you will then see the dialog represented below.

In the Caption field you can type the text of the comment to an image file.

^  4.2 Macros  <

   Macros are keywords placed between percent characters which represent information about a graphics file (photo). The information a macro represents will be displayed in the comment for your photo (graphics file). These macros will only work in Comments and in the ApplicationName parameter from the configuration file.
   A list of macros with explanations:
 %FILE_NAME%  - current file name with extension
 %SHORT_FILE_NAME%  - current file name without extension
 %FOLDER_NAME%  - name of the current photo folder (same as a first item in the navigator window)
 %PATH%  - full path to the current photo folder
 %IMAGE_WIDTH%  - width of the current photo in pixels
 %IMAGE_HEIGHT%  - height of the current photo in pixels
 %IMAGE_SIZE_K%  - size of the current file in kilobytes
 %IMAGE_SIZE_M%  - size of the current file in megabytes
 %ROTATE_LEFT%  - to rotate photo to the left by 90° before showing photo
 %ROTATE_RIGHT%  - to rotate photo to the right by 90° before showing photo
 %CURRENT_FOLDER%  - full path to the current folder
 %SLIDESHOW_COUNT%  - total count of photos in the slideshow
 %SLIDESHOW_CURRENT%  - number of the current photo in the slideshow
 %MUSIC_FILE_NAME%  - current music file name with extension
 %MUSIC_SHORT_FILE_NAME%  - current music file name without extension

^  4.3 Tags  <

   It is possible to use special tags in the text of comments. Examples of all tags are shown below:
<REM> The text within these tags are remarks and will not be displayed </REM>
<SOUND> Text within this tag will be seen only if the sound comment feature is turned on </SOUND>
<MUSIC> This text will be seen only if background music is turned on </MUSIC>
<SLIDESHOW> This text will be seen only during a slideshow </SLIDESHOW>
   It is also possible to use language tags which match the name of the current interface language file. For example if the parameter ApplicationLanguage=English, i.e. current language file is English.lang.txt, then:
<ENGLISH> The comment text within these tags will be seen </ENGLISH>
However if you choose another language, the comment text within the above English tags becomes invisible.
   All opening tags should have closing tags. Symbols within a tag have no special meaning. Tags can be nested. Unrecognized tags which satisfy the rules described above are treated as REM tags. Negative tags can also be used. Examples of negative tags are shown below:
<!SOUND> This text will be seen only if the sound comment is turned off </!SOUND>
<!SLIDESHOW> This text will be seen only if there is no slideshow in progress </!SLIDESHOW>

^  4.4 PhotoCDBrowser setup

   For PhotoCDBrowser to successfully display the photos on your CD you must configure it correctly . Configuration consists of creating a autorun.inf file for the CD and editing the PhotoCDBrowsr.ini file.
   This is in addition to creating any scripts for slideshows needed for your CD.

^  4.5 Autorun

   If you wish to have PhotoCDBrowser auto start (where it starts automatically when the CD is inserted into the CD-ROM drive) then you will need to edit or create an autorun.inf file. This file should be placed in the root directory of your CD. Here is how it should look using our example above:
[AutoRun]
Open=Browser\PhotoCDBrowser.exe
Icon=Browser\PhotoCDBrowser.exe,0
   The number 0 at the end of the second line above means that the first icon of the program is displayed by the autorun feature in Windows Explorer or My Computer. To change icons substitute any of the other numbers assigned to the icons in the program as shown below. There are a total of 5 icons to choose from:

   The file autorun.inf can contain additional parameters which, for example, will allow the MS Windows Explorer or My Computer to display two slideshow scripts. Here is how to expand the autorun selection feature:
[AutoRun]
Open=Browser\PhotoCDBrowser.exe
Icon=Browser\PhotoCDBrowser.exe,0
Shell\Script1=&Slideshow Script 1 ...
Shell\Script1\command=Browser\PhotoCDBrowser.exe script1.script.txt
Shell\Script2=&Slideshow Script 2 ...
Shell\Script2\command=Browser\PhotoCDBrowser.exe script1.script.txt
   In the case above there are 2 slideshow scripts: script1.script.txt and script2.script.txt. The popup menu displayed when the user clicks the right mouse button on the CD-drive where your CD is inserted looks like this:

   Be careful with long file names of scripts! If the name of the script contains white spaces - it needs to be in quotes, for example:
Shell\Script3=&Slideshow Script 3 ...
Shell\Script3\command=Browser\PhotoCDBrowser.exe "Slideshow Script 3.script.txt"

^  5. Interface setup

   The interface of the program depends on:

^  5.1 Default files

   During startup the program searches in the current folder for files used by default for the various functions. A list of these files is shown below.
PhotoCDBrowser.bmp - splash file. This file is displayed on the opening screen until the user chooses a photo for viewing.
PhotoCDBrowser.ni - bmp file with extension ni (Navigator Icons). If the program finds such a file, the icons used for the navigator window are replaced by the icons from within this file.
The minimum variation (4 icons):
The maximum variation (13 icons):
The obligatory requirements for this file are: PhotoCDBrowser.wav - the sound file which is played during the startup of the program.
PhotoCDBrowser.ini - the file containing the parameters and values for the program configuration.

^  5.2 PhotoCDBrowser.ini setup

   The appearance and behavior of the PhotoCDBrowser program is determined in many respects by the parameters and values within the global configuration file named PhotoCDBrowser.ini. The parameters are read from this file only once - during the startup of the program. An example of the contents of this file along with explanations is shown in the Appendix B.
   The program automatically saves the settings in the PhotoCDBrowser.ini file when it closes including any changes made by the user during the program operation. Consequently you cannot set this file's attribute to ReadOnly.

^  5.3 Configuration files - redefining

   PhotoCDBrowser understands local configuration files. You can setup individual settings for a folder, a slideshow script or a graphic file. The local configuration file can but need not contain all necessary parameters. You might only want to include those parameters needed for a particular folder, script or file. If the local configuration file does not contain all necessary parameters, then any absent parameters are automatically inherited from the global configuration file or from the previous local configuration file. Here are the keyboard commands for local configuration file management:
 Ctrl + D  - run Notepad to edit the configuration file attached to the current photo
 Ctrl + Backspace  - delete the configuration file attached to the current photo
 Shift + D  - run Notepad to edit the configuration file in the current folder
 Shift + Backspace  - delete the configuration file in the current folder
   If you have a script with the name "SlideShow1.script.txt" then a local configuration file with the name "SlideShow1.script.ini" will be an attached to this local slideshow script file.

^  5.4 Multilanguage support

   The language interface of the program is determined by the contents of the *.lang.txt files. The number of files with such extensions which reside in the same directory as the program will determine how many languages the program interface will support. The current language is determined by the value of the parameter ApplicationLanguage. If, for example, the value of this parameter is set to AAA, the program will search for the file AAA.lang.txt and in a dialog box the user will be given a choice of languages with the default language shown as AAA. If the program does not find a file AAA.lang.txt, it will create it and fill it with the default English strings.

^  6. About version

   The current program version is 2.95. A versions history is available here. New versions of the program will be upload to www.photocdbrowser.com. Send bug reports and suggestions for future versions to support@photocdbrowser.com
   PhotoCDBrowser is a freeware program with "AS IS" license agreement.
   When creating this program the libraries of other authors were used:
PaintLib - Copyright (C) 1996-2000, Ulrich von Zadow
LibTiff - Copyright (C) 1988-1997 Sam Leffler, Copyright c 1991-1997 Silicon Graphics, Inc.
LibJpeg - Copyright (C) 1991-1997, Thomas G. Lane
Xaudio - Copyright (C) 1996-2000 Xaudio Corporation

I want give a token of appreciation to Bill Mudd for his input and collaboration in this help file creation.

PhotoCDBrowser Copyright (C) 1999-2002 M.Onyshchuk


^  Appendix A. Glossary

Navigator
Comment
Sound comment
Slideshow
Slideshow script
Effects
Current effects set
CommandsAfter...
RGB

<  Navigator is a window that displays the folders and files you can choose to view in the program main window. If you click the right mouse button within the navigator window a popup menu is displayed which enables the you to change to any directory above the current level directory.
For example in the navigator window if the folder is open to C:\Program Files\PhotoCDBrowser\My Photos\Part1, then the popup menu will look like:

<  Comment is text which can be displayed with a photo. The number of characters in each comment should not exceed 1023. Within the comment text you can use macros or tags. Comments may be written:

   Also available are:    The priority when building the comments (embedded comments, comments to folders, scripts and global comments) is determined by the CommentsOrder parameter in the PhotoCDBrowser.ini file.

<  Sound comment to a photo is a sound format file (WAV only !) located in the same folder as the photo itself. It must have the same name as the photo file (except it will have a .WAV format extension). The sound comment plays every time its associated photo file is displayed. In the navigator window files with sound comments have the following icon:

<  Slideshow is a special program mode which displays one photo after another. The delay time between photo displays is determined by the parameter SlideShowDelay in the PhotoCDBrowser.ini file.

<  Slideshow script is a text file with the extension .script.txt. An example of the name of a slideshow script file is - Summer 2000.script.txt. If such a file were placed in the same folder with PhotoCDBrowser, then at the start of a Total Slideshow a menu would appear with choices that would include the script Summer 2000.
   The slideshow script file has a very simple structure. On the first line is a format value followed by a semicolon (after which any comments can be written). All subsequent lines beginning with the second line are composed of the path and name of each of the image files - each image file and its path must have a separate line.
Variations of path designations:
C:\My Documents\My Phots\Photo1.jpg
:\My Archive\Photo1.jpg
   In the second example above it is assumed that the folder My Archive is located on the same drive as the PhotoCDBrowser program. If the folder is on a CD it is necessary to use this second variation of designating a path because drive letter assignments for a CD-ROM device vary from one computer to another.

<  Effects are various types of transitions from one photo to the next photo. During transitions the next photo is slowly painted over the previous photo using a special effect.

<  Current effects set is a list of effects from the EffectsIncluded parameter. This would not include effects listed in the EffectsExcluded parameter. With these two parameters you can manage the transition effects in your slideshow.
   Example:
 EffectsIncluded=all
 EffectsExcluded=none
With the above settings all available transition effects will be used in your slideshow.

<  CommandsAfter... are commands that you want to be executed "after" a specified program event.
It uses the numbers from the hotkeys definition file.
   Example:
In the default hotkeys definition file (Default.keys.txt) 172 is assigned to F10 (call main menu).
 CommandsAfterProgramStart=172
The above setting will result in the main menu opening after the program startup.

<  RGB is a term that designates color in combinations of red, green and dark blue in that order (Red, Green, Blue). The amount of each of these colors in a combination is set by numbers from 0 to 255.
   Examples:
 0,0,0 - black
 255,255,255 - white
 255,0,0 - red
 0,255,0 - green
 0,0,255 - blue


^  Appendix B. Ini-file parameters  <

   This appendix contains the list of all the parameters in the PhotoCDBrowser.ini configuration file along with explanations of each parameter.
 
[General Settings]
ApplicationLanguage
ApplicationName
ApplicationIcon
PathHorizon
PathToStart
BackgroundColor
PlaySoundCommentToPhoto
KeysHelpRunCount
IntelliMouseMode
ScaleStart
ScaleSavingMode
OpenPhotoWith
OpenCommentWith
OpenConfigurationWith
 
[Navigator Settings]
Navigator
NavigatorRect
NavigatorDockingSpace
NavigatorBackgroundColor
NavigatorTextColor
 
[Comment Settings]
Comment
CommentRect
CommentRectAutoSize
CommentColor
CommentShadowColor
CommentShadowOffset
CommentAlign
CommentFont
CommentFontFile
CommentsOrder
CommentsIncluded
 
[Slideshow Settings]
SlideShowAutoExec
SlideShowAutoExecScript
SlideShowDelay
SlideShowAbsolutePathes
SlideShowStopScreenSaver
SlideShowMoveDownCursor
SlideShowSmallEndAction
SlideShowTotalEndAction
SlideShowSmallRandom
SlideShowTotalRandom
 
[Thumbnails Settings]
Thumbnails
ThumbnailsSize
ThumbnailsSpaceX
ThumbnailsSpaceY
ThumbnailsBorder
ThumbnailsBorderColor
ThumbnailsCacheInFolders
ThumbnailsFineQuality
ThumbnailsSelection
 
[Music Settings]
Music
MusicPresent
MusicSearchMask
MusicRandom
 
[Effects Settings]
Effects
EffectsIncluded
EffectsExcluded
EffectsRandom
 
[Commands Settings]
CommandsHotkeys
CommandsAfterProgramStart
CommandsAfterMusicFileEnd
CommandsAfterSlideshowStart
CommandsAfterSlideshowFinish
CommandsAfterZoomIn
CommandsAfterZoomOut
CommandsAfterKeyDown
CommandsAfterMouseMove

[General Settings]

<  ApplicationLanguage
The language in which the menu and dialogs of the program will be displayed. This is determined by the value of the parameter ApplicationLanguage in the PhotoCDBrowser.ini file. The value must be the same as the name of one of the language files with the extension .lang.txt.
If, for example, the setting for this parameter is:
ApplicationLanguage=English
The program will search for a file named English.lang.txt and display a dialog box of languages with the default choice shown as English. If the parameter is empty, the program at startup will show a dialog box of all the language choices.

<  ApplicationName
The name which will be displayed on the title bar of the navigator window. It is possible to use macros in the value of this parameter. For example:
ApplicationName=Photoarchive [%CURRENT_FOLDER%]

<  ApplicationIcon
The icon number (1-5), which will be assigned to the program during startup.
Choices:

<  PathHorizon
This parameter limits the PhotoCDBrowser from displaying any files above the path assigned to this parameter. The current directory folder is not displayed in the Navigator window so the user can not access files above this directory. This is especially useful in creating CDs. If you place all the graphic files you want displayed in the directory assigned to this parameter (or its subdirectories), the user will have access to the graphic files but not the program files.
Examples:
:\Archive - path on a drive where the PhotoCDBrowser.exe file is located.
..\Main - path of a directory one level above the directory where PhotoCDBrowser.exe is located.
.\Photos - path of a directory one level below the directory where PhotoCDBrowser.exe is located.

<  PathToStart
The path (drive and directory) where you want the PhotoCDBrowser to begin displaying graphic files. It can be a different drive and directory than where the PhotoCDBrowser.exe program is located. When the Navigator window is activated, it will display all the files in this directory including the directory and any subdirectory folders. The current directory folder is displayed as open. If the user clicks on the open directory folder, the Navigator will then display all the files and folders in the path above the one listed in this parameter. This way the Navigator window can be used to explore the rest of the computer for other graphic files to display in PhotoCDBrowser. To limit this feature see PathHorizon.
Examples:
:\Archive - path on a drive where the PhotoCDBrowser.exe file is located.
..\Main - path of a directory one level above the directory where PhotoCDBrowser.exe is located.
.\Photos - path of a directory one level below the directory where PhotoCDBrowser.exe is located.

<  BackgroundColor
Color of the background of the main program display window. It is set using RGB values.

<  PlaySoundCommentToPhoto
Parameter that determines if sound comments are played. It can also be changed from the menu or the keyboard (F4).
Choices:
 0 - the comment will not play
 1 - the comment will play

<  KeysHelpRunCount
Number of times the program starts with hot keys hints displayed. Each start of the program decrease this value by 1 (this is true only for hard drives, not for CDs).
Default value - 0.

<  IntelliMouseMode
IntelliMouse operation mode.
Choices:
 z - zooming
 n - navigation on files (next-previous)

<  ScaleStart
Start scale mode
Choices:
 r - (Real) - each photo will initially be displayed in real scale (see "Real Scale" menu item).
 f - (Fit to Screen) - each photo will initially be fitted to screen.
 a - (Auto) - "automatic" mode. This means that in the case of small photo (if the size of photo is less than size of the screen area) it will be displayed in real scale and in case of a large photo it will be fitted to screen.

<  ScaleSavingMode
Parameter that determines if the scale of the previous image will be saved and applied to the next image after a transition. This parameter can be changed by the Alt+S shortkey.
Choices:
 0 - scale is not saved
 1 - scale is saved

<  OpenPhotoWith
The name of the program which is used to open the current file when Ctrl+O is pressed. If this Parameter is not specified - the program used is the one associated in MS Windows with files that have this type of extension such as (*.tif, *.jpg, ...).
Examples:
 photoshp.exe
 acdsee.exe
It is possible to specify any program listed in the Windows registry under:
HKEY_CLASSES_ROOT\Applications

<  OpenCommentWith
The name of the program which is used to edit text comment files. This editor is runned after Shift+T and Ctrl+T pressing. Full path to comment is passed to this editor in the command line.
Example:
 OpenCommentWith=notepad.exe

<  OpenConfigurationWith
The name of the program which is used to edit configuration files. This editor is runned after Shift+D and Ctrl+D pressing. Full path to configuration files (PhotoCDBrowser.ini) is passed to this editor in the command line.
Example:
 OpenConfigurationWith=notepad.exe

[Navigator Settings]

<  Navigator
To show or to not show the navigator window at the startup of the program.
Choices:
 0 - navigator window is hidden at startup
 1 - navigator window is visible at startup

<  NavigatorRect
Initial coordinates of navigator window. It's assumed that the size of the program window is 1000x1000 and the real screen resolution is substituted later. The order of the field coordinates are as follows - X, Y, W, H (horizontal displacement from the left side of the screen, vertical displacement from the top of the screen, width, height).

<  NavigatorDockingSpace
Parameter which designates the docking space near the screen boundaries. It's measured in pixels.
Choices:
 minimum value - 0 (navigator docking is turned off),
 maximum value - 19
Default value - 9

<  NavigatorBackgroundColor
If this parameter is present and given a value, the color (RGB) of the navigator window's background will have that color value. Otherwise the color from the default Windows setting will be used.
Parameter is not obligatory!

<  NavigatorTextColor
If this parameter is present and given a value, the color (RGB) of navigator text labels will have that color value. Otherwise the color from the default Windows setting will be used.
Parameter is not obligatory!

[Comment Settings]

<  Comment
To show or to not show the comments to photos at the startup of the program.
Choices:
 0 - comments are hidden
 1 - comments are visible

<  CommentRect
Coordinates of the display rectangle for comments. It's assumed that the size of the program window is 1000x1000 and the real screen resolution is substituted later. The order of the field coordinates are as follows - X, Y, W, H (horizontal displacement from the left side of the screen, vertical displacement from the top of the screen, width, height).

<  CommentRectAutoSize
Parameter for switching on the autosize mode in displaying comment text. If the comments with the current font do not fit within the display rectangle specified by the parameter CommentRect, the display rectangle will be re-sized to fit the comment.
Choices:
 0 - comment rect autotuning is turned off
 1 - comment rect autotuning is turned on
Default value - 1

<  CommentColor
Color of comment text shadow. It is set as an RGB value.

<  CommentShadowColor
Color of comment text shadow. It is set as an RGB value.

<  CommentShadowOffset
Value of this parameter determines the displacement to the right and downwards from the comment text (in pixels).

<  CommentAlign
This parameter determines align of comments text.
Choices:
 l - to left
 c - to center
 r - to right
Default value - c

<  CommentFont
Font of the comment. The order of font name and effect fields are as follows:
 the name, size, Bold (0-1), Italic (0-1), Underline (0-1).
Font by default:
 Arial,24,0,0,0

<  CommentFontFile
Name of a font file which should be in the same folder as the program. This parameter has to be specified when you want to use fonts which might not be loaded or even exist on the computer viewing the CD with the PhotoCDBrowser program. You should also include the font file itself on the CD just to be safe. Example 1 for TTF font "Berling Antiqua Bold":
CommentFontFile=berlingb.ttf
Example 2 for raster font "Modern":
CommentFontFile=modern.fon
Files "berlingb.ttf" and "modern.fon" must be placed near program (Photo‘‚Browser.exe) in both cases.

<  CommentsOrder
This parameter determines the display priority assigned to the various types of comments.
Choices:
 1  - results in a display priority with the following order:
  • embedded comments within graphics files (only for TIFF or JPEG formats)
  • text file comments attached to graphics files
  • comments from descrip.ion files
  • comments attached to folders or slideshow scripts
  • global comments
 2  - results in the same as "1" above but in the reverse order - from global to embedded comments.
 3  - results in only the first comment found being displayed as the program searches in the order from embedded to global comments.
 4  - results in only the first comment found being displayed as the program searches in the order from global to embedded comments.

<  CommentsIncluded
This parameter determines available parts of result comments. Unlike CommentsOrder this parameter determines not order but set of available parts.
Highest possible set:
 CommentsIncluded=e,a,d,f,s,g
Each character in this set determines one type of available comments:
 e - embeded in the photo
 a - attached to th photo text file
 d - comment from descript.ion file
 f - comment to folder
 s - comment to slideshow script
 g - global comment
If you want to hide some parts from result comments you need only exclude suitable character from this parameter. For example to hide date and time of snapshot from digital camera (embeded comment) you need to write:
 CommentsIncluded=a,d,f,s,g

[Slideshow Settings]

<  SlideShowAutoExec
The Parameter which specifies whether or not Total Slideshow will start immediately after the startup of the program.
Choices:
 0 - will not start
 1 - will start a total slideshow
 2 - will start a small slideshow

<  SlideShowAutoExecScript
The designated script of a slideshow which will begin at the startup of the program if the parameter SlideShowAutoExec is set to the value 1.
Example:
 SlideShowAutoExecScript=Slideshow1.script.txt

<  SlideShowDelay
Delay between two successive frames in slideshow mode. This is measured in seconds.
Choices:
 minimum value - 1.00
 maximum value - 600.00
Default value - 3.00

<  SlideShowAbsolutePathes
Parameter which specifies what type of path (absolute or relative) is assigned to the photo files and written to the slideshow script during the current total slideshow if Ctrl + S is pressed.
Choices:
 1 - absolute paths, i.e. with actual drive letter (for example E:\My Archive).
 0 - relative paths, i.e. without a drive letter but with a path "relative" to the drive root (for example :\My Archive)
Default value - 0

<  SlideShowStopScreenSaver
Parameter that specifies whether to stop or not to stop the screensaver when running a slideshow.
Choices:
 0 - do not stop the screensaver
 1 - stop the screensaver
Default value - 1

<  SlideShowMoveDownCursor
Parameter that specifies whether to move the mouse cursor down (to hide) or not to move the mouse cursor down during a slideshow.
Choices:
 0 - to not move down
 1 - to move down (hide)
 2 - to move right (hide)
Default value - 0

<  SlideShowSmallEndAction
Parameter specifies the action to be performed at the end of Small Slideshow.
Choices:
 b - to begin slideshow again
 s - to stop slideshow
 q - to quit program
Default value - b

<  SlideShowTotalEndAction
Parameter specifies the action to be performed at the end of Total Slideshow.
Choices:
 b - to begin slideshow again
 s - to stop slideshow
 q - to quit program
Default value - b

<  SlideShowSmallRandom
Parameter sets in what order the photo files will be shown in the small slideshow mode. The photos can be shown as sorted by name or shown randomly.
Choices:
 1 - the photo files will be shown randomly
 0 - the photo files will be shown in the usual order

<  SlideShowTotalRandom
Parameter sets in what order the photo files will be shown in the total slideshow mode. The photos can be shown as sorted by name or shown randomly.
Choices:
 1 - the photo files will be shown randomly
 0 - the photo files will be shown in the usual order

[Thumbnails Settings]

<  Thumbnails
Parameter which turns on or turns off thumbnails mode. In this mode small reduced copies of each photo are displayed within the navigator window instead of just text names. This parameter can also be turned on or turned off from the menu or using the keyboard (Ins) key.
Choices:
 1 - thumbnails mode is turn on
 0 - thumbnails mode is turn off

<  ThumbnailsSize
Size of thumbnails - this is set in pixels.
Choices:
 minimal value - 32
 maximal value - 96

<  ThumbnailsSpaceX
Horizontal spacing between two thumbnails. This is set in pixels.
Choices:
 minimal value - 13
 maximal value - 53

<  ThumbnailsSpaceY
Vertical spacing between two thumbnails. This is set in pixels.
Choices:
 minimal value - 13
 maximal value - 53

<  ThumbnailsBorder
Parameter which determines whether the thumbnails have a border.
Choices:
 0 - border is absent
 1 - border is present

<  ThumbnailsBorderColor
Thumbnail border color. This is set as an RGB value.

<  ThumbnailsCacheInFolders
Parameter which turns on thumbnails being cached in a folder, i.e. it allows the creation of the PhotoCDBrowser.cache file containing all the thumbnails for the current folder.
Choices:
 0 - caching turned off - PhotoCDBrowser.cache files will not be created
 1 - caching turned on - PhotoCDBrowser.cache files will be created

<  ThumbnailsFineQuality
This parameter turns on or turns off "fine quality" mode for thumbnails. Be careful! If this parameter is turned on the total time needed for the creation of thumbnails may be increased up to 30%-100%.
Choices:
 1 - fine quality mode is turned on
 0 - fine quality mode is turned off

<  ThumbnailsSelection
This parameter manage thumbnailes selection.
Choices:
 1 - usual selection mode
 2 - extended selection mode (only background of thumbnailes)

[Music Settings]

<  Music
Parameter which specifies whether background music is included. It can also be changed through the menu or keyboard (F3).
Choices:
 0 - background music is switched off
 1 - background music will play at once or after startup of the program, or after starting a slideshow. This is set by the MusicPresent parameter.

<  MusicPresent
Parameter specifies whether background music always plays in the background or only during slideshows.
Choices:
 a - background music will play always
 s - in (slideshow only

<  MusicSearchMask
Parameter sets a mask for searching a set of music files used as background music or as sound comments. It searches all files with MP1, MP2 and MP3 formats.
Examples:
 MusicSearchMask=C:\My Music\*.* - all files in the folder C:\My Music will be searched
 MusicSearchMask=:\Autorun\*.mp? - in this case it is assumed that PhotoCDBrowser starts from the drive and in the root directory where the  Autorun.inf file is located. It searches all files in this directory whose extension begins with "MP".
 MusicSearchMask=*.mp3 - searches all files with the extension "mp3" located in the same folder as PhotoCDBrowser.
 No search is made of subfolders. Files are sorted by name.

<  MusicRandom
Parameter sets in what order the background music files are played. The files can be played as sorted by name or played randomly.
Choices:
 0 - the music files will be played as sorted by name
 1 - the music files will be played randomly

[Effects Settings]

<  Effects
This parameter turns on or turns off transition effects. The order in which the effects occur in the current set is determined by EffectsRandom parameter.
Choices:
 a - effects are always turned on
 s - effects are turned on in slideshows only
 n - none. Effects are turned off
 m - effects are turned on in small slideshow only
 t - effects are turned on in total slideshow only

<  EffectsIncluded
List of effects included in the current effects set.
Choices:
 all - all available effects in the current program version will be included.
 _all_ Use this parameter to get a list of effects available in the current version. Start PCDB with "EffectsIncluded=_all_" then exit PCDB.
 Open the PhotoCDBrowser.ini file and view the "EffectsIncluded=_" parameter again. You will see that a list of the currently available effects numbers  have replaced "_all_"  (for example)  "EffectsIncluded=11,12,13,14, ..."
 none - exclude all effects from the current set. It's the same as turning off effects. This value may be useful for local settings.
Example:
To have transition effect #21 applied to your photo named "Laura1.jpg" you would do the following:
  a) create a local configuration file named "Laura1.ini"
  b) include "EffectsIncluded=21" (without quotes) within this file
This can be done for every photo in your slideshow or for only one or two. Photos which do not have a local configuration file with "EffectsIncluded= " would be assigned a transition from the current set.
It is also possible to use an effects list, comma separated, as the value for this parameter.
   Appendix C contains the valid numbers for all effects.

<  EffectsExcluded
List of effects excluded from the current effects set.
Choices:
 none - do not exclude any effects from current set.
It is also possible to use an effects list, comma separated, as the value for this parameter.
   Appendix C contains the valid numbers for all effects.

<  EffectsRandom
This parameter determines the order of effects for the application.
Choices:
 1 - random order
 0 - order is determined by the current set

[Commands Settings]

<  CommandsHotkeys
This parameter stores the name of the current hotkeys file. For example the Default.keys.txt hotkeys file name will be stored as the Default if you set:
 CommandsHotkeys=Default

<  CommandsAfterProgramStart
This parameter determines a list of commands to be executed after program startup.
Choices:
 0 - void list (no commands are executed)
Only values from [Keyboard] section of *.keys.txt files are valid. Values in the list may be separated by commas.

<  CommandsAfterMusicFileEnd
This parameter determines a list of commands to be executed after each background music file has finished playing.
Be careful !   Sound card drivers can create inaccurate timing up to + or - 3 seconds.
Choices:
 0 - void list (no commands are executed)
Only values from [Keyboard] section of *.keys.txt files are valid. Values in the list may be separated by commas.

<  CommandsAfterSlideshowStart
This parameter determines a list of commands to be executed after the slideshow starts.
Choices:
 0 - void list (no commands are executed)
Only values from [Keyboard] section of *.keys.txt files are valid. Values in the list may be separated by commas.

<  CommandsAfterSlideshowFinish
This parameter determines a list of commands to be executed after the slideshow finishes.
Choices:
 0 - void list (no commands are executed)
Only values from [Keyboard] section of *.keys.txt files are valid. Values in the list may be separated by commas.

<  CommandsAfterZoomIn
This parameter determines a list of commands to be executed after zooming in on the current photo.
Choices:
 0 - void list (no commands are executed)
Only values from [Keyboard] section of *.keys.txt files are valid. Values in the list may be separated by commas.

<  CommandsAfterZoomOut
This parameter determines a list of commands to be executed after zooming out from the current photo.
Choices:
 0 - void list (no commands are executed)
Only values from [Keyboard] section of *.keys.txt files are valid. Values in the list may be separated by commas.

<  CommandsAfterKeyDown
This parameter determines a list of commands to be executed after any key down.
Choices:
 0 - void list (no commands are executed)
Only values from [Keyboard] section of *.keys.txt files are valid. Values in the list may be separated by commas.

<  CommandsAfterMouseMove
This parameter determines a list of commands to be executed after mouse move event.
Choices:
 0 - void list (no commands are executed)
Only values from [Keyboard] section of *.keys.txt files are valid. Values in the list may be separated by commas.

^  Appendix C. Effects numbers  <

   These are the effects and the numbers assigned to them in the current version. Use these numbers in the EffectsIncluded and EffectsExcluded parameters.

effect #11

effect #12

effect #13

effect #14

effect #21

effect #22

effect #23

effect #24

effect #37

effect #38

effect #45

effect #46

If you do not see pictures or animation - turn it on in the browser options or press F5.