: : Black Belt Systems NJPL public interface load document : Last Update: January 24th, 1992 : Revision Level: 1.00 : Docs: Ben Williams, AA7AS & : Pete Patterson : Software: Pete Patterson : :Changes List :------------ : 1.00 - Initial Release : :This is a NJPL file format image load function for the following :image processing packages from Black Belt Systems: : : Image Professional : Imagemaster F/c : Imagemaster : :If you have one of these packages, but have an earlier revision than :what the changes list says you need, you'll have to obtain an update :to your image processor. Contact Black Belt Systems for details. : :In this document, all of these programs will be referred to as :the "image processor" to remain general. : Contents: ========= The NJPLRD load module consists of two portions; first, an ARexx script called "njplr.rexx", and a CLI command called "NJPLRD". Installation: ============= This module is automatically installed by the install-pi script Use: ==== Invoking the AREXX macro (pressing F1 in our example) will cause a file requester to open. Use this file requester to locate and choose the NJPL file you would like loaded as an image. If you are loading straight from the CD-ROM, the image will have an extension of either .ibg or .imq depending on wether it is a full size image or a 'browse' image. (see the discussion below for a description of each) You will be asked if you wish to save the image info as a text file. See the NJPL discussion section below for a description of the image info data. If you decide to save this data, you will be prompted for another file name via the file requester. General Loading =============== During loading, the WorkBench screen is displayed. This is done so that those of you who are using a high-resolution 16 color screen for display will not suffer speed penalties during file loading. When the image has been loaded, the image processor display will return to the front, and the image will be drawn. Short NJPL Discussion ===================== NJPL is our name for a set of CD-ROMS containing over 20,000 images at 800 x 800 resolution. The images were transmitted to earth by the Voyager 1 and Voyager 2 interplanetary probes, and in the series are images from Jupiter, Saturn and Uranus as well as many images of their satellites and other interesting phenomena. The letters NJPL stand for NASA Jet Propulsion Laboratory. There are two kinds of images stored on the CD-ROMS. There are full resolution 800 x 800 x 256 grey level compressed images, and there are 200 x 200 by 256 color uncompressed 'browse' images. This loader will load either type. Both the browse images and the full resolution images contain a good deal of text information describing various attributes of the image. You are given the option to save this data as a text file. Here is a sample of a typical image's information. Note that the comments are not ours, but are in the file itself. NJPL1I00PDS100000000 = SFDU_LABEL /* FILE FORMAT AND LENGTH RECORD_TYPE = VARIABLE_LENGTH RECORD_BYTES = 836 FILE_RECORDS = 860 LABEL_RECORDS = 54 /* POINTERS TO STARTING RECORDS OF MAJOR OBJECTS IN FILE ^IMAGE_HISTOGRAM = 55 ^ENCODING_HISTOGRAM = 57 ^ENGINEERING_TABLE = 60 ^IMAGE = 61 /* IMAGE DESCRIPTION SPACECRAFT_NAME = VOYAGER_1 MISSION_PHASE_NAME = SATURN_ENCOUNTER TARGET_NAME = TITAN IMAGE_ID = '1516S1-002' IMAGE_NUMBER = 34909.12 /*FLIGHT DATA SUBSYSTEM (FDS) IMAGE_TIME = 1980-11-11T19:52:34Z EARTH_RECEIVED_TIME = 1980-11-11T21:19:46Z INSTRUMENT_NAME = WIDE_ANGLE_CAMERA SCAN_MODE_ID = '3:1' SHUTTER_MODE_ID = BOTSIM GAIN_MODE_ID = LOW EDIT_MODE_ID = '1:1' /*FULL RESOLUTION FILTER_NAME = CH4_JS FILTER_NUMBER = 0 EXPOSURE_DURATION = 15.3600 NOTE = "MULTISPECTRAL LONGITUDE COVERAGE" /* DESCRIPTION OF THE OBJECTS CONTAINED IN FILE OBJECT = IMAGE_HISTOGRAM ITEMS = 256 ITEM_TYPE = VAX_INTEGER ITEM_BITS = 32 END_OBJECT OBJECT = ENCODING_HISTOGRAM ITEMS = 511 ITEM_TYPE = VAX_INTEGER ITEM_BITS = 32 END_OBJECT OBJECT = ENGINEERING_TABLE BYTES = 242 ^STRUCTURE = 'ENGTAB.LBL' END_OBJECT OBJECT = IMAGE ENCODING_TYPE = HUFFMAN_FIRST_DIFFERENCE LINES = 800 LINE_SAMPLES = 800 LINE_SUFFIX_BYTES = 36 SAMPLE_TYPE = UNSIGNED_INTEGER SAMPLE_BITS = 8 SAMPLE_BIT_MASK = 2#11111111# ^LINE_SUFFIX_STRUCTURE = 'LINESUFX.LBL' END_OBJECT END The meaning of the information in the text file is well beyond the scope of this doc, but if you have the source CD-ROM(s), there is a more than ample explanation of the meanings of these terms on the disks themselves. Possible Problems: ================== NOTE: We have tried to ensure that this loader will reject files that do not conform to this format, but we cannot guarantee that NASA JPL will not upgrade their storage format in a way that will break our loader. We encourage you to try this loader on other image collections that you know came from NASA, but if you choose to do so, please make sure that you are ready for potential problems. We would appreciate being notified if you find CD-ROM images from NASA that will not load with this loader. Messages: --------- If there are problems encountered by the NJPLRD module, messages will indicate what the problem is. These messages normally appear in the image processor control panels unless the problem is especially severe. ARexx: ------ If you do not have ARexx installed, this loader cannot function at all. The obvious solution is to get ARexx. ARexx comes standard with the 2.0 operating system; since the 1.3 operating system is now out of date, you should purchase an 2.0 Enhancer package for your Amiga. You'll get ARexx in that package. We no longer support, nor recommend the use of, the 1.3 operating system in any form.