AttrSquareFill Class Reference

Square Graduated Fill Attribute class. More...

#include <fillattr2.h>

Inheritance diagram for AttrSquareFill:

List of all members.

Public Member Functions
	AttrSquareFill ()
	AttrSquareFill (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 AttributeValue *	GetAttributeValue ()=0
virtual FillControl	TestColourDrop (AttrColourDrop *ColDrop)
	Check to see which colour will be changed if dropped at this point.
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	NeedsToRenderAtEachBrushStroke () const
	So that don't have to keep re-rendering attributes whilst drawing a brush, this identifies whether or not the attribute need to be rendered at each step, e.g. radial fills.
virtual INT32	GetNumberOfControlPoints ()
Protected Member Functions
virtual void	ValidateAttributeValue ()
	Makes sure the Coords of the Fill are sensible.

---

Detailed Description

Square Graduated Fill Attribute class.

Author:

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

Date:

9/8/96

See also:

SquareFillAttribute

Definition at line 1267 of file fillattr2.h.

---

Constructor & Destructor Documentation

AttrSquareFill::AttrSquareFill (   )  [inline]

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

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

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

---

Member Function Documentation

BOOL AttrSquareFill::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 9944 of file fillattr.cpp. { return TRUE; }

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

Implements AttrFillGeometry. Implemented in AttrSquareColourFill, and AttrSquareTranspFill.

DocRect AttrSquareFill::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 10230 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); if (DraggedFill == this) { // This fill is being dragged, so we have to include the Parallelagram // bounding rect as well DocRect StartBlobRect; DocRect EndBlobRect; DocRect DragRect = GetParallelagramBounds(StartPoint, EndPoint, EndPoint2); // Get the Bounding rect of Blobs on each of the ends (Camelot.GetBlobManager())->GetBlobRect(DragRect.lo, &StartBlobRect); (Camelot.GetBlobManager())->GetBlobRect(DragRect.hi, &EndBlobRect); // Now 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. BoundingRect.IncludePoint(StartBlobRect.lo); BoundingRect.IncludePoint(StartBlobRect.hi); BoundingRect.IncludePoint(EndBlobRect.lo); BoundingRect.IncludePoint(EndBlobRect.hi); } else { // We're not being dragged, so just calc the bounds of the Start and End Blobs DocRect StartBlobRect; DocRect EndBlobRect; DocRect End2BlobRect; // Get the Bounding rect of the Fill Line, including the Blobs on the ends (Camelot.GetBlobManager())->GetBlobRect(StartPoint, &StartBlobRect); (Camelot.GetBlobManager())->GetBlobRect(EndPoint, &EndBlobRect); (Camelot.GetBlobManager())->GetBlobRect(EndPoint2, &End2BlobRect); // Now 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. BoundingRect.IncludePoint(StartBlobRect.lo); BoundingRect.IncludePoint(StartBlobRect.hi); BoundingRect.IncludePoint(EndBlobRect.lo); BoundingRect.IncludePoint(EndBlobRect.hi); BoundingRect.IncludePoint(End2BlobRect.lo); BoundingRect.IncludePoint(End2BlobRect.hi); } IncludeArrowHead(&BoundingRect, StartPoint, EndPoint); IncludeArrowHead(&BoundingRect, StartPoint, EndPoint2); // and return it return BoundingRect; #else return DocRect(0,0,0,0); #endif }

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

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

virtual BOOL AttrSquareFill::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 1293 of file fillattr2.h. { return TRUE; }

virtual BOOL AttrSquareFill::NeedsToRenderAtEachBrushStroke (   )  const [inline, virtual]

So that don't have to keep re-rendering attributes whilst drawing a brush, this identifies whether or not the attribute need to be rendered at each step, e.g. radial fills. Author: Diccon_Yamanaka (Xara Group Ltd) <camelotdev@xara.com> Date: 29/11/99 Parameters: -  [INPUTS] -  [OUTPUTS] Returns: TRUE if this attribute should be rendered at every step of a brush stroke Errors: See Also; Brush code (ndbrshmk.cpp) Reimplemented from NodeAttribute. Definition at line 1296 of file fillattr2.h. { return TRUE;}

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

Reimplemented from AttrFillGeometry. Definition at line 10119 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 Aspect ratio can be locked either by it being circular // or 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 based on the aspect ratio DocCoord temp = MakeLineAtAngle(StartPoint, Pos, 90, INT32(StartPoint.Distance(EndPoint2) * Ratio)); SetEndPoint2(&temp); } SetEndPoint(&Pos); break; case FILLCONTROL_SECONDARYPOINT: // Someone is dragging the second End Point // Constrain the angle if necessary if (ClickMods.Constrain) DocView::ConstrainToAngle(StartPoint, &Pos); // The Aspect ratio can be locked either by it being circular // or 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 based on the aspect ratio DocCoord temp = MakeLineAtAngle(StartPoint, Pos, -90, INT32(StartPoint.Distance(EndPoint) * Ratio)); SetEndPoint(&temp); } SetEndPoint2(&Pos); break; default: // check for dragging a ramp point if (ISA_RAMPINDEX(DragControl)) { AttrFillGeometry::OnControlDrag( Pos, DragControl, ClickMods); } break; } #endif }

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

Reimplemented from AttrFillGeometry. Reimplemented in AttrSquareColourFill, and AttrSquareTranspFill. Definition at line 1285 of file fillattr2.h. {};

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

Reimplemented from AttrFillGeometry. Definition at line 9968 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) if (AllowRampRedraw == FALSE) { FillRamp *pRamp = GetFillRamp(); if (pRamp) { pRamp->RenderSelectedBlob (ATTRVALUE(), pRender); } return; } DocCoord StartPoint = ControlPoints[FILLCONTROL_STARTPOINT]; DocCoord EndPoint = ControlPoints[FILLCONTROL_ENDPOINT]; 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; } DocCoord EndPoint2 = ControlPoints[FILLCONTROL_SECONDARYPOINT]; // 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 (AllowBoundsRedraw) { // If we are being dragged then draw a Parallelgram to // show the shape of the bitmap pRender->SetLineColour(COLOUR_SELECTEDBLOB); pRender->SetFillColour(COLOUR_NONE); Path ParaPath; ParaPath.Initialise(); MakeMeshParallelagram(&ParaPath, StartPoint, EndPoint, EndPoint2); // Draw the parallelagram pRender->DrawPath(&ParaPath); } } // 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); pRender->DrawBlob(EndPoint2,BT_SELECTED); } else { // Draw Unselected Blobs pRender->SetFillColour(COLOUR_UNSELECTEDBLOB); pRender->DrawBlob(EndPoint, BT_UNSELECTED); pRender->DrawBlob(EndPoint2,BT_UNSELECTED); } // now render any ramp blobs FillRamp *pRamp = GetFillRamp(); if (pRamp) pRamp->RenderRampBlobs(ATTRVALUE(), pRender, NULL); // Put all the old attributes back pRender->RestoreContext(); #endif }

FillControl AttrSquareFill::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 9821 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; // This next bit effectively transforms the drop point into the parallelogram coord space // t & u specify the coords (i.e. EndPoint is t = 1 and u = 0 and EndPoint2 is t = 0 and u = 1 // If the absolute value of either coord is less than 0.5 then we are closer to the start point DocCoord StartPoint = *GetStartPoint(); DocCoord EndPoint = *GetEndPoint(); DocCoord EndPoint2 = *GetEndPoint2(); DocCoord P = EndPoint - StartPoint; DocCoord Q = EndPoint2 - StartPoint; DocCoord N = DropPoint - StartPoint; double px = P.x; double py = P.y; double qx = Q.x; double qy = Q.y; double nx = N.x; double ny = N.y; double den = (px * qy) - (py * qx); // Default to end point ControlHit = FILLCONTROL_ENDPOINT; // Guard against divide by zero // If this is zero it indicates that the fill is collapsed in some way // We always hit the end point because that is what is displayed if (den != 0.0) { // Calculate u double u = ((px * ny) - (py * nx)) / den; // If this is smaller than 0.5 then we need to calculate t if (fabs(u) < 0.5) { double t = 1.0; if (px != 0.0) t = (nx - (u * qx)) / px; else t = (ny - (u * qy)) / py; if (fabs(t) < 0.5) ControlHit = FILLCONTROL_STARTPOINT; } } return ControlHit; #else return FILLCONTROL_NULL; #endif }

void AttrSquareFill::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 9917 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 AttrSquareFill::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 10312 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 DocCoord temp = CentreOf(AttrBounds); SetStartPoint(&temp); // and set End Points to Middle Right, and Middle Top temp = DocCoord((*GetStartPoint()).x + (Width/2), (*GetStartPoint()).y); SetEndPoint(&temp); temp = DocCoord((*GetStartPoint()).x, (*GetStartPoint()).y + (Height/2)); SetEndPoint2(&temp); } // If the EndPoint is 'NULL' then make end points sensible if ((*GetEndPoint()) == DocCoord(0,0)) { DocCoord temp = DocCoord((*GetStartPoint()).x + (Width/2), (*GetStartPoint()).y); SetEndPoint(&temp); temp = DocCoord((*GetStartPoint()).x, (*GetStartPoint()).y + (Height/2)); SetEndPoint2(&temp); } if ((*GetEndPoint2()) == DocCoord(0,0)) { DocCoord temp = MakeLineAtAngle((*GetStartPoint()), (*GetEndPoint()), 90, Height/2); SetEndPoint2(&temp); } #endif }

---

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

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

---