Help available for following commands:
display logar light doc landg landd pause
Type:
@help <command>
A program to make files from which the Laser printer can produce pictures. The pictures will be bi-level, but by using dot-clumping and dither matrices there are notionally 256 different grey-levels. The input picture to be depicted is in the form of a standard picture file, as used by Vision:display. By using the '-m' option the grey scale of the picture can be adjusted using a map-file that is compatible with those made by Vision:retouch. The Description file allows the user to print multiple pictures on the same piece of paper. The user can position them using as units pixels,inches or cms. If inches or cms are used then you specify the the size of a bounding box inwhich the picture (appropriately scaled) will be drawn.
COMMAND LINE
dot1 {-flag[value]} description_file {output_file}
Output_file
If an output file is not specified one will be created with a "unique" file name of the form "FxxPyy" where xx and yy are two digit numbers. This is useful when sending output directly to the laser printer via the '-l' option.
Command Line Flags
-l This prefixes the output file name with "Lp1:" so that it
will be sent directly to the laser printer queue directory
and printed (in time).
-r This inverts the grey levels in the output picture so that
it can be viewed on the Level 1 Graphics program called
"Doc:lg1". Note files thus produced will appear as
"negatives" if printed on the laser printer.
-c Any specifitions of length will be taken as being in cms.
-i Any specifitions of length will be taken as being in inches.
Format of Description files
{ {-flag[value]} input_image_file newline }
Description File Line Flags
-x<picture size> input picture size is the number of pixels along the square
image. (not needed if a header exists).
-m<map file> map file is the name of the file to be used to adjust the
grey levels (as produced by Vision:retouch). The default
map file is Map.dat. If '-m' is not used a linear grey
scale will be used.
-c<x><y> the top left hand corner of the square that delimits the
box inwhich the picture will be drawn can be specified
by the values of x and y. They are the respective
horizontal and vertical distances from the top left hand
corner of the paper. If the units are not specified on the
command line they are assumed to be in pixels.
-s<scaling factor> If the distances are NOT being specified in inches or cms,the
scaling factor is the integer multiple by which the output
picture size will be scaled when drawn on paper.
Default scaling factor is 1.
If the distances ARE being specified in inches or cms,
the scaling factor is the length of the side of the
bounding box in which the picture will be drawn, in the
specified units. The program will automatically scale
up the picture to fit into the box (but it won't scale it
down).
-o If the distances ARE being specified in inches or cms,
this option will cause the picture to be centred in its
bounding box, rather than drawn in the top left hand
corner of it.
Sending Files to Laser Printer Manually and Multiple Copies.
If you want to make many copies of one picture don't use the '-l' option, but transfer the file outputted to your local directory to the Lp1: directory the required number of times using the operating system command:
}t outputfile/lp1:file
where file is a unique file name for each copy, not containing a '.' character.
Using DOC:LG1 to preview output files
If the '-i' option has been used the output file is ready to be viewed on the level 1 graphics screen. To do this issue the operating system command:
}doc:lg1
followed by a carriage-return and the character '1', then enter the name of the output file. For big pictures only the top left corner will be visible. If you are satisfied with the picture on the screen and want a hardcopy you should run VISION:DOT again without the '-i' option and send it to the laser printer.
to run, type:
landd [-x<file size> -n<new image> -d( no dither )
<intensity file> <info file>]
e.g.
landd -x256 -n v_pic:ill.256 info1
displays image with info in info1
e.g.
landd log2
replaces histograms etc with info from log2
to run, type:
landg [-x<file size> -l<scale factor> -d( no dither )
<intensity file> <lightness file>]
or just landg and use the menu
Use is the same as land, except to output info to file :
select 'menu' then 'both' and enter name of info file
e.g.
landg -x256 v_pic:ill.256 v_pic:ill.lig
e.g.
pause 10
The input picture to be depicted is either in the form of a standard picture file, or (with the -x<nnn> option) may be headerless. By using the '-m' option the grey scale of the picture can be adjusted using a map-file as produced by the retouch program.
RUNNING INSTRUCTIONS
display {-flags[value]} {input_files}
Flags
-x<picture size> input picture size is the number of pixels along the square
image.
-s Sole picture, centrally positioned.
-m<map file> map file is the name of the file to be used to adjust the
grey levels (as produced by Vision:retouch). The default
map file is Map.dat. If '-m' is not used a linear grey
scale will be used.
-l<scale> enLarge images by a factor scale (2 .. 8).
-f<F> First image to be displayed in Fth position, (0 ... ),
without preliminary erasure of the screen.
-d Dither supressed. Default is to use dither, augmenting
the hardware, to display 8 bits of grey.
-a Anaglyph: treats input list as a sequence of (left,right)
stereo pairs. View through red-green goggles.
-z Hardware is level 1 graphics.
-c<C> Colour C (only with -z).
-o<C> Overlay colour C (only with -z).
Multiple input files are displayed in left to right, top to bottom order. This only works properly if the images are all the same size.
Makes logarithmic images
RUNNING INSTRUCTIONS
logar {-flag[value]} input_file output_file
Flags
-x<picture size> picture size is the number of pixels along the square image. -d display logarithmic conversion table used
Lights will run on a half mega-byte machine whereas light need a full MB.
RUNNING INSTRUCTIONS
light {-flag[value]} input_file output_file
Flags
-x<picture size> picture size is the number of pixels along the square image.
-i<iterations> iterations means the number of iterations to be used.
Default 2000.
-p<precision> precision is the number of bits in addition to the 8 in
the input intensities, that will be used in aritmetic
calculations.
Default 16.
-j<value> value is an integer in the range [1,16] by which the
relaxation parameter w is set:
w = 1 + value/16.
w is defined in the book by Young on page 72 and is related
to the lambda parameter used by Blake in his lightness paper
by
w = 1 -lambda.
Default value = 8.
-m Causes the output intensity values to be in the range [0..256].
The default range is [-128..127] which is called the mean-zero
option which is compatible with the "lightness" files used by
the program called vision:land.
-l Causes the input intensities not to be converted into logarithms.
The default is to convert.
-t<value> value is a floating point number that defines the thresholding
value. In the case of the log conversion option (not using -l)
the value represents the percentage change in intensity at
threshold. Otherwise it is compared directly to the input
intensities which range from [0..256].
Default 6% or 100.
-b Causes a beep sound after every ten iterations.
Default off.
-s Supresses messages to screen. Useful for unwatched batch jobs.
A program to make files from which the Laser printer can produce pictures. The pictures will be bi-level, but by using dot-clumping and dither matrices there are notionally 256 different grey-levels. The input picture to be depicted is in the form of a standard picture file, as used by Vision:display. By using the '-m' option the grey scale of the picture can be adjusted using a map-file that is compatible with those made by Vision:retouch.
RUNNING INSTRUCTIONS
dot {-flag[value]} input_file {output_file}
Output_file
If an output file is not specified one will be created with a "unique" file name of the form "FxxPyy" where xx and yy are two digit numbers. This is useful when sending output directly to the laser printer via the '-l' option.
Flags
-x<picture size> input picture size is the number of pixels along the square
image.
-s<scaling factor> scaling factor is the multiple by which the output picture
size will be scaled. (Note it is also the square root of the
number of pixels in the output file that will be used to
represent one pixel in the input file).
Default scaling factor is 1.
-m<map file> map file is the name of the file to be used to adjust the
grey levels (as produced by Vision:retouch). The default
map file is Map.dat. If '-m' is not used a linear grey
scale will be used.
-l This prefixes the output file name with "Lp1:" so that it
will be sent directly to the laser printer queue directory
and printed (in time).
-i This inverts the grey levels in the output picture so that
it can be viewed on the Level 1 Graphics program called
"Doc:lg1". Note files thus produced will appear as
"negatives" if printed on the laser printer.
Sending Files to Laser Printer Manually and Multiple Copies.
If you want to make many copies of one picture don't use the '-l' option, but transfer the file outputted to your local directory to the Lp1: directory the required number of times using the operating system command:
}t outputfile/lp1:file
where file is a unique file name for each copy, not containing a '.' character.
Using DOC:LG1 to preview output files
If the '-i' option has been used the output file is ready to be viewed on the level 1 graphics screen. To do this issue the operating system command:
}doc:lg1
followed by a carriage-return and the character '1', then enter the name of the output file. For big pictures only the top left corner will be visible. If you are satisfied with the picture on the screen and want a hardcopy you should run VISION:DOT again without the '-i' option and send it to the laser printer.
view:vision printed on 16/02/89 at 17.24