PhoA Help System

Command line parameters

PhoA supports a number of command line parameters. The general format of the command line is as following:

phoa.exe [key1 [key_value1] [key2 [key_value2]] ... ] [photo_album_file],

where:

  • keyN - a character prepended with a dash (-). See below for the list of available keys.
  • key_valueN - a character string specifying the key value. Some keys don't allow values while some do. Hence the rest ones allow optional value.
  • photo_album_file - optional photo album file name which will be loaded after program is started.

Available keys

-w view_name Activate view view_name. If the key is omitted the program displays picture groups upon start by default. The view is searched case insensitively.
Example:
    -w "By date and place"
-g group_path Select a group specified by the group_path in the tree. The path for a group is a string similar to OS file path with the difference that it is separated with slash character (/). You may do or do not specify the starting slash as this affects none. You are also allowed to specify both ordinary picture group or a view's group (ie. with using the -w key). If you omit this key the program selects the root item of the group tree by default. The groups are searched by the name case insensitively.
Example:
    -g "Photos by date/2000/January/Morning"
-i pic_ID Select a picture with specified ID in thumbnail window. If the key is omitted the program selects the first thumbnail in the list by default.
Example:
    -i 418
-v Enter the View mode upon start. The view mode is allowed only when a there is a picture selected.
-s Only applicable with -v key. When specified, the program will start the Slide show mode.
-f [1|0] Only applicable with -v key and specifies whether fullscreen or window mode is used. If you omit this key the program will use the default (current) settings for fullscreen mode. If the key is specified with no value or with value of 1 (one) the fullscreen mode will be forced (for the current session only). If the key is specified with value of 0 (zero), the window mode will be forced (also for the current session only).
Examples:
    -f
    -f 0
NB:
  • The command line parameters are separated with spaces.
  • If a parameter value or photo album file name contain spaces you need to enclose them in double quotes as in examples above.
  • You can specify the photo album file name anywhere in the command line but make sure the program doesn't consider it a key value. E.g., you may write it at the start of the parameter list or right after the key value (because a key may have only one value).
  • The program displays errors found in command line parameters upon start.