BlendPath Class Reference

This contains a NodePath, plus other data, generated by an object that is blended. More...

#include <nodebldr.h>

Inheritance diagram for BlendPath:

List of all members.

Public Member Functions
	BlendPath ()
	Default constructor.
	~BlendPath ()
	Default destructor.
BOOL	Initialise (NodeRenderableInk *pThisBlendNode, INT32 Index, NodeRenderableInk *pThisCreatedByNode, UINT32 SubpathID, UINT32 SubPathNum, CCAttrMap *pAttrMap, BOOL CheckDirection=TRUE)
	Inits the BlendPath object to use the given NodePath. NOTE: pThisNodePath should point to isolated instance, and not to a used NodePath linked into the tree! NOTE: Once you give a BlendPath a NodePath, this becomes property of the BlendPath and can be altered and/or deleted by the BlendPath at any time. DO NOT KEEP A COPY OF THE PTR pThisNodePath!!! If you want a copy of the NodePath at pThisNodePath, make a new copy of the node.
BOOL	Initialise (BlendPath *pBlendPath, NodeRenderableInk *pNodeToBlend)
	Inits this blend path, replacing the blend node with the one given.
NodeRenderableInk *	GetBlendNode ()
Path *	GetPath ()
NodeRenderableInk *	GetCreatedByNode ()
INT32	GetOrigMapping ()
PathTypeEnum	GetPathType ()
UINT32	GetSubPathID ()
UINT32	GetSubPathNum ()
INT32	GetNumElements ()
BOOL	UniqueAppliedAttrs ()
MILLIPOINT	GetAppliedLineWidth ()
	Returns the cached line width applying to this blendpath.
BOOL	IsLine ()
BOOL	IsShape ()
void	Transform (TransformBase &Trans)
	Transforms the NodePath attached to this blend path, plus any applied attrs it may have.
void	RenderBlendBlobs (RenderRegion *pRender, Trans2DMatrix *pMatrix)
	Renders the blend blobs by asking the pNodePath's Path to render its path blobs.
BOOL	IsFilled ()
	Find out if the path is filled.
BOOL	IsStroked ()
	Find out if the path is Stroked.
DocCoord	GetPathCoord (INT32 Index)
	Access to path's coord array.
BOOL	IsPointOverBlob (DocCoord *pPointerPos, INT32 *pIndex, Trans2DMatrix *pMatrix)
	This sees if the point given lies on a selected blob. If a match is found, the index to blob element is updated.
INT32	MapPath (INT32 Index)
	This will ensure that the path's first element is the element at Index. It does this by rotating the path until element at index 'Index' is at index 0. The value returned can be used to undo the mapping, i.e. to apply an inverse mapping.
DocCoord	MapPath (DocCoord Index)
	This will ensure that the path's first element is the element closest to Pos. It does this by rotating the path until element at Pos is at index 0. The value returned can be used to undo the mapping, i.e. to apply an inverse mapping.
INT32	FindBottomLeft ()
	This scans the path for the bottom left most element, and returns the index to it.
CCAttrMap *	FindAppliedAttributes ()
	This calls FindAppliedAttributes() on the node that created this blend path. It will only do this if this is the first call since the last FreeAppliedAttributes() or is the first ever call (in other words, it is cached).
void	FreeAppliedAttributes ()
	This will free any memory used to store the applied attributes of this blend path.
AttrBitmapFill *	GetAppliedBitmapColourFill ()
	as above
AttrBitmapFill *	GetAppliedBitmapTranspFill ()
	as above
void	SetAppliedAttributes (CCAttrMap *pMap)
	Designed specifically for use when blending brush attributes, which need to generate blendpaths and attribute maps by hand,so to speak. This function allows you to set an external attribute map for this blendpath.
void	SetPath (Path *pPath)
	Designed specifically for use when blending brush attributes, which need to generate blendpaths and attribute maps by hand,so to speak. This function allows you to set an external path for this blendpath.
void	DeleteAttributesAndPath ()
	Sets m_SubPathID to zero thus ensuring that all the attributes and the attribute map are deleted. We need to do this for blendpaths created by blending brush attributes as mentioned in the previous two functions. I don't recommend use of this function under normal circumstances.
void	SetPathType (PathTypeEnum PathType)
void	Transform (Matrix *pTransMatrix, BOOL TransformLines, BOOL Tile=FALSE)
	Transforms the NodePath attached to this blend path, plus any applied attrs it may have Plus it also records transforms in the member variable, so that later they may be undone This is specifically required by brush attributes.
BOOL	TransformBrushAttributesBeforeSave ()
	Undoes the transformations performed on the attributes of this blendpath. This function must be called prior to saving a brush attribute. If you wish to keep using the attribute after the save call TransformBrushAttributesAfterSave or else your attributes will be all over the place.
BOOL	TransformBrushAttributesAfterSave ()
	Undoes the transformations performed on the attributes by the previous function.
void	SetBlendNode (NodeRenderableInk *pInk)
void	SetFreeAttributeFlag (BOOL Value)
	Sets the flag which indicates whether or not we definitely want to delete the attribute map upon destruction of this blendpath. This was designed pretty specifically for use with the Brush code so if you want to use it for other purposes you should be careful.
void	SetCreatedViaNodeBlendPath (BOOL val)
BOOL	GetCreatedViaNodeBlendPath ()
BOOL	MakeCopyPathAndAttributes ()
	Because of all the imprecision problems we've been having I've decided it is best if we never ever access the orignal blendpath path and attribute data for rendering. Instead what we will do is generate copies of this data and supply it to anyone who wants to render with this brush. The copies will then be destroyed after we have finished rendering.
BOOL	UpdateCopyPathAndAttributes ()
	Because of all the imprecision problems we've been having I've decided it is best if we never ever access the orignal blendpath path and attribute data for rendering. Instead what we will do is generate copies of this data and supply it to anyone who wants to render with this brush. The copies will then be destroyed after we have finished rendering.
CCAttrMap *	MakeAttributeMapCopy ()
	To make a complete copy of the applied attribute map.
CCAttrMap *	UpdateAttributeMapCopy (CCAttrMap *pCopyMap)
	To make a complete copy of the applied attribute map.
void	DeleteCopyPathAndAttributes ()
	Deletes the copies we made of the paths and attributes.
void	DeleteAttributeMapAndAttributes (CCAttrMap *pMap)
	Counterpart to MakeAttributeMap, deletes all the copied attributes and then the map.
Path *	GetCopyPath ()
	access
CCAttrMap *	GetCopyAttributes ()
	access
Public Attributes
Path *	m_pPath
Private Member Functions
	CC_DECLARE_MEMDUMP (BlendPath)
void	ProcessVerbs ()
	This processes the verbs so the GBlend can cope with them. It clears any PT_CLOSEFIGURE flags it finds. If it finds one or more PT_CLOSEFIGURE, CloseFigure = PT_CLOSEFIGURE.
void	CorrectDirection (INT32 Index)
	This ensures that the path is going in the correct direction. It doesn't matter which direction, as long as the direction is the same for all blend paths.
Private Attributes
NodeRenderableInk *	m_pBlendNode
NodeRenderableInk *	m_pCreatedByNode
CCAttrMap *	m_pAppliedAttrs
UINT32	m_CloseFigure
INT32	m_OrigMapping
PathTypeEnum	m_PathType
BOOL	m_DirChanged
BOOL	m_UniqueAttrs
UINT32	m_SubPathID
UINT32	m_SubPathNum
INT32	m_NumElements
DocCoord	m_BrushStartCoord
DocCoord	m_BrushCurrentCoord
BOOL	m_bDeleteAll
BOOL	m_bFreeAttrMapOnDestruct
MILLIPOINT	m_AppliedLineWidth
BOOL	m_bCreatedViaNodeBlendPath
Path *	m_pCopyPath
CCAttrMap *	m_pCopyAttrs

---

Detailed Description

This contains a NodePath, plus other data, generated by an object that is blended.

Author:

Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>

Date:

11/10/94

Definition at line 138 of file nodebldr.h.

---

Constructor & Destructor Documentation

BlendPath::BlendPath (   )

Default constructor. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 12/10/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Definition at line 4757 of file nodebldr.cpp. { m_pBlendNode = NULL; m_pPath = NULL; m_pCreatedByNode= NULL; m_pAppliedAttrs = NULL; m_CloseFigure = 0; m_OrigMapping = 0; m_PathType = PATHTYPE_NONE; m_SubPathID = 0; m_DirChanged = FALSE; m_NumElements = -1; m_UniqueAttrs = FALSE; m_bDeleteAll = FALSE; m_bFreeAttrMapOnDestruct = FALSE; m_AppliedLineWidth = -1; m_bCreatedViaNodeBlendPath = FALSE; m_pCopyPath = NULL; m_pCopyAttrs = NULL; }

BlendPath::~BlendPath (   )

Default destructor. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 12/10/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - Notes: This destructor has actually gotten quite complicated as it Blendpaths are an important part of the brush attribute and there are a number of different cases to deal with: The normal case is where the blendpath is part of a blend, in this case it may wish to delete its applied attributes, but more than often will not, as they are still used in the tree. The brush has two deletion scenarios: normally the m_bFreeAttributes flag is set, as we wish to ensure the attribute map is deleted but we do not wish to delete the attributes (as they are probably shared) if this blendpath has been created specially as part of a blend between two brush attributes, then the m_bDeleteAll flag will be set, which asks that we delete everything Definition at line 4807 of file nodebldr.cpp. { // Delete our copies DeleteCopyPathAndAttributes(); // Only delete the applied attr map if this is the first sub path that was generated from the // source path supplied when making shapes. // This assumes that all sub-paths within a given path have the same attributes (far assumption) if (m_SubPathNum == 0 || m_bDeleteAll) { if ((m_UniqueAttrs || m_bDeleteAll) && m_pAppliedAttrs != NULL) { CCRuntimeClass *pType; void *pVal; // delete all attrs CMapPtrToPtr::iterator Pos = m_pAppliedAttrs->GetStartPosition(); CMapPtrToPtr::iterator End = m_pAppliedAttrs->GetEndPosition(); for(; Pos != End;) { // Get attr at CMapPtrToPtr::iterator Pos m_pAppliedAttrs->GetNextAssoc( Pos, pType, pVal ); if (pVal != NULL) delete (NodeAttribute*)pVal; } } if (m_pAppliedAttrs != NULL) { delete m_pAppliedAttrs; m_pAppliedAttrs = NULL; } } // m_bFreeAttributes should only really be set by brushing code, so unless you are a // brush you should never enter the following section if (m_bFreeAttrMapOnDestruct) { if (m_pAppliedAttrs != NULL) { delete m_pAppliedAttrs; m_pAppliedAttrs = NULL; } } if (m_pBlendNode) { m_pBlendNode->CascadeDelete(); delete m_pBlendNode; } if (m_bDeleteAll) { if (m_pPath != NULL) delete m_pPath; } }

---

Member Function Documentation

BlendPath::CC_DECLARE_MEMDUMP (  BlendPath   )  [private]

void BlendPath::CorrectDirection (  INT32  Index  )  [private]

This ensures that the path is going in the correct direction. It doesn't matter which direction, as long as the direction is the same for all blend paths. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 9/11/94 Parameters: Index  = index of the node the blend was attempted from [INPUTS] pPath  potentially reversed so it is rendered in the correct direction [OUTPUTS] Returns: - Definition at line 5042 of file nodebldr.cpp. { switch (m_PathType) { case PATHTYPE_SHAPE: { // Dummy vars for the GWinding() call UINT32 l; POINT p; // Get the direction of the path BOOL Direction = GWinding((PPOINT)m_pPath->GetCoordArray(),m_pPath->GetVerbArray(),m_pPath->GetNumCoords(),FLATNESS,l,p); // If clockwise, reverse it so it's anticlockwise (this is ArtWorks compatible!!) if (Direction) m_pPath->Reverse(); m_DirChanged = Direction; } break; case PATHTYPE_LINE: { // Get num coords INT32 NumCoords = m_pPath->GetNumCoords(); if (Index != 0 && Index != (NumCoords-1)) { // Get the coords array of the line DocCoord* pCoords = m_pPath->GetCoordArray(); // Find the coords of the two end points of the line DocCoord Coord1 = pCoords[0]; DocCoord Coord2 = pCoords[NumCoords-1]; // if the start of the line is less bottom-left than the end, reverse the line. if ((Coord1.x + Coord1.y) > (Coord2.x + Coord2.y)) { m_pPath->Reverse(); m_OrigMapping = NumCoords-1; // Pretend that user mapped to end of line } } } break; default : ERROR3("Unknown path type"); break; } }

void BlendPath::DeleteAttributeMapAndAttributes (  CCAttrMap *  pMap  )

Counterpart to MakeAttributeMap, deletes all the copied attributes and then the map. Author: Diccon_Yamanaka (Xara Group Ltd) <camelotdev@xara.com> Date: 11/9/2000 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - See also: - Definition at line 5963 of file nodebldr.cpp. { if (pMap != NULL) { pMap->DeleteAttributes(); delete pMap; pMap = NULL; } }

void BlendPath::DeleteAttributesAndPath (   )

Sets m_SubPathID to zero thus ensuring that all the attributes and the attribute map are deleted. We need to do this for blendpaths created by blending brush attributes as mentioned in the previous two functions. I don't recommend use of this function under normal circumstances. Author: Diccon_Yamanaka (Xara Group Ltd) <camelotdev@xara.com> Date: 28/3/2000 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - See also: - Definition at line 6070 of file nodebldr.cpp. { m_bDeleteAll = TRUE; }

void BlendPath::DeleteCopyPathAndAttributes (   )

Deletes the copies we made of the paths and attributes. Author: Diccon_Yamanaka (Xara Group Ltd) <camelotdev@xara.com> Date: 28/3/2000 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - See also: - Definition at line 6346 of file nodebldr.cpp. { if (m_pCopyPath != NULL) { delete m_pCopyPath; m_pCopyPath = NULL; } if (m_pCopyAttrs != NULL) { DeleteAttributeMapAndAttributes(m_pCopyAttrs); m_pCopyAttrs = NULL; } }

CCAttrMap * BlendPath::FindAppliedAttributes (   )

This calls FindAppliedAttributes() on the node that created this blend path. It will only do this if this is the first call since the last FreeAppliedAttributes() or is the first ever call (in other words, it is cached). Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 16/11/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: Ptr to the attributes applied to this blend path NULL if unable to get attributes See also: - Definition at line 5780 of file nodebldr.cpp. { if (m_pAppliedAttrs == NULL) { m_pAppliedAttrs = new CCAttrMap(30); if (m_pAppliedAttrs != NULL) { // Ilan 4/5/00 // Ensure geometry linked attributes which are applied to the entire Blend compound // aren't found if (!m_pCreatedByNode->FindAppliedAttributes(m_pAppliedAttrs,5000,NULL,TRUE)) { delete m_pAppliedAttrs; m_pAppliedAttrs = NULL; } AttrTranspFillGeometry* pTransp = NULL; m_pCreatedByNode->FindAppliedAttribute(CC_RUNTIME_CLASS(AttrTranspFillGeometry), (NodeAttribute**)&pTransp); } } return m_pAppliedAttrs; }

INT32 BlendPath::FindBottomLeft (   )

This scans the path for the bottom left most element, and returns the index to it. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 8/11/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: The index of the bottom left most element (or -1 if something when wrong) Definition at line 5274 of file nodebldr.cpp. { DocCoord* pCoords = m_pPath->GetCoordArray(); if (pCoords == NULL) return -1; INT32 BottomLeftIndex = -1; INT32 Index; BOOL ok; DocCoord VeryMostBottomLeft(0x7fffffff,0x7fffffff); double SmallestDist = 1.0e100,ThisDist; for (Index=0,ok=TRUE;ok;) { if (pCoords[Index].x < VeryMostBottomLeft.x) VeryMostBottomLeft.x = pCoords[Index].x; if (pCoords[Index].y < VeryMostBottomLeft.y) VeryMostBottomLeft.y = pCoords[Index].y; ok = m_pPath->FindNextEndPoint(&Index); } for (Index=0,ok=TRUE;ok;) { ThisDist = VeryMostBottomLeft.Distance(pCoords[Index]); if (ThisDist < SmallestDist) { BottomLeftIndex = Index; SmallestDist = ThisDist; } ok = m_pPath->FindNextEndPoint(&Index); } // return BottomLeftIndex; UINT32 u; POINT p; // Get the direction of the path GWinding((PPOINT)m_pPath->GetCoordArray(),m_pPath->GetVerbArray(),m_pPath->GetNumCoords(),FLATNESS,u,p); // TRACEUSER( "Markn", _T("\n")); INT32 GIndex=-1; DocCoord Coord(p.x,p.y); SmallestDist = 1.0e100; for (Index=0,ok=TRUE;ok;) { ThisDist = Coord.Distance(pCoords[Index]); if ((ThisDist-SmallestDist) < 5.0) { // This point is close enough, so remember it's index GIndex = Index; // Only update the smallest dist if it is indeed the smallest so far if (ThisDist < SmallestDist) SmallestDist = ThisDist; } //TRACEUSER( "Markn", _T("(%d) %f - "),Index,ThisDist); ok = m_pPath->FindNextEndPoint(&Index); } // TRACEUSER( "Markn", _T("\n")); // TRACEUSER( "Markn", _T("GIndex = %ld\n"),GIndex); // TRACEUSER( "Markn", _T("BottomLeftIndex = %ld\n"),BottomLeftIndex); // if (GIndex != BottomLeftIndex) // { // TRACEUSER( "Markn", _T("*^*^*^*^*^*^*^*^*^*^*^*^*^*^")); // } // ERROR3IF_PF(GIndex != BottomLeftIndex,("GIndex != BottomLeftIndex: GIndex = %ld, BottomLeftIndex = %ld",GIndex,BottomLeftIndex)); return GIndex; // return BottomLeftIndex; }

void BlendPath::FreeAppliedAttributes (   )

This will free any memory used to store the applied attributes of this blend path. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 16/11/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: - See also: - Definition at line 5817 of file nodebldr.cpp. { if (!m_UniqueAttrs && m_pAppliedAttrs != NULL) { delete m_pAppliedAttrs; m_pAppliedAttrs = NULL; } }

AttrBitmapFill * BlendPath::GetAppliedBitmapColourFill (   )

as above Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 16/11/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: the bitmap colour fill attribute applying to this blendpath, if there is one See also: - Definition at line 6090 of file nodebldr.cpp. { // Get our applied attribute map CCAttrMap* pAttrMap = FindAppliedAttributes(); if (pAttrMap == NULL) return NULL; // loop through the map until we find an bitmap fill CCRuntimeClass *pType; void *pVal; NodeAttribute* pNodeAttr = NULL; // iterating all (key, value) pairs for( CMapPtrToPtr::iterator Pos = pAttrMap->GetStartPosition(); Pos != pAttrMap->GetEndPosition();) { // Get attr at CMapPtrToPtr::iterator Pos pAttrMap->GetNextAssoc(Pos,pType,pVal); // pVal is actually an attribute, so get a ptr to it pNodeAttr = (NodeAttribute *)pVal; if (pNodeAttr->IsABitmapFill() &&!pNodeAttr->IsATranspFill()) break; pNodeAttr = NULL; } // first get the attribute value from the attribute node if (pNodeAttr != NULL) { return (AttrBitmapFill*)pNodeAttr; } return NULL; }

AttrBitmapFill * BlendPath::GetAppliedBitmapTranspFill (   )

as above Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 16/11/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: the bitmapfill transparent attribute applying to this blendpath, if there is one See also: - Definition at line 6142 of file nodebldr.cpp. { // Get our applied attribute map CCAttrMap* pAttrMap = FindAppliedAttributes(); if (pAttrMap == NULL) return NULL; // loop through the map until we find an bitmap fill CCRuntimeClass *pType; void *pVal; NodeAttribute* pNodeAttr = NULL; // iterating all (key, value) pairs for( CMapPtrToPtr::iterator Pos = pAttrMap->GetStartPosition(); Pos != pAttrMap->GetEndPosition();) { // Get attr at CMapPtrToPtr::iterator Pos pAttrMap->GetNextAssoc(Pos,pType,pVal); // pVal is actually an attribute, so get a ptr to it pNodeAttr = (NodeAttribute *)pVal; if (pNodeAttr->IsABitmapFill() &&pNodeAttr->IsATranspFill()) break; pNodeAttr = NULL; } // first get the attribute value from the attribute node if (pNodeAttr != NULL) { return (AttrBitmapFill*)pNodeAttr; } return NULL; }

MILLIPOINT BlendPath::GetAppliedLineWidth (   )

Returns the cached line width applying to this blendpath. Author: Diccon_Yamanaka (Xara Group Ltd) <camelotdev@xara.com> Date: 28/3/2000 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: the applied linewidth, or -1 indicating that no line width was found See also: - Definition at line 6195 of file nodebldr.cpp. { // find the line width attribute NodeAttribute* pAttr = NULL; m_pCreatedByNode->FindAppliedAttribute(CC_RUNTIME_CLASS(AttrLineWidth), &pAttr); if (pAttr != NULL) m_AppliedLineWidth = ((AttrLineWidth*)pAttr)->Value.LineWidth; return m_AppliedLineWidth; }

NodeRenderableInk* BlendPath::GetBlendNode (   )  [inline]

Definition at line 172 of file nodebldr.h. { return m_pBlendNode; }

CCAttrMap * BlendPath::GetCopyAttributes (   )

access Author: Diccon_Yamanaka (Xara Group Ltd) <camelotdev@xara.com> Date: 28/3/2000 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: the copy we made of our attribute map See also: - Definition at line 6395 of file nodebldr.cpp. { return m_pCopyAttrs; }

Path * BlendPath::GetCopyPath (   )

access Author: Diccon_Yamanaka (Xara Group Ltd) <camelotdev@xara.com> Date: 28/3/2000 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: the copy we made of our path See also: - Definition at line 6375 of file nodebldr.cpp. { return m_pCopyPath; }

NodeRenderableInk* BlendPath::GetCreatedByNode (   )  [inline]

Definition at line 174 of file nodebldr.h. { return m_pCreatedByNode; }

BOOL BlendPath::GetCreatedViaNodeBlendPath (   )  [inline]

Definition at line 221 of file nodebldr.h. { return (m_bCreatedViaNodeBlendPath); }

INT32 BlendPath::GetNumElements (   )  [inline]

Definition at line 179 of file nodebldr.h. { return m_NumElements; }

INT32 BlendPath::GetOrigMapping (   )  [inline]

Definition at line 175 of file nodebldr.h. { return m_OrigMapping; }

Path* BlendPath::GetPath (   )  [inline]

Definition at line 173 of file nodebldr.h. { return m_pPath; }

DocCoord BlendPath::GetPathCoord (  INT32  Index  )

Access to path's coord array. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 10/11/94 Parameters: Index  = index into the path's coord array of coord required [INPUTS] If index < 0 or index >= num coords in array, an value of 0 used -  [OUTPUTS] Returns: The DocCoord at index Index Definition at line 5607 of file nodebldr.cpp. { DocCoord Result(0,0); if (m_pPath != NULL) { if (m_DirChanged) m_pPath->Reverse(); DocCoord* pCoords = m_pPath->GetCoordArray(); INT32 n = m_pPath->GetNumCoords(); if (Index >= n || Index < 0) Index = 0; if (Index < n && pCoords != NULL) Result = pCoords[Index]; if (m_DirChanged) m_pPath->Reverse(); } return Result; }

PathTypeEnum BlendPath::GetPathType (   )  [inline]

Definition at line 176 of file nodebldr.h. { return m_PathType; }

UINT32 BlendPath::GetSubPathID (   )  [inline]

Definition at line 177 of file nodebldr.h. { return m_SubPathID; }

UINT32 BlendPath::GetSubPathNum (   )  [inline]

Definition at line 178 of file nodebldr.h. { return m_SubPathNum; }

BOOL BlendPath::Initialise (  BlendPath *  pBlendPath, NodeRenderableInk *  pNodeToBlend )

Inits this blend path, replacing the blend node with the one given. Author: David_McClarnon (Xara Group Ltd) <camelotdev@xara.com> Date: 6/3/2000 Parameters: pBlendPath  - the blend path to copy from [INPUTS] -  [OUTPUTS] Returns: TRUE if Successful, FALSE otherwise Definition at line 5003 of file nodebldr.cpp. { m_pPath = pBlendPath->GetPath(); pNodeToBlend->NodeCopy((Node **)(&m_pBlendNode)); m_pCreatedByNode = pBlendPath->GetCreatedByNode(); m_OrigMapping = pBlendPath->GetOrigMapping(); m_PathType = pBlendPath->GetPathType(); m_SubPathID = pBlendPath->GetSubPathID(); m_SubPathNum = pBlendPath->GetSubPathNum(); m_NumElements = pBlendPath->GetNumElements(); m_UniqueAttrs = pBlendPath->UniqueAppliedAttrs(); m_DirChanged = pBlendPath->m_DirChanged; m_BrushStartCoord = pBlendPath->m_BrushStartCoord; m_BrushCurrentCoord = pBlendPath->m_BrushCurrentCoord; if (m_pAppliedAttrs) m_pAppliedAttrs = pBlendPath->m_pAppliedAttrs->Copy(); else m_pAppliedAttrs = NULL; return TRUE; }

BOOL BlendPath::Initialise (  NodeRenderableInk *  pThisBlendNode, INT32  Index, NodeRenderableInk *  pThisCreatedByNode, UINT32  ThisSubPathID, UINT32  ThisSubPathNum, CCAttrMap *  pAttrMap, BOOL  CheckDirection = TRUE )

Inits the BlendPath object to use the given NodePath. NOTE: pThisNodePath should point to isolated instance, and not to a used NodePath linked into the tree! NOTE: Once you give a BlendPath a NodePath, this becomes property of the BlendPath and can be altered and/or deleted by the BlendPath at any time. DO NOT KEEP A COPY OF THE PTR pThisNodePath!!! If you want a copy of the NodePath at pThisNodePath, make a new copy of the node. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 12/10/94 Parameters: pThisBlendNode  = ptr to the node that this BlendPath will use (should NOT be linked in the tree) [INPUTS] Index = index to path element the path should start on (-1 means bottom left most el) pThisCreatedByNode = ptr to the node that created pThisNodePath ThisSubPathID = ID for this subpath (all blend paths generated from the same path have the same subpath ID). Must be >=1 ThisSubPathNum = The sub path number specifying which sub path of the original path this represents. The first sub path is numbered 0. pAttrMap = ptr to applied attrs (or NULL if to use attrs applied to pThisCreatedByNode) -  [OUTPUTS] Returns: TRUE if Successful, FALSE otherwise Definition at line 4894 of file nodebldr.cpp. { if (pThisBlendNode == NULL || pThisCreatedByNode == NULL) return FALSE; if (pThisBlendNode->IsNodePath()) ERROR3IF(ThisSubPathID == 0,"Invalid subpath ID"); DELPTR(m_pBlendNode); m_pBlendNode = pThisBlendNode; if (m_pBlendNode->IsNodePath()) { m_pPath = &(((NodePath *)m_pBlendNode)->InkPath); } else { // get the node to blend out of this path node & use this if (pThisBlendNode->IsCompound()) { NodeRenderableInk * pInk = ((NodeCompound *)pThisBlendNode)->GetNodeToBlend(); if (pInk) { if (pInk->IsNodePath()) { m_pPath = &(((NodePath *)pInk)->InkPath); } else { ERROR3("Node to blend isn't a node path"); } } else { ERROR3("No node to blend"); } } } m_pCreatedByNode= pThisCreatedByNode; m_SubPathID = ThisSubPathID; m_SubPathNum = ThisSubPathNum; m_pAppliedAttrs = pAttrMap; m_UniqueAttrs = (pAttrMap != NULL); if (m_pPath) { m_NumElements = m_pPath->GetNumElements(); m_PathType = m_pPath->GetPathType(); } else { m_NumElements = 0; m_PathType = PATHTYPE_SHAPE; } // If we don't have an start element index (i.e. == -1) and its a shape (not a line) // then pick the bottom left element if (m_pPath && CheckDirection) { if (Index < 0 && m_PathType == PATHTYPE_SHAPE) Index = FindBottomLeft(); ProcessVerbs(); MapPath(Index); CorrectDirection(Index); } // record the initial CMapPtrToPtr::iterator (used for loading and saving brushes so that we don't get // the control coordinates of fill attributes wrong) DocRect BRect; if (m_pPath) { BRect = m_pPath->GetBoundingRect(); } else { BRect = m_pBlendNode->GetBoundingRect(FALSE, FALSE); } m_BrushStartCoord = BRect.Centre(); return TRUE; }

BOOL BlendPath::IsFilled (   )

Find out if the path is filled. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 8/11/94 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if the associated path is filled Definition at line 5564 of file nodebldr.cpp. { if (m_pPath != NULL) return (m_pPath->IsFilled); else return FALSE; }

BOOL BlendPath::IsLine (   )  [inline]

Definition at line 183 of file nodebldr.h. { return m_PathType == PATHTYPE_LINE; }

BOOL BlendPath::IsPointOverBlob (  DocCoord *  pPointerPos, INT32 *  pIndex, Trans2DMatrix *  pMatrix )

This sees if the point given lies on a selected blob. If a match is found, the index to blob element is updated. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 10/11/94 Parameters: pPointerPos  = point to check against [INPUTS] pIndex = ptr to place to store index if match is found pMatrix = matrix to apply to the path points before testing with pointer pos *pIndex,updated  if TRUE returned, undefined otherwise [OUTPUTS] Returns: TRUE if match found, FALSE otherwise Markn 26-5-99: Modified so that if the function returns TRUE, *pPointerPos is updated so that it contains the coords of the blob it is over See also: - Definition at line 5714 of file nodebldr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) BOOL Found = FALSE; if (m_pPath != NULL && pIndex != NULL) { Path* pPath = m_pPath; if (pMatrix) { pPath = new Path; if (pPath != NULL && pPath->Initialise()) { pPath->MergeTwoPaths(*m_pPath); pMatrix->Transform((DocCoord*)(pPath->GetCoordArray()), pPath->GetNumCoords() ); } } Found = pPath->FindNearestPoint(*pPointerPos,POINTFLAG_ENDPOINTS,pIndex); if (Found) { if (m_PathType == PATHTYPE_LINE) Found = ((*pIndex == 0) || (*pIndex == (pPath->GetNumCoords()-1))); else if (m_DirChanged) { pPath->