GINO Graphics Suite - GINO v9.0  

gDrawCone

Syntax

[C/C++:]
void gDrawCone(float xp, float yp, float zp, float rad1, float rad2, ...);
[F90:]
subroutine gDrawCone(xp, yp, zp, rad1, rad2, gHeight, gURot, gVRot, gWRot, gVVec, gAbs, gUComp, gVComp)

real, intent(in) :: xp,yp,zp,rad1,rad2

real, optional, intent(in) :: gHeight
real, optional, intent(in) :: gURot, gVRot, gWRot
type (GPOINT3), optional, intent(in) :: gVVec
integer, optional, intent(in) :: gAbs
integer, optional, intent(in) :: gUComp, gVComp

Arguments

xp, yp, zp
Origin (bottom, centre) of cone

rad1, rad2
Bottom and top radii of cone

Optional Args

gHeight
Optional cone height (default 1.0)

gURot ,gVRot, gWRot
Optional rotations about local axes (default 0.0,0.0,0.0)

gVVec
Optional heigh/orientation vector

gAbs
Optional height/orientation vector direction flag

= GABSOLUTE, Absolute height/orientation vector
= GRELATIVE, Relative height/orientation vector

gUComp ,gVComp
Optional object complexity (default 10 x 10)

Description

The routine gDrawCone() draws a 'solid' cone primitive constructed of outward facing facets according to the specified complexity. The cone is centred at the origin (xp, yp, zp), with the defined bottom and top radii (rad1 and rad2) and a default unit height extending in a positive direction along the local V (vertical) axes.

An alternative height/orientation can be specified using either a height dimension (in gHeight) and up to three local axes rotations (gURot, gVRot, gWRot ) or an absolute/relative vector, gVVec from the base of the object. In the latter case a local rotation about the object's vertical axis can also be added in gVRot.

The arguments gUComp and gVComp define the object's complexity in its U (circumference) and V (height) axes respectively. These values determine the number of divisions (facets) in either direction and in the case of the circumferential value, the objects smoothness. Setting gUComp to 6 will define a 6 sided cone for example.

The facets are drawn in the current facet colour/material according to the current lighting/shading environment and subject to the current modelling/viewing transformations.

See Also

gDrawCone Usage
gDrawFacet