Author: Stefan Spaeth
Description: Description of configuration entries of createPhotoWebPages.pl

# createPhotoWebPages.pl - Configuration Entries

back to main page

All entries are composed of upper case letters and the underscore character. They can be divided into different categories. Each entry is associated to a certain type and category. Types and categories are described in more detail in the following sections.

- Types of Entries

Categories:

- Basic and more Generic Entries
- General Script Settings
- Renaming Parameters
- Image Creation Parameters
- More Image Creation Parameters
- HTML Colors
- Generic HTML Parameters
- HTML Formatting Parameters
- HTML Filename Parameters
- HTML Parameters for the Top-Page
- Thumbnail HTML Page Parameters
- Image Parameters

## Types of Entries

Type | Description
--- | ---
String | Any line of text (i.e. a line of printable characters). Even HTML entities or elements may be included. The main limitation is that the text is limited to a single line. Some entries are marked as being <multiline> (in the field "Default Values"). This means that the entry may appear multiple times in sequence (i.e. subsequent lines) which is then treated as a list of strings. Multi-line entries do never have a default value.
Word | A text element composed of any printable characters except for blank characters. It must fit into a single line. Possible values are normally obvious from the context.
Pathname | A file name or directory name with associated path name.
Switch (boolean) | Only the values 0 or 1 are allowed. 1 = Switch on, 0 = Switch off.
Color | A color in HTML format. The format comprises of a leading "#" character and 6 subsequent hexadecimal characters (upper and lower case are allowed).
Integer | Any integer number. In most cases the range of possible values is somehow restricted.
Fixed-point Number (fixed) | Any fixed-point number. In most cases the range of possible values is somehow restricted.

back to top

## Basic and more Generic Entries

Entry | Type | Default Value | Description
--- | --- | --- | ---
TITLE | String | Photo Thumbnails Web Page | The HTML title for all HTML pages.
EMAIL | Word | S.Spaeth@z.zgs.de | The email address of the HTML author (a "@" character is expected)
AUTHOR | String | Stefan Spaeth | The name of the HTML author (i.e. actually your name ;-)
COPYRIGHT | String | Copyright © 2002 Stefan Spaeth | The copyright notice.
LEVEL_UP | Pathname | ../index.html | Describes the path name of a higher level HTML page (to which you might want to link your generated HTML pages). A link to that page is generated if this entry is not empty.
WEB_READY | Switch | 0 | Describes the operating mode: 1 = Web-Ready Mode 0 = File System Mode
TARGET_DIR | Pathname | ./test/ | Only relevant for the Web-Ready Mode. It describes the target directory into which the generated HTML pages and images are going to be written. A relative path name is expected. Note that the designated directory must already exist.
IVIEW_SELECTION_FILE | Pathname | Slideshow.lst | This entry defines the path name for the "iview" selection file. The (DOS/Windows) program allows to generate self-starting CD presentations. The selection file contains path names to all images in the order given in the configuration file. If this entry is empty then the selection file is not created. The file is created in the directory in which the HTML index files are placed.

back to top

## General Script Settings

The following entries are likely to be converted into script configuration options in a later version of createPhotoWebPages.

Entry | Type | Default Value | Description
--- | --- | --- | ---
USE_JPEGTRAN_JHEAD | Switch | 1 | This switch indicates if the utility programs "jhead" and "jpegtran" are available (in the program execution path). These programs are not always required. Setting this switch prevents the script from attempting to use those utilities. 1 = utilities available, 0 = not available.

back to top

## Renaming Parameters

The following parameters are mainly required for the "image scan" mode. They determine how an image file name is converted into an IMAGE_NAME" entry.
The same rules are applied in case of a "rename" run. There they determine how the new image file name is derived from an "IMAGE_NAME" entry.
Examples for the use of those entries are given in the document describing the renaming rules.

Entry | Type | Default Value | Description
--- | --- | --- | ---
IMG_NAME_NO_ALPHA_PREFIX | Switch | 1 | This entry is only relevant when reading in the selection configuration file. It is not used when composing new file names. If the switch is set to 1 then an existing letter file name prefix (composed of letters and trailing underscore character) is not appearing in the "IMAGE_NAME" entry. See also Prefix option.
IMG_NAME_NO_NUMBER_PREFIX | Switch | 0 | This entry is only relevant when reading in the selection configuration file. It is not used when composing new file names. If the switch is set to 1 then an existing digits file name prefix (composed of digits and trailing underscore character) is not appearing in the "IMAGE_NAME" entry.
IMG_NAME_NO_NUMBER_SUFFIX | Switch | 1 | If an image file name is read which is composed of letters and digits following immediately at the end then a blank is set between letters and digits when creating the "IMAGE_NAME" entry. If an image file name is created then any blank found between letters and digits (at the end of the entry) are removed. This behavior may be switched off by setting the switch to a value of 0.
IMG_NAME_REPLACE_UNDERSCORE | Switch | 1 | If this switch is set to a value of 1, underscore characters are replaced with blanks when reading in image file names (i.e. when composing the "IMAGE_NAME" entry). In the opposite direction, blanks are replaced by an underscore characters when creating file names. This behavior may be switched off by setting the switch to a value of 0.
IMG_NAME_REPLACE_DASH | Switch | 0 | If this switch is set to a value of 1, then dashes are replaced by blanks when reading in image file names (i.e. when composing the "IMAGE_NAME" entry). In the opposite direction, blanks are replaced by a dash when creating file names. This behavior may be switched off by setting the switch to a value of 0.
IMG_NAME_BLANK_BEFORE_CAPS | Switch | 1 | If this switch is set to a value of 1, then an upper case letter following a lower case letter is separated with a blank when composing the "IMAGE_NAME" entry. In the opposite direction, these blanks are removed when composing file names. This behavior may be switched off by setting the switch to a value of 0.

back to top

## Image Creation Parameters

Entry | Type | Default Value | Description
--- | --- | --- | ---
IMG_BORDER_COLOR | Color | #000000 | The color of the optional frame of a newly created image.
IMG_SHADOW_COLOR | Color | #333333 | The color of the optional shadow of a newly created image.
IMG_BORDER_WIDTH | Integer | 1 | The thickness of the optional frame of a newly created image. 0 = no frame. Possible values range from 0 to 128.
IMG_SHADOW_ENABLE | Switch | 1 | This switch activates the shadow creation for a newly created image. 0 = no shadow, 1 = add a shadow.
IMG_SHADOW_OFFSET | Integer | 3 | This parameter determines the shadow offset (depth) of thumbnail and button size images. Websize images get a value of twice that size. Possible values range from 0 to 128.
IMG_SHADOW_BLUR | Integer | 5 | This parameter determines the depth of the blur effect that is applied to the image shadow. The value is given in number of pixels. The value is applied to thumbnail and button size images. Websize images get a value of twice that size. Possible values range from 0 to 128.
THUMBNAIL_ROTATION_ANGLE | Fixed-point number | 0 | This parameter determines the maximum rotation angle of thumbnail images (in case that thumbnail image rotation is enabled). 0 = do not rotate. Possible values range from 0 to 10.0. Values smaller than 0.1 are ignored.
THUMBNAIL_RANDOM_ROTATE | Switch | 0 | This switch determines if all thumbnail images are to be rotated with the same angle, or if the given rotation angle is a maximum value up to which random rotation values are generated (the actual range of values is -max value to +max value). 1 = use random values, 0 = fixed rotation angle.
WEBSIZE_ROTATION_ANGLE | Fixed-point number | 0 | This parameter determines the maximum rotation angle of websize images (in case that websize image rotation is enabled). 0 = do not rotate. Possible values range from 0 to 5.0. Values smaller than 0.1 are ignored.
WEBSIZE_RANDOM_ROTATE | Switch | 0 | This switch determines if all websize images are to be rotated with the same angle, or if the given rotation angle is a maximum value up to which random rotation values are generated (the actual range of values is -max value to +max value). 1 = use random values, 0 = fixed rotation angle.
IMG_JPEG_QUALITY | Zahl | 75 | This parameter determines the compression ratio for the created JPEG images. The range of possible values stretches from 0 to 100. 100, 90, 75 and 50 are considered reasonable values.
IMG_JPEG_PROGRESSIVE | Switch | 1 | This switch determines if the websize image is saved in progressive JPEG mode (i.e. a mode that allows an early preview of the not yet fully loaded image). 1 = progressive mode, 0 = non-progressive mode.
IMG_IMPRINT_DEFAULT | String |  | This text is imprinted into the lower right corner of each websize image. This feature may, for example, be used to include copyright notices or camera information into the image. If the entry is left blank then nothing is imprinted. Note that the entry IMAGE_IMPR, which can be associated with each image separately, does overwrite this entry.
IMG_ADD_JPG_INFO_PAGE | Switch | 0 | This switch determines if, by default, a separate JPEG EXIF information HTML page should be generated. 1 = create info page, 0 = no info page. The entry IMAGE_INFO, which can be associated with each image separately, does overwrite this entry.

back to top

## More Image Creation Parameters

The following parameters determine the concrete sizes, file naming and target directories of the images that need to be created.

Entry | Type | Default Value | Description
--- | --- | --- | ---
THUMBNAIL_SIZE | Integer | 128 | The maximum width (or height, depending on which is larger) of the thumbnail image that is created. Possible values range between 64 and 256.
BUTTON_SIZE | Integer | 64 | The maximum width (or height, depending on which is larger) of the button image that is created. Possible values range between 32 and 256.
WEBSIZE_SIZE | Integer | 640 | The maximum width (or height, depending on which is larger) of the websize image that is created. Possible values range between 256 and 1024.
ALWAYS_WEBSIZE | Switch | 0 | Whenever the width or height of the image (the larger of both counts) exceeds the value of WEBSIZE_SIZE, the image is reduced to the value given. If this switch is set to "1" then images which are smaller than the value given in WEBSIZE_SIZE are enlarged to the value given. A value of "0" leaves the websize image in its original size.
FULLSIZE_SIZE | Integer | 800 | The maximum width (or height, depending on which is larger) of the button image that is created (see FULLSIZE_ENABLE). Possible values range between 512 and 4096.
FULLSIZE_ENABLE | Switch | 0 | This switch enables the creation of a larger (full-size) image. This images is then used instead of the original image. This entry is interesting when using the Web-Ready mode.
THUMBNAIL_SUFFIX | Word | _thumbnail | This word is the part of the thumbnail image filename that is appended to the original image filename.
THUMBNAIL_DIR | Word | thumbnails | All generated thumbnail images are placed into the directory determined by this parameter. If the directory does not yet exist it is automatically created. The directory is either placed where the original image is located (File system mode), or it is placed in the directory referenced by the entry "TARGET_DIR" (Web-Ready mode).
BUTTON_SUFFIX | Word | _button | This word is the part of the button image filename that is appended to the original image filename.
BUTTON_DIR | Word | buttons | All generated button images are placed into the directory determined by this parameter. If the directory does not yet exist it is automatically created. The directory is either placed where the original image is located (File system mode), or it is placed in the directory referenced by the entry "TARGET_DIR" (Web-Ready mode).
WEBSIZE_SUFFIX | Word | _websize | This word is the part of the websize image filename that is appended to the original image filename.
WEBSIZE_DIR | Word | websize | All generated websize images are placed into the directory determined by this parameter. If the directory does not yet exist it is automatically created. The directory is either placed where the original image is located (File system mode), or it is placed in the directory referenced by the entry "TARGET_DIR" (Web-Ready mode).
FULLSIZE_SUFFIX | Word | _fullsize | This word is the part of the full size image filename that is appended to the original image filename.
FULLSIZE_DIR | Word | fullsize | All generated full size images are placed into the directory determined by this parameter. If the directory does not yet exist it is automatically created. The directory is either placed where the original image is located (File system mode), or it is placed in the directory referenced by the entry "TARGET_DIR" (Web-Ready mode).
THUMBNAILS_PER_ROW | Integer | 4 | This value determines the maximum number of thumbnail images which are placed in a single row on a thumbnail HTML page. Possible values range from 3 to 8.
THUMBNAILS_MAX_ROWS | Integer | 3 | This value determines the maximum number of thumbnail rows that are placed on a thumbnail HTML page before a new page is started. Possible values range from 1 to 128. Note that this limitation is not valid for the Top HTML thumbnail page. There it is simply assumed that the number of "SUBTITLE" entries does not exceed a resonable amount.

back to top

## HTML Colors

The color parameters listed in this section allow to configure various color settings of the HTML pages.

Entry | Type | Default Value | Description
--- | --- | --- | ---
HTML_BG_COLOR | Color | #ffffdd | background color of HTML pages
HTML_TEXT_COLOR | Color | #000000 | text color of HTML pages
HTML_LINK_COLOR | Color | #3333ff | link color of HTML pages
HTML_VLINK_COLOR | Color | #993399 | visited link color of HTML pages
HTML_ALINK_COLOR | Color | #000099 | active link color of HTML page

back to top

## Generic HTML Parameters

The following parameters allow to control the general appearance of the created HTML pages.

Entry | Type | Default Value | Description
--- | --- | --- | ---
HTML_TEXT_BACK | String | [Back To Thumbnails] | This entry defines the text that is placed below the HTML link that points back to the thumbnail HTML pages (or top thumbnail HTML page).
HTML_CSS_ENABLE | Switch | 0 | Setting this value to 1 enables CSS stylesheets for the use with font settings. A value of 0 leads to the insertion of <font> statements.
HTML_CSS_FILENAME | Word | stylesheet | This is the name that is used to identify the filename of the CSS stylesheet. The file extension ".css" is automatically appended.
HTML_ADDRESS_TEXT |  | <multiline> | This multi-line entry allows to replace the predefined HTML <address> tag. The predefined default is comprised of name and email of author and a copyright notic (see also "EMAIL", "AUTHOR", "COPYRIGHT"). If the default address tag is used it is also possible to remove the tool hint line (see "HTML_NO_TOOL_HINT").
HTML_NO_TOOL_HINT | Switch | 1 | This switch allows to remove the hint to script name and version which is used in the default <address> tag. Setting this switch to a value of "0" disables the tool hint. Note that the script name and version are still mentioned in the HTML header, but are no longer visible (see "generator" tag in HTML header).
LINK_ORIGINAL_IMAGE | Switch | 1 | The File System mode allows to link the original image inside the HTML pages. This is achieved by setting this switch to a value of "1". A value of "0" suppresses this link. Note that the "Web-Ready" mode, currently, does not support links to the original images at all.
HTML_NO_PART_NUMBER | Switch | 0 | The images are automatically distributed to multiple thumbnail HTML pages if needed. These HTML thumbnail pages are numbered (starting with a value of 1). This number is normally also available and visible inside the HTML code. Setting this switch to "1" suppresses the visible numbering inside the HTML code. (see also entry "HTML_NO_PART_ONE")
HTML_NO_PART_ONE | Switch | 1 | See also "HTML_NO_PART_NUMBER". Similarly to that entry, this parameter allows to suppress the HTML thumbnail page number only for the very first page. This is sometimes helpful, as it is often not desired to have page numbers - especially if only a single thumbnail HTML page exists.

back to top

## HTML Formatting Parameters

These parameters might, for example, be used to adjust the distances between the thumbnail images on thumbnail HTML pages. In addition some parameters are also handling the alignment and formatting of text elements.
A bit of experimenting might be needed to find out how the parameters affect the appearance of the HTML pages.

Entry | Type | Default Value | Description
--- | --- | --- | ---
HTML_THUMBNAIL_SPACING | Integer | 4 | The distance in number of pixels between the thumbnail table rows. Actually, this correlates to the "cellspacing" HTML tag for HTML tables. Possible values range from 2 to 16.
HTML_THUMBNAIL_DISTANCE | Integer | 4 | An additional offset (in number of pixels), which if added to the width of a thumbnail image results in the width of a thumbnail HTML table cell. Possible values range from 4 to 128.
HTML_IMAGE_SPACING | Integer | 2 | The distance in number of pixels between websize image table cells. Actually, this correlates to the "cellspacing" HTML tag for HTML tables. Possible values range from 2 to 16.
HTML_IMAGE_DISTANCE | Integer | 12 | An additional offset (in number of pixels), which if added to the width of a websize image results in the width of a websize image HTML table cell. Possible values range from 4 to 128.
HTML_TEXTCELL_HEIGHT | Integer | 20 | This value determines the height of a table cell (in number of pixels) which only contains a single line of text (e.g. an HTML text link). Possible values range from 8 to 128.
HTML_TEXT_ALIGN | Word | center | This parameter determines the text alignment of headings, text and tables inside the HTML code. Values are limited to "center", "left" and "right". Upper case letters are automatically converted into lower case letters.
HTML_TOP_TEXT_ALIGN | Word | center | This parameter determines the alignment of text specified in the HTML_TOP_TEXT Entry. Values are limited to "center", "left" and "right". Upper case letters are automatically converted into lower case letters.
HTML_SUB_TEXT_ALIGN | Word | center | This parameter determines the alignment of text specified in the HTML_SUB_TEXT Entry. Values are limited to "center", "left" and "right". Upper case letters are automatically converted into lower case letters.
HTML_IMG_TEXT_ALIGN | Word | center | This parameter determines the alignment of text specified in the IMAGE_TEXT Entry. Values are limited to "center", "left" and "right". Upper case letters are automatically converted into lower case letters.
HTML_IMG_MAKE_DENSE | Switch | 0 | If this parameter is set to a value of "1" then the header part of an image HTML page is designed to be more dense. Instead of using additional headings, information like caption or image name are placed inside the table itself.
HTML_IMG_CREATE_ALWAYS | Switch | 0 | A value of "1" allows to always regenerate all HTML pages. A value of "0" does only re-generate and HTML page if it does not yet exist or the update recognition has determined a need for regeneration (which may fail in some circumstances). This parameter may be used instead of always applying the option combination "-force -html".

back to top

## HTML Filename Parameters

The following parameters allow to influence the file naming of the HTML files that are created.

Entry | Type | Default Value | Description
--- | --- | --- | ---
HTML_INDEX_NAME | Word | index | All thumbnail HTML files share the same file name prefix portion which is determined by this parameter entry. The default filename prefix is "index". when creating the filename for a thumbnail HTML page, the script adds a number suffix for all normal thumbnail HTML files and uses the parameter as is to name the Top thumbnail HTML page. The file extension is determined by the entry "HTML_FILE_EXTENSION". The default value of the entry is "index". The thumbnail files may then, for example, be named "index_0.html", "index_1.html", etc. The top thumbnail HTML page (if existing) is named "index.html".
HTML_IMAGE_SUFFIX | Word | _img | The hTML file which comprise the websize images (websize HTML pages) get the name of the image for which the are created plus a suffix determined by this parameter. Default setting is "_img". The websize HTML page for the image "ab_Image1.jpg" is therefore normally named "ab_Image1_img.html".
HTML_INFO_SUFFIX | Word | _info | The hTML file which comprise the EXIF information (info HTML pages) get the name of the image for which the are created plus a suffix determined by this parameter. Default setting is "_info". The info HTML page for the image "ab_Image1.jpg" is therefore normally named "ab_Image1_info.html".
HTML_WRAPPER_SUFFIX | Word | _wrap | The hTML file which comprise the original image (wrapper HTML pages) get the name of the image for which the are created plus a suffix determined by this parameter. Default setting is "_wrap". These HTML pages are basically empty and contain solely the original image plus an image link back to the original websize HTML page. The info HTML page for the image "ab_Image1.jpg" is therefore normally named "ab_Image1_wrap.html".
HTML_FILE_EXTENSION | Word | html | This parameter entry determines the file extension that is used for all created HTML pages.The only possible values are "html" and "htm" (in lower case letters).
HTML_IMAGE_DIR | Word | html | This parameter names the subdirectory into which all image-related HTML files are placed (see also "HTML_INFO_SUFFIX", "HTML_IMAGE_SUFFIX", and "HTML_WRAPPER_SUFFIX"). The directory is placed into the current directory when the script is operating in file system mode. In Web-Ready mode the subdirectory is placed in the directory specified by the entry "TARGET_DIR".

back to top

## HTML Parameters for the Top-Page

The parameters listed in this section influence the detailed appearance of the Top thumbnail HTML page. They allow to decide whether to create the page at all, and which texts to display on the page.
The thumbnail images that are displayed on this page (and are linked to a normal thumbnail page) are either the first thumbnail image on that particular page, or the thumbnail on that page that is marked with the "IMAGE_SEL" entry. Only one image may be selected per thumbnail HTML page (i.e. per "SUBTITLE" entry) and represents that page on the top thumbnail HTML page.

Entry | Type | Default Value | Description
--- | --- | --- | ---
HTML_CREATE_TOP | Switch | 1 | If this parameter is set to "1" then the top thumbnail HTML page is automatically created as long as at least one "SUBTITLE" entry exists.
HTML_TOP_TEXT | String | <multiline> | This descriptive text (spread over multiple lines, and including HTML tags or HTML entities) is put on top of the top thumbnail HTML page (if it exists).
HTML_TOP_CAPTION | String | nbsp; | This descriptive subtitle (a single line that may contain HTML elements or entities) is placed on the bottom of the top thumbnail HTML page (if it exists).
HTML_TOP_BACK | String | [Back To Thumbnails] | This text entry is used to set a text link from the top thumbnail HTML page to an upper level HTML page. This upper level HTML page is specified by the parameter "LEVEL_UP". If the parameter "LEVEL_UP" is left empty then no link is set.

back to top

## Thumbnail HTML Page Parameters

The distribution of images onto different thumbnail HTML pages can be influenced with the addition of "SUBTITLE" entries. After each such entry an new thumbnail HTML page is created, independent of the number of thumbnail images that are already placed on the current page.
"SUBTITLE" entries must always be placed between two images and must follow an "IMAGE_PATH" entry in order to be correctly interpreted. (The first "SUBTITLE" entry is, of course, placed in front of the first image.)

Entry | Type | Default Value | Description
--- | --- | --- | ---
SUBTITLE | String | Photo-Selection | This entry helps to structure the images that are listed in the selection configuration file. The thumbnail HTML pages are filled up to the predefined number of images before a new page is started (see "THUMBNAILS_PER_ROW" and "THUMBNAILS_MAX_ROWS"). A "SUBTITLE" entry forces the generation of a new thumbnail HTML page. It is recommended to used a "SUBTITLE" entry right before the first image. This entry is also used as a subtitle for all following thumbnail HTML pages (until a new "SUBTITLE" entry changes the title). The entry is a single line (that may also be composed of HTML tags and entities). If "NONE" (without double quotes ;-) is used as a "SUBTITLE" value then the display of HTML captions and titles is suppressed, although the entry still forces the generation of a new thumbnail HTML page.
HTML_SUB_TEXT | String | <multiline> | Each "SUBTITLE" entry may be complemented with additional descriptive text. It is placed on the first thumbnail HTML page belonging to that "SUBTITLE". A description may be comprised of multiple entries (lines) which may themselves be comprised of HTML elements and entities. The alignment of this text can be influenced with the parameter "HTML_SUB_TEXT_ALIGN".
SUB_PAGES_NO_TEXT | Switch | 0 | This parameter allows to suppress an kind of text on thumbnail HTML pages and image HTML pages belonging to that "SUBTITLE". This mainly affects automatically created IMAGE_NAME or IMAGE_CAPT entries (image captions or subtitles). The entry must be placed exactly before the "SUBTITLE" it belongs to. The parameter is not yet fully implemented and is valid from that subtitle until it is switched off. Currently, the parameter is switched off right in front of the "SUBTITLE" in order to re-enable the display of HTML text.

back to top

## Image Parameters

A number of additional parameters exist for each image. They mainly describe additional texts and descriptive information. Besides that, parameters exist which influence a potential rotation of the image or decide if an image should represent the actual "SUBTITLE" selection on the top thumbnail HTML page.

Entry | Type | Default Value | Description
--- | --- | --- | ---
IMAGE_NAME | String | <automatically generated from the file name> (see also renaming rules) | This entry represents the image title, or name of the image. It should be kept concise and readable. In case of a later rename run this entry is used to derive a new modified image filename. This entry therefore directly affects the readability of your image file names.
IMAGE_CAPT | String | <IMAGE_NAME by default> | This is the image caption (placed as subtitle below the image itself).
IMAGE_TEXT | String | <multiline> | This multiple line entry allows to add descriptive text to each image. This text may be composed of HTML tags and entities if needed. The alignment of the text can be influenced with the parameter "HTML_IMG_TEXT_ALIGN".
IMAGE_ROT | Integer | 0 | This parameter describes the rotation which needs to be done to get the image into the normal position (the rotation is performed counter-clock-wise). "0" means no rotation. The possible values are 0, 90, 180, 270, -270, -180, -90. In the course of a rename run the original image is first copied and renamed to, e.g., "ab_ImageName.orig.jpg". After that the original image is rotated according to that value (while keeping the original name). The "IMAGE_ROT" value is finally set to "0" to indicate that the image is now in its normal position. Without "rename" option a different strategy is applied. In that case the original image is preserved as is and a copy of the image is rotated. The copied and rotated image file is named like the original with a suffix that denotes th rotation angle (e.g. "ab_ImageName_90deg.jpg"). This rotated image is then also used to create all derived images like thumbnails, etc. Note that the rotation of the original image is performed without any loss in quality (the utility "jpegtran" is used for that purpose).
IMAGE_SEL | Switch | 0 | A value of "1" indicates that this image is used to represent the "SUBTITLE" group on the top thumbnail HTML page. Note that only one image per "SUBTITLE" group should have its "IMAGE_SEL" value set to "1".
IMAGE_ALT | String | <IMAGE_NAME by default> | This text is written to the "ALT" option of the "IMG" HTML tags of the thumbnail and websize images. Note that the button images use the content of the "IMAGE_NAME" entry in their "ALT" option.
IMAGE_IMPR | String | <the value of the IMG_IMPRINT_DEFAULT entry> | The text string value of this parameter (if not empty) is imprinted into the right bottom corner of the Websize image. Note that it is not possible to use HTML tags or entities. However, the string may contain special characters which are converted as is (if possible, the supported special characters mainly depend on the font that is used).
IMAGE_EXIF | Switch | undefined | A value of 0 in that entry supresses the reading of the EXIF-header-information. Set the value to 1 (or remove the entry) to force the reading of the JPEG EXIF-header-info. If no EXIF-header-info exists, or is not readable, then the value is automatically reset to 0. Whenever the configuration file is written only the value 0 is actually written. A value of 1 is ignored as it is identical to no entry at all. This switch is normally automatically set with a correct value after the first analysis of an image and it suppresses unnecessary "jhead" read operations in all following program runs.
IMAGE_INFO | Switch | <the value of the IMG_ADD_JPG_INFO_PAGE entry> | If this parameter is set to a value of "1", and if the type or format of the image file is JPEG, then an additional info HTML page is generated. This page comprises of additional information about the image that is extracted from the JPEG EXIF header. Note that the utility "jhead" is required to read the EXIF information.
IMAGE_DEL | Switch | 0 | Setting this parameter to a value of "1" removes the image from the selection configuration file and deletes all created image and HTML files (but does not delete the original file!). The selection configuration file is overwritten to reflect the modified selection. Note that also all links to that image or related HTML pages are automatically removed from the other HTML pages.
IMAGE_LINK | Pathname |  | An image may also belong and point to a secondary image selection. The "IMAGE_LINK" entry describes the HTML page to which the thumbnail image should point. Note that neither the thumbnail image nor the HTML file are automatically generated. The script assumes that both do already exist. The entries "IMAGE_ROT" and "IMAGE_DEL" may therefore not be used in connection with the entry "IMAGE_LINK".
IMAGE_PATH | Pathname | (an empty value is not allowed!) | Tis parameter entry describes the file pathname of the image file. Note that the Web-Ready mode expects solely relative pathnames. For reasons of backward compatibility, each line, that is not a comment or an empty line, nor any other known configuration entry, is interpreted as an image file pathname. This allows, for example, to read existing iview image lists. Pathnames in DOS format must not contain any drive information and are automatically converted into Unix format pathnames (i.e. backslashes are converted into slashes).

back to top, back to main page