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.

Categories:

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


Last Change: ,
Stefan Spaeth, S.Spaeth@z.zgs.de
Copyright © 2002, 2003 Stefan Spaeth