Enter 1999 November/ENTER11_1.bin/OS2/DCITU/dcitu.hlp

OS/2 Help File | 1999-09-04 | 17.7 KB | 551 lines

ΓòÉΓòÉΓòÉ 1. Help for the Options window ΓòÉΓòÉΓòÉ

The settings in the Options window must be set before you can connect to your
camera.  These settings are temporary unless you chose Save Options from the
menubar.


ΓòÉΓòÉΓòÉ 1.1. Camera Type ΓòÉΓòÉΓòÉ

This combobox is used to select the digital camera to which a connection will
be made.  At this time, these are the only camera types that are supported:

     Digita (see note below)
        -  Kodak DC220
        -  Kodak DC260
        -  Kodak DC265
        -  Minolta Dimage 1500
     Kodak DC25 (see note below)
     Kodak DC120 (see note below)
     Kodak DC200, DC210 and DC215
     Kodak DC240
     Kodak DC280
     Project 'O'
        -  Agfa ePhoto
        -  Epson PhotoPC
        -  Nikon Coolpik 900
        -  Olympus
        -  Sanyo VPC/DSC
        -  Sierra SD640
        -  Toshiba PDR-2

 If your camera does not appear in this list, and you wish to know if it is
 compatible, I suggest you try the following model types:

   1. Olympus
   2. Digita
   3. Kodak DC240 (with raw directory path enabled)
   4. Kodak DC210
   5. Kodak DC120
   6. Kodak DC25

 Note:  This option takes effect the next time a connection is established.

 Note:  You cannot change the camera type if a connection has already been
 established.

 Note:  The Casio QV digital cameras are no longer supported.

 Note:  You may need the OS/2 tools contained in the archive KDC_DC2.ZIP if you
 are using the Kodak DC25 or Kodak DC120 digital cameras.  The file KDC_DC2.ZIP
 can be downloaded free of charge from various locations on the internet,
 including ftp://hobbes.nmsu.edu/pub/os2/apps/graphics/convert/kdc_dc2.zip.

 Note:  Some thumbnail formats for the DIGITA cameras are not yet supported.


ΓòÉΓòÉΓòÉ 1.2. Advanced COM Port ΓòÉΓòÉΓòÉ

In the default deselected state, the advanced COM port selection is disabled,
forcing you to select a standard COM port such as COM1, etc. When you select
this checkbox, you can then type the true device name to which your camera is
connected, including network serial ports.  Also see Advanced COM Port Name.

Note:  If you are using a normal serial port, you should leave this checkbox
deselected.

Note:  This option takes effect the next time a connection is established.


ΓòÉΓòÉΓòÉ 1.3. Advanced COM Port Name ΓòÉΓòÉΓòÉ

If you have a special multi-port serial card installed with the appropriate
OS/2 drivers, you can select a name other than COM.  For example, the
RocketPort card by default installs itself as \dev\rck1 through \dev\rckN.

You can also use network serial ports by specifying the NETBIOS name of the
shared serial port.  For example, you could use the shared serial port COM7 on
the computer WORKSTATION by using the name \\WORKSTATION\COM7.

Note:  The Advanced COM Port checkbox must be selected for this option to be
available.

Note:  This option takes effect the next time a connection is established.


ΓòÉΓòÉΓòÉ 1.4. COM Port ΓòÉΓòÉΓòÉ

This spinbutton is used to select the serial COM port to which the camera is
attached.  Previous versions of DCITU used to scan the COM ports to try and
determine if a serial port was available; however, it was suspected that this
was causing some problems with certain hardware, so all serial COM ports are
now listed regardless of the port's availability.

While all possible serial ports available to OS/2 are listed, please note that
not all of these may be available on your computer!  You should select the port
to which the camera has been attached.

Valid selections include physical serial ports available on your computer, or
ports that have been re-directed using either Peer or IBM Lan Server.

Note:  This option takes effect the next time a connection is established.


ΓòÉΓòÉΓòÉ 1.5. Transfer Speed ΓòÉΓòÉΓòÉ

The transfer rate is the speed at which information is sent from the digital
camera to the computer.  The maximum value you can use for the transfer rate is
determined by the following three factors:

   1. rate supported by the serial port hardware
   2. rate supported by the camera model
   3. unregistered/registered version of DCITU

 Most newer computers have built-in serial ports that can easily handle a baud
 rate of 115200.  Some older computers without buffered serial ports will only
 handle 9600 or 19200 baud.  While OS/2 supports serial transfer rates as high
 as 230400, this normally requires additional hardware and/or special drivers.

 Note that the unregistered version of DCITU will only use speeds of 9600 baud,
 regardless of what transfer rate you have selected.  This is the only
 difference between the registered and unregistered version of DCITU.

 Note:  This option takes effect the next time a connection is established.


ΓòÉΓòÉΓòÉ 1.6. Extended Buffers ΓòÉΓòÉΓòÉ

Newer serial ports built-in to most computers use extended buffers to achieve
greater reliability at higher transfer rates.  These extended buffers are
sometimes referred to as 16550 UARTs.  Using the Extended Buffers combobox, you
can choose to:

     automatically detect and use extended buffering when available
     force OS/2 to try and enable extended buffering even if not detected
     force OS/2 to disable extended buffering

 Note:  In most cases, the default setting of auto-detect is the best option
 available.  The other two options should only be used if you are using special
 hardware with specific OS/2 drivers that may not correctly detect the presence
 of a 16550-type UART.

 Note:  This option takes effect the next time a connection is established.


ΓòÉΓòÉΓòÉ 1.7. Timeout Detection ΓòÉΓòÉΓòÉ

The timeout detection value is used by DCITU to determine the length of time to
wait for the camera to send information.  If this amount of time has elapsed
without the camera sending any information, then DCITU assumes that the camera
has no more information to send, or (depending on the circumstance) that an
error has occured.

     With the Kodak cameras, this setting can be kept at 5 seconds.

     With most Project 'O'-type cameras, this setting should be less than 5; a
      value of 2 or 3 seems to be sufficient in most cases.

 Note:  This option takes effect the next time a connection is established.


ΓòÉΓòÉΓòÉ 1.8. Pause Between Commands ΓòÉΓòÉΓòÉ

Some camera models may encounter errors while trying to transfer or delete
multiple images at once.  This may be caused by DCITU sending commands too
quickly to the digital camera.  If you can transfer or delete a single image,
but cannot select multiple images and transfer or delete them at once, try
increasing the number of milliseconds that DCITU pauses between commands.

Note:  See the option Pause After Changing Baud Rate before adding a pause
between commands.

Note:  This option takes effect the next time an image is downloaded from the
camera.


ΓòÉΓòÉΓòÉ 1.9. Pause After Changing Baud Rate ΓòÉΓòÉΓòÉ

To properly synchronize, some cameras need to pause after having changed the
baud rate at which communications with the computer take place.  Prior to
version 1.6e of DCITU, there was fixed pause of 100ms for all of the Kodak-type
cameras, while all others had no pause (0ms).  A minimum of 100ms or 200ms for
almost all camera types will probably help ensure that communications do not
break down.

Note:  Setting a too short or too long pause time will cause DCITU and your
camera to either lose synchronization or timeout, possibly requiring you to
reconnect.

Note:  This option takes effect the next time an image is downloaded from the
camera.


ΓòÉΓòÉΓòÉ 1.10. Retry Partial Transfers ΓòÉΓòÉΓòÉ

Some serial port hardware may report incomplete serial byte transfers.  In
these cases, multiple requests must be made to the hardware to transfer a full
block of bytes from the serial port to DCITU.  This behaviour has been observed
on multi-port serial cards, such as the RocketPort and the DigiBoard, as well
as on standard serial ports when Ray Gwinn's SIO.SYS driver is used instead of
IBM's normal COM.SYS driver.

By default, this option should normally be enabled, regardless of the driver or
serial port type being used.

Note:  This option takes effect the next time an image is downloaded from the
camera.


ΓòÉΓòÉΓòÉ 1.11. Ignore Memory Card ΓòÉΓòÉΓòÉ

If you do not have an ATA flash memory card in the camera, select this item to
let DCITU know that the calls to initialize the ATA card should be ignored.


ΓòÉΓòÉΓòÉ 1.12. Convert KDC to JPG ΓòÉΓòÉΓòÉ

Compressed .KDC-format files used with the Kodak DC120 camera can be
automatically converted to .JPG-format when this option is selected.  This
conversion is the same as that accomplished by the KDC-JPG tool.

Note:  Uncompressed .KDC files are not converted to .BMP format.  This can only
be done with the command-line conversion tools available from
ftp://hobbes.nmsu.edu/pub/os2/apps/graphics/convert/kdc_dc2.zip.

Note:  This option is only available with the Kodak DC120 cameras.


ΓòÉΓòÉΓòÉ 1.13. Use Raw Directory Path ΓòÉΓòÉΓòÉ

With the Kodak DC240 and DC280 digital camera, the images are stored in
subdirectories that are grouped together using a combination of numbers and
model identifiers.  Normally, when DC240 or DC280 is selected as the camera
type, only the respective DC240 or DC280 directories are searched for images.
When Use Raw Directory Path is selected, all directories found on the ATA card
will be searched.

Note:  The Kodak cameras may not allow some non-Kodak JPEG files to be
downloaded even though the file is listed in DCITU.

Note:  This option takes effect the next time a connection is established.


ΓòÉΓòÉΓòÉ 1.14. Use Alternate Camera Startup ΓòÉΓòÉΓòÉ

Some Project 'O'-type cameras use a different startup sequence when
establishing a connection.  If you cannot get a valid connection, and you've
already seen the note concerning the timeout detection, then you may want to
set this option.

Note:  This option takes effect the next time a connection is established.

Note:  This option is only available with the Project 'O'-type cameras.


ΓòÉΓòÉΓòÉ 1.15. Keep Thumbnail Files ΓòÉΓòÉΓòÉ

When you download thumbnail images from the camera, this creates temporary
image files which can then be deleted, or kept for use as pre-made thumbnails.
Selecting this option will keep these temporary images.

Note:  This option is only available with the Project 'O'-type cameras.


ΓòÉΓòÉΓòÉ 1.16. Enable LCD Display ΓòÉΓòÉΓòÉ

During image transfers, the corresponding thumbnail will be displayed on the
LCD screen.

Note:  Enabling this feature may drain the batteries faster, especially for a
large number of images.


ΓòÉΓòÉΓòÉ 1.17. How to setup the serial line ΓòÉΓòÉΓòÉ

The serial line settings can greatly affect the communication between your
computer and digital camera.  Unless you have a special camera and/or serial
port adapter that requires a specific setting, you should use the following
defaults:

   1. DTR control mode: enable
   2. RTS control mode: enable
   3. output handshacking using CTS: not selected
   4. output handshacking using DSR: not selected
   5. output handshacking using DCD: not selected
   6. input sensitivity using DSR: not selected
   7. automatic transmit flow control: not selected
   8. automatic receive flow control: not selected

 Using the pushbutton "reset to default for selected camera" will reset the
 spinbuttons and checkboxes to these default values.

 Note:  This option takes effect the next time a connection is established.


ΓòÉΓòÉΓòÉ 1.18. Image Transfer Directory ΓòÉΓòÉΓòÉ

The directory specified will be used to save images when they are being
transferred from the digital camera.  The default is to use the current working
directory.

Note:  Starting with version 1.8b, DCITU will actually change the current drive
and directory to the transfer directory to help ensure that user-defined
scripts can be easily called.

Note:  This option takes effect the next time an image is downloaded from the
camera.


ΓòÉΓòÉΓòÉ 1.19. Delete Failed Image Transfers ΓòÉΓòÉΓòÉ

If an image transfer is unsuccessful, partial or empty image files can remain
in the image transfer directory.  Selecting this option will delete files that
result from failed image transfers.


ΓòÉΓòÉΓòÉ 1.20. Use Highest Priority ΓòÉΓòÉΓòÉ

Starting with version 1.8a of DCITU, the Use Highest Priority option was
created to allow DCITU to run at the highest possible priority level.  This can
be used on busy systems to help DCITU prevent incoming serial port characters
from being lost.

Enabling this option will change the GUI thread and DCITU's serial port service
thread to run at OS/2's foreground server priority.  Without this option, the
GUI thread runs at normal priority while the serial port service thread runs at
time critical priority.

From lowest to highest, OS/2's thread priority is defined as follows:

   1. idle priority
   2. regular priority
   3. time critical priority
   4. foreground server priority

 Note:  Enabling this option may cause the rest of the system, including OS/2's
 Workplace Shell, to seem unresponsive.

 Note:  This option has no effect until the next time DCITU is started.


ΓòÉΓòÉΓòÉ 1.21. Connect to Camera on Startup ΓòÉΓòÉΓòÉ

When selected, this option will cause DCITU to automatically attempt to connect
to the camera when first started.  The last-saved options will be used to
determine the camera type, baud rate, and other settings.

Note:  This option has no effect until the next time DCITU is started.


ΓòÉΓòÉΓòÉ 1.22. Auto Download Thumbnails on Connect ΓòÉΓòÉΓòÉ

When selected, this option ensures that the thumbnails are automatically
downloaded from the camera when a connection is established.

Note:  This option is not available with the Kodak DC120 cameras.


ΓòÉΓòÉΓòÉ 1.23. Use 4-bit Thumbnails ΓòÉΓòÉΓòÉ

When Auto Download Thumbnails on Connect is selected, this option will enable
the transfer of the 4-bit thumbnails.

Note:  This option is only available with the Kodak DC210 cameras.


ΓòÉΓòÉΓòÉ 1.24. Use 24-bit Thumbnails ΓòÉΓòÉΓòÉ

When Auto Download Thumbnails on Connect is selected, this option will enable
the transfer of the 24-bit thumbnails.

Note:  This option is not available with the Kodak DC120 cameras.


ΓòÉΓòÉΓòÉ 1.25. Auto Transfer Images on Connect ΓòÉΓòÉΓòÉ

When selected, this option will auto download all of the images from the camera
after a connection is established.  If the Auto Download Thumbnails on Connect
option is selected, all of the thumbnails will be transfered before the images.


ΓòÉΓòÉΓòÉ 1.26. Overwrite Images with Identical Names ΓòÉΓòÉΓòÉ

When selected, this option will cause existing files to be overwritten when
images are being transfered.  Without this option being selected, images that
already exist in the transfer directory will not be downloaded.

Note:  This option takes effect the next time an image is downloaded from the
camera.


ΓòÉΓòÉΓòÉ 1.27. Delete Images From Camera after Transfer ΓòÉΓòÉΓòÉ

When selected, this option will delete from the camera images that were
successfully transfered.

Note:  This option is not available with the Kodak DC120 and Kodak DC25
cameras.

Note:  This option takes affect the next time an image is downloaded from the
camera.


ΓòÉΓòÉΓòÉ 1.28. How to Use Scripts ΓòÉΓòÉΓòÉ

To run a script, you must have selected the appropriate checkbox and have a
script name specified in the corresponding entryfield.  If a name is not
specified, or the checkbox is not selected, then the script will not be
started.

Names that can be specified as scripts include OS/2 executables and REXX, Perl,
or other scripts.  When the script filename does not end with .EXE or .COM, you
may have to start a secondary shell to run the script.  For example, if you
want to run the script MY_REXX_SCRIPT.CMD, you must use the name CMD.EXE /C
MY_REXX_SCRIPT.CMD.

You can use any normal command processor, such as 4OS2.EXE, etc. The same
example would then be 4OS2.EXE /C MY_REXX_SCRIPT.CMD.

Some of the scripts have special variables that are automatically replaced
before the script is called.  If you specify %i as a parameter to the script
that gets called after a connection is established, this is automatically
replaced with the number of images in the camera.  If you specify %s as a
parameter to the script that gets called when an image is transfered or
deleted, this is automatically replaced with the name of the image.  For
example, specifying C:\PMVIEW\PMVIEW.EXE %s as the script to call when an image
is transfered will call PMView with the name of the image file.

Note:  Starting with version 1.8b, DCITU will actually change the current drive
and directory to the transfer directory to help ensure that user-defined
scripts can be easily called.


ΓòÉΓòÉΓòÉ 1.29. After Connecting to the Camera (checkbox) ΓòÉΓòÉΓòÉ

Select this checkbox to run a script after a connection is established between
DCITU and the camera.

Note:  Also see How to Use Scripts.


ΓòÉΓòÉΓòÉ 1.30. After Connecting to the Camera (entryfield) ΓòÉΓòÉΓòÉ

This is the name of the script to run after a connection is established between
DCITU and the camera.

The parameter %i, if specified, is replaced with the number of images.

Note:  Also see How to Use Scripts.


ΓòÉΓòÉΓòÉ 1.31. After Successful Image Transfer (checkbox) ΓòÉΓòÉΓòÉ

Select this checkbox to run a script after an image has been transfered.

Note:  Also see How to Use Scripts.


ΓòÉΓòÉΓòÉ 1.32. After Successful Image Transfer (entryfield) ΓòÉΓòÉΓòÉ

This is the name of the script to run after an image has been transfered.

The parameter %s, if specified, is replaced with the name of the image.

Note:  Also see How to Use Scripts.


ΓòÉΓòÉΓòÉ 1.33. After Deleting An Image From the Camera (checkbox) ΓòÉΓòÉΓòÉ

Select this checkbox to run a script after an image has been deleted.

Note:  Also see How to Use Scripts.


ΓòÉΓòÉΓòÉ 1.34. After Deleting An Image From the Camera (entryfield) ΓòÉΓòÉΓòÉ

This is the name of the script to run after an image has been deleted.

The parameter %s, if specified, is replaced with the name of the image.

Note:  Also see How to Use Scripts.


ΓòÉΓòÉΓòÉ 1.35. When No More Images Remain in the Camera (checkbox) ΓòÉΓòÉΓòÉ

Select this checkbox to run a script after the last images has been deleted.

Note:  Also see How to Use Scripts.


ΓòÉΓòÉΓòÉ 1.36. When No More Images Remain in the Camera (entryfield) ΓòÉΓòÉΓòÉ

This is the name of the script to run after the last image has been deleted.

Note:  Also see How to Use Scripts.


ΓòÉΓòÉΓòÉ 1.37. After Disconnecting from the Camera (checkbox) ΓòÉΓòÉΓòÉ

Select this checkbox to run a script after disconnecting from the camera.

Note:  Also see How to Use Scripts.


ΓòÉΓòÉΓòÉ 1.38. After Disconnecting from the Camera (entryfield) ΓòÉΓòÉΓòÉ

This is the name of the script to run after disconnecting from the camera.

Note:  Also see How to Use Scripts.


ΓòÉΓòÉΓòÉ 1.39. Name ΓòÉΓòÉΓòÉ

This is the name that you requested to use with the registration.  This
information will be provided to you along with the registration key once you
register DCITU.

For additional registration information, please see the DCITU web page:
http://users.uniserve.ca/~software/dcitu/index.html.


ΓòÉΓòÉΓòÉ 1.40. Key ΓòÉΓòÉΓòÉ

This is the registration key required to register DCITU.  This information will
be provided to you once you have registered.

For additional registration information, please see the DCITU web page:
http://users.uniserve.ca/~software/dcitu/index.html.


ΓòÉΓòÉΓòÉ 1.41. Register ΓòÉΓòÉΓòÉ

Registration allows you to use transfer rates greater than 9600 baud.  Once you
have registered, you will be sent a key to match the registration name.

This information is required in the Name and Key fields before you can use the
Register pushbutton.

For additional registration information, please see the DCITU web page:
http://users.uniserve.ca/~software/dcitu/index.html.


ΓòÉΓòÉΓòÉ 1.42. OK ΓòÉΓòÉΓòÉ

The OK pushbutton will accept the currently selected settings.


ΓòÉΓòÉΓòÉ 1.43. Cancel ΓòÉΓòÉΓòÉ

The Cancel pushbutton will discard all changes that have been made to the
Options window.