Parent Topic: DCP

IMAGE COMMANDS

General Image Command Syntax: DCP> I? n1,n2 ...

where ? is replaced by the particular command.

If n1=0, it defaults to the most recently used image plane. If no image planes have been used yet, n1 defaults to image plane 1. This default is represented in the parameter description as <last image>.

IMAGE COMMANDS AVAILABLE:

 IA:Image Averaging   IB:Image Blank     ID:Image Display
 IF:Image Filtering   IH:Image Histogram IL:Image Label
 IM:Image Modify      IO:Image Overlay   IW:Image Window
 IX:Image Transfer    IZ:Image Clearing  I+:Image Add
 I-:Image Subtract    I*:Image Multiply  I/:Image Divide

IA

Image Averaging average filters one image into another with weighting.

 IA [n1,n2,...,n11]

 n1:      Destination image plane             <last image>
 n2:      Source image plane                  <n1>
 n3-n11:  Weights for averaging               <1>
Weights are assigned as follows in a 3X3 matrix:

         n3  n4  n5
         n6  n7  n8
         n9  n10 n11

IB

Image Blank disables all image planes, leaving graphic planes enabled. IB has no parameters. If the ID or IO command is executed without parameters after executing an IB command, image planes are enabled with the colour gun mapping that was in place before the IB command was executed.

ID

Image Display disables all graphic planes, and displays up to 3 image planes, assigned to specific colour guns.

 ID [n1,n2,n3]

 n1:      image plane assigned to Red gun     <last image>
 n2:      image plane assigned to Green gun   <n1>
 n3:      image plane assigned to Blue gun    <n2>
If image planes are not specified, the colour gun mapping is set to the previous setting before the last IB, GD, or ZZ command.

IF

Image Filtering filters one image plane into another with weighting.

 IF [n1,n2,...,n11]

 n1:      Destination image plane             <last image>
 n2:      Source image plane                  <n1>
 n3-n11:  Weights for filtering               <see table>
The weights and their defaults are as follows for a 3X3 matrix:

    weights:            defaults:
    n3  n4  n5         -1  -1  -1
    n6  n7  n8         -1   8  -1
    n9  n10 n11        -1  -1  -1

IH

Image Histogram plots a histogram of an image plane.

 IH [n1,n2,...,n17]

 n1:      Image plane for histogram plotting  <last image>
 n2:      Graphic to plot histogram on        <n1>
 n3,n4:   X and Y offsets to sample window    <0,0>
 n5,n6:   X and Y dimensions of sample window <display size>
 n7:      Graphic plane number for mask,      <0>
          0 if no graphic mask is being used
 n8,n9:   Plot window offset                  <n1/8 display size>
 n10,n11: Plot window size                    <1/2 display size>
          If n10,n11 are explicitly specified,
          then n8,n9 default to 0,0
 n12:     Histogram smoothing factor          <no smoothing>
 n13:     Plot type;  1: single points,       <3>
          2: connected lines, 3: vertical bars
 n14:     Point mark type (See GM command)    <none>
 n15:     Labelling:  1: yes, 2: no.          <1>
          Labelling occurs only if there is
          enough room around the plot window
          to write the labels.
 n16,n17: Grey-level plot range               <0,255>

IL

Image Label writes a label to an image plane.

 IL [n1,n2,n3,n4,n5,label]
 n1:      Image plane to label                <last image>
 n2:      Character font size                 <1>
          -1: small font (6 x 8)
          0 or 1: standard font (9 x 12)
          2,3,4,5: large font (14*(n2-1) x 24*(n2-1))
 n3:      Grey-level value of label           <255>
 n4,n5:   Upper left position of label        <cursor position>
 label:   Alphanumeric text for label         <prompted>
The standard (default) character font is 9 by 12 pixels. It is printed when n2 = 0 or 1. The small character font is 6 by 8 pixels and is printed when n2 = -1. The large font is 14*(n2-1) by 24*(n2-1) pixels, where n2 is between 2 and 5. For example: setting n2 = 2 prints 14 by 24 pixel large font. If n3 > 0, the characters are assigned value n3 (default 255). If n3 < 0, the rectangular border around the characters is assigned the value -n3, whereas image values under characters are untouched. If `label' is missing, the user is continuously prompted to enter lines of text until an empty line is entered. If n4,n5 are not specified, the current cursor position specifies the upper left corner for the next line of text. If the cursor is not moved between entering lines of text, the next line is printed immediately below the current line. However, if the cursor is moved, the next line is printed starting at the new cursor position. If both n4,n5 are specified, the cursor position has no effect on the label position, and each line of text is always printed below the previous line.

IM

Image Modify modifies (writes) a grey level value in the image plane.

 IM [n1],n2[,n3,n4]

 n1:      Image plane to modify               <last image>
 n2:      Grey-level value                    <0>
 n3,n4:   Coordinates of position to modify   <cursor position>

IO

Image Overlay overlays one or more image planes on the display, without removing graphic planes.

 IO [n1,n2,n3]

 n1:      Image plane assigned to Red gun     <last image>
 n2:      Image plane assigned to Green gun   <n1>
 n3:      Image plane assigned to Blue gun    <n2>
If image planes are not specified, the colour gun mapping is set to the previous setting before the last IB, GD, or ZZ command.

IW

Image Window prints a numeric window of grey level values for an image plane. The grey level at the position specified by n2,n3, (or by the cursor) is highlighted by pointed arrows.

 IW [n1,n2,n3,n4,n5]

 n1:      Image plane to be examined          <last image>
 n2,n3:   Window centre point                 <cursor position>
 n4,n5:   Window size                         <16,16>

IX

Image Transfer transfers the image plane n2 into the image plane n1.

 IX [n1],n2

 n1:      Destination image plane             <last image>
 n2:      Source image plane                  <>

IZ

Image Clearing clears the image plane.

 IZ [n1,n2,n3]

 n1:      Image plane to be cleared           <last image>
 n2:      First line to be cleared            <1>
 n3:      Last line to be cleared             <bottom line>

I+ I- I* I/

Image Add, Image Subtract, Image Multiply, and Image Divide perform arithmetic operations on image planes.

 n1:      Image plane to contain results of   <last image>
          arithmetic operation
 n2:      Image plane, first operand          <0>
 n3:      Image plane, second operand         <0>
 n4:      Scalar, alternate second operand    <>

 I+ [n1],n2,n3[,n4]     Addition        n1 = n2 + ni
 I- [n1],n2,n3[,n4]     Subtraction     n1 = n2 - ni
 I* [n1],n2,n3[,n4]     Multiplication  n1 = n2 * ni
 I/ [n1],n2,n3[,n4]     Division        n1 = n2 / ni
where ni is either n3 or n4.

If n3 is null, n4 is used. If n3 is specified, n4 is ignored. n3 and n4 cannot both be null.


Parent Topic: DCP
About PCI Help Gateway