NectarineDoc.tioga
Giordano Bruno Beretta, April 11, 1986 7:57:41 pm PST
gbb August 22, 1986 11:46:56 am PDT
Nectarine
CEDAR 6.1 — FOR INTERNAL XEROX USE ONLY
Nectarine
Fuzzless and sweeter than peaches
Giordano Bruno Beretta
© Copyright 1986 Xerox Corporation. All rights reserved.
Abstract: The ultimate layout and schematics printing and documentation system. Creates Interpress masters and prints them on Interpress printers; or alternatively produces PD files from these Interpress masters and prints them on Peach printers, directly or using a Peach expand server. The resulting image may also be pasted directly as a figure into a Tiogadocument. The Interpress masters can be further manipulated with Preview or with Gargoyle.
Created by: Giordano Bruno Beretta
Maintained by: Giordano Bruno Beretta <Beretta.pa>
Keywords: ChipNDale, ChipNSil, documentation, illustration, imaging, Interpress, no fuzz, Peach, printing
XEROX  Xerox Corporation
   Palo Alto Research Center
   3333 Coyote Hill Road
   Palo Alto, California 94304

For Internal Xerox Use Only
1. Brief Manual
The easiest way to print a ChipNDale image is to produce an Interpress master. To this purpose the control panel contains a line of Interpress buttons on the bottom (you may have to scroll it up). The framed button, labelled "Nectarine", causes an Interpress master to be created. The contents and end are controlled by three sets of buttons on the same line. They are labelled "What", "Where", and "Copies". For the first two you can scroll through the options by bugging the button, while the last one can be filled in by editing the value.
Those of the first set ("What") are labelled "Design", "Wysiwyg" and "Selection". If you bug "Design", Nectarine creates an Interpress master containing your full design. If you bug "Wysiwyg", Nectarine will put in the Interpress master only what you see in the viewer (what you see is what you get). Similarly, "Selection" will cause only the selected cells to be included in the Interpress master. Watch for the file name in the terminal viewer (it may be different from what you expect).
The buttons of the second set ("Where") are labelled after the printers currently supported (i.e. the Interpress and the Peach printers) and a Tioga document. Some printers have a fast mode for black and white drawings (e.g., schematics). Complext layout for the color Versatec should be sent to the Peach Expand server, from where they are automatically printed (see section 3 on how to do back-of-the-envelope calculations). See section 4 for the default names.
Figures in Tioga documents are scaled so that when printed they are fitted to be flush to the margin of the sibling text node.
The tools in "InterpressTools" and Gargoyle can be used to further process the master.
To print it on Stinger, enter in the Command Tool viewer
InterpressToPD <your file name> raven384
To send the drawing to Stinger, use the TSetter program.
2. Client Interface
Example of usage:
Nectarine.Print [Nectarine.DoInterpress [fooDesign, CDCommandOps.BoundingBox [fooDesign]], $CDVersatec]
3. Useful Hints
How long does it take? On the chip PermuyJun86Part3 — whose size is 3.390 10.217 mm and which contains 1'156'260 rectangles — it takes 2 hours, 12 minutes, and 2 seconds to produce the Interpress master. If the job is long, Nectarine after a while prints an estimated termination date and time. This estimation is repeated when half of the job is done. If you want an intermediate progress report, look at the number displayed just after the very first dot; this is the total number — 1 of groups of three dots that will be displayed.
The raster-scan conversion of the Interpress master takes a long time (49 minutes and 58 seconds for the above chip). The reason is, that for sake of generality the Imager cannot do any assumptions on the input. Hence, it will clip the entire Interpress master on every window consistiting of a band of 64 scan lines, and this for every band. Also it must assume arbitrary overlaps. In the future it might be possible to include hints into the Interpress master. Therefore, Nectarine eliminates all overlaps in rectangles (they are trivial anyway) and sorts the rectangles into bands. These bands are sorted by decreasing slow coordinate. Inside each band the rectangles are sorted lexicographically by slow and fast coordinate. Care has been taken to make the Interpress master as short as possible,
During the creation of an Interpress master and its subsequent raster-scan conversion, a fair amount of disk I/O occurs (which can be aggravated by paging when your machine is running some other big guy). It is annoying when you encounter a fatal disk error. The following is what you can do depending on the phase in which it happens.
— Writing the Interpress master: you lose; restart from the beginning.
— Doing the raster-scan conversion: you can reexecute it in the event viewer. Pop up in the stack until you get to NectarineImpl. It will be sitting at the call of PrintFileConvert.InterpressToPD. Simply copy the statement into the event viewer. You can also call manually InterpressToPD from a command tool (see InterpressToolsDoc for the details) and then send it to the server with Chat.
— Sending the file: Look up the name of the PD file in the terminal viewer and send it manually to the printer server.
You'll gonna need lotsa space gal. Before attempting to ship to the color Versatec a whole chip, you should do a little back of the envelope calculations. Both the Interpress master and the PD file are flat. The 1'156'260 rectangles of the above chip will yield an Interpress master of 35'125'206 bytes. Since there are 500 bytes in a page, the free disk figure you see in the Watch viewer will decrease by 70'250. The size of a PD file for the Versatec (which is 64'057'308 bytes for the above chip) can be estimated by the size of the bitmap: (40"200)2"(4"2) bits, which is 128'000 pages (in reality the PD file does not contain a bitmap, but runs, which in the case of dense plots can be very short , so that the PD file is long). Use the program PigsInSpace to find space on your disk.
Why does the transmission to the printer server take such a long time? An idea of how to asses the size of the PD file has been given above. The transmission rate is 256 KBits per second (which makes 1954" = 32', 34" for the above chip). On the Peach printer each packet is taken and the runs are expanded to a piece of bitmap which is written to disk. The total amount of time spent into expansion on for the above chip is a little more than a day. The actual printing is fast, because the bitmap just has to be shuffled from the disk to the printer.
In summary the approximate total time for a design with 1'156'260 rectangles is 2 hours for the Interpress master, 50 minutes for the PD file, 30 minutes for the transmission, and a little more than 24 hours for the expansion. The expansion will be much faster when the Dicentras will be replaced by Dragons. This will also eliminate the PD file creation and save disk space. In the meantime there is a hack which allows you to obtain a time factor of about 8 in the expansion (if I am not used also as a Summoner server). As the printer where to print select PeachExpand, and power on the machine in office 2110 (Bennington). For convenience, PeachExpand will always send the image to ColorVersatec for printing. Please delete the file from my disk after you have printed it. The size of the expanded PD file will be 322'520 bytes per cm, with a maximum size of 11"4.705883"800"1024 bytes = 42'405'650 bytes. The above chip was expanded into a file of 6'357'760 bytes, i.e., a tenth the original size, which prints in 8 minutes. (This is a temporary hack.)
Landscape or portrait format? Nectarine tries to scale to use the full paper width; paper waste is controlled by limiting the length of Versatec plots to 279.4"4.705883 mm H 1.315 m. If the above chip is printed in portrait format, the sizes of the PD files increase to 75'930'208 bytes unexpanded and 9'182'936 bytes expanded (the size of the Interpress master depends only upon the number of rectangles).
If you attempt to process an extraordinarily dense chip, it might happen that when you walk back to your machine, the screen is completely white with the exception of the cursor, which will not react to the mouse. The machine will even not let swat itself. Some resource in the microcoded allocator has come to short. The error has not yet been identified. Temporary fix: enter ← NectarineImpl.risk ← 0 and retry.
4. User Profile Options
Nectarine.Versatec: ROPE ← "Sleepy"
Nectarine.ColorVersatec: ROPE ← "Sleepy"
Nectarine.Bw400: ROPE ← "MtFuji"
Nectarine.Color400: ROPE ← "MtFuji"
Nectarine.Raven300: ROPE ← "Quoth"
Nectarine.PeachExpand: ROPE ← "Bennington"