next up previous contents
Next: The format of .tkderm_profile Up: Customizing tkDerm Previous: The Preferences dialog   Contents

How to set an each item in the Preferences dialog

This section describes the meaning of each item.

PostgreSQL Server
The IP address of the PostgreSQL server. tkDerm can connect to the PostgreSQL server running on a remote host. To configure tkDerm and PostgreSQL in such a fashion, you should type the IP address of the server in this entry and edit postgresql.conf and pg_hba.conf files in the PostgreSQL installation. On detailed explanation for this topic, you should consult the chapter on the client authentication in the PostgreSQL Documentation.

The default value is ''localhost''.

Language
The language used for displaying button names, menu items, window titles or messages.

You must restart tkDerm after changing the Language setting to see the effect because the language used in tkDerm is chosen when it starts up.

Auto
The language will be chosen automatically according to the one used in the operating system running.
English
English will be chosen irrespective of the language used in the operating system running.
Japanese
Japanese will be chosen irrespective of the language used in the operating system running.

The default value is ''Auto''.

font
This sets the font used for showing data in the table of the Search Result panel and the Register window. The Font Selection dialog will pop up when you click the ''...'' button. You should choose items from the Font, Size and Format menus. According to your choice, the font example in the middle of the dialog will change. The Reset button will turn the font to the default setting.

If you leave this entry empty, a system font depending on the operating system will be chosen.

The default value is empty.

Datestyle
This specifies how to handle a date input in the Birthday entry in the New Data dialog.

YMD
To select month-day-year interpretation.
MDY
To select month-day-year interpretation.
DMY
To select day-month-year interpretation.

For example, 01/02/03 is interpreted as 3 February 2001 in the YMD mode, 2 January 2003 in the MDY mode and 1 February 2003 in the DMY mode. On the contrary, 2001-02-03, 20010203 and 010203 is regarded as 3 February 2001 in every mode. Therefore, it is preferable to use these style in typing a date because they are unambiguous in interpretation.

You can find a complete description for date/time interpretation in the Appendix in the PostgreSQL documentation.

The default value is ''YMD''.

Notebook Order

This specifies ordering of the pages of the main window.

Patient_First
Patient-Macro-Micro ordering.
Patient_Last
Macro-Micro-Patient ordering.

The default value is ''Patient_First''.

Patient Attribute Order

This specifies ordering of the First_Name and Last_Name attributes in the Patient page of the New Data dialog and the tables in which patient data are shown.

Auto
The ordering is chosen automatically according to the language setting described above, that is, First_Name-Last_Name ordering is selected in case of English, while Last_Name-First_Name ordering is selected in case of Japanese.

First_Last
First_Name-Last_Name ordering irrespective of the language setting.
Last_First
Last_Name-First_Name ordering irrespective of the language setting.

The default value is ''Auto''.

Volume Capacity(MB)

This specifies the size of the volume in megabytes.

If you leave this entry empty, the Used progress bar in the Volume dialog and the Volume progress bar in the Register window will not work.

You should consult Chapter 7กส[*] page) for information on volumes.

The default value is ''650''.

Max Interval(min)

If you set this item, dummy data will be inserted automatically at image registration when the shooting time is apart from the data insertion time by more than the time (in minutes) that is set in this item.

If you leave this entry empty, the automatic dummy data insertion will not happen.

You should consult Section 3.4.5 ([*] page) on this topic.

The default value is empty.

Time Adjustment(sec)

tkDerm enters the current time into the following entries automatically.

  1. The Time entry in the Macro page of the New Data dialog.
  2. The Insert_Time entry in the Micro page of the New Data dialog.
  3. The Time entry in the Edit Micro Data dialog if you click the '' ! '' button.

Automatic Image Registration (see Chapter 3 starting from [*] page) doesn't work properly if the current time reported by the clock in your computer is much different from the time of the clock in your digital camera. This sets a time adjustment (in minutes) in these entries to adjust the timing difference between the computer and camera.

To set this item, you can use the Adjust Clock dialog that will pop up via the Adjust Clock...command from the Admin menu.

The default value is ''0'' (no adjustment).

Removable Media Directory

This specifies the directory to which a memory card of your digital camera is mounted.

This directory must be writable by the tkDerm superuser and empty at image registration.

It will be created if it doesn't exist at image registration.

You can specify this item by a path name relative to your home directory in addition to by an absolute path.

It is better to set this item by the Choose Directory dialog that will pop up when you click the ''...'' button than to type a path name by yourself because the latter method may result in specifying a directory that doesn't exist by errors in typing.

If you choose the Import Exif Files item from the Register menu, tkDerm will look for jpeg files under this directory and if it find them, it will copy them to the directory specified in the Import Directory item (see below).

If you leave this entry empty, the Choose Removable Media Directory dialog will pop up when you choose the Import Exif Files item from the Register menu and you should select the mount point of the memory card.

The default value is empty.

Import Directory

This specifies the directory in which tkDerm looks for image files to be registered.

This directory must be writable by the tkDerm superuser and empty at image registration. If you are going to use tkDerm touch, the directory must be writable by the PostgreSQL superuser, postgres, too.

It will be created if it doesn't exist at image registration.

You can specify this item by a path name relative to your home directory in addition to by an absolute path.

It is better to set this item by the Choose Directory dialog that will pop up when you click the ''...'' button than to type a path name by yourself because the latter method may result in specifying a directory that doesn't exist by errors in typing.

If you choose the Import Exif Files item from the Register menu, tkDerm will copy jpeg files found under the directory specified in the Removable Media Directory (see above) to this directory.

If you leave this entry empty, the Choose Import Directory dialog will pop up when you choose the Import Exif Files item or the Register...item from the Register menu and you should select the directory for pooling image files to be registered.

The default value is empty.

Mounted Import Directory

If you are going to register photos by tkDerm on the client machine and the Import Directory of the server machine is mounted on the client, you should set the mount point as this item.

If the Import Directory and tkDerm are on the same machine, that is, locathost is set as the PostgreSQL Server item, it is not necessary to set this item.

The default value is empty.

Clean Photo
This specifies whether or not image files are removed from the Import Directory after image registration.

The default value is ''Off'' (image files aren't removed).

Photo Directory

This specifies the top directory of the image-storing directory tree.

This directory must be writable by the tkDerm superuser and empty before the first image registration.

It will be created if it doesn't exist at image registration.

You can specify this item by a path name relative to your home directory in addition to by an absolute path.

It is better to set this item by the Choose Directory dialog that will pop up when you click the ''...'' button than to type a path name by yourself because the latter method may result in specifying a directory that doesn't exist by errors in typing.

You should set this item to a directory outside your home directory if you share tkDerm others because the directory must be readable by all users.

The default value is ''photo'' (a directory named photo in your home directory).

Backup Photo

This specifies whether or not the image-storing directory is duplicated at image registration.

The default value is ''Off'' (the image-storing directory isn't duplicated).

Backup Photo Directory

This specifies the top directory of a duplicate of the image-storing directory tree.

This setting is ignored if the Backup Photo item described above isn't checked.

This directory must be writable by the tkDerm superuser and empty before the first image backup.

It will be created if it doesn't exist at the first image backup.

You can specify this item by a path name relative to your home directory in addition to by an absolute path.

It is better to set this item by the Choose Directory dialog that will pop up when you click the ''...'' button than to type a path name by yourself because the latter method may result in specifying a directory that doesn't exist by mistakes in typing.

It is advisable to locate the directory specified by this item in a hard drive that is different from the drive in which the Photo Directory described above resides not to lose your image files in case of a disk failure.

The default value is empty.

PNG Photo Directory

This specifies the directory under which PNG files for tkDerm touch are deployed.

The PostgreSQL superuser, postgres, needs write permission for this directory.

The default value is empty.

Backup Data

This specifies whether or not session data are inserted to a PostgreSQL server running on a remote host.

The default is ''Off'' (session data aren't inserted to a remote server).

PostgreSQL Backup Server

This specifies the IP address of the remote host to which session data are inserted when the Backup Data item described above has been set to ''On''.

To duplicate session data in a remote server, the following conditions must be met:

  1. A PostgreSQL server is running on a remote host.
  2. The server has a database whose name is the same as the one you are going to duplicate.
  3. The server can accept a connection request from the host running tkDerm.

You can control client authentication of PostgreSQL by editing the postgresql.conf and pg_hba.conf files. See the PostgreSQL documentation for details.

The default value is empty.

PostgreSQL Directory

This specifies the PostgreSQL installation directory.

It is better to set this item by the Choose Directory dialog that will pop up when you click the ''...'' button than to type a path name by yourself because the latter method may result in specifying a directory that doesn't exist by mistakes in typing.

tkDerm uses some client applications that are shipped with PostgreSQL to do some important tasks. For example,

  1. bin/pg_dump is required for dumping databases
  2. bin/pg_restore is required for restoring databases
  3. share/contrib/pgcrypt.sql and bin/psql are required for encrypting or decrypting databases
In the above examples, the executable files or the script are expressed as path names relative to the top directory of a PostgreSQL installation.

This setting tells tkDerm where to look for the client applications. Therefore, if this item is not properly set, tkDerm cannot perform the above mentioned tasks.

ImageMagick Directory

PNG files for tkDerm touch are created by ImageMagick.

This specifies the directory in which ImageMagick executables, convert and identify, are installed.

On Macintosh and Linux, typing in the terminal

which convert

will show the absolute path of convert.

You need not set this item if you don't use tkDerm touch.

The default value is empty.

ExifTool Directory

When using tkDerm touch, Exif data such as the shooting time and the camera model name are read with the Perl module, Image::ExifTool.

This specifies the installation directory of the module.

In the terminal, the command

perldoc -ml Image::Exiftool

will show the absolute path of Image::ExifTool. The path excluding the last /Image/Exiftool.pm should be entered as the ExifTool Directory of the preferences setting.

You need not set this item if you don't use tkDerm touch.

The default value is empty.

Photoshop JavaScript Directory

This sets the directory in which tkDerm saves a JavaScript file for the Adobe Photoshop to open image files registered by tkDerm by reading the JavaScript file.

On this topic, see Section 5.5 ([*] page).

The default value is empty.

Bridge JavaScript Directory

This sets the directory in which tkDerm saves a JavaScript file for the Adobe Bridge to open a photo-storing directory by reading the JavaScript file.

On this topic, see Section 5.6 ([*] page).

The default value is empty.

Package Directory

This specifies the top directory of user-defined packages.

This directory must be writable by the tkDerm superuser and empty before the first package creation.

It will be created if it doesn't exist when tkDerm is started up.

You can specify this item by a path name relative to your home directory in addition to by an absolute path.

It is better to set this item by the Choose Directory dialog that will pop up when you click the ''...'' button than to type a path name by yourself because the latter method may result in specifying a directory that doesn't exist by errors in typing.

You should set this item to a directory outside your home directory if you share tkDerm others because the directory must be readable and executable by all users.

The default value is ''pkg'' (a directory named pkg in your home directory).

Thumbnail Prefix

This specifies the prefix of thumbnail files.

tkDerm regards a file whose name begins with the string specified by this setting as a thumbnail file. You should change the default value ''tn'' to another string if the names of image files happen to begin with ''tn'' because in such an exceptional case, tkDerm cannot distinguish thumbnail files from original image files. Except for such a rare situation, you need not change the default setting.

The default value is ''tn''.

Caution : This setting must be done before the first image registration because tkDerm wouldn't recognize the thumbnails already created if you change the thumbnail prefix later.

Thumbnail Width

This sets the width of the thumbnail in pixels.

The default value is 150.

Thumbnail Rim Length

This sets the width of the rim of the thumbnail in pixels.

The default value is 10.

PNG Full Height

This sets the length in pixels of the shorter rims of PNG photos for tkDerm touch.

The default is 1536.

PNG Thumb Height

This sets the length in pixels of the shorter rims of the thumbnails of PNG photos for tkDerm touch.

The default is 154.

PNG Thumb Height

This sets the length in pixels of the shorter rims of the icons of PNG photos for tkDerm touch.

The default is 44.

Clipboard Image Number in Row

This sets the number of the images in the row in the clipboard window or tabnotebook.

The default value is 2.

Register Thumbnail Number in Row

This sets the number of the thumbnails in the row in the register window.

The default value is 5.

Appearance Dialog Lines

This sets the number of lines per page in the Appearance dialog.

The default value is 10.

Pref Dialog Lines

This sets the number of lines per page in the Preferences dialog.

The default value is 10.

Patient Select Row

This sets the number of rows of the Search Result panel in the Patient page of the main window.

The default value is 10.

Macro Select Row

This sets the number of rows of the Search Result panel in the Macro page of the main window.

The default value is 10.

Micro Select Row

This sets the number of rows of the Search Result panel in the Micro page of the main window.

The default value is 10.

Database Empty Row

This sets the number of empty rows of the database table in the Create & Drop Database dialog.

The default value is 2.

Camera Empty Row

This sets the number of empty rows of the database table in the Insert & Delete Camera Data dialog.

The default value is 2.

Doctor Empty Row

This sets the number of empty rows of the database table in the Insert & Delete Doctor Data dialog.

The default value is 2.

Register Empty Row

This sets the number of empty rows of the data table in the register window.

The default value is 2.

Image Panel Type

This specifies the style of the image window.

Window
The image window is presented as an independent window.
Tab
The image window is presented as a page of the tabnotebook style.

The default value is ''Window''.

Clipboard Panel Type

This specifies the style of the clipboard window.

Window
The clipboard window is presented as an independent window.
Tab
The clipboard window is presented as a page of the tabnotebook style.

The default value is ''Window''.

Register Log

This specifies whether or not Automatic Image Registration (AIR, see Chapter 3 ([*] page) writes its report as a file named tkderm_register.txt in your home directory.

If the tkderm_register.txt file doesn't exist in your home directory, it will be created. If it does, new data will be added to the file.

On how to read the tkderm_register.txt file, you should consult Section 15.2 ([*] page).

The default value is ''Off''.

Bug Log

This specifies whether or not tkDerm writes a bug report as a file named tkderm_bug.txt in your home directory instead of popping up an error-reporting dialog when an error occurs.

If the tkderm_bug.txt file doesn't exist in your home directory, it will be created. If it does, a new report will be added to the file.

The default value is ''Off''.

Expect Windows Debug

This specifies whether or not outputs from Expect are shown for debugging on Windows.

Expect is a Tcl-based program for automating interactive programs and is used in tkDerm for dumping, restoring and encrypting databases.

On platforms other than Windows, this setting is ignored.

The default value is ''Off''.


next up previous contents
Next: The format of .tkderm_profile Up: Customizing tkDerm Previous: The Preferences dialog   Contents
manabu 2010-11-14