Settings window

The settings window is used to set the user preferences for PhotoFolio.

Settings are grouped together in common blocks in a list down the left hand side to make finding and adjusting settings easier.

Clicking ok accepts all the settings´ changes and closes the window. Any visual updates that are needed are then made. Apply performs a similar function to ok except that the settings window remains open. Save accepts all the settings´ changes and saves the current settings as the default settings.

Clicking cancel abandons any changes (not yet applied) and closes the window.

The settings window shows settings that are applicable for the window from which the settings window was opened. For example, main window settings are not shown if the settings window is opened from a browse window.


Main

Configures the main window. This settings group is only visible if the settings window is opened from the main window.

Projects in list

Setting this to 0 disables the storing of recent projects. If the new number is lower than the previous settings, then the list is cropped to the new size. The clear recent project list item in the settings menu clears all stored entries.

Path list default

The cycle gadget offers two choices:

  1. PhotoFolio project
  2. Path

Either a path or a PhotoFolio project can be automatically loaded on program startup.

The string gadget should contain either a valid image path or valid PhotoFolio project file.

Add one/all/recursively

Determines the way the default path is added to the path list. It is only used if the default path is an image path.

Add paths to path list as

Indicates that paths added to the path list should be added in tree or flat mode. For example adding Ram:pictures/nature in tree mode creates a Ram: folder, inside that a pictures folder and inside that a nature folder. If added in flat mode, a single entry Ram:pictures/nature is created in the path list.

Use toolbar

When enabled, the toolbar appears in the main window.

Save icons with projects

When enabled, icons are saved along with project files.

Auto open project information

When enabled, the project information window opens automatically whenever a project is loaded.

Browse

Configures browse windows.

Proof sorting

Proofs displayed in a browse window are sorted in one of 4 ways:

  1. Sort alphabetically
  2. Sort by size
  3. Sort by type
  4. No Sort

This can also be changed from the browse window's menu.

Hide questionable

When enabled any proof that has the questionable attribute set is hidden from view in the browse window.

This can also be changed from the browse window's menu.

Attributes panel

Toggles the attribute selection area in the browse window on and off.

This can also be changed from the browse window's menu.

Owner number

Sets the default owner for the catalogue system.

Lock owner number

If enabled, when a change attributes window is opened, lock settings is also enabled. This forces proofs to be viewed with this owner number rather than with the owner number they were catalogued with.

Update display after every

Every time a proof is added to the browse window, MUI updates the entire browse window (even the non visible parts).

Increasing this value speeds up display refreshing. It can be set between 1 and 300. This indicates that the display will update every x proofs. e.g. if you are loading a directory with 30 proofs, you will not see anything until the first x are loaded, and then again after the next x are loaded etc.

Confirm closing browse windows

When enabled, a confirmation requester appears whenever you attempt to close a browse window.

Ignore files matching this pattern

The string gadget specifies files (using the AmigaDOS pattern matching system) that should be ignored when scanning files to load into a browse window. For example to ignore .info files, enter #?.info.

Use toolbar

When enabled, the toolbar appears in the browse window.


Proofs

Change the way the proofs appear in a browse window.

Description position

Sets where and how the text describing the proof appears:

  1. No text - Turns text off altogether.
  2. Text left
  3. Text right
  4. Text top
  5. Text bottom
  6. Bubble - no text is visible, however if the mouse is positioned over a proof, the description appears in a bubble

Proof text attributes

By enabling or disabling these items the lines of text displayed with proofs can be selected.

·        Display file name

·        Display file size

·        Display image width and height

 

Display proofs at a constant size

When enabled, PhotoFolio draws proofs at the size currently set by the proof size setting in make window settings. This ensures that all proofs are aligned evenly in the browse window, however it takes up unnecessary space and fewer proofs can be displayed in the same area than if this was turned off.

If the proof size settings are smaller than the proof being loaded, the proof is drawn at the proof's actual size.

Indicate proofs unsaved (with red box)

When enabled, PhotoFolio draws a small red box in the bottom right corner of any unsaved proof.

Proof font

The font used for the text displayed beneath a proof. The pop up gadget opens an ASL requester to select a font, or enter a font name and size directly into the string gadget. For example, topaz.font/11.

Proof dithering

This is only available if guigfx.library is being used.

There are 4 dithering modes:

  1. None
  2. Floyd-Steinberg
  3. Random
  4. EDD

This setting is for displaying proofs only. If you find your system is slow, set this to none and the graphics rendering will be faster, however the quality of the displayed proofs may suffer.

Proof export path

The default path used when exporting proofs.


Make

Determines how proofs are created for browse windows and the make window.

Proof size

The width and height of the generated proofs.

Proof save JPEG quality

Each proof image is saved internally as a jpeg image using jpeg.library. This setting determines the quality of the jpeg proof image. Qualities range from 1 to 100 with 100 being the best quality. A good balance between size and quality is 85.

Scaling mode

There are 3 different scaling routines PhotoFolio can use to scale the original image to the proof size.

  1. Low quality scaling (fast)
  2. High quality scaling (slow)
  3. Cubic interpolation scaling (slowest)

Low quality scaling is still good, and is much faster than the other two methods.

This can also be changed from the browse window´s menu.

Make all proofs

PhotoFolio can store proofs in two different ways, linked and non-linked:

  1. A linked proof is stored in a totally different place to that of the original image. It is stored in the proof destination directory, in a directory structure that can mirror the original. Proofs can be moved between directories later without the connection to the original images being lost.
  1. A non-linked proof is stored with the original image. The file name is changed so that the two files can coexist in the same directory. An extender is created to make it easier to pick a proof from a real image. This type of proof must reside in the same directory as the image. It should not be moved to another directory independently of the image.

Files are not overwritten by non-linked proofs. A different name is created to avoid filename conflicts.

Copy file comment to proof comment

If enabled, when creating proofs the image files' comment is copied to the proofs' comment.

Correct gamma

If enabled, automatically corrects gamma on proof creation. Creation is slower but saves time if you usually perform this operation afterwards.

Proof destination directory

This is the directory where PhotoFolio saves created proofs. A directory structure mirroring the original directory structure can be created here. The destination directory is only valid if the proofs are linked.

Mirror image directory structure

When proofs are saved they can be saved directly into the proof destination directory or, if this option is enabled, into a directory structure which mirrors that of the original images´. For example:

The image is stored in: Graphics:images/pictures/jpegs

The proof destination directory is: Ram:proofs

Without this option enabled, proofs are saved into Ram:proofs. When enabled, proofs are saved into Ram:proofs/graphics/images/pictures/jpegs

This is useful for creating proofs of directories of images where the directory structure of the created proofs matches that of the original images.

Count files before making

When enabled, PhotoFolio scans the directory and counts the files before commencing a make. This allows PhotoFolio to update progress indicators while a make is in progress. If this is disabled, progress indicators are not displayed.

Add path to list after make

If enabled, once a path has been made, the created proof path (if linked) is automatically added to the path list in the Proofs folder. This avoids having to manually add the created path to the path list.


Show

Configures the default viewer and settings for each of the viewing modules.

Default image viewer

The cycle gadget at the top allows selection the image viewer PhotoFolio uses as its default viewer.

  1. Internal, use PhotoFolio's internal viewer to view the images.
  1. External, use an external viewer to view images.
  1. MysticView, use mysticview.library to view the images.

Internal

Progressive image loading

When enabled, the image being displayed in the show window is  seen progressively, as it is being loaded. When disabled, the image won't be seen until loading is complete.

This feature does not function with images loaded using the Amiga datatype system.

 

Scaled image loading

When enabled, the image being displayed is automatically scaled to fit the screen.

Subtask priority

The show window uses a separate task to load and decode images. This allows other windows in PhotoFolio to continue to function while images are loading. The loading priority of this task can be adjusted, allowing you to decide how much priority you want to give to loading and decoding images. Tweaking this may or may not improve the performance of loading on your machine.

Setting the priority to its maximum value may in fact result in reduced performance. If progressive loading is enabled, having the priority set too high will result in the image not showing until loading is completed (because the loading task has a higher priority than the viewing task).

Most users should leave this set to the default value of -1.

Filename

Sets the default path in which to save images when using save as.

Jpeg quality

If the image is saved in jpeg format, this sets the default jpeg quality of the saved image.

Show dithering

This is only available if guigfx.library is being used.

There are 4 dithering modes:

1.      None

2.      Floyd-Steinberg

3.      Random

4.      EDD

This setting is for showing images only. If you find your system is slow, set this to none and the graphics rendering will be faster, however the quality of the displayed images may suffer.


External

External viewer

Enter the Path:Filename of the external program used to view images.

External viewer arguments

Enter the arguments to pass to the external viewing program.

When calling the external viewer, PhotoFolio builds an argument string in this manner:

1.      The name of the external viewing program.

2.      The argument string is appended.

3.      Files to be viewed are appended.

The Amiga limits the length of command lines. Consequently, if the number of files appended to the argument string exceeds this limit, the string is truncated and not all of the selected files will be seen.

Generate an image file list

When enabled, PhotoFolio creates a list of images to view in a file. This file is then passed to the external viewer. A %s in the external viewer argument string indicates where the file list name is to be placed.

For example:

pubscreen=Workbench listfile=%s

The external viewer program must support the passing in of images through a file list for this to work. Consult the external viewer's documentation for the correct Shell arguments for passing in file lists.

MysticView

Show buttons

Toggles the button bar in the top of the MysticView window on and off.

Show picture info

Toggles the picture information bar in the bottom of the MysticView window on and off. It enabled, the image filename and width and height are displayed.

Show arrows

When enabled, draws arrows at the picture's borders, when the image is not fully visible in the respective direction.

Show picture in picture

Displays a thumbnail of the image in the top left hand corner of the image. The green box indicates the visible portion of the image.

Show cursor

When enabled, activates a crosshair on the picture, indicating the current cursor position. Scrolling moves the cursor and zooming centers on the crosshair.

Mouse drag picture

Enables scrolling of the image by clicking and holding the left button and dragging the mouse.

Use static palette

When enabled, MysticView uses a static palette instead of a dynamic one (calculated for each picture). This option is meaningless for hicolor and truecolor displays.

 

A static palette,

·        Gives bad results without dithering.

·        Produces more stable quality with dithering.

·        Triggers MysticView's automatic dithering in most cases.

·        Causes less flickering when advancing from one picture to another, because there is no need to clear the display.

·        Is not necessarily faster than a dynamic one. This depends on the picture.

Window display mode

Scale with aspect

The image is scaled to fit the window size, maintaining its aspect ratio. If the window is resized, the image is also resized. This guarantees that the image is always fully visible.

Display 1:1 pixel

The image is displayed actual size, regardless of the window size. Each pixel in the image is represented by one pixel on the screen.

Refresh mode

No realtime refresh

No realtime update takes place. The image is rendered in the highest possible quality.

Grid refresh

A 10 x 10 grid is drawn instead of the picture and then the picture is rendered into this grid with the highest possible quality.

Opaque refresh

After a quick preview has been displayed, the image is rendered into the display in the highest possible quality (if necessary). This option increases memory consumption dramatically and should only be enabled on systems with a fast CPU.


ARexx

Set the default ARexx scripts for the main window and browse windows.

The page consists of 2 lists. The top list contains the scripts for the main window and the bottom list contains the scripts for browse windows.

The main window ARexx scripts list can only be edited if the settings window is opened from the main window.

Click the add script gadget underneath either of the lists and select an ARexx script from the ASL requester. The script is added to the respective list. After clicking ok, save or apply, the respective window´s menus are updated.

Remove script removes the highlighted script from the list.

Each script list has a context menu to add a script and remove the script clicked on with the right mouse button.


Misc

Other settings affecting the global operation of PhotoFolio can be found here.

Maximum free memory

If the amount of free memory goes below this setting during a load, PhotoFolio stops loading and displays pagination gadgets.

 

Photoalbum compatibility

When enabled, PhotoFolio automatically recognises Photoalbum thumbnails stored in the jpeg format and displays them in a browse window.

Photoalbum thumbnails cannot have their attributes set.

Confirm quit

When enabled and a quit is attempted, a requester opens to confirm quitting PhotoFolio.

If the project has been modified, the quit confirmation requester is slightly different.

Automatic error window

When enabled, the error window automatically opens, or if it is already open, is brought to the front, whenever an error occurs. Errors are still added to the error window even with this option disabled.

Selection

The default filename pattern matching strings for pattern select windows are defined here.

Preset 1 - 10

These define 10 default filename pattern matching strings for use with the pattern select window.

These strings must conform to the AmigaDOS pattern matching system more frequently used in the Shell and ASL requesters.


Examples of valid patterns:

#?.gif

Match all the files with .gif as the last part of their filename.

#?.(jpg|jpeg)

Match all the files with .jpg or .jpeg as the last part of their filename.

~(#?.(jpg|jpeg))

Match all the files that don't have .jpg or .jpeg as the last part of their filename.

#?.(jpg|gif|tif|png)

Match all the files with .jpg or .gif or .tif or .png as the last part of their filename.

#?sun#?

Match all the files with sun somewhere in the filename.

Scanner

Settings for image grabbing modules can be configured here.

VLab save filename

Enter the default name to use for saving VLab image grabs. The filename should consist of text characters followed by a 3 digit number e.g. Graphics:VLab/Grabs/VLGrab000

PhotoFolio automatically increments the number on the end of the filename each time a grab is saved to ensure batch saved grabs have their own unique filename.

VLab save jpeg quality

The jpeg quality to use when saving a Vlab grab as a jpeg.

Export HTML

If the Export HTML module is installed correctly, default settings for exporting proofs as HTML files can be set here.


Even though the settings for this module can be configured from any settings window, they are global settings and changing the module's settings in one window affects all other windows.

Page title

This string appears in the title bar of the web browser when viewing the HTML file.

Proof grid

Sets the number of proofs across and down that appear in the exported HTML file(s). The down value can be set to endless to indicate that the creation should not span across multiple HTML files; instead creating an endless page. The popup gadget contains preset values for commonly used layouts.

Export image links

When enabled, clickable links to the original images are embedded in the exported HTML file. To send the original images to the destination directory as well, enable copy images. (Selecting this option automatically selects copy images as that is probably what was intended.)

Display name

When enabled, displays the image's name underneath the proof image.

Display image width and height

When enabled, displays the width and height of the image underneath the proof image.

Destination

The destination path and filename. The filename is used as a base for the created HTML files and the path part of the filename is where subdirectories containing proofs and images are stored. e.g. ram:steeple.html

The path must exist before starting the export.

Copy images

If enabled, copies the images to a subdirectory in the destination path. To allow the viewing of the images in the HTML file, image links must also be enabled.