home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / m / morpho.zip / morpho / doc / manpages / vgdiskse.1 < prev    next >
Text File  |  1992-07-27  |  4KB  |  131 lines
  1.  
  2. vgdiskse(1)                  Khoros                   vgdiskse(1)
  3.  
  4. PROGRAM
  5.      vgdiskse - Creates a image of a disk with the origin at the
  6.      center
  7.  
  8. SYNTAX
  9.      vgdiskse
  10.  
  11.      -o             output image
  12.  
  13.      -t             Selects data type of output image:
  14.                      'integer' (choose Integer data storage
  15.                     type),
  16.                       or 'byte' (choose Byte data storage type)
  17.  
  18.      [-trigger]     trigger input
  19.  
  20.      [-r]           Desired number of rows in output image
  21.  
  22.      [-c]           Desired number of columns in output image
  23.  
  24.      [-d]           Diameter of circle (in pixels)
  25.  
  26.      [-x]           X coordinate of center of circle
  27.  
  28.      [-y]           Y coordinate of center of circle
  29.  
  30.      [-b]           Background level
  31.  
  32.      [-f]           Foreground level
  33.  
  34.      [-V]           Gives the version for vgdiskse
  35.  
  36.      [-U]           Gives the usage for vgdiskse
  37.  
  38.      [-P]           Prompts for command line options
  39.  
  40.      [-A [file1]]   Creates the answer file called vgdiskse.ans
  41.                     or file1
  42.  
  43.      [-a [file1]]   Uses vgdiskse.ans or file1 as the answer file
  44.  
  45. DESCRIPTION
  46.      vgdiskse creates an image of a disk.  The background inten-
  47.      sity is set by the -b argument. The foreground or circle
  48.      intensity is set by the -f argument.  The circle can be
  49.      placed anywhere, and is NOT required to lie completely
  50.      within the image boundaries.  The origin of the structuring
  51.      elment is placed at the center of the disk.
  52.  
  53.      The position of the center of the circle and its diameter
  54.      can all be specified as floating point numbers, allowing
  55.      sub-pixel positioning of the circle.
  56.  
  57.      The trigger input can be used to cause vgdiskse to re-
  58.      execute when used inside cantata. No image is read from this
  59.      input.
  60.  
  61. REQUIRED ARGUMENTS
  62.      -o     type: outfile
  63.             desc: output image
  64.  
  65.      -t     type: string
  66.             desc: Selects data type of output image
  67.             allowed values:
  68.              'integer' (choose Integer data storage type),
  69.               or 'byte' (choose Byte data storage type)
  70.  
  71. OPTIONAL ARGUMENTS
  72.      -trigger
  73.             type: infile
  74.             desc: trigger input
  75.  
  76.      -r     type: integer
  77.             desc: Desired number of rows in output image
  78.             default: 17
  79.             bounds: value > 0
  80.  
  81.      -c     type: integer
  82.             desc: Desired number of columns in output image
  83.             default: 17
  84.             bounds: value > 0
  85.  
  86.      -d     type: float
  87.             desc: Diameter of circle (in pixels)
  88.             default: 15
  89.             bounds: value >= 0.0
  90.  
  91.      -x     type: float
  92.             desc: X coordinate of center of circle
  93.             default: 7
  94.             bounds: no range checking
  95.  
  96.      -y     type: float
  97.             desc: Y coordinate of center of circle
  98.             default: 7
  99.             bounds: no range checking
  100.  
  101.      -b     type: float
  102.             desc: Background level
  103.             default: 0
  104.             bounds: no range checking
  105.  
  106.      -f     type: float
  107.             desc: Foreground level
  108.             default: 255
  109.             bounds: no range checking
  110.  
  111. EXAMPLES
  112.      vgdiskse -r 32 -c 32 -b 3.5 -f 100 -x 32 -y 16 -d 32 -t int
  113.  
  114.      Creates a 32x32 image of type INT, with the background level
  115.      at 3.5 and the foreground at 107.5. The circle lies in this
  116.      case halfway off the image to the right.  The diameter of
  117.      the circle is 32 pixels.
  118.  
  119. SEE ALSO
  120.      intro(1), verror(3), vgparms(3), vutils(3), lvgdiskse(3)
  121.  
  122. RESTRICTIONS
  123.      vgdiskse will generate only BYTE or FLOAT images.
  124.  
  125. COPYRIGHT
  126.      Copyright 1992, University of New Mexico.  All rights
  127.      reserved.
  128.  
  129. Khoros                    Release: 1.0                          1
  130.  
  131.