All Frameworks Class Hierarchy This Framework Indexes Previous Next

GeometricObjects Interface CATCone

Usage: an implementation of this interface is supplied and you must use it as is. You should not reimplement it.

interface CATCone

Interface representing a geometric cone.
Only right circular cones are supported.
The CATCone is created by the CreateCone method of the CATGeoFactory interface and deleted with the Remove method.
A cone is defined by:

a CATMathAxis in which:
- the third direction is the cone direction
- the first and second directions define the P plane on which relies the base radius.
an external cone angle (CATAngle) expressed in radians. Legal values: 0 < ConeAngle < Pi/2.
a start angle in radians measured from the first direction of the cone axis.
an end angle in radians measured from the first direction of the cone axis. This end angle must be greater than the start angle.
a low limit of the cone length. This limit is the slant height counted from the P plane on which relies the base radius. Note that this limit is not counted along the cone axis.
a high limit of the cone length. This limit is the slant height counted from the P plane on which relies the base radius. Note that this limit is not counted along the cone axis. The values of the low and high limits must be such that the generated surface remains bounded by the apex. Double cones (two cones placed apex to apex) are not supported.

Note:
The CATCone is parameterized by the arc length (first direction U) of the mean circular section and the chord length (second direction V) along a ruling.

 C(U,V) = Origin +
  (StartRadius + L * cos(ConeAngle))*(cos(theta)*OX + sin(theta)*OY)
  +  L * sin(ConeAngle) * OZ 
  where U = UScale * theta and L is the rule-length, L = LenScale*V.

Method Index

o GetApex(CATMathPoint&): Returns the apex of this CATCone.
o GetConeAngle(): Returns the angle of this CATCone.
o GetEndAngle(): Returns the high limit of the circle arc of this CATCone.
o GetEndRuleLength(): Returns the high limit of the slant height of this CATCone.
o GetRadiusAtV(double): Returns the radius of the circular cross-section of this cone at the input V-value.
o GetSemiAngle(): Returns the angle between this cone and its axis third direction.
o GetStartAngle(): Returns the low limit of the circle arc of this CATCone.
o GetStartRadius(): Returns the radius in the plane defined by the first and second directions of the cone axis.
o GetStartRuleLength(): Returns the low limit of the slant height of this CATCone.
o GetUScale(): Retrieves the scale on the circular direction of this CATCone.
o GetVScale(): Retrieves the scale along the rule-lines of this CATCone.
o GetVShift(): Retrieves the shift along the rule-lines of this CATCone.
o SetUScale(double): Modifies the scale on the circular direction of this CATCone.
o SetVScale(double): Modifies the scale along the rule-lines of this CATCone.
o SetVShift(double): Modifies the shift along the rule-lines of this CATCone.

Methods

o GetApex

public virtual GetApex( ioPoint)

Returns the apex of this CATCone.

Parameters:

ioPoint: The mathematical definition of the apex.

o GetConeAngle

public virtual GetConeAngle(

)

Returns the angle of this CATCone.

Returns:: The external cone angle.

o GetEndAngle

public virtual GetEndAngle(

)

Returns the high limit of the circle arc of this CATCone.

Returns:: The high limit of the circle arc.

o GetEndRuleLength

public virtual GetEndRuleLength(

)

Returns the high limit of the slant height of this CATCone.

Returns:: The high limit of the slant height. Note that this limit is not counted along the cone axis.

o GetRadiusAtV

public virtual GetRadiusAtV( const iVval)

Returns the radius of the circular cross-section of this cone at the input V-value.

Parameters:

iVval: The parameter value in the V direction.

Returns:

The corresponding radius value.

o GetSemiAngle

public virtual GetSemiAngle(

)

Returns the angle between this cone and its axis third direction.

Returns:: The angle value.

o GetStartAngle

public virtual GetStartAngle(

)

Returns the low limit of the circle arc of this CATCone.

Returns:: The low limit of the circle arc.

o GetStartRadius

public virtual GetStartRadius(

)

Returns the radius in the plane defined by the first and second directions of the cone axis.

Returns:: The base radius on the plane defined by the first and second directions of the cone axis.

o GetStartRuleLength

public virtual GetStartRuleLength(

)

Returns the low limit of the slant height of this CATCone.

Returns:: The low limit of the slant height. Note that this limit is not counted along the cone axis.

o GetUScale

public virtual GetUScale(

)

Retrieves the scale on the circular direction of this CATCone.

Returns:: The scale: U = UScale * theta, in which theta is the angle measured on the MeanCircularSection, with theta(OX)=0 and theta(OY)=Pi/2.

o GetVScale

public virtual GetVScale(

)

Retrieves the scale along the rule-lines of this CATCone.

Returns:: The scale. This starts as 1.0, so that V measures rule-length. However, to preserve parametrization under dilations, it may be changed.

o GetVShift

public virtual GetVShift(

)

Retrieves the shift along the rule-lines of this CATCone.

Returns:: The shift. This starts as 0.0, so that V measures rule-length from the ex-ey plane of the CATMathAxis. However, to preserve parametrization under offsets, it may be changed. In particular, positive offsets can be handled without the shift, but a large enough negative offset requires a shift in V in order to avoid a negative StartRadius.

o SetUScale

public virtual SetUScale( const iNewUScale)

Modifies the scale on the circular direction of this CATCone.

Parameters:

iNewUScale: The scale.

o SetVScale

public virtual SetVScale( const iNewVScale)

Modifies the scale along the rule-lines of this CATCone.

Parameters:

iNewVScale: The new scale.

o SetVShift

public virtual SetVShift( const iNewVScale)

Modifies the shift along the rule-lines of this CATCone.

Parameters:

iNewVScale: The new shift.

This object is included in the file: CATCone.h
If needed, your Imakefile.mk should include the module: CATGMGeometricInterfaces