import-images.xl (Conversion of Individual Image Files)

Author: Hirohisa Mori / joshua@globalbase.org + [Transrate]Reiko Inoue Bendtsen c/o Suzaku Translations / (http://www.suzaku-translations.com/) +

PROTOTYPE

xl import-images.xl / [image-format] [path-to-images] [destination-directory] [bib-file]

ARGUMENTS

[image-format] Image format after conversion. Either r64 or mtx can be specified.

[path-to-images] Path to the conversion source image file. A wild card can be used.

[destination-directory] Save destination directory

[bib-file] A file containing bibliographic information

Option

process=all,wp The default is all .

ENVIRONMENT

Agent exl [UNDEF REF (exl)]

EXPLANATION

This command converts .tif, .jpeg, and .bmp files to formats that can be viewed with GLOBALBASE. It also generates .crd, .map and .lst files at the same time and saves them as is in a status where they can be viewed.

It not only saves image files, but also generates warp point files that reference the saved files. If you refer to this file from the Warp Point menu of COSMOS, you can choose coordinate systems of generated images from a list in the warp point menu and add them.

A [bib-file] example is shown below.


<?xl version="0.1" encoding="EUC-JP"?>
<bib xmlns:gb="xlp://isjhp1.nichibun.ac.jp:8080/gb_metadata">
   <gb:title type="text" data="Japan Ortho"/>
   <gb:creator type="text" data="Osaka City University"/>
   <gb:content.period type="W3C-DTF" data="2003-01-01 / 2003-01-01"/>
   <gb:issue.period type="W3C-DTF" data="2006-06-01"/>
   <gb:property type="gb-prop" data="photo"/>
   <gb:homepage type="URL" data="http://www.osaka-cu.ac.jp/"/>
</bib>

If you prepare a [bib-file] and execute the following command, an image coordinate system file is generated in [destination-directory]=kochizu1.


% xl import-images.xl - - / r64 '/home/gbs/data/nichibun/kochizu1/2813459.tif' kochizu1 bib.xl

When selecting either r64 or mtx as the file format, it is recommended to select r64 as a general guideline, as long as the non-compressed file size does not exceed 4Gbytes; for larger files, it is recommended to choose mtx. Although files stored in the r64 format must be smaller than 4Gbyte, the compression ratio is high and hence the network load required when transmitting images is small. Relatively speaking, the network load is higher when transmitting images using mtx is larger than when using r64, but the advantage is that the file size can be larger than 4Gbytes. In the future, as the image transfer capacities, performance and function of mtx files are improved, the preferred file format can be expected to shift toward the mtx format gradually.

Warp point menu files are saved in the directory where this script is executed under the file name wp.xl. Since the URL of each image coordinate system is calculated from the position of this wp.xl file, it is recommended to choose [destination-directory] as a directory under the directory where this script is executed.

If process=all is specified, all processes are executed. If process=wp is specified, only warp point menus are generated.

[UP] Go To Page Top

RETURN VALUE

[destination-directory]/image file
wp.xl warp point menu file

ERRORS

REFERENCE

BUGS

In versions ver.B.b16.10 or earlier, there is a bug where an error occurs when using the mtx format. Please use ver.B.b16.11 or later.

[UP] Go To Page Top