AttrThreeColFill Class Reference

ThreeCol Graduated Fill Attribute class. More...

#include <fillattr2.h>

Inheritance diagram for AttrThreeColFill:

List of all members.

Public Member Functions
	AttrThreeColFill ()
	AttrThreeColFill (Node *ContextNode, AttachNodeDirection Direction, BOOL Locked=FALSE, BOOL Mangled=FALSE, BOOL Marked=FALSE, BOOL Selected=FALSE)
virtual void	Transform (TransformBase &)
	Transform a grad fill attribute by moving the start and end points.
virtual BOOL	CanTransform ()
	Indicate that this attribute can be transformed.
virtual void	RenderFillBlobs (RenderRegion *pRender)
virtual void	RenderFillMesh (RenderRegion *, DocCoord *, BOOL *, INT32 NumControlPoints=0)
virtual void	OnControlDrag (DocCoord, FillControl &, ClickModifiers)
virtual void	RenderControl (FillControl Control, BOOL RenderOn)
	Renders a specified control.
virtual void	CycleSelection (BOOL Reverse)
	Cycles the selection state of the controls.
virtual FillControl	CheckForControlHit (DocCoord &ClickPos)
	Check to see if a click was on a Fill Control Point.
virtual AttributeValue *	GetAttributeValue ()=0
virtual FillControl	TestColourDrop (AttrColourDrop *ColDrop)
	Check to see which colour will be changed if dropped at this point.
virtual void	TransformSelectedControlPoints (TransformBase &, BOOL *isARampBlob=NULL)
	Transform a grad fill attribute by moving the selected control points.
virtual BOOL	IsAGradFill () const
	Virtual function for determining if the node is an attribute.
virtual DocRect	GetBlobBoundingRect ()
	Calculates the bounding rectangle of the attrs blobs.This should always be calculated on the fly as the view scale can change without the attr knowing, giving an incorrect result.
virtual BOOL	NeedsForceToSimpleMapping ()
virtual INT32	GetNumberOfControlPoints ()
Protected Member Functions
virtual void	ValidateAttributeValue ()
	Makes sure the Coords of the Fill are sensible.

---

Detailed Description

ThreeCol Graduated Fill Attribute class.

Author:

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

Date:

18/07/94

See also:

ThreeColFillAttribute

Definition at line 1437 of file fillattr2.h.

---

Constructor & Destructor Documentation

AttrThreeColFill::AttrThreeColFill (   )  [inline]

Definition at line 1442 of file fillattr2.h. : AttrFillGeometry() {}

AttrThreeColFill::AttrThreeColFill (  Node *  ContextNode, AttachNodeDirection  Direction, BOOL  Locked = FALSE, BOOL  Mangled = FALSE, BOOL  Marked = FALSE, BOOL  Selected = FALSE )  [inline]

Definition at line 1443 of file fillattr2.h. : AttrFillGeometry(ContextNode, Direction, Locked, Mangled, Marked, Selected) {}

---

Member Function Documentation

BOOL AttrThreeColFill::CanTransform (   )  [virtual]

Indicate that this attribute can be transformed. Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 9/8/96 Returns: TRUE => transform this attribute. See also: Copied from AttrLinearFill Reimplemented from NodeRenderable. Definition at line 11205 of file fillattr.cpp. { return TRUE; }

FillControl AttrThreeColFill::CheckForControlHit (  DocCoord &  ClickPos  )  [virtual]

Check to see if a click was on a Fill Control Point. Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 14/08/96 Parameters: ClickPos,The  DocCoord position to check. [INPUTS] Returns: A FillControl, indicating the Fill Control Point Hit, or FILLCONTROL_NULL, if no points hit. See also: FillControl Reimplemented from AttrFillGeometry. Definition at line 11631 of file fillattr.cpp. { // Set up a default, that indicates not control points hit FillControl HitControl = FILLCONTROL_NULL; #if !defined(EXCLUDE_FROM_RALPH) DocRect BlobRect; if (!GetApplication()->GetBlobManager()->GetCurrentInterest().Fill || !IsVisible()) return FILLCONTROL_NULL; // Get the rectangle around the Start Control Point (Camelot.GetBlobManager())->GetBlobRect(*GetStartPoint(), &BlobRect); // See if the Click Position is within the rectangle if ( BlobRect.ContainsCoord(ClickPos) ) HitControl = FILLCONTROL_STARTPOINT; // Get the rectangle around the End Control Point (Camelot.GetBlobManager())->GetBlobRect(*GetEndPoint(), &BlobRect); // See if the Click Position is within the rectangle if ( BlobRect.ContainsCoord(ClickPos) ) HitControl = FILLCONTROL_ENDPOINT; // Get the rectangle around the Secondary Control Point (Camelot.GetBlobManager())->GetBlobRect(*GetEndPoint2(), &BlobRect); // See if the Click Position is within the rectangle if ( BlobRect.ContainsCoord(ClickPos) ) HitControl = FILLCONTROL_ENDPOINT2; #endif return HitControl; }

void AttrThreeColFill::CycleSelection (  BOOL  Reverse  )  [virtual]

Cycles the selection state of the controls. Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 14/08/96 Reimplemented from AttrFillGeometry. Definition at line 11585 of file fillattr.cpp. { if (GetSelectionCount() == 1) { if (SelectionState[FILLCONTROL_STARTPOINT]) { DeselectAll(); if (Reverse) SelectBlob(FILLCONTROL_ENDPOINT2); else SelectBlob(FILLCONTROL_ENDPOINT); } else if (SelectionState[FILLCONTROL_ENDPOINT]) { DeselectAll(); if (Reverse) SelectBlob(FILLCONTROL_STARTPOINT); else SelectBlob(FILLCONTROL_ENDPOINT2); } else if (SelectionState[FILLCONTROL_ENDPOINT2]) { DeselectAll(); if (Reverse) SelectBlob(FILLCONTROL_ENDPOINT); else SelectBlob(FILLCONTROL_STARTPOINT); } } }

virtual AttributeValue* AttrThreeColFill::GetAttributeValue (   )  [pure virtual]

Implements AttrFillGeometry. Implemented in AttrThreeColColourFill, and AttrThreeColTranspFill.

DocRect AttrThreeColFill::GetBlobBoundingRect (   )  [virtual]

Calculates the bounding rectangle of the attrs blobs.This should always be calculated on the fly as the view scale can change without the attr knowing, giving an incorrect result. Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 9/8/96 Returns: DocRect - The rectangle that contains all the nodes selection blobs. Reimplemented from AttrFillGeometry. Definition at line 11466 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) // Optimisation. If there is currently no interest in Fill Blobs // and this fill is not being Dragged (Fill blobs are turned off during // a fill drag), then we needn't bother doing anything. if ( (!GetApplication()->GetBlobManager()->GetCurrentInterest(TRUE).Fill || !IsVisible()) && DraggedFill != this ) return DocRect(0,0, 0,0); // Get the Start and End Points DocCoord StartPoint = *GetStartPoint(); DocCoord EndPoint = *GetEndPoint(); DocCoord EndPoint2 = *GetEndPoint2(); // Make a dummy bounds from just the Start Point DocRect BoundingRect(StartPoint, StartPoint); // We're not being dragged, so just calc the bounds of the Start and End Blobs DocRect BlobRect; // Get the Bounding rect of the Blob and include the Bottom Left and // Top Right of each blob in the Bounds. // We have to do it like this to make sure that the DocRect's coords // are valid. ie. The Hi's are Higher than the Lo's. (Camelot.GetBlobManager())->GetBlobRect(StartPoint, &BlobRect); BoundingRect.IncludePoint(BlobRect.lo); BoundingRect.IncludePoint(BlobRect.hi); (Camelot.GetBlobManager())->GetBlobRect(EndPoint, &BlobRect); BoundingRect.IncludePoint(BlobRect.lo); BoundingRect.IncludePoint(BlobRect.hi); (Camelot.GetBlobManager())->GetBlobRect(EndPoint2, &BlobRect); BoundingRect.IncludePoint(BlobRect.lo); BoundingRect.IncludePoint(BlobRect.hi); IncludeArrowHead(&BoundingRect, StartPoint, EndPoint); IncludeArrowHead(&BoundingRect, StartPoint, EndPoint2); // and return it return BoundingRect; #else return DocRect(0,0,0,0); #endif }

virtual INT32 AttrThreeColFill::GetNumberOfControlPoints (   )  [inline, virtual]

Reimplemented from AttrFillGeometry. Definition at line 1479 of file fillattr2.h. { return 3; }

virtual BOOL AttrThreeColFill::IsAGradFill (   )  const [inline, virtual]

Virtual function for determining if the node is an attribute. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 13/2/95 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if the node is a NodeAttribute, will return TRUE Errors: Reimplemented from NodeAttribute. Definition at line 1471 of file fillattr2.h. { return TRUE; }

virtual BOOL AttrThreeColFill::NeedsForceToSimpleMapping (   )  [inline, virtual]

Reimplemented from AttrFillGeometry. Definition at line 1475 of file fillattr2.h. { return (FALSE); }

void AttrThreeColFill::OnControlDrag (  DocCoord  , FillControl &  , ClickModifiers  )  [virtual]

Reimplemented from AttrFillGeometry. Definition at line 11365 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) // Get the current Control Positions DocCoord StartPoint = *GetStartPoint(); DocCoord EndPoint = *GetEndPoint(); DocCoord EndPoint2 = *GetEndPoint2(); INT32 dx, dy; // Which control point is being dragged ? switch (DragControl) { case FILLCONTROL_STARTPOINT: // Someone is dragging the Centre of the Fill dx = StartPoint.x - Pos.x; dy = StartPoint.y - Pos.y; // Move the other points relative EndPoint.translate(-dx, -dy); EndPoint2.translate(-dx, -dy); SetEndPoint(&EndPoint); SetEndPoint2(&EndPoint2); SetStartPoint(&Pos); break; case FILLCONTROL_ENDPOINT: // Someone is dragging the first End Point // Constrain the angle if necessary if (ClickMods.Constrain) DocView::ConstrainToAngle(StartPoint, &Pos); // The mesh can be locked as an equilateral triangle by the Shift key if (ClickMods.Adjust) { double OldLen = StartPoint.Distance(EndPoint); double NewLen = StartPoint.Distance(Pos); double Ratio = 1.0; if (OldLen == 0) Ratio = 0; else Ratio = NewLen/OldLen; // Calculate the new end point DocCoord temp = MakeLineAtAngle(StartPoint, Pos, 60, INT32(StartPoint.Distance(EndPoint2) * Ratio)); SetEndPoint2(&temp); } SetEndPoint(&Pos); break; case FILLCONTROL_ENDPOINT2: // Someone is dragging the second End Point // Constrain the angle if necessary if (ClickMods.Constrain) DocView::ConstrainToAngle(StartPoint, &Pos); // The mesh can be locked as an equilateral triangle by the Shift key if (ClickMods.Adjust) { double OldLen = StartPoint.Distance(EndPoint2); double NewLen = StartPoint.Distance(Pos); double Ratio = 1.0; if (OldLen == 0) Ratio = 0; else Ratio = NewLen/OldLen; // Calculate the new end point DocCoord temp = MakeLineAtAngle(StartPoint, Pos, -60, INT32(StartPoint.Distance(EndPoint) * Ratio)); SetEndPoint(&temp); } SetEndPoint2(&Pos); break; } #endif }

void AttrThreeColFill::RenderControl (  FillControl  Control, BOOL  RenderOn )  [virtual]

Renders a specified control. Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 14/08/96 Parameters: Control,the  control to render [INPUTS] RenderOn, TRUE if rendering blob on FALSE if off See also: FillControl Reimplemented from AttrFillGeometry. Definition at line 11526 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) DocRect ControlRect; // Ignore if we're not in the tree yet // We may be a tempory clone, or something NodeRenderable* pParent = (NodeRenderable*)FindParent(); if (pParent == NULL) return; if (IsBlobSame(Control)) return; // Ignore if same as the last blob rendered Spread* pSpread = this->FindParentSpread(); switch (Control) { case FILLCONTROL_STARTPOINT: if (GetStartPoint() != NULL) { // Redraw the Start Point Blob (Camelot.GetBlobManager())->GetBlobRect(*GetStartPoint(), &ControlRect); RenderFillControl(RenderOn, &ControlRect, pSpread, pParent); } break; case FILLCONTROL_ENDPOINT: if (GetEndPoint() != NULL) { // Redraw BOTH End Point Blobs (Camelot.GetBlobManager())->GetBlobRect(*GetEndPoint(), &ControlRect); RenderFillControl(RenderOn, &ControlRect, pSpread, pParent); } break; case FILLCONTROL_ENDPOINT2: if (GetEndPoint2() != NULL) { (Camelot.GetBlobManager())->GetBlobRect(*GetEndPoint2(), &ControlRect); RenderFillControl(RenderOn, &ControlRect, pSpread, pParent); } break; } #endif }

virtual void AttrThreeColFill::RenderFillBlobs (  RenderRegion *  pRender  )  [inline, virtual]

Reimplemented from AttrFillGeometry. Reimplemented in AttrThreeColColourFill, and AttrThreeColTranspFill. Definition at line 1455 of file fillattr2.h. {};

void AttrThreeColFill::RenderFillMesh (  RenderRegion *  , DocCoord *  , BOOL *  , INT32  NumControlPoints = 0 )  [virtual]

Reimplemented from AttrFillGeometry. Definition at line 11229 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) DocCoord StartPoint = ControlPoints[FILLCONTROL_STARTPOINT]; DocCoord EndPoint = ControlPoints[FILLCONTROL_ENDPOINT]; DocCoord EndPoint2 = ControlPoints[FILLCONTROL_ENDPOINT2]; if (StartPoint == EndPoint) return; if (SelState == NULL) { // If no selection state passed in, then assume // all the points are deselected BOOL Selected[NUMCONTROLPOINTS]; for (INT32 i=0; i< NumControlPoints; i++) { Selected[i] = FALSE; } SelState = Selected; } // Remember what attributes were here before pRender->SaveContext(); // Get the current blob size in Doc Units INT32 BlobSize = (Camelot.GetBlobManager())->GetBlobSize(); // Calculate the Arrow on the End of the Line Path ArrowPath; ArrowPath.Initialise(); DocCoord LineEnd; MakeMeshArrow(&ArrowPath, StartPoint, EndPoint, &LineEnd); // Calculate the Arrow on the End of the Line2 Path ArrowPath2; ArrowPath2.Initialise(); DocCoord LineEnd2; MakeMeshArrow(&ArrowPath2, StartPoint, EndPoint2, &LineEnd2); // Set the line colours etc as we need them pRender->SetLineWidth(0); pRender->SetLineColour(COLOUR_UNSELECTEDBLOB); pRender->SetFillColour(COLOUR_UNSELECTEDBLOB); // First Draw the Line pRender->SetLineWidth(BlobSize/4); pRender->DrawLine(StartPoint, LineEnd); // Draw the secondary line pRender->DrawLine(StartPoint, LineEnd2); // Render an Arrow at the end of the line pRender->SetLineWidth(0); pRender->SetLineColour(COLOUR_NONE); pRender->DrawPath(&ArrowPath); // and on the end of the secondary line pRender->DrawPath(&ArrowPath2); if (DraggedFill == this) { // If we are being dragged then draw a line accros the end of the triangle pRender->SetLineColour(COLOUR_SELECTEDBLOB); pRender->SetFillColour(COLOUR_NONE); pRender->DrawLine(EndPoint, EndPoint2); } // Now Render the blobs on the path // Set the line colour to none pRender->SetLineColour(COLOUR_NONE); // Draw a blob at the start point if (SelState[FILLCONTROL_STARTPOINT]) { // Draw Selected Blob pRender->SetFillColour(COLOUR_SELECTEDBLOB); pRender->DrawBlob(StartPoint, BT_SELECTED); } else { // Draw Unselected Blob pRender->SetFillColour(COLOUR_UNSELECTEDBLOB); pRender->DrawBlob(StartPoint, BT_UNSELECTED); } // Draw the blobs at the end points if (SelState[FILLCONTROL_ENDPOINT]) { // Draw Selected Blobs pRender->SetFillColour(COLOUR_SELECTEDBLOB); pRender->DrawBlob(EndPoint, BT_SELECTED); } else { // Draw Unselected Blobs pRender->SetFillColour(COLOUR_UNSELECTEDBLOB); pRender->DrawBlob(EndPoint, BT_UNSELECTED); } // Draw the blobs at the second end point if (SelState[FILLCONTROL_ENDPOINT2]) { // Draw Selected Blobs pRender->SetFillColour(COLOUR_SELECTEDBLOB); pRender->DrawBlob(EndPoint2,BT_SELECTED); } else { // Draw Unselected Blobs pRender->SetFillColour(COLOUR_UNSELECTEDBLOB); pRender->DrawBlob(EndPoint2,BT_UNSELECTED); } // Put all the old attributes back pRender->RestoreContext(); #endif }

FillControl AttrThreeColFill::TestColourDrop (  AttrColourDrop *  ColDrop  )  [virtual]

Check to see which colour will be changed if dropped at this point. Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 9/8/96 Parameters: ColDrop  - pointer to the [INPUTS] Reimplemented from AttrFillGeometry. Definition at line 11106 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) // So, where was it dropped (or where will it be dropped) DocCoord DropPoint = ColDrop->GetDropPoint(); // Look to see if the DropPoint is over any of the Fill Control Points FillControl ControlHit = CheckForControlHit(DropPoint); // If it hit one of our control points, then use that if (ControlHit != FILLCONTROL_NULL) return ControlHit; // It didn't hit any of our control points, so if the drop is over // the object then we'll make a guess as to which control point // the user would like to change, depending on which area of the // object the pointer is over. // First make sure we're actually over an object NodeRenderableInk* pParentObject = ColDrop->GetObjectDroppedOn(); if (pParentObject == NULL) return FILLCONTROL_NULL; // We're not over any object // Make sure this fill type has some Control Points if (GetStartPoint() == NULL || GetEndPoint() == NULL || GetEndPoint2() == NULL) return FILLCONTROL_NULL; DocCoord StartPoint = *GetStartPoint(); DocCoord EndPoint = *GetEndPoint(); DocCoord EndPoint2 = *GetEndPoint2(); double StartDist = DropPoint.Distance(StartPoint); double EndDist = DropPoint.Distance(EndPoint); double End2Dist = DropPoint.Distance(EndPoint2); // FInd which point is closest if (StartDist < End2Dist) { if (StartDist < EndDist) ControlHit = FILLCONTROL_STARTPOINT; else ControlHit = FILLCONTROL_ENDPOINT; } else { if (EndDist < End2Dist) ControlHit = FILLCONTROL_ENDPOINT; else ControlHit = FILLCONTROL_ENDPOINT2; } return ControlHit; #else return FILLCONTROL_NULL; #endif }

void AttrThreeColFill::Transform (  TransformBase &  Trans  )  [virtual]

Transform a grad fill attribute by moving the start and end points. Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 9/8/96 Parameters: Trans  - the transform object to apply to this attribute. [INPUTS] See also: Copied from AttrLinearFill Reimplemented from NodeRenderable. Definition at line 11178 of file fillattr.cpp. { if ( Trans.TransFills ) { Trans.Transform( GetStartPoint(), 1); Trans.Transform( GetEndPoint(), 1); Trans.Transform( GetEndPoint2(), 1); if (IsPerspective()) Trans.Transform( GetEndPoint3(), 1); } }

void AttrThreeColFill::TransformSelectedControlPoints (  TransformBase &  Trans, BOOL *  isARampBlob = NULL )  [virtual]

Transform a grad fill attribute by moving the selected control points. Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 28/8/96 Parameters: Trans  - the transform object to apply to this attribute. [INPUTS] See also: NodeRenderable::Transform Reimplemented from AttrFillGeometry. Definition at line 11049 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) if ( Trans.TransFills ) { ClickModifiers ClickMods; ClickMods.Adjust = FALSE; // Force adjust off // If the start point is selected then move the whole mesh if (IsSelected(FILLCONTROL_STARTPOINT)) { DocCoord Pos = *GetStartPoint(); Trans.Transform( &Pos, 1); FillControl Start = FILLCONTROL_STARTPOINT; OnControlDrag(Pos, Start, ClickMods); } else { // Otherwise move the fill points if (IsSelected(FILLCONTROL_ENDPOINT)) { DocCoord Pos = *GetEndPoint(); Trans.Transform( &Pos, 1); FillControl End = FILLCONTROL_ENDPOINT; OnControlDrag(Pos, End, ClickMods); } if (IsSelected(FILLCONTROL_ENDPOINT2)) { DocCoord Pos = *GetEndPoint2(); Trans.Transform( &Pos, 1); FillControl End2 = FILLCONTROL_ENDPOINT2; OnControlDrag(Pos, End2, ClickMods); } } } #endif }

void AttrThreeColFill::ValidateAttributeValue (   )  [protected, virtual]

Makes sure the Coords of the Fill are sensible. Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 9/8/96 Reimplemented from AttrFillGeometry. Definition at line 11676 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) if ((*GetStartPoint()) != DocCoord(0,0) && (*GetEndPoint()) != DocCoord(0,0)) { // If the EndPoint2 is 'NULL' then make it sensible if (*GetEndPoint2() == DocCoord(0,0)) { DocCoord temp = MakeLineAtAngle((*GetStartPoint()), (*GetEndPoint()), 90); SetEndPoint2(&temp); } return; } // Make up some sensible defaults DocRect AttrBounds = DocRect(0,0,0,0); INT32 Width = DEFAULT_FILLWIDTH; INT32 Height = DEFAULT_FILLHEIGHT; // Are we an Orphan ? if (FindParent() != NULL) { // Nope, so we can use Daddies Bounding Box SelRange* Selected = GetApplication()->FindSelection(); if (Selected == NULL || Selected->Count() <= 1) AttrBounds = ((NodeRenderableBounded*)FindParent())->GetBoundingRect(TRUE); else AttrBounds = Selected->GetBoundingRect(); Width = AttrBounds.Width(); Height = AttrBounds.Height(); } // If the StartPoint is 'NULL' then make all points sensible if ((*GetStartPoint()) == DocCoord(0,0)) { // Start in the centre of the bounds SetStartPoint(&AttrBounds.lo); // and set End Points to Middle Right, and Middle Top DocCoord temp = DocCoord(AttrBounds.hi.x, AttrBounds.lo.y); SetEndPoint(&temp); temp = DocCoord(AttrBounds.lo.x, AttrBounds.hi.y); SetEndPoint2(&temp); } // If the EndPoint is 'NULL' then make it sensible if ((*GetEndPoint()) == DocCoord(0,0)) { DocCoord temp = DocCoord(AttrBounds.hi.x, AttrBounds.lo.y); SetEndPoint(&temp); } if ((*GetEndPoint2()) == DocCoord(0,0)) { DocCoord temp = DocCoord(AttrBounds.lo.x, AttrBounds.hi.y); SetEndPoint2(&temp); } #endif }

---

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

• Kernel/fillattr2.h (r1785/r1708)
• Kernel/fillattr.cpp (r1785/r1771)

---