HUtilityBoolean

Functions

void	`SplitTarget`
HC_KEY	`MakeWindingConsistent`
void	`CutBlock`
HC_KEY	`MakeBoolean`
void	`ProjectShell`
void	`UnProjectShell`
HC_KEY	`DMakeBoolean`
void	`DProjectShell`
void	`DUnProjectShell`
HC_KEY	`DCalculateSilhouette`
HC_KEY	`CalculateSilhouette`
int	`ObjectMovedEvent`
bool	`TestCollision`

Detailed Description

class HUtilityBoolean

The HUtilityBoolean class contains a set of utility functions related to the polygonal boolean functionality.

HUtilityBoolean includes utility functions for using the 3DGS boolean functionality in interactive boolean Applications like n-degree milling.

Public Static Functions

static void SplitTarget(HBaseView *view, HC_KEY targetshell)

Splits a shell in all three dimensions to allow for localization of boolean operations. The newly created geometry will reside in child segments of the segment which contains the original shell.

Parameters:

view – Pointer to HBaseView object
targetshell – Key of Shell which will be cut

static HC_KEY MakeWindingConsistent(HC_KEY shellkey)

Identifies faces with inconsistent handedness inside a shell and “repairs” those faces

Parameters:: shellkey – Shell Key
Returns:: new shell with consistent handedness

static void CutBlock(HBaseView *m_pHView, HC_KEY targetshell, int side, int slicenum)

Splits a target shell along one of the three major axis

Parameters:

targetshell – Shell to split
side – 0 to 3 indicating the split axis 0 = x, 1 = y, 2 = z
slicenum – Number of cuts along the indicated axis

static HC_KEY MakeBoolean(HC_KEY s1, HC_KEY s2, char *whattype, bool doTransform = false)

Performs a boolean operation of one shell with another

Parameters:

s1 – Shell Key representing the “Tool” of the boolean operation
s2 – Shell Key representing the “Target” of the boolean operation
whattype – string passed into HC_Compute_Boolean_Shell function determening the type of boolean operation
doTransform – If true the resulting shell is transformed by the modelling matrix of the currently open segment after the operation

Returns:

Key to shell which represents the result of the boolean operation

static void ProjectShell(HC_KEY shellkey, int plen, HPoint *points, int flen, int *faces)

Projects shell by the modelling matrix of its containing segment

Parameters:

shelllkey – Key to Shell
plen – Length of Point Array which contains the projected points of the shell
points – Point Array which contains the projected points of the shell
flen – Length of Face List Array
faces – Face List Array

static void UnProjectShell(HC_KEY shellkey)

Modifies the point list of an existing shell by the inverse of the modelling matrix of its containing segment

Parameters:: shelllkey – Key to Shell

static HC_KEY DMakeBoolean(HC_KEY s1, HC_KEY s2, char *whattype, bool doTransform = false)

Performs a boolean operation of one shell with another using double precision

Parameters:

s1 – Shell Key representing the “Tool” of the boolean operation
s2 – Shell Key representing the “Target” of the boolean operation
whattype – string passed into HC_Compute_Boolean_Shell function determening the type of boolean operation
doTransform – If true the resulting shell is transformed by the modelling matrix of the currently open segment after the operation

Returns:

Key to shell which represents the result of the boolean operation

static void DProjectShell(HC_KEY shellkey, int plen, HDPoint *points, int flen, int *faces)

Projects shell by the modelling matrix of its containing segment using double precision

Parameters:

shelllkey – Key to Shell
plen – Length of Point Array which contains the projected points of the shell
points – Point Array which contains the projected points of the shell
flen – Length of Face List Array
faces – Face List Array

static void DUnProjectShell(HC_KEY shellkey)

Modifies the point list of an existing shell by the inverse of the modelling matrix of its containing segment. Uses Double Precision

Parameters:: shelllkey – Key to Shell

static HC_KEY DCalculateSilhouette(HC_KEY targetshell, HPoint start, HPoint end)

Calculates the silhouette for a given shell given the start and end point. The resulting shell will be placed in a segment called “sil” underneath the segment containing the referenced shell. The result shell will be double precision

Parameters:

targetshell – Key of shell to calculate the silhouette for
start – Start Point for silhouette calculation
end – End Point for silhouette calculation

Returns:

Key of Shell representing the silhouette

static HC_KEY CalculateSilhouette(HC_KEY targetshell, HPoint start, HPoint end)

Calculates the silhouette for a given shell given the start and end point. The resulting shell will be placed in a segment called “sil” underneath the segment containing the referenced shell.

Parameters:

targetshell – Key of shell to calculate the silhouette for
start – Start Point for silhouette calculation
end – End Point for silhouette calculation

Returns:

Key of Shell representing the silhouette

static int ObjectMovedEvent(HBaseView *view, HC_KEY key, HPoint *p, HPoint posbeforemovedevent)

This funcion should be called after an ObjectMovedEvent has been triggered from an HObjectManipulationListener

Parameters:

view – Pointer to HBaseView object
key – Key of moved geometry
p – New Position
posbeforemovedevent – Old Position

Returns:

Event Return

static bool TestCollision(HBaseView *view, HC_KEY key1, HC_KEY key2, bool first, bool doTransform1, bool doTransform2)

Determines if a collision occured between the bounding boxes of two shells

Parameters:

key1 – First shell to determine collision for
key2 – Second shell to determine collision for
first – If true testcollision is called for the first time and default parameters are calculated
doTransform1 – If true perform a projection of first shell
doTransform1 – If true perform a projection of second shell

Returns:

True if collision occured