DgnTorusPipeDetail Struct Reference

A DgnTorusPipeDetail represents a pipe elbow as a torus with partial sweep in the major circle and full circle of pipe. More...

#include <SolidPrimitive.h>

Public Member Functions
	DgnTorusPipeDetail (DPoint3dCR center, DVec3dCR vectorX, DVec3dCR vectorY, double majorRadius, double minorRadius, double sweepAngle, bool capped)
	Detail consructor with complete field list as parameters ... More...
	DgnTorusPipeDetail ()
	Default value constructor. More...
bool	GetRange (DRange3dR range) const
	Return range. More...
bool	GetRange (DRange3dR range, TransformCR transform) const
	Return range when transformed. More...
bool	TryGetConstructiveFrame (TransformR localToWorld, TransformR worldToLocal) const
	Return coordinate system with origin at major hoop center, X axis towards starting minor circle center. More...
bool	IsSameStructure (ISolidPrimitiveCR other) const
	Test for same type and structure (but no coordinate comparison) More...
bool	IsSameStructureAndGeometry (ISolidPrimitiveCR other, double tolerance) const
	Test for same type, structure and coordinates. More...
bool	IsClosedVolume () const
	Test if this is a closed volume. More...
double	ParameterizationSign () const
	Return +1 or -1 that matches the volume sign after integration over the parameter space. More...
bool	HasRealCaps () const
	Return true if capped and incomplete major sweep. More...
DEllipse3d	UFractionToVSectionDEllipse3d (double fraction) const
	Return full ellipse on minor hoop at fractional position along major circle. More...
DEllipse3d	VFractionToUSectionDEllipse3d (double fraction) const
	Return full ellipse on minor hoop at fractional position along minor circle. More...
bool	TryGetRotationAxis (DPoint3dR center, DVec3dR axis, double &sweepRadians) const
bool	TryGetFrame (DPoint3dR center, RotMatrixR axes, double &radiusA, double &radiusB, double &sweepRadians) const
bool	TryGetFrame (TransformR localToWorld, TransformR worldToLocal, double &radiusA, double &radiusB, double &sweepRadians) const
void	AddRayIntersections (bvector< SolidLocationDetail > &pickData, DRay3dCR ray, int parentId, double minParameter) const
	Compute intersections with a ray and add to the pickData. More...
void	AddCurveIntersections (CurveVectorCR curves, bvector< CurveLocationDetail > &curvePoints, bvector< SolidLocationDetail > &solidPoints, MeshAnnotationVector &messages) const
	Compute intersections with curves and add to the data array. More...
void	AddCurveIntersections (ICurvePrimitiveCR curves, bvector< CurveLocationDetail > &curvePoints, bvector< SolidLocationDetail > &solidPoints, MeshAnnotationVector &messages) const
	Compute intersections with a single curve and add to the data array. More...
bool	ClosestPoint (DPoint3dCR spacePoint, SolidLocationDetail &pickDetail) const
bool	TryUVFractionToXYZ (SolidLocationDetail::FaceIndices const &faceIndices, double uFraction, double vFraction, DPoint3dR xyz, DVec3dR dXdu, DVec3dR dXdv) const
	convert u,v fraction on specified face to xyz and derivatives. More...
IGeometryPtr	GetFace (SolidLocationDetail::FaceIndices const &indices) const
	Return a single face of the solid primitive. More...
void	GetFaceIndices (bvector< SolidLocationDetail::FaceIndices > &indices) const
	Fill a list of all possible face indices. More...
ICurvePrimitivePtr	GetConstantVSection (SolidLocationDetail::FaceIndices const &indices, double fraction) const
	Copy a section curve at constant v of a single face to a single ICurvePrimitive. More...
ICurvePrimitivePtr	GetConstantUSection (SolidLocationDetail::FaceIndices const &indices, double fraction) const
	Copy a section at constant u of a single face to a single ICurvePrimitive. More...
bool	TryGetMaxUVLength (SolidLocationDetail::FaceIndices const &indices, DVec2dR uvLength) const
	Compute the lengths of the longest u and v direction sections of a single face of a solid primitive. More...
ISolidPrimitivePtr	Clone () const
	Copy to a new (allocated) solid primitive. More...
bool	TransformInPlace (TransformCR transform)
	Transform in place. More...
bool	ComputeSecondMomentAreaProducts (TransformR localToWorld, DMatrix4dR localProducts) const
	Return the various integrated products for area moment calculations. More...
bool	ComputeSecondMomentVolumeProducts (TransformR localToWorld, DMatrix4dR localProducts) const
	Return the various integrated products for moment calculations. More...
void	IntersectCurveLocal (ICurvePrimitiveCR curve, bvector< double > &curveFractions, bvector< DPoint3d > &normalizedConePoints, TransformR localToWorld, TransformR worldToLocal, double &rMajor, double &rMinor, double &sweepRadians, bool boundedConeZ) const
	Return all intersection points of a curve with the pipe body Returned data is the detailed local coordinates, with additional data to relate it back to world. More...

Static Public Member Functions
static void	SetDetailCoordinatesFromLocalPipeCoordinates (SolidLocationDetail &detail, DPoint3dCR localuvw, TransformCR localToWorld, double &rMajor, double &rMinor, double &sweepRadians)
	set point, uv coordinates, and uv derivatives vectors More...

Public Attributes
DPoint3d	m_center
	Center of primary circle. More...
DVec3d	m_vectorX
	X vector of primary circle. More...
DVec3d	m_vectorY
	Y vector of primary circle. More...
double	m_majorRadius
	radius of elbow More...
double	m_minorRadius
	radius of pipe section More...
double	m_sweepAngle
	major circle sweep angle More...
bool	m_capped
	cap surface present (e.g. for incomplete sweep) More...

Detailed Description

A DgnTorusPipeDetail represents a pipe elbow as a torus with partial sweep in the major circle and full circle of pipe.

Constructor & Destructor Documentation

DgnTorusPipeDetail	(	DPoint3dCR	center,
		DVec3dCR	vectorX,
		DVec3dCR	vectorY,
		double	majorRadius,
		double	minorRadius,
		double	sweepAngle,
		bool	capped
	)

Detail consructor with complete field list as parameters ...

Parameters

[in]	center	Center of primary circle
[in]	vectorX	X vector of primary circle
[in]	vectorY	Y vector of primary circle
[in]	majorRadius	radius of elbow
[in]	minorRadius	radius of pipe section
[in]	sweepAngle	major circle sweep angle
[in]	capped	true for solid

DgnTorusPipeDetail

(

)

Default value constructor.

Member Function Documentation

void AddCurveIntersections	(	CurveVectorCR	curves,
		bvector< CurveLocationDetail > &	curvePoints,
		bvector< SolidLocationDetail > &	solidPoints,
		MeshAnnotationVector &	messages
	)		const

Compute intersections with curves and add to the data array.

Parameters

[in]	curves
[in,out]	curvePoints	growing array of curve points.
[in,out]	solidPoints	growing array of solid points.
[in,out]	messages	array of error messages

void AddCurveIntersections	(	ICurvePrimitiveCR	curves,
		bvector< CurveLocationDetail > &	curvePoints,
		bvector< SolidLocationDetail > &	solidPoints,
		MeshAnnotationVector &	messages
	)		const

Compute intersections with a single curve and add to the data array.

Parameters

[in]	curves
[in,out]	curvePoints	growing array of curve points.
[in,out]	solidPoints	growing array of solid points.
[in,out]	messages	array of error messages

void AddRayIntersections	(	bvector< SolidLocationDetail > &	pickData,
		DRay3dCR	ray,
		int	parentId,
		double	minParameter
	)		const

Compute intersections with a ray and add to the pickData.

Parameters

[in]	ray	origin and direction
[in]	minParameter	smallest parameter of pick. (e.g. 0 for picking along a positive ray from an eyepoint)
[in,out]	pickData	growing array of picks.
[in]	parentId	caller's id for this solid. Will be placed in each pickData entry has parentId.

ISolidPrimitivePtr Clone

(

)

const

Copy to a new (allocated) solid primitive.

bool ClosestPoint	(	DPoint3dCR	spacePoint,
		SolidLocationDetail &	pickDetail
	)		const

Parameters

[in]	spacePoint	search for point close to here and on the solid surface
[out]	pickDetail	closest point data.

Returns

false if not supported.

bool ComputeSecondMomentAreaProducts	(	TransformR	localToWorld,
		DMatrix4dR	localProducts
	)		const

Return the various integrated products for area moment calculations.

The primitive is treated as a thin shell.

Parameters

[out]	localToWorld	transform from preferred system where the products are most easily computed to world.
[out]	localProducts	integrated [xx xy xz x; xy yy yz y; xz yz zz z; x y z 1] dA

Returns

false if unable to compute.

bool ComputeSecondMomentVolumeProducts	(	TransformR	localToWorld,
		DMatrix4dR	localProducts
	)		const

Return the various integrated products for moment calculations.

The primitive is treated as a volume

Parameters

[out]	localToWorld	transform from preferred system where the products are most easily computed to world.
[out]	localProducts	integrated [xx xy xz x; xy yy yz y; xz yz zz z; x y z 1] dA

Returns

false if unable to compute.

ICurvePrimitivePtr GetConstantUSection	(	SolidLocationDetail::FaceIndices const &	indices,
		double	fraction
	)		const

Copy a section at constant u of a single face to a single ICurvePrimitive.

Parameters

[in]	indices	selects face
[in]	fraction	u fraction for section curve

ICurvePrimitivePtr GetConstantVSection	(	SolidLocationDetail::FaceIndices const &	indices,
		double	fraction
	)		const

Copy a section curve at constant v of a single face to a single ICurvePrimitive.

Parameters

[in]	indices	selects face
[in]	fraction	v fraction for section curve

IGeometryPtr GetFace

(

SolidLocationDetail::FaceIndices const &

indices

)

const

Return a single face of the solid primitive.

Parameters

indices

integer selectors for the face.

void GetFaceIndices

(

bvector< SolidLocationDetail::FaceIndices > &

indices

)

const

Fill a list of all possible face indices.

Parameters

[out]

indices

array of selectors for the faces.

bool GetRange

(

DRange3dR

range

)

const

Return range.

bool GetRange	(	DRange3dR	range,
		TransformCR	transform
	)		const

Return range when transformed.

bool HasRealCaps

(

)

const

Return true if capped and incomplete major sweep.

void IntersectCurveLocal	(	ICurvePrimitiveCR	curve,
		bvector< double > &	curveFractions,
		bvector< DPoint3d > &	normalizedConePoints,
		TransformR	localToWorld,
		TransformR	worldToLocal,
		double &	rMajor,
		double &	rMinor,
		double &	sweepRadians,
		bool	boundedConeZ
	)		const

Return all intersection points of a curve with the pipe body Returned data is the detailed local coordinates, with additional data to relate it back to world.

Parameters

[in]	curve	curve to intersect with instance cone.
[out]	curveFractions	intersection fractions along the curve
[out]	normalizedConePoints	intersection points, in local coordinates
[out]	localToWorld	local to world transformation
[out]	worldToLocal	world to local transformation
[out]	rMajor	major radius
[out]	rMinor	minor radius
[out]	sweepRadians	pipe sweep
[in]	boundedConeZ	if true, skip intersections outside the cone caps.

bool IsClosedVolume

(

)

const

Test if this is a closed volume.

bool IsSameStructure

(

ISolidPrimitiveCR

other

)

const

Test for same type and structure (but no coordinate comparison)

bool IsSameStructureAndGeometry	(	ISolidPrimitiveCR	other,
		double	tolerance
	)		const

Test for same type, structure and coordinates.

double ParameterizationSign

(

)

const

Return +1 or -1 that matches the volume sign after integration over the parameter space.

static void SetDetailCoordinatesFromLocalPipeCoordinates ( SolidLocationDetail &  detail, DPoint3dCR  localuvw, TransformCR  localToWorld, double &  rMajor, double &  rMinor, double &  sweepRadians  )

static

set point, uv coordinates, and uv derivatives vectors

Parameters

[in,out]	detail	detail to update
[in]	localuvw	coordinates in local fraction space.
[in]	localToWorld	transform to world coordinates
[out]	rMajor	major radius
[out]	rMinor	minor radius
[out]	sweepRadians	sweep angle

bool TransformInPlace

(

TransformCR

transform

)

Transform in place.

bool TryGetConstructiveFrame	(	TransformR	localToWorld,
		TransformR	worldToLocal
	)		const

Return coordinate system with origin at major hoop center, X axis towards starting minor circle center.

bool TryGetFrame	(	DPoint3dR	center,
		RotMatrixR	axes,
		double &	radiusA,
		double &	radiusB,
		double &	sweepRadians
	)		const

Parameters

[out]	center	center of rotation.
[out]	axes	coordinate axes, xy in major plane, z through hole.
[out]	radiusA	major radius (elbow radius)
[out]	radiusB	minor radius (pipe diameter)
[out]	sweepRadians	angle of rotation.

bool TryGetFrame	(	TransformR	localToWorld,
		TransformR	worldToLocal,
		double &	radiusA,
		double &	radiusB,
		double &	sweepRadians
	)		const

bool TryGetMaxUVLength	(	SolidLocationDetail::FaceIndices const &	indices,
		DVec2dR	uvLength
	)		const

Compute the lengths of the longest u and v direction sections of a single face of a solid primitive.

Parameters

[in]	indices	selects face.
[out]	uvLength	sizes in u, v directions.

bool TryGetRotationAxis	(	DPoint3dR	center,
		DVec3dR	axis,
		double &	sweepRadians
	)		const

Parameters

center	OUT center of rotation.
axis	OUT axis of rotation.
sweepRadians	OUT angle of rotation.

bool TryUVFractionToXYZ	(	SolidLocationDetail::FaceIndices const &	faceIndices,
		double	uFraction,
		double	vFraction,
		DPoint3dR	xyz,
		DVec3dR	dXdu,
		DVec3dR	dXdv
	)		const

convert u,v fraction on specified face to xyz and derivatives.

Parameters

[in]	faceIndices	face selection indices
[in]	uFraction	fractional coordinate in u direction.
[in]	vFraction	fractional coordinate in v direction.
[out]	xyz	point on face.
[out]	dXdu	derivative of face point wrt uFraction.
[out]	dXdv	derivative of face point wrt vFraction.

DEllipse3d UFractionToVSectionDEllipse3d

(

double

fraction

)

const

Return full ellipse on minor hoop at fractional position along major circle.

DEllipse3d VFractionToUSectionDEllipse3d

(

double

fraction

)

const

Return full ellipse on minor hoop at fractional position along minor circle.

Member Data Documentation

bool m_capped

cap surface present (e.g. for incomplete sweep)

DPoint3d m_center

Center of primary circle.

double m_majorRadius

radius of elbow

double m_minorRadius

radius of pipe section

double m_sweepAngle

major circle sweep angle

DVec3d m_vectorX

X vector of primary circle.

DVec3d m_vectorY

Y vector of primary circle.

---

The documentation for this struct was generated from the following file:

• SolidPrimitive.h