NAME	ucd cell cones

SYNOPSIS: Draw Vector Cones from Cell Centroids for Finite Volume UCD data

Author: Ian Curington, AVS Inc, Staines, UK  < ianc@avs.com >

Type	Mapper

Input	UCD

Output	Geometry

Parameters:
	Name		Type		Choices

	Scale		float		1.0, unbounded
	Width		float		0.2, unbounded
        Subdivision     int             2-16, default=6

Source	ucd_cell_cones.c


DESCRIPTION:
  
   This  module draws cones from UCD input showing CELL vector data.
   The length and direction of the cones are representative of
   the vector quantity passed in through the cell data ucd structure.
   Scale and width dials control magnification factors on
   the raw data, to get the cones sized for visibility.
   The subdivision control defines the course to fine tessalation.
  
   This is a special ucd mapper module designed to make
   representations based on CELL based values rather than
   the more typical NODE based values. If you have CELL based
   values, you should also consider the ucd_cell_to_node module.

   The module will draw both 2D and 3D vectors, as required.

   The Scale dial is simply a length multiplier.
  
This module is intended as a source example for other UCD module
developers.

Restrictions: This relies on AVS version 4.0 or later,
              as READ UCD had cell data bugs in version 3.0.

Related Modules: ucd_to_geom, ucd_contour, ucd_cell_geom
                 ucd_cell_arrows


Example Network: ( see ucd_cell_cones.net )
A data file is included to test the module.

                    READ_UCD  (cell-based vectors)
           ------------|
           |           |
       UCD CELL  CONES |
           |           |
           |     UCD TO GEOM (edge mode)
           |          |
           |----|     |
              RENDER GEOMETRY
                     |
              DISPLAY PIXMAP