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