User's Guide

LJ

Add, modify, delete, or list requests within the LightJet queue.

Function:

LJ allows a user to add, modify, delete, or list requests within the LightJet queue. The requests are later processed by the program LJMGR (executed by an operator) to generate a 40x50 or 50x50 inch print on the LightJet 5000, or to generate a film chip on the LightJet 2080. Custom requests are automatically deleted after 14 days of inactivity. Programs that update the last access date are LJ-MOD and LJMGR-CUSTOM.

The -MODIFY subcommand initiates a dynamic tutor session; therefore it cannot be executed in batch mode.

A LightJet request consists of a LAS or TIFF image and a number of optional parameters. If necessary, the images will be transfered across the network from where they reside to the host of the LightJet. LJ has the following features:


   Transfers and prints LAS or TIFF image data 
   Allows specification of a spatial window
   Allows a band specification (1 or 3 bands only)
   Prints an annotation block which includes the date, time, media
      type, spot size, LUT files, image size, and usercode.
   Prints corner TIC marks.
   Option to print image name.
   Option to print a color/linear gray scale.
   Option to specify media type 
   Option to expand the image
   Option to subsample the image
   Option to print multiple copies
   Option to select different enhancement LUTs
   Option to reverse the background value (0 or 255)
   Option to annotate a 100 character title
   Option to annotate a 120 character free formatted text
   Option to print the SPOT copyright symbol.
   Option to print enhancement LUT values for each band.
   Option to print the Dorran Order/Unit/Bin values.

Parameters:

Subcommand -ADD:
Adds a request to the custom request file. The program places the parameters and options for each request into the custom request file. Compatibility between the parameters is checked before the request is added to the file. The program outputs the record number which identifies the request within the file. The record number is required to modify or delete a request within the custom request file.

IN
Input image. The input image may be windowed and/or sub-banded. The image must contain 1 or 3 bands. If the image consists of 3 bands, the band sequence must be specified in the order of RED, GREEN, BLUE.

The format of IN is dependent on the file type defined by parameter FTYPE. If FTYPE is set to:

   LAS:
       - LAS image specified as a TAE name
       - Image may be windowed and/or sub-banded
       - Image must contain 1 or 3 bands
       - If image is 3 bands, the band sequence
         must be specified as RED, GREEN, BLUE.

   TIF:
       - File specified using host file name
       - TIFF file must be Planar
       - Complete image is processed (ie. user
         cannot specify window or sub-band)
       - Image must contain 1 or 3 bands
       - If image is 3 bands, the band sequence
         must be specified as RED, GREEN, BLUE.

PRINTER
Output printer.

  =LJ2080: LightJet 2080 produces a film chip.
  =LJ5000: LightJet 5000 produces a paper print.

MEDIA(--)
Currently, the AGFA media is being used on the LightJet 5000 with 40x50" and 50x50" stock. The 50x50" stock is not a standard product; therefore; it may be unavailable at times.

Ektachrome 200 (Ekta) is now the standard film type on the LightJet 2080. Ekta a pictorial color reversal film, designed to make positives. As a result of their different intended uses, Ekta positives have much brighter colors than Aero positives. Ekta's black is also much deeper. Although Ekta has much better colors than Aero, it is not quite as sharp. Minute image details are a little less distinct on Ekta than they are on Aero. This reduction of sharpness is only apparent under magnification.

The default value for parameter MEDIA is to select the best fit available media for the specified printer.


                          MEDIA TYPES
  -------------------------------------------------------------
  Film Type  |  Color or B/W  |  Color Saturation  |  Sharpness
  -------------------------------------------------------------
     AGFA    |     color      |       low          |  medium
     Ekta    |     color      |       high         |  low

FTYPE(LAS)
File Type

  =LAS: LAS Image
  =TIF: TIFF Image

MODE(--)
Processing mode. Valid entries are 1 through 4. Each mode is a particular combination of effective spot size and maximum image size.

The default value for parameter MODE indicates that the largest spot size in which the image will fit should be used. If the mode is specified in which the image is too large and parameter REDUCE is set to NULL, the image is subsampled to fit onto one frame of media (if REDUCE=1, then the image is paneled onto multiple frames). The processing mode is defined by the following table.

NOTE: The maximum lines and samples assumes only the mandatory annotation (the default), the MARGIN parameter is set to zero, and EXPAND is set to one.


LightJet 5000:
MODE|  Effective   |          | 40x50" Max Size | 50x50" Max Size
    |  Spot Size   | Pixel/mm | Lines X Samples | Lines X Samples
----|--------------|----------|-----------------|------------------
 1  | 62.5 microns |  16      | 16,032 X 20,320 | 20,064 X 20,320
 2  | 83.3 microns |  12      | 12,028 X 15,240 | 15,048 X 15,240


LightJet 2080:
MODE|  Effective   |          | 9.2x9.2" Max Size | 10.2x13" Max Size
    |  Spot Size   | Pixel/mm | Lines X Samples   | Lines X Samples
----|--------------|----------|-------------------|------------------
 3  | 12.5 microns |  80      | 18,720 X 18,720   | 20,720 X 26,400
 4  | 25.0 microns |  40      |  9,360 X  9,360   | 10,360 X 13,200
The following annotation fields are optional. If any of these annotation fields are specified, the max number of lines for image data is reduced as indicated in the following table:


Annot Lines     LJ Parameter    Annot Description
-----------     ------------    -----------------
    3           TITLE           Title Annotation (First Line)
    2           TITLE           Title Annotation (Second Line)
    1           STRETCH         Enhancement stretch points
    1           IMGOPT/WEDGE    Image name annotation and/or Color wedge
    1           ANNOT/DORRAN    Annot text and/or Dorran values


LightJet 5000:
____________________________________________________________________________
           |                    AGFA 40x50" Stock                          |
           |                    Maximum Image Size                         |
           |                     Lines X Samples                           |
-----------|---------------------------------------------------------------|
MODE| Spot | 0 Line| 1 Line| 2 Line| 3 Line| 4 Line| 5 Line| 6 Line| 7 Line|
    | Size | Annot | Annot | Annot | Annot | Annot | Annot | Annot | Annot |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|
 1  | 62.5 |16032 X|15952 X|15872 X|15792 X|15712 X|15632 X|15552 X|15472 X|
    |      |20320  |20320  |20320  |20320  |20320  |20320  |20320  |20320  |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|
 2  | 83.3 |12028 X|11970 X|11912 X|11854 X|11796 X|11738 X|11680  |11622  |
    |      |15240  |15240  |15240  |15240  |15240  |15240  |15240  |15240  |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|



____________________________________________________________________________
           |                    AGFA 50x50" Stock                          |
           |                    Maximum Image Size                         |
           |                     Lines X Samples                           |
-----------|---------------------------------------------------------------|
MODE| Spot | 0 Line| 1 Line| 2 Line| 3 Line| 4 Line| 5 Line| 6 Line| 7 Line|
    | Size | Annot | Annot | Annot | Annot | Annot | Annot | Annot | Annot |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|
 1  | 62.5 |20064 X|19968 X|19872 X|19776 X|19680 X|19584 X|19488 X|19392 X|
    |      |20320  |20320  |20320  |20320  |20320  |20320  |20320  |20320  |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|
 2  | 83.3 |15048 X|14976 X|14904 X|14832 X|14760 X|14688 X|14616  |14544  |
    |      |15240  |15240  |15240  |15240  |15240  |15240  |15240  |15240  |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|


LightJet 2080:
____________________________________________________________________________
           |                    EKTA 10x13 Film                            |
           |                    Maximum Image Size                         |
           |                     Lines X Samples                           |
-----------|---------------------------------------------------------------|
MODE| Spot | 0 Line| 1 Line| 2 Line| 3 Line| 4 Line| 5 Line| 6 Line| 7 Line|
    | Size | Annot | Annot | Annot | Annot | Annot | Annot | Annot | Annot |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|
 3  | 12.5 |20720 X|20528 X|20336 X|20144 X|19952 X|19760 X|19568 X|19376 X|
    |      |26400  |26400  |26400  |26400  |26400  |26400  |26400  |26400  |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|
 4  | 25.0 |10360 X|10264 X|10168 X|10072 X| 9976 X| 9880 X| 9784  | 9688  |
    |      |13200  |13200  |13200  |13200  |13200  |13200  |13200  |13200  |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|


____________________________________________________________________________
           |                    EKTA 9.2x9.2 Film                            |
           |                    Maximum Image Size                         |
           |                     Lines X Samples                           |
-----------|---------------------------------------------------------------|
MODE| Spot | 0 Line| 1 Line| 2 Line| 3 Line| 4 Line| 5 Line| 6 Line| 7 Line|
    | Size | Annot | Annot | Annot | Annot | Annot | Annot | Annot | Annot |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|
 3  | 12.5 |18720 X|18528 X|18336 X|18144 X|17952 X|17760 X|17568 X|17376 X|
    |      |18720  |18720  |18720  |18720  |18720  |18720  |18720  |18720  |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|
 4  | 25.0 | 9360 X| 9264 X| 9168 X| 9072 X| 8976 X| 8880 X| 8784  | 8688  |
    |      | 9360  | 9360  | 9360  | 9360  | 9360  | 9360  | 9360  | 9360  |
----|------|-------|-------|-------|-------|-------|-------|-------|-------|

EXPAND(--)
Option to expand the image by interpolating pixels using the hardware command within the LightJet 5000 or LightJet 2080. Scaling can be performed in the line and sample directions independently. The default value specifies not to expand the image. If EXPAND=(1 1), the image will not be resized and it will be printed at full resolution (may require multiple panels). If EXPAND is set such that the image does not fit on one print, then it will be printed in panels.

REDUCE(--)
Option to reduce the image by deleting pixels. The image must be reduced by the same factor in the x and y direction. If REDUCE and EXPAND parameters are defaulted, the image will be reduced so that it fits on one print. If REDUCE=(1 1), the image will not be resized and it will be printed at full resolution (may require multiple panels).

MAPSCALE(--)
Based on the image pixel size specified in meters, set image expansion to obtain desired map scale. The map scale is entered as 1:x where x is the value of MAPSCALE. For example, MAPSCALE=500000 results in an output image at a scale of 1:500000.

The LightJet is unable to perform image reduction; therefore, a fatal error is generated if the expansion is less than one.


The following formula is used to compute the map scale.

            Ground pixel size
   EXPAND = -----------------  * MAPSCALE
            Media pixel size

For example, if the ground pixel size is 75m, using the 
62.5um spot size, and a desired scale of 1:500,000, the 
following formula computes the value for expand:
   EXPAND = 75,000,000 / 62.5 * 1 / 500,000 = 2.4

Note that, for the metric conversion to feet using this coordinate system, 1 meter equals exactly 39.37 inches, not current standard accepted by the National Bureau of Standards in 1959, in which 1 inch equals exactly 2.54 centimeters. Surveyors continue to follow the former conversion for consistency. The difference is only two parts in a million, but it is enough to cause confusion, if it is not accounted for." --Map Projections Used by the U.S. Geological Survey (Snyder, 1982)

PIXSIZE(--)
Image pixel size specified in meters. If MAPSCALE is set, then the pixel size is required. If the input image has a LAS DDR with valid projection units specified as meters and parameter PIXSIZE is NULL, then the DDR values are used to compute the map scale.

PRNTSIZE(--)
Auto set image expansion to obtain desired print size specified in inches. PRNTSIZE is a two value parameter specified has (Height,Width). The LightJet is unable to perform image reduction; therefore, a fatal error is generated if the expansion is less than one. The aspect ratio in the line and sample direction is always maintained (the minimum expansion factor is selected, and the image will be centered).

The margin settings, top and bottom annotation, and the image are included within the print size specification. In general, if the user does not want to include the bottom annotation within the print area, the user should add .75" to the image height.

WARNING: It is easy to set PRNTSIZE to an invalid size in that the full media width/length may not be available. For example:


        MEDIA TYPE     ACTUAL HEIGHT     ACTUAL WIDTH
        ---------------------------------------------
        PAPER40x50     39.84"            49.96"
        PAPER50x50     49.84"            49.96"
        FILM9x9         9.21"             9.21"
        FILM10x13      10.19"            12.91"

NCOPIES(1)
Number of copies. Multiple copies of the image may be produced.

BACKGRND(0)
Background value. The background value within the image area but surrounding the actual image can be set to either 0 (black) or 255 (white).

  = 0:    Black Background
  = 255:  White Background

MARGIN(--)
Image margin. The user can specify a margin around the image. The first value defines a margin on top and bottom of the image, and the second value defines a margin on left and right of the image. The margin is specified in inches. The default is .5".

Note that if a margin is specified, the max number of lines/samples for the image is reduced. The number of lines/samples required for the MARGIN parameter can be computed:


     Mode   Spot    Lins/mm     Formula
     ----------------------------------
     1      62.5    16          MARGIN * 2 * 25.4 * 16
     2      83.3    12          MARGIN * 2 * 25.4 * 12
     3      12.5    80          MARGIN * 2 * 25.4 * 80
     4      25.0    40          MARGIN * 2 * 25.4 * 40

TITLE(--)
Title of print. A two line 100 character title can be printed at the top of the image. If a title is specified, it is buffered from the start of the image as a single line of annotation. The title is annotated using a 2x font; therefore, a single title line requires three font lines, a dual title line requires five font lines. The default is not to print a title.

Note that if a title is specified, the max number of lines for the image is reduced. Please refer to the help text on parameter MODE.

ANNOT(--)
Annotation text. The annotation string can be up to 120 characters of text printed at the bottom of the image.

Note that if the annotation text is specified, the max number of lines for the image is reduced. Please refer to the help text on parameter MODE.

WEDGE(NO)
Color wedge. The color bar can optionally be printed along the bottom of the image.

  = YES:  Print the color bar
  = NO:   Do not print the color bar

Note that if the wedge is specified, the max number of lines for the image is reduced. Please refer to the help text on parameter MODE.

SPOTCOPY(NO)
Spot Copyright. The copyright symbol for SPOT data will be included at the bottom of the image.

  = YES:  Print the SPOT copyright symbol
  = NO:   Do not print the SPOT copyright symbol

Note that if the spot copyright annotation is specified, the max number of lines for the image is reduced. Please refer to the help text on parameter MODE.

STRETCH(NO)
Stretch annotation is constructed by the enhancement points specified by parameter INFILE. If the annotation is too long, it will be truncated.

  = YES:  Print stretch annotation
  = NO:   No stretch annotation

Note that if the stretch annotation is specified, the max number of lines for the image is reduced. Please refer to the help text on parameter MODE.

CALFILE(--)
Calibration file number. The calibration file that is to be used. This parameter is reserved for testing and should be defaulted by users. Valid entries are 0 through 99. Each MODE/MEDIA combination has a specific default calibration file associated with it. The default value assigns the correct calibration for most requests.

A calibration file maps gray level to media density. The calibration file is a representation of the actual response of the LightJet. It describes what the actual media density is when a particular gray level is exposed on the recorder.

CONFILE(--)
Control files map image brightness to media density, giving aim RGB densities for input brightness values. Control files are media-specific.


                              CONTROL FILES
  --------------------------------------------------------------------------
  Film|File |Gen 1| 1st Generation  |           Application           |Gen 1
  Type| #   | pos | Curve Shape     |                                 |Color
  --------------------------------------------------------------------------
* AGFA| 54  | pos |linear           |general                          |color

* Default value for specified media.

EDC generally stretches digital images to increase their contrast. We usually customize the stretch to fit the image. For pre-stretched images, linear control files work well. A linear control file linearly maps input bv to output density. Customized stretches result in images that do not correlate well from swath to swath or year to year. Some customers require temporal and scene-to-scene consistency in LightJet products. For these customers, EDC implements logarithmic control files and no custom stretching. These two approaches (custom stretches with a linear control file and no stretch with a logarithmic control file) often have roughly similar results for the same scene.

INFILE(--)
Input enhancement file name. INFILE may be either an ASCII text file created by program CF, or QLP, or a display and look-up table file (DLTF) created by DMS program SAVDLTF. If no value is specified, the user is required to interactively enter the enhancement stretch point values (refer to user notes for edit options).

If it is an ASCII file created by CF, LJ, or QLP, the file specification should not include the extension.

If it is a DLTF file, the look-up table that is needed to map the input image is read from this file. The parameter INDLTF must contain the key field of this DLTF entry.

An enhancement look-up table (LUT) maps gray levels to gray levels to create a contrast enhancement of the image data.

INDLTF(--)
Input display and look up-table file entry. The DLTF entry from a previously created look-up table stored on disk in DLTF format. The number of look-up tables in the INDLTF entry must be greater than or equal to three. The look-up tables are assumed to be in the order of red, green, blue. The maximum length for INDLTF is 12 characters.

PRIORITY(9)
Priorities range from 1-9, with one being the highest and nine being the lowest priority. This will allow flexibility in dealing with customer requests.

There must, however, be a set of guidelines that are to be adhered to when entering orders. If not the system will get bogged down and orders will not get produced as required. The intent is not to be restrictive but to have flexibility. One should consider various factors to be in place when establishing priority orders. First, we must assume that the hardware and software systems are all functional or the turnaround times may not be met. Secondly, requests within the same priority level are usually processed on a first-in/first-out basis with the producing lab having the latitude to make changes if it will aid in improving their turnaround times as a whole. In addition, there will not be any overtime automatically given to orders of priority levels 4-9. Overtime may be granted for priority orders if necessary to meet the turnaround time required. The producing labs may request and be granted overtime to work off their backlog if necessary.

In addition to the above stated priorities there are an entire set of exceptions that need to be dealt with for internal EDC customers/users. This issue primarily deals with the producing products from such devices as the colorfire, quicklook printers, and various plotters. It is readily apparent that there needs to be new definitions of what priorities mean here. The big differences here are the fact that users themselves can create these products directly as opposed to submitting orders through DORRAN and the turnaround times are considerably different here as well. Keep in mind that you are competing with other users for the same resources so please do not abuse the priorities. If this becomes a problem your Department Manager will be notified and appropriate action taken. The following priorities should be adhered to when creating such products.

Priority Order 1

   Highest priority.  Requires a Manager's approval.

   Product orders will occur immediately and take priority over
   orders of priority level 2-9.  Turnaround time will be as
   soon as possible.  Support personnel will be called upon 
   immediately, by the producing lab having problems, to fix 
   any hardware/software problems should any arise. 

   If overtime is required the required the responsible Manager may 
   give authorization for it.

   The user will personally notify managers in all effected 
   production labs as soon as possible of the pending order.

Priority Order 2

   High priority order.  The products will be processed ahead of 
   priority levels 3-9.  All products will be produced ASAP during 
   shifts that are routinely staffed.

   Priority 2 requires a responsible Managers' approval and 
   authorization for overtime if necessary.  

Priority Order 3

   Priority order.  The products will be processed ahead of priority 
   levels 4-9.  All products will be produced ASAP during shifts 
   that are routinely staffed.

   Priority 3 requires a responsible Managers' approval and 
   authorization for overtime if necessary.  

Rush Orders 4-6

   Rush Orders.  The products will be processed on a 
   first-in/first-out (FIFO) ahead of priority level 7-9 orders.

   Rush orders are intended to be used for products or intermediate 
   products that require quick turnaround to complete the order by
   the due date.
        
   All orders will be produced during shifts that are normally 
   staffed with the turnaround time normally being within 24 
   hours  (No overtime will be utilized).

   Three levels are used in order for a user working on multiple 
   projects to prioritize them.

Standard Orders 7-9

   Standard Orders.  The products will be processed on a 
   first-in/first-out (FIFO) basis.

   These orders are intended to be used for products or 
   intermediate products that do not require quick turnaround.

   All orders will be produced during shifts that are normally 
   staffed with no guarantee on the turnaround time (No overtime 
   will be utilized).

   Normally the products will be generated within five working 
   days unless unforeseen problems occur such as equipment being 
   down.

   Three levels are used in order for a user working on multiple 
   projects to prioritize them.

DELFLG(NO)
Delete flag.

  = YES: Delete user's image file after network transfer.
  = NO:  Do not delete image file.

SPECIAL(--)
Special instructions. Instructions indicating the course of action if something unusual happens to the request.


1.  If a user modifies a request, the user is required to 
    assign a value to SPECIAL to inform customer services as 
    to why the request is being reworked.

DORRAN(--)
DORRAN Parameters. Three value parameter to allow the user to specify the Order, Unit, and Bin. If specified, the values are annotated onto film above the gray scale.

SPANEL(1)
Starting panel number. Normally the user will want to print all panels; however, if the request failed after successfully printing several panels, the user may want to skip the panels that have already printed.
Subcommand -MODIFY:
Modifies a request that is already located within the custom request file. The initial parameter set consists of the record number, which identifies the request within the custom request file that is to be modified. A dynamic tutor session is initiated to modify the parameter values of the request. The default value for each parameter of the dynamic tutor is the value currently assigned to the request that is to be modified. Compatibility between the parameters are checked before the updated request is written into the custom request file. The parameter descriptions of the -MODIFY dynamic tutor are the same as the -ADD subcommand.

RECNUM
Record number of the custom request file to process.
Subcommand -DELETE:
Deletes requests within the custom request file. When the delete subcommand is run, it removes the requests identified by the record numbers from the custom request file.

RECNUM
Record number of the custom request file to process.
Subcommand -LS:
List requests within the custom request file.

MEDIA(PAPER40X50 PAPER50X50 FILM10X13 FILM9X9)
Currently, the AGFA media is being used on the LightJet 5000 with 40x50" and 50x50" stock. The 50x50" stock is not a standard product; therefore; it may be unavailable at times.

Ektachrome 200 (Ekta) is now the standard film type on the LightJet 2080. Ekta a pictorial color reversal film, designed to make positives. As a result of their different intended uses, Ekta positives have much brighter colors than Aero positives. Ekta's black is also much deeper. Although Ekta has much better colors than Aero, it is not quite as sharp. Minute image details are a little less distinct on Ekta than they are on Aero. This reduction of sharpness is only apparent under magnification.

The default value for parameter MEDIA is to select the best fit available media for the specified printer.


                          MEDIA TYPES
  -------------------------------------------------------------
  Film Type  |  Color or B/W  |  Color Saturation  |  Sharpness
  -------------------------------------------------------------
     AGFA    |     color      |       low          |  medium
     Ekta    |     color      |       high         |  low

RECNUM(--)
Record number of the custom request file to process.

STFLAG(QUEUE NET RUN SUCC ERROR HOLD)
Queue status flag. The default is to list all entries in the queue. This parameter may be set to subset the queue entries by the status flag in some combination of the following:

   QUEUE -- list entries currently queued
   NET   -- list entries currently being
            trasfered across the network
   RUN   -- list entries currently running
   SUCC  -- list entries that have been
            printed successfully
   ERROR -- list entries that have been
	    processed but encountered an
            error

MEDIA(PAPER40X50 PAPER50X50 FILM10X13 FILM9X9)
Film type. The default is to list all entries in the queue. This parameter may be set to subset the queue entries by the film type in some combination of the following:

 = PAPER40x50  40x50" Paper
 = PAPER50x50  50x50" Paper
 = FILM10x13   10x13" Film
 = FILM9x9     9.2x9.2" Film

OUTFORM(SHORT)
Output format. The short format prints all requests (including requests not owned by the user) in a one line format. The long format prints only request owned by the user in long format (all fields of the request).

In the short format, the "Total Panels" field is the total number of frames left to be processed. Typically, once the request has been successfully processed, this field will show a value of 0.


  = SHORT: short form
  = LONG:  long form

PRINT("TERM")
Output destination. The destination of the output.


  = TERM:  Output goes to the user's terminal
  = FILE:  Output is stored in a text file
  = LP:    Output goes to the line printer

Examples:

    1. LAS> LJ-ADD IN=[gacke.las]us PRINTER=LJ5000 TITLE="United States"

    This example adds a request to the LightJet 5000 queue. It requests the image [gacke.las]us be printed with a title of "United States".

    2. LAS> LJ-LS

    This example lists all entries in the queue in short format. The report consists of the record number, priority, user name, system name, status flag, media type, number of total panels, and the submit date.

    3. LAS> LJ-LS OUTFORM=LONG

    This example lists all entries in the queue that the user owns. The long listing lists all fields in the request.

    4. LAS> LJ-LS STFLAG=(RUN QUEUE)

    This example lists all entries in short format that have a status flag of RUN or QUEUE.

    5. LAS> LJ-MOD 1

    This example will modify queue reqest number 1 (assuming it is owed by the user). A dynamic tutor session is initiated in which the default values are the fields within the request.

Description/Algorithm:

Each record of the custom request file consists of the record number, process flag, and the input parameters. The record number identifies the request to be modified or deleted from the file. When the LightJet is in custom mode and processing the CRF, there are several flags that are checked prior to processing a request. These flags are:


    PRINTER: LightJet 5000 or LightJet 2080
    MEDIA:   The operator specifies the type of media currently
             loaded in the LightJet.
    STATUS:  The status flag must be set to QUEUE.  The status
	     flag is automatically set to QUEUE by LJ-ADD or
	     LJ-MODIFY.

There are three additional record fields within the file that are transparent to the user. These fields are: the delete flag, the number of runs, a backward pointer, and a forward pointer. The delete flag indicates if the request has been deleted from the file. The number of runs is a field which keeps track of how many times the request has been processed by the LightJet and will be output on the assessment sheet. A singly linked list contains the records that do not have valid requests, i.e., the requests have been deleted. The forward and backward pointers are used to form a doubly linked list among the requests containing the same priority.

The request file is organized so that a request with a sequence number of "i" is stored in the ith record within the file.

Algorithm of the -ADD subcommand:

The records that contain deleted requests are stored in a singly linked list. If this list is not empty, the head record is removed from the list and the new request is written into this record. If the list is empty, a new record is appended to the end of the file and the new request is written into this record.

Before the request is written into the file, the doubly linked list must be updated. A doubly linked list exists for each priority (there are nine priorities). The user assigns the priority to the request. The request is then added to the end of its priority list. When the file is processed by the Color FIRE, the requests with high priority are processed first. Note that the requests within the same priority are processed as First In/First Out.

Algorithm of the -MODIFY subcommand:

The request to be modified is identified by the parameter RECNUM. The record containing this request is read, and a dynamic parameter block is built. The default values of the dynamic parameters are set to the existing values of the request being modified. The user will modify the parameters to their desired values and type RUN to continue processing. The new parameters are read to form the updated request. The updated request is written back into the same record of the custom request file. If the priority of the request is modified, the request must be deleted from its old priority list and added to the new priority list. Note that if the user is in the dynamic tutor session and types EXIT rather than RUN, the custom request file is unchanged.

Algorithm of the -DELETE subcommand:

Each request to be deleted is identified by the parameter RECNUM. For each request to be deleted, the following steps are taken. The priority of the request is determined by reading the record. The request is then removed from its priority list. The record is added to the singly linked list containing all records that no longer contain valid requests.

Note that the requests are deleted but that the record containing the request is not deleted from the file. This allows easier manipulation of the file and also solves the problem of ever-increasing record numbers because record numbers can be reused after the record is deleted.

Error Messages:

  1. Sequence number x does not exist

    User tried to modify or delete a request from the queue that does not exist. User should run LJ-LS to verify the correct sequence number.

  2. ERROR: User x is not owner of custom request xx

    User tried to access a request within the queue in which they are not the owner. User should run LJ-LS to verify the correct sequence number.

  3. File is on remote system x, unable to verify file

    This error message indicates the request was originally added from one host, and then the user tried to modify the request from another host. As long as the image name is not modified, the request can be updated but the image is not verified.

  4. ERROR: File x is on x. Cannot modify from remote system

    This error message indicates originally added from one host, and then user tried to modify the image name from another host. The user is required to log in on the original host and modify the request.

  5. Window sizes of input images must be the same

    If paramter IN specifies multiple images, each image must represent the same window size (same number of lines and samples).

  6. ERROR: Request x is currently being processed

    User tried to modify or delete a request while it is in the RUN or NET state. Once a request is being processed, it cannot be modified or deleted until the processing is completed.

  7. Invalid media and/or print size specification for printer XXX

    LJ is unable to set the media type and/or size for the selected printer. Either parameter MEDIA is set to an invalid media type of the printer, or parameter PRNTSIZE is set to an invalid media type. It is easy to set PRNTSIZE to an invalid size in that the full media width/length may not be available. For example:

    MEDIA TYPE ACTUAL HEIGHT ACTUAL WIDTH --------------------------------------------- PAPER40x50 39.84" 49.96" PAPER50x50 49.84" 49.96" FILM9x9 9.21" 9.21" FILM10x13 10.19" 12.91"

  8. Error setting ENH lut values from file x

    Error encountered setting the enhancement LUT from the file specified in parameter INFILE. The request is not added to the queue.

  9. LUT File x does not exist

    The specified LUT file specified by parameter INFILE does not exist.

  10. Unable to open LUT File x

    The specified LUT file specified by parameter INFILE exists, but program cannot open it. User should check at the file permission.

  11. ERROR -- LUT File x is corrupt

    The specified LUT file specified by parameter INFILE cannot be read. The user may be able to edit the LUT file(s) to be in the correct format.

  12. LUT File is limited to 255 map points

    The specified LUT file specified by parameter INFILE consists of too many map points. The user is required to delete some of the map points.

  13. ERROR: Enhance file input values are not ascending

    The software requires the input brightness values to be in ascending order.

  14. ERROR: enhance file has two equal input brightness values

    The software requires that no two input brightness values to have an equal value.

  15. ERROR: enhance file is required to have 255 as an input map point

    The software requires that the enhancement LUT to end with an input brightness value of 255.

  16. Request consists of x enh map pts, max is 255

    An enhancement stretch can have a maximum of 255 points specified. User is required to modify the enhancement map points prior to printing the image.

  17. Error converting DLTF TAE name to host name

    The value specified in parameter INFILE does not translate into a valid host file name for a DLTF file. INFILE should be specified in TAE syntax.

  18. Error accessing DLTF file x

    The DLTF file specified in parameter INFILE cannot be accessed.

  19. Error setting ENH lut values from file x entry x

    Error setting the enhancement LUT from the DLTF specified by parameters INFILE and INDLTF. The request is not added to the queue.

  20. rddltf: DLTF consists of less than x bands

    The DLTF entry is required to define a LUT for each of the bands specified in parameter IN.

  21. rddltf: Error allocating lut data buffer

    Error allocating data buffer to read the DLTF LUT entry.

User Notes:

  1. Windowing and subbanding are supported by specifying it within the input image specification. It is the same syntax as all standard LAS programs.

  2. Single-band images are actually written three times, once each for red, green, and blue. Identical red, green, and blue stretches result in a black/white image. This is true for both color and black/white media. Dissimilar red, green, and blue stretches result in a colored image on color media. Dissimilar three-color stretches would result in a black/white image that has incorrect densities.

  3. If INFILE is set to NULL, the user dynamically edits the LUT files. The user has the option of editing the whole file, inserting a map point, or modifying a map point.

    To edit a map point, the user is prompted for the input brightness value. The user inputs a decimal value and then presses the return key. The program then prompts the user to input the output value, which is entered similarly. If no value is entered for the input or output value (i.e., pressing the return key with no decimal value), the map point for that color is unchanged. There are special commands associated with the input brightness value. If the input brightness value is assigned:

    -2 --then the map point for that color is deleted -1 --then the edit routine is exited

    To edit the entire file, the program asks the user to input all map points for the LUT file starting at point 0 and continuing through point 31. The user can exit the editing routine at any time by inputting a -1 for the input brightness value.

    To edit a specific map point, the program queries the user for which point to modify. The user is then prompted to enter the input and output values for that map point. The edit routine continues to query the user for the next map point. The edit routine is exited when the user inputs a for the map point.

  4. The enhancement, calibration, and control look-up tables are stored in separate files for the purpose of easy maintenance. However, when a user selects the tables to be used with an image, the tables are mathematically combined into one final table. This final table is loaded out to the LightJet and used in the generation of the frame. The resulting effect is analogous to applying the enhancement table to the raw image data and then taking the enhanced image and forcing it to its appropriate film density.

  5. Color bar. The user has the option to include a special annotation field that consists of a color bar. If WEDGE is set to YES, the color bar is annotated onto the media. The color bar is a 30-step gray scale that is right justified below the image.

    The red, green, and blue values for each step are defined as follows:

    
        STEP     RED    GREEN   BLUE
        ____     ___    _____   ____
    
           1     118     255     255
           2     255     118     255
           3     255     255     118
           4     255     118     118
           5     118     255     118
           6     118     118     255
           7       1     255     255
           8     255       1     255
           9     255     255       1
          10     255       1       1
          11       1     255       1
          12       1       1     255
          13     168     120      80
          14     195     180     144
          15     255     255     255
          16     239     239     239
          17     221     221     221
          18     205     205     205
          19     187     187     187
          20     171     171     171
          21     153     153     153
          22     137     137     137
          23     118     118     118
          24     102     102     102
          25      84      84      84
          26      68      68      68
          27      50      50      50
          28      34      34      34
          29      16      16      16
          30       1       1       1