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.Alt + Z - switches the IntelliMouse wheel button function between zooming and navigation. |
F9 | - begin or stop total slideshow |
Pause | - stop or continue total slideshow |
Ctrl + S - to create the script for the current total slideshow. |
^ 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. |
%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 |
<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> |
<ENGLISH> The comment text within these tags will be seen </ENGLISH> |
<!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> |
[AutoRun] Open=Browser\PhotoCDBrowser.exe Icon=Browser\PhotoCDBrowser.exe,0 |
[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 |
Shell\Script3=&Slideshow Script 3 ... Shell\Script3\command=Browser\PhotoCDBrowser.exe "Slideshow Script 3.script.txt" |
^ 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.^ 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 |
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
<
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:
<
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 |
< 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 |
<
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 |
<
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
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 |
<
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 |
<
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 |
<
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 |
<
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 |
<
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). |
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 |
CommentFontFile=modern.fon |
<
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:
|
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 |
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 |
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 |
<
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) |
<
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 |
<
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) |
<
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 |
<
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 |
<
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. |
<
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. |
<
EffectsExcluded
List of effects excluded from the current effects set.
Choices:
none - do not exclude any effects from current set. |
<
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) |
<
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) |
<
CommandsAfterSlideshowStart
This parameter determines a list of commands to be executed after the slideshow starts.
Choices:
0 - void list (no commands are executed) |
<
CommandsAfterSlideshowFinish
This parameter determines a list of commands to be executed after the slideshow finishes.
Choices:
0 - void list (no commands are executed) |
<
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) |
<
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) |
<
CommandsAfterKeyDown
This parameter determines a list of commands to be executed after any key down.
Choices:
0 - void list (no commands are executed) |
<
CommandsAfterMouseMove
This parameter determines a list of commands to be executed after mouse move event.
Choices:
0 - void list (no commands are executed) |
^ 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.
|
If you do not see pictures or animation - turn it on in the browser options or press F5.