OpNodePathEditControlBlob Class Reference

This operation is started by the NodePath when it receives a drag message from one of the tools. It uses it to drag one of the paths Bezier control points around the screen to edit the path. As the control points are dragged about the new version of the path, corosponding to the new blob positions, will be EOR rendered to the window. This class is derived from OpNodePathEditBlob which drags the normal selected points around. This drags the Bezier control points around of one of the selected points on the curve. Most of the functions are not needed as it uses the base class versions. More...

#include <pathedit.h>

Inheritance diagram for OpNodePathEditControlBlob:

List of all members.

Public Member Functions
	OpNodePathEditControlBlob ()
void	DoStartDragEdit (NodePath *, DocCoord Anchor, Spread *pSpread, INT32)
	This is called when a Drag operation has been started on a control point of a path.
virtual void	DragPointerMove (DocCoord PointerPos, ClickModifiers ClickMods, Spread *, BOOL bSolidDrag)
	This is called every time the mouse moves, during a drag.
virtual void	RenderDragBlobs (DocRect, Spread *, BOOL bSolidDrag)
	Renders the new version of the path to the window. It calls to the base class function to render the path, then renders some blobs itself.
Static Public Member Functions
static BOOL	Init ()
	Adds the operation to the list of all known operations.
static OpState	GetState (String_256 *Description, OpDescriptor *)
	Find out the state of the operation at the specific time.
Protected Member Functions
BOOL	BuildEditPath ()
	Builds a copy of the path that we can edit, without destroying the original data. Also sets the NeedToRenderFlags for the EOR rendering during the drag. The parts of the path need to be rendered during the drag are the segment that contains this control point and the segment with the opposite control point if the rotate flag is set on the endpoint.
void	RecalculatePath (DocCoord Offset)
	Will move the control point in question and then re-calculate the whole path setting the redraw flag where needed.
virtual void	RenderDraggingBlobs (DocRect, Spread *)
	Call this function to render all the blobs on screen from this operation.
void	RenderPathEditControlBlobs (DocRect Rect, Spread *pSpread)
	Renders the new version of the path to the window. It calls to the base class function to render the path, then renders some blobs itself.
void	SetStatusLineHelp ()
	Updates the status line message to reflect the current situation.
Protected Attributes
INT32	Index
INT32	EndPointIndex
INT32	OppositeIndex

---

Detailed Description

This operation is started by the NodePath when it receives a drag message from one of the tools. It uses it to drag one of the paths Bezier control points around the screen to edit the path. As the control points are dragged about the new version of the path, corosponding to the new blob positions, will be EOR rendered to the window. This class is derived from OpNodePathEditBlob which drags the normal selected points around. This drags the Bezier control points around of one of the selected points on the curve. Most of the functions are not needed as it uses the base class versions.

Author:

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

Date:

1/7/93

Definition at line 270 of file pathedit.h.

---

Constructor & Destructor Documentation

OpNodePathEditControlBlob::OpNodePathEditControlBlob (   )  [inline]

Definition at line 277 of file pathedit.h. : OpNodePathEditBlob() { };

---

Member Function Documentation

BOOL OpNodePathEditControlBlob::BuildEditPath (   )  [protected]

Builds a copy of the path that we can edit, without destroying the original data. Also sets the NeedToRenderFlags for the EOR rendering during the drag. The parts of the path need to be rendered during the drag are the segment that contains this control point and the segment with the opposite control point if the rotate flag is set on the endpoint. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> - later attacked by Peter Date: 17/02/94 Returns: TRUE if it managed to build the path, FALSE if it failed Errors: If it runs out of memory then it will return FALSE Reimplemented from OpNodePathEditBlob. Definition at line 3584 of file pathedit.cpp. { // Make a copy of the original path and clear its need to render flags const INT32 NumCoords = OriginalPath->InkPath.GetNumCoords(); if (!EditPath.Initialise(NumCoords, 24)) return FALSE; if (!EditPath.CopyPathDataFrom(&(OriginalPath->InkPath))) return FALSE; EditPath.ClearNeedToRender(); PathFlags* Flags = EditPath.GetFlagArray(); // Set the render flag on the endpoint after the dragged control point so that segment renders if (Flags[Index-1].IsEndPoint) Flags[Index+2].NeedToRender = TRUE; else Flags[Index+1].NeedToRender = TRUE; // Now do the same for the opposite control point, if the Rotate flag is set on the endpoint if (Flags[EndPointIndex].IsRotate && OppositeIndex>=0 && OppositeIndex<NumCoords) { if (Flags[OppositeIndex-1].IsEndPoint) Flags[OppositeIndex+2].NeedToRender = TRUE; else Flags[OppositeIndex+1].NeedToRender = TRUE; } // Set the endpoints smooth flag to FALSE Flags[EndPointIndex].IsSmooth = FALSE; return TRUE; }

void OpNodePathEditControlBlob::DoStartDragEdit (  NodePath *  OrigPath, DocCoord  Anchor, Spread *  pSpread, INT32  ControlIndex )

This is called when a Drag operation has been started on a control point of a path. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 5/7/93 Parameters: OrigPath  - The original Node path object [INPUTS] Anchor - The position of the mouse at the start of the Drag pSpread - the spread that the drag started on ControlIndex - The Coord number of the control point that we are dragging Definition at line 3403 of file pathedit.cpp. { // We had better take a note of the starting point of the drag LastMousePos = Anchor; StartMousePos = Anchor; StartSpread = pSpread; OriginalPath = OrigPath; Index = ControlIndex; BOOL ok = TRUE; PathFlags* Flags = OrigPath->InkPath.GetFlagArray(); PathVerb* Verbs = OrigPath->InkPath.GetVerbArray(); DocCoord* Coords = OrigPath->InkPath.GetCoordArray(); // Find the index of the end point that this control point is attached to if (Flags[Index-1].IsEndPoint) EndPointIndex = Index-1; else EndPointIndex = Index+1; ConstrainPoint = Coords[EndPointIndex]; ConstrainPrevPoint = ConstrainPoint; ConstrainNextPoint = ConstrainPoint; // Find the opposite index OppositeIndex = OrigPath->InkPath.FindOppositeControlPoint(Index); // We also need to make a version of the path that we can change if (ok) ok = BuildEditPath(); // Create and send a change message about this path edit if (ok) ok = EditObjChange.ObjChangeStarting(OrigPath,this,&EditPath,StartSpread,TRUE) == CC_OK; if (ok) ok = CreateCursors(); if (ok) ChangeCursor(pCrossHairCursor); // Since we're editing control points, we have to clear the IsSmooth flags on this, // the adjacent point and the endpoint if (ok) { Flags = EditPath.GetFlagArray(); Verbs = EditPath.GetVerbArray(); Flags[ControlIndex].IsSmooth = FALSE; if (OppositeIndex >= 0) Flags[OppositeIndex].IsSmooth = FALSE; Flags[EndPointIndex].IsSmooth = FALSE; } // Render the bits of the path that are different if (ok) { DocRect EditPathBBox = EditPath.GetBoundingRect(); RenderPathEditControlBlobs(EditPathBBox, pSpread); DragStarted = TRUE; // And tell the Dragging system that we need drags to happen ok = StartDrag(DRAGTYPE_AUTOSCROLL, &EditPathBBox, &LastMousePos); } if (!ok) { InformError(); FailAndExecute(); End(); } }

void OpNodePathEditControlBlob::DragPointerMove (  DocCoord  PointerPos, ClickModifiers  ClickMods, Spread *  pSpread, BOOL  bSolidDrag )  [virtual]

This is called every time the mouse moves, during a drag. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 5/7/93 Parameters: PointerPos  - The current position of the mouse in Doc Coords [INPUTS] ClickMods - Which key modifiers are being pressed pSpread - the spread that the cursor is over now See also: ClickModifiers Reimplemented from OpNodePathEditBlob. Definition at line 3493 of file pathedit.cpp. { EndSnapped = FALSE; // Always false in this operation // If drag has moved onto a different spread, convert the coord to be relative to the // original spread. if (pSpread != StartSpread) PointerPos = MakeRelativeToSpread(StartSpread, pSpread, PointerPos); Path TempPath; // inform the parent a change is happening if (EditObjChange.ChangeMask.EorBlobs) { ChangeCode Chge=EditObjChange.RenderCurrentBlobs(OriginalPath,this,&EditPath,StartSpread,TRUE); if (Chge!=CC_OK) return; // Create a local copy of the edit path if (!TempPath.Initialise(EditPath.GetNumCoords(), 12)) return; TempPath.CopyPathDataFrom(&EditPath); } // Optionally constrain the new position ERROR3IF(ConstrainPoint == DocCoord(-1,-1),"ConstrainPoint wasn't set"); if (ClickMods.Constrain) DocView::ConstrainToAngle(ConstrainPoint, &PointerPos); DocView::SnapCurrent(StartSpread, &PointerPos); // Rub out the old EORed version of the path RenderPathEditControlBlobs( EditPath.GetBoundingRect(), StartSpread ); // This is the bit where we go off and re-calculate the paths position, // based on how much the mouse has moved DocCoord Offset; Offset.x = PointerPos.x - LastMousePos.x; Offset.y = PointerPos.y - LastMousePos.y; RecalculatePath( Offset ); if (EditObjChange.ChangeMask.EorBlobs) { ChangeCode Chge=EditObjChange.RenderChangedBlobs(OriginalPath,this,&EditPath,StartSpread,TRUE); if (Chge!=CC_OK) { // replace the old edit path EditPath.CopyPathDataFrom(&TempPath); RenderPathEditControlBlobs( EditPath.GetBoundingRect(), StartSpread ); return; } } // Update the last mouse position and draw in the new version of the path LastMousePos = PointerPos; RenderPathEditControlBlobs( EditPath.GetBoundingRect(), StartSpread ); // Now we want to update the Line tool infobar if the position of control point being // dragged is being shown. PathFlags* Flags = EditPath.GetFlagArray(); // DocCoord* Coords = EditPath.GetCoordArray(); INT32 CurrentIndex; if (Flags[Index+1].IsEndPoint) { CurrentIndex = Index+1; } else { CurrentIndex = Index-1; } // We'll broadcast a message about the edit, thus hopping over the kernel/tool DLL boundary BROADCAST_TO_ALL(PathEditedMsg(&EditPath, pSpread, CurrentIndex)); SetStatusLineHelp(); }

OpState OpNodePathEditControlBlob::GetState (  String_256 *  Description, OpDescriptor *  )  [static]

Find out the state of the operation at the specific time. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 5/7/93 Parameters: Description  - GetState fills this string with an approriate description [OUTPUTS] of the current state of the selector tool Returns: The state of the operation, so that menu items (ticks and greying can be done properly Reimplemented from OpNodePathEditBlob. Definition at line 3777 of file pathedit.cpp. { OpState Blobby; return Blobby; }

BOOL OpNodePathEditControlBlob::Init (  void   )  [static]

Adds the operation to the list of all known operations. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 5/7/93 Returns: TRUE if all went OK, False otherwise Reimplemented from OpNodePathEditBlob. Definition at line 3748 of file pathedit.cpp. { PORTNOTETRACE("other","OpNodePathEditControlBlob::Init - do nothing"); return (RegisterOpDescriptor( 0, _R(IDS_NODEPATH_EDIT), CC_RUNTIME_CLASS(OpNodePathEditControlBlob), OPTOKEN_NODEPATH, OpNodePathEditControlBlob::GetState, 0, // help ID _R(IDBBL_NODEPATHOP), 0 ) ); // bitmap ID }

void OpNodePathEditControlBlob::RecalculatePath (  DocCoord  Offset  )  [protected]

Will move the control point in question and then re-calculate the whole path setting the redraw flag where needed. Author: Rik_Heywood (Xara Group Ltd) <camelotdev@xara.com> Date: 9/11/93 Parameters: Offset  - The Amount to move the selected blobs by before re-calcing everything [INPUTS] Scope: Private Definition at line 3632 of file pathedit.cpp. { // Find the coords in the path DocCoord* Coords = EditPath.GetCoordArray(); PathFlags* Flags = EditPath.GetFlagArray(); INT32 NumCoords = EditPath.GetNumCoords(); if (Flags[EndPointIndex].IsRotate && OppositeIndex >=0 && OppositeIndex < NumCoords) { EditPath.CalcRotate(Coords[EndPointIndex], &Coords[Index], &Coords[OppositeIndex], Offset); } else { Coords[Index].x += Offset.x; Coords[Index].y += Offset.y; } }

void OpNodePathEditControlBlob::RenderDragBlobs (  DocRect  Rect, Spread *  pSpread, BOOL  bSolidDrag )  [virtual]

Renders the new version of the path to the window. It calls to the base class function to render the path, then renders some blobs itself. Author: Jim_Lynn (Xara Group Ltd) <camelotdev@xara.com> Date: 25/8/94 Reimplemented from OpNodePathEditBlob. Definition at line 3661 of file pathedit.cpp. { // Don't render anything if the last mouse position is the same as the start point if (LastMousePos == StartMousePos) return; // Now render the current edit path RenderPathEditControlBlobs(Rect,pSpread); // And report the change to our parents. if (EditObjChange.ChangeMask.EorBlobs) EditObjChange.RenderCurrentBlobs(OriginalPath,this,&EditPath,StartSpread,TRUE); }

void OpNodePathEditControlBlob::RenderDraggingBlobs (  DocRect  Rect, Spread *  pSpread )  [protected, virtual]

Call this function to render all the blobs on screen from this operation. Author: Peter_Arnold (Xara Group Ltd) <camelotdev@xara.com> Date: 1/5/95 Reimplemented from OpNodePathEditBlob. Definition at line 3683 of file pathedit.cpp. { RenderPathEditControlBlobs(Rect, pSpread); }

void OpNodePathEditControlBlob::RenderPathEditControlBlobs (  DocRect  Rect, Spread *  pSpread )  [protected]

Renders the new version of the path to the window. It calls to the base class function to render the path, then renders some blobs itself. Author: Mike_Kenny (Xara Group Ltd) <camelotdev@xara.com> Date: 16/01/95 Parameters: Rect  = a doc rect rectangle [INPUTS] pSpread = a pointer to a spread to render into Definition at line 3703 of file pathedit.cpp. { if (LastMousePos == StartMousePos) return; DocCoord* Coords = EditPath.GetCoordArray(); PathFlags* Flags = EditPath.GetFlagArray(); // PathVerb* Verbs = EditPath.GetVerbArray(); INT32 NumCoords = EditPath.GetNumCoords(); // BOOL PrevIsEndPoint; DocCoord StartCoord = Coords[0]; // And this bit actually draws the path we have just made RenderRegion* pRegion = DocView::RenderOnTop( NULL, StartSpread, ClippedEOR ); while ( pRegion ) { OpNodePathEditBlob::RenderPathEditBlobs(Rect, pSpread); EditPath.DrawControlBlob(pRegion, Coords[Index]); EditPath.DrawControlLine(pRegion, Coords[Index], Coords[EndPointIndex]); if (Flags[EndPointIndex].IsRotate && OppositeIndex>=0 && OppositeIndex<NumCoords && Flags[Index].IsSelected) { EditPath.DrawControlBlob(pRegion, Coords[OppositeIndex]); EditPath.DrawControlLine(pRegion, Coords[OppositeIndex], Coords[EndPointIndex]); } // Get the Next render region pRegion = DocView::GetNextOnTop( &Rect ); } }

void OpNodePathEditControlBlob::SetStatusLineHelp (   )  [protected, virtual]

Updates the status line message to reflect the current situation. Author: Peter_Arnold (Xara Group Ltd) <camelotdev@xara.com> Date: 4/1/96 Reimplemented from OpNodePathEditBlob. Definition at line 3793 of file pathedit.cpp. { String_256 HelpString(_R(IDS_PATHDRAGFINISHCONTROL)); GetApplication()->UpdateStatusBarText(&HelpString, FALSE); }

---

Member Data Documentation

INT32 OpNodePathEditControlBlob::EndPointIndex [protected]

Definition at line 300 of file pathedit.h.

INT32 OpNodePathEditControlBlob::Index [protected]

Definition at line 299 of file pathedit.h.

INT32 OpNodePathEditControlBlob::OppositeIndex [protected]

Definition at line 301 of file pathedit.h.

---

The documentation for this class was generated from the following files:

• Kernel/pathedit.h (r1785/r1282)
• Kernel/pathedit.cpp (r1785/r1282)

---