KHKs ISQ Cropper

Authors

Karl-Heinz Kunzelmann

History

2006

Source

Available upon request

Installation

Download the java archive: ISQ_Cropper.jar

To run the project from the command line, go to its folder and type the following:

java -jar “ISQ_Cropper.jar”

Description

This java program takes a Scanco microct ISQ file as input. The user can select a region of interest, for example to crop black margines. The cropped file is saved as ISQ file with all header data. The program is stand alone.

The intention, was to make it possible to large handle ISQ files on computers with limited memory.

Follow the menu from the left to the right (3 steps). Batch mode is possible, too, see example batch file in the zip archive.

Howto use ISQ Cropper

Verwendung des „Stand-alone-Programmes“ ISQ-Cropper:

Wir haben generell das Problem, dass wir zu wenig Speicherhaben, um die großen ISQ-Dateien zu bearbeiten. Aus diesem Grund habe ich nochein Programm geschrieben, das die Dateien in kleinen Portionen einliest, verkleinertund dann wieder auf die Festplatte schreibt.

Das Programm heisst: ISQ-Cropper.

Es gibt zwei Möglichkeiten mit dem Programm zu arbeiten.

  • Mit einer graphischen Oberfläche (GUI = graphical user interface) – man kann damit aber nur eine Datei bearbeiten.
  • Als „Kommandozeilenprogramm“ in einem Dos-Fenster oder über einen Aufruf als Batch-Datei. Damit kann man den Rechner die ganze Nacht beschäftigen und er arbeitet die ganze Liste an Aufträgen ab.

Auf dem Desktop eines jeden Benutzers kann man ein Icon anlegen: ISQ_Cropper_GUI.bat.

Dieses anklicken.

Hintergrundinformation:

Die Datei ISQ_Cropper_GUI.bat enthält nur 1 Zeile:

java -jarc:\programme\isq_cropper\dist\isq_cropper.jar

Es öffnen sich dann zwei Fenster:

Links oben (man kann es sich auch so hinschieben) ist das Fenster, in dem die Systemmeldungen zu lesen sein werden (man nennt diesesFenster die „Konsole“).

Unten sieht man die Eingabemaske des Programms. Es müssen drei Schritte durchgeführt werden (von links nach rechts):

  • Das File aussuchen
  • Die Daten eingeben
  • Den Vorgang starten

Am Schluss kann man dann mit Exit das Programm verlassen –oder: gleich mit dem nächsten File bei 1) wieder beginnen (dies hat denVorteil, dass der Pfad noch vom letzten Bild gespeichert ist).

Die Eingabe der Daten ist eigentlich selbsterklärend. DieDaten kann man mit ImageJ aus einem abgebrochenen Import mit Import_ISQ ablesen(mit dem Cursor).

Der Batch-Vorgang wird über eine *.bat Datei ausgeführt.

Ein Beispiel ist – schreibgeschützt – in C:\Programme\ISQ_Cropper\dist\isq_cropper.batzu finden. Man kann sich mit dem „Editor“ (= Notepad.exe) selbst so eine Dateianlegen.

Hier steht, was die einzelnen Kommandos bedeuten:

java -jar c:\Programme\isq_cropper\dist\isq_cropper.jar “C:\usr4\dias\Bilder-KH\C0000178.ISQ;1” 100 100 400 400 20 5

java -jar c:\Programme\isq_cropper\dist\isq_cropper.jar = Aufruf des Java-Compilers, start des Programmes isq_cropper, jar ist ein Archiv mit vielen einzelnen Dateien.

c:\Programme\isq_cropper\dist\isq_cropper.jar - dieser Teil muss so angepasst werden, dass er zu dem Verzeichnis führt, indem auf dem jeweiligen Rechner isq_cropper.jar zu finden ist.

“C:\usr4\dias\Bilder-KH\C0000178.ISQ;1” - der volle Pfad zu der ISQ-Datei– IN ANFÜHRUNGSZEICHEN

Dann kommen die Daten:

<filename> <upperLeftX><upperLeftY> <lowerRightX> <lowerRightY> <number of slicesto copy> <number of slice where to start>

ACHTUNG die Reihenfolge ist wichtig!

Wenn in einem Dateinamen Leerzeichen oder andereSonderzeichen auftauchen, dann muss man links und rechts ein „“ ergänzen!

Man kann beliebig viele Zeilen hintereinander bearbeiten!