AttrBitmapFill Class Reference

Bitmap Fill Attribute class. More...

#include <fillattr2.h>

Inheritance diagram for AttrBitmapFill:

List of all members.

Public Member Functions
	AttrBitmapFill ()
	AttrBitmapFill (Node *ContextNode, AttachNodeDirection Direction, BOOL Locked=FALSE, BOOL Mangled=FALSE, BOOL Marked=FALSE, BOOL Selected=FALSE)
virtual void	Transform (TransformBase &)
	Changes the Dpi of this bitmap by scaling the fill control points.Transform a grad fill attribute by moving the start and end points.
virtual BOOL	CanTransform ()
	Indicate that this attribute can be transformed.
virtual void	TransformSelectedControlPoints (TransformBase &, BOOL *isARampBlob=NULL)
	Transform a grad fill attribute by moving the selected control points.
virtual AttributeValue *	GetAttributeValue ()=0
virtual void	RenderFillBlobs (RenderRegion *pRender)
virtual void	RenderFillMesh (RenderRegion *, DocCoord *, BOOL *, INT32 NumControlPoints=0)
virtual void	OnControlDrag (DocCoord, FillControl &, ClickModifiers)
virtual void	SetAspectRatio (double Ratio)
virtual void	DrawEndBlobs ()
	Draws the blobs on the ends of the fill arrows.
virtual FillControl	CheckForControlHit (DocCoord &)
	Check to see if a click was on a Fill Control Point.
virtual BOOL	ChangeControlTransp (AttrTranspChange *)
	Applies a colour to selected Fill Control Points.
virtual BOOL	ChangeControlColour (AttrColourChange *)
	Applies a colour to selected Fill Control Points.
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	HidingNode ()
	This virtual function is called whenever the node is hidden. It allows the node do things like 'optimise' itself to use less memory or send a message to let others know it is being hidden etc.
virtual BOOL	ShowingNode ()
	This virtual function is called whenever the node is re-shown after being Hidden. It allows the node to reconstruct itself if it was optimised or send a message to let others know it is back etc.
virtual FillControl	TestColourDrop (AttrColourDrop *)
	Check to see which colour will be changed if dropped at this point.
virtual BOOL	IsABitmapFill () const
	Virtual function for determining if the node is an attribute.
virtual BOOL	IsAGradFill () const
	Virtual function for determining if the node is an attribute.
virtual KernelBitmap *	EnumerateBitmaps (UINT32 Count)
	Find out what bitmaps, if any, are used by this node.
virtual double	GetEffectiveBitmapMinDPI (KernelBitmap *pBitmap)
	Returns the minimum effective dpi this bitmap is used at.
virtual BOOL	ReplaceBitmap (KernelBitmap *pOrigBitmap, KernelBitmap *pNewBitmap)
virtual BOOL	NeedsForceToSimpleMapping ()
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 BOOL	IsTypeExtendible () const
virtual DocRect	ValidateExtend (const ExtendParams &ExtParams)
	Determine whether applying an extend to this Node is a reversible process.
virtual void	Extend (const ExtendParams &ExtParams)
	Perform an extend operation on this fill node.
virtual void	TransformTranslateObject (const ExtendParams &ExtParams)
	Translate this bitmap fill, according to the offsets and flags defined in ExtParams, and a reference centre, defined by NodeRenderable::FindExtendCentre(). This function does nothing unless ExtParams uses X_EXTEND or Y_EXTEND.
virtual INT32	GetNumberOfControlPoints ()
virtual NodeAttribute *	GetOtherAttrToApply (BOOL *IsMutate)
	Some attributes require a secondary atribute to be changed when they are changed. This routine obtains a pointer to the secondary attribute to apply.
Protected Member Functions
virtual void	ValidateAttributeValue ()
	Makes sure the Coords of the Fill are sensible. Defaults to natural size of the bitmap.
BOOL	CopyNodeContents (AttrBitmapFill *NodeCopy)
	This method copies the node's contents to the node pointed to by NodeCopy.

---

Detailed Description

Bitmap Fill Attribute class.

Author:

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

Date:

8/8/94

See also:

BitmapFillAttribute

Definition at line 1804 of file fillattr2.h.

---

Constructor & Destructor Documentation

AttrBitmapFill::AttrBitmapFill (   )  [inline]

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

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

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

---

Member Function Documentation

BOOL AttrBitmapFill::CanTransform (   )  [virtual]

Indicate that this attribute can be transformed. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 23/8/94 Returns: TRUE => transform this attribute. See also: NodeRenderable::CanTransform Reimplemented from NodeRenderable. Reimplemented in AttrFractalFill. Definition at line 13997 of file fillattr.cpp. { return TRUE; }

virtual BOOL AttrBitmapFill::ChangeControlColour (  AttrColourChange *   )  [inline, virtual]

Applies a colour to selected Fill Control Points. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 2/9/94 Parameters: NewColour,the  colour that selected control points should change to. [INPUTS] Returns: TRUE if a control point was selected, and the colour applied. See also: AttrFillGeometry::Mutate Reimplemented from AttrFillGeometry. Reimplemented in AttrBitmapColourFill, and AttrTextureColourFill. Definition at line 1835 of file fillattr2.h. { return FALSE; }

virtual BOOL AttrBitmapFill::ChangeControlTransp (  AttrTranspChange *   )  [inline, virtual]

Applies a colour to selected Fill Control Points. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 2/9/94 Parameters: NewColour,the  colour that selected control points should change to. [INPUTS] Returns: TRUE if a control point was selected, and the colour applied. See also: AttrFillGeometry::Mutate Reimplemented from AttrFillGeometry. Reimplemented in AttrBitmapTranspFill, and AttrTextureTranspFill. Definition at line 1834 of file fillattr2.h. { return FALSE; }

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

Check to see if a click was on a Fill Control Point. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 21/07/94 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. Reimplemented in AttrTextureColourFill, and AttrTextureTranspFill. Definition at line 14041 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) if (!GetApplication()->GetBlobManager()->GetCurrentInterest().Fill || !IsVisible()) return FILLCONTROL_NULL; // Set up a default, that indicates not control points hit FillControl HitControl = FILLCONTROL_NULL; DocRect BlobRect; DocCoord StartPoint = *GetStartPoint(); DocCoord EndPoint = *GetEndPoint(); DocCoord EndPoint2 = *GetEndPoint2(); // Bodge Alert !! // Bitmap fills have a complicated control point system. // The actual control points needed for rendering are the Bottom Left, // Top Left, and Bottom Right points of the bitmap. But on screen the // points seen and moved are the Centre, Middle Right, and Middle Top. // So we need to convert the click points into vitual points before // we do the hit test. DocCoord CentrePoint; DocCoord Drag2Blob; DocCoord Drag3Blob; GetBitmapVirtualPoints(StartPoint, EndPoint, EndPoint2, &CentrePoint, &Drag2Blob, &Drag3Blob); // Get the rectangle around the Centre Control Point (Camelot.GetBlobManager())->GetBlobRect(CentrePoint, &BlobRect); // See if the Click Position is within the rectangle if ( BlobRect.ContainsCoord(ClickPos) ) HitControl = FILLCONTROL_STARTPOINT; // Get the rectangle around the First End Point (Camelot.GetBlobManager())->GetBlobRect(Drag2Blob, &BlobRect); // See if the Click Position is within the rectangle if ( BlobRect.ContainsCoord(ClickPos) ) HitControl = FILLCONTROL_ENDPOINT; // Get the rectangle around the Second End Point (Camelot.GetBlobManager())->GetBlobRect(Drag3Blob, &BlobRect); // See if the Click Position is within the rectangle if ( BlobRect.ContainsCoord(ClickPos) ) HitControl = FILLCONTROL_SECONDARYPOINT; return HitControl; #else return FILLCONTROL_NULL; #endif }

BOOL AttrBitmapFill::CopyNodeContents (  AttrBitmapFill *  NodeCopy  )  [protected]

This method copies the node's contents to the node pointed to by NodeCopy. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 23/8/94 Parameters: A  copy of this node [OUTPUTS] Returns: Errors: An assertion failure will occur if NodeCopy is NULL Scope: protected Definition at line 14015 of file fillattr.cpp. { ERROR2IF(NodeCopy == NULL, FALSE, "NULL pointer in AttrBitmapFill::CopyNodeContents!"); AttrFillGeometry::CopyNodeContents( NodeCopy ); // Copy contents specific to derived class here return TRUE; }

void AttrBitmapFill::DrawEndBlobs (   )  [virtual]

Draws the blobs on the ends of the fill arrows. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 25/1/95 Reimplemented from AttrFillGeometry. Definition at line 14544 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) Node *pNode = this; while ((pNode != NULL) && !pNode->IsKindOf(CC_RUNTIME_CLASS(Spread))) pNode = pNode->FindParent(); if (pNode == NULL) return; // We're not really in the tree Spread* pSpread = (Spread*)pNode; DocRect Bounds = GetBlobBoundingRect(); DocCoord Start = *GetStartPoint(); DocCoord End = *GetEndPoint(); DocCoord End2 = *GetEndPoint2(); GetBitmapVirtualPoints(Start, End, End2, &Start, &End, &End2); RenderRegion* pRender = DocView::RenderOnTop(&Bounds, pSpread, UnclippedEOR); while (pRender) { // Draw a blob at the start point if (IsSelected(FILLCONTROL_STARTPOINT)) { // Draw Selected Blob // pRender->SetLineColour(COLOUR_SELECTEDBLOB); pRender->SetLineColour(COLOUR_NONE); pRender->SetFillColour(COLOUR_SELECTEDBLOB); pRender->DrawBlob(Start, BT_SELECTED); } else { // Draw Unselected Blob // pRender->SetLineColour(COLOUR_UNSELECTEDBLOB); pRender->SetLineColour(COLOUR_NONE); pRender->SetFillColour(COLOUR_UNSELECTEDBLOB); pRender->DrawBlob(Start, BT_UNSELECTED); } // Draw a blob at the end point if (IsSelected(FILLCONTROL_ENDPOINT)) { // Draw Selected Blob // pRender->SetLineColour(COLOUR_SELECTEDBLOB); pRender->SetLineColour(COLOUR_NONE); pRender->SetFillColour(COLOUR_SELECTEDBLOB); pRender->DrawBlob(End, BT_SELECTED); pRender->DrawBlob(End2, BT_SELECTED); } else { // Draw Unselected Blob // pRender->SetLineColour(COLOUR_UNSELECTEDBLOB); pRender->SetLineColour(COLOUR_NONE); pRender->SetFillColour(COLOUR_UNSELECTEDBLOB); pRender->DrawBlob(End, BT_UNSELECTED); pRender->DrawBlob(End2, BT_UNSELECTED); } // Get the Next render region pRender = DocView::GetNextOnTop(&Bounds); } // Bodge to stop fill meshes EOR each other out. AttrFillGeometry::LastRenderedMesh = NULL; #endif }

KernelBitmap * AttrBitmapFill::EnumerateBitmaps (  UINT32  Count  )  [virtual]

Find out what bitmaps, if any, are used by this node. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 02/17/95 Parameters: Count  - the bitmap to get (see Purpose). [INPUTS] Returns: The KernelBitmap in use by the node, or NULL if no more are used. The base class returns NULL always, so you over-ride this in any node classes that use bitmaps. This function supports nodes that use more than one bitmap - you call this function repeatedly and keep incrementing the Count parameter that you pass in each time by 1. You should stop calling it when it returns NULL, as this indicates that no more bitmaps are used by this node. Count should start off as 0 for the first call. Note that this function can (and often will) return NULL for the first call, as many nodes don't use bitmaps, obviously. See also: KernelBitmap Reimplemented from Node. Definition at line 5599 of file fillattr.cpp. { if (IsAFractalFill()) return NULL; if (Count == 0) return GetBitmap(); return NULL; }

void AttrBitmapFill::Extend (  const ExtendParams &  ExtParams  )  [virtual]

Perform an extend operation on this fill node. Author: Karim_MacDonald (Xara Group Ltd) <camelotdev@xara.com> Date: 08/12/1999 Parameters: ExtParams  description parameters for the extension. [INPUTS] This  fill node may have its dimensions altered by the extension. [OUTPUTS] Returns: Errors: See also: class Extender; IsTypeExtendible(); Extend() Reimplemented from AttrFillGeometry. Definition at line 14664 of file fillattr.cpp. { // a bitmap fill's behaviour depends upon what it is applied to: // non-path with EXTEND :: do nothing - its parent will transform it correctly. // path node with EXTEND :: translate itself; remember that its parent has moved // its centre by ExtParams.doccOffset already. // any node with STRETCH :: we need to unstretch ourself... // it is assumed here, though this may not always be true, that the fill's parent node // is the node to which it is applied. Node* pParent = FindParent(); if (pParent != NULL) if (pParent->IsNodePath() || pParent->IsCompound()) TransformTranslateObject(ExtParams); // if we are asked to stretch, we must first undo any stretch which was done to us by the // node we are applied to. then we must translate ourself, so that we maintain our place, // relative to the centre of the button. // we do all of this because this is what would be expected for a texture on a button. // the texture should _not_ stretch if the button stretches, but _should_ move around // with the button. // if the button stretches and moves, we arbitrarily decided that the fill should remain // in the same position relative to the scale-reference coord of the button - see // definition of ExtendParams for details. ExtendParams eps = ExtParams; eps.xscale = 1 / eps.xscale; // eps.yscale = 1 / eps.yscale; // ie, 'undo the stretch, but leave eps.doccScaleStart = ExtParams.doccScaleEnd; // us where the stretch put us." eps.doccScaleEnd = ExtParams.doccScaleEnd; // TransformStretchObject(eps); }

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

Implements AttrFillGeometry. Implemented in AttrBitmapColourFill, AttrBitmapTranspFill, AttrTextureColourFill, AttrFractalColourFill, AttrNoiseColourFill, AttrTextureTranspFill, AttrFractalTranspFill, and AttrNoiseTranspFill.

DocRect AttrBitmapFill::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: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 10/8/94 Returns: DocRect - The rectangle that contains all the nodes selection blobs. Reimplemented from AttrFillGeometry. Definition at line 14460 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(); // Work out the Virtual Coords GetBitmapVirtualPoints(StartPoint, EndPoint, EndPoint2, &StartPoint, &EndPoint, &EndPoint2); // 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 }

double AttrBitmapFill::GetEffectiveBitmapMinDPI (  KernelBitmap *  pBitmap  )  [virtual]

Returns the minimum effective dpi this bitmap is used at. Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 07/08/2006 Parameters: pBitmap  - pointer to a KernelBitmap [INPUTS] Returns: Reimplemented from Node. Definition at line 5656 of file fillattr.cpp. { if (!IsAFractalFill() && GetBitmap() == pBitmap) { // Do we have a valid bitmap ? OILBitmap *OilBM = pBitmap->ActualBitmap; if (OilBM != NULL) { BitmapInfo Info; OilBM->GetInfo(&Info); // Get the Width of the Bitmap in Pixels INT32 PixWidth = Info.PixelWidth; INT32 PixHeight = Info.PixelHeight; DocCoord Start(*GetStartPoint()); DocCoord End(*GetEndPoint()); DocCoord End2(*GetEndPoint2()); // Get the Width of the Bitmap in Millipoints INT32 Width = INT32(Start.Distance(End)); INT32 Height = INT32(Start.Distance(End2)); // Use doubles so that we can round up as well as down. This improves // the dpi calculated. double HDpi = 0; double VDpi = 0; if (Width > 0) HDpi = ((double)PixWidth * 72000.0)/(double)Width; if (Height > 0) VDpi = ((double)PixHeight * 72000.0)/(double)Height; // Use the smaller of the two dpi values if (HDpi < VDpi) return(HDpi); else return(VDpi); } } return(1e9); }

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

Reimplemented from AttrFillGeometry. Definition at line 1869 of file fillattr2.h. { return 2; }

NodeAttribute * AttrBitmapFill::GetOtherAttrToApply (  BOOL *  IsMutate  )  [virtual]

Some attributes require a secondary atribute to be changed when they are changed. This routine obtains a pointer to the secondary attribute to apply. Author: Chris_Snook (Xara Group Ltd) <camelotdev@xara.com> Date: 8/12/99 Returns: The secondary attribute to apply, or NULL if none to apply Reimplemented from NodeAttribute. Reimplemented in AttrFractalFill. Definition at line 5715 of file fillattr.cpp. { ERROR3IF(IsMutate == NULL, "NULL flag pointer passed to GetOtherAttrToApply"); // A bitmap fill change also needs to set the mapping to repeating .... NodeAttribute* OtherAttr = NULL; if (GetAttributeType() == CC_RUNTIME_CLASS(AttrFillGeometry)) { OtherAttr = new AttrFillMappingLinear; } else { OtherAttr = new AttrTranspFillMappingLinear; } if (OtherAttr == NULL) { return (NULL); } ((AttrFillMappingLinear*) OtherAttr)->SetRepeat(RT_Repeating); *IsMutate = FALSE; return OtherAttr; }

BOOL AttrBitmapFill::HidingNode (   )  [virtual]

This virtual function is called whenever the node is hidden. It allows the node do things like 'optimise' itself to use less memory or send a message to let others know it is being hidden etc. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 11/1/94 Returns: TRUE if all was ok. FALSE if an error occured. ALWAYS CALL THE BASE CLASS' FUNCTION FROM YOUR OVERRIDDEN FUNCTION. Reimplemented from Node. Reimplemented in AttrFractalFill. Definition at line 13787 of file fillattr.cpp. { // Call the base class first if (!AttrFillGeometry::HidingNode()) return FALSE; GetBitmapRef()->RemoveFromTree(); return TRUE; }

virtual BOOL AttrBitmapFill::IsABitmapFill (   )  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. Reimplemented in AttrBitmapColourFill. Definition at line 1844 of file fillattr2.h. { return TRUE; }

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

virtual BOOL AttrBitmapFill::IsTypeExtendible (   )  const [inline, virtual]

Reimplemented from AttrFillGeometry. Definition at line 1860 of file fillattr2.h. { return TRUE; }

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

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

virtual BOOL AttrBitmapFill::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 1853 of file fillattr2.h. { return FALSE;}

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

Reimplemented from AttrFillGeometry. Reimplemented in AttrTextureColourFill, and AttrTextureTranspFill. Definition at line 14108 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) // Get the current Control Point Positions DocCoord StartPoint = *GetStartPoint(); DocCoord EndPoint = *GetEndPoint(); DocCoord EndPoint2 = *GetEndPoint2(); DocCoord CentrePoint; DocCoord Drag2Blob; DocCoord Drag3Blob; // Bodge Alert !! // Bitmap fills have a complicated control point system. // The actual control points needed for rendering are the Bottom Left, // Top Left, and Bottom Right points of the bitmap. But on screen the // points seen and moved are the Centre, Middle Right, and Middle Top. // So we need to convert the click points into vitual points before // we start dragging them about. GetBitmapVirtualPoints(StartPoint, EndPoint, EndPoint2, &CentrePoint, &Drag2Blob, &Drag3Blob); INT32 dx, dy; // Which control is being dragged ? switch (DragControl) { case FILLCONTROL_STARTPOINT: // They're dragging the Centre Point dx = CentrePoint.x - Pos.x; dy = CentrePoint.y - Pos.y; // Move the other points relative Drag2Blob.translate(-dx, -dy); Drag3Blob.translate(-dx, -dy); CentrePoint = Pos; break; case FILLCONTROL_ENDPOINT: // If the Constrain key is down then constrain the Angle of the // point, relative to the centre position. if (ClickMods.Constrain) DocView::ConstrainToAngle(CentrePoint, &Pos); if (ClickMods.Adjust) { // Shift is pressed, so lock the aspect ratio of the bitmap mesh double OldLen = CentrePoint.Distance(Drag2Blob); double NewLen = CentrePoint.Distance(Pos); double Ratio = 1.0; if (OldLen == 0) Ratio = 0; else Ratio = NewLen/OldLen; // Calculate the new point based on the aspect ratio Drag3Blob = MakeLineAtAngle(CentrePoint, Pos, 90, INT32(CentrePoint.Distance(Drag3Blob) * Ratio)); } Drag2Blob = Pos; break; case FILLCONTROL_SECONDARYPOINT: // If the Constrain key is down then constrain the Angle of the // point, relative to the centre position. if (ClickMods.Constrain) DocView::ConstrainToAngle(CentrePoint, &Pos); if (ClickMods.Adjust) { // Shift is pressed, so lock the aspect ratio of the bitmap mesh double OldLen = CentrePoint.Distance(Drag3Blob); double NewLen = CentrePoint.Distance(Pos); double Ratio = 1.0; if (OldLen == 0) Ratio = 0; else Ratio = NewLen/OldLen; // Calculate the new point based on the aspect ratio Drag2Blob = MakeLineAtAngle(CentrePoint, Pos, -90, INT32(CentrePoint.Distance(Drag2Blob) * Ratio)); } Drag3Blob = Pos; break; } // Now we have to convert the Virtual Coords back into real // bitmap control points. TRACEUSER( "Mike", _T("Centre at %d,%d\n"), CentrePoint.x, CentrePoint.y); GetBitmapRealPoints(CentrePoint, Drag2Blob, Drag3Blob, &StartPoint, &EndPoint, &EndPoint2); // Store the new points back in the Fill SetStartPoint(&StartPoint); SetEndPoint(&EndPoint); SetEndPoint2(&EndPoint2); #endif }

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

Reimplemented from AttrFillGeometry. Reimplemented in AttrBitmapColourFill, AttrBitmapTranspFill, AttrTextureColourFill, and AttrTextureTranspFill. Definition at line 1825 of file fillattr2.h. {}

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

Reimplemented from AttrFillGeometry. Reimplemented in AttrBitmapColourFill, AttrBitmapTranspFill, AttrTextureColourFill, and AttrTextureTranspFill. Definition at line 14356 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) 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]; DocCoord Start; DocCoord End; DocCoord End2; // Work out the Virtual positions of the Bitmap Controls GetBitmapVirtualPoints(StartPoint, EndPoint, EndPoint2, &Start, &End, &End2); // 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, Start, End, &LineEnd); // Calculate the Arrow on the End of the Line2 Path ArrowPath2; ArrowPath2.Initialise(); DocCoord LineEnd2; MakeMeshArrow(&ArrowPath2, Start, End2, &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(Start, LineEnd); // Draw the secondary line pRender->DrawLine(Start, 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 Parallelgram to // show the shape of the bitmap pRender->SetLineColour(COLOUR_SELECTEDBLOB); pRender->SetFillColour(COLOUR_NONE); Path ParaPath; ParaPath.Initialise(); MakeMeshParallelagram(&ParaPath, Start, End, End2); // Draw the parallelagram pRender->DrawPath(&ParaPath); } // Put all the old attributes back pRender->RestoreContext(); #endif }

BOOL AttrBitmapFill::ReplaceBitmap (  KernelBitmap *  pOrigBitmap, KernelBitmap *  pNewBitmap )  [virtual]

Author: Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com> Date: 07/08/2006 Parameters: pOrigBitmap  - pointer to a KernelBitmap [INPUTS] pNewBitmap - pointer to a KernelBitmap Returns: TRUE if ok, FALSE if bother Reimplemented from Node. Definition at line 5625 of file fillattr.cpp. { if (!IsAFractalFill()) { if (GetBitmap() == pOrigBitmap) { BitmapFillAttribute* pVal = (BitmapFillAttribute*)GetAttributeValue(); if (pVal) pVal->GetBitmapRef()->Attach(pNewBitmap); return(TRUE); } } return FALSE; }

void AttrBitmapFill::SetAspectRatio (  double  Ratio  )  [virtual]

Reimplemented from AttrFillGeometry. Reimplemented in AttrFractalFill. Definition at line 14217 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) // Get the current Control Point Positions DocCoord StartPoint = *GetStartPoint(); DocCoord EndPoint = *GetEndPoint(); DocCoord EndPoint2 = *GetEndPoint2(); DocCoord CentrePoint; DocCoord Drag2Blob; DocCoord Drag3Blob; GetBitmapVirtualPoints(StartPoint, EndPoint, EndPoint2, &CentrePoint, &Drag2Blob, &Drag3Blob); Drag3Blob = MakeLineAtAngle(CentrePoint, Drag2Blob, 90, INT32(CentrePoint.Distance(Drag2Blob) * Ratio) ); GetBitmapRealPoints(CentrePoint, Drag2Blob, Drag3Blob, &StartPoint, &EndPoint, &EndPoint2); // Store the new points back in the Fill SetStartPoint(&StartPoint); SetEndPoint(&EndPoint); SetEndPoint2(&EndPoint2); #endif }

BOOL AttrBitmapFill::ShowingNode (   )  [virtual]

This virtual function is called whenever the node is re-shown after being Hidden. It allows the node to reconstruct itself if it was optimised or send a message to let others know it is back etc. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 11/1/94 Returns: TRUE if all was ok. FALSE if an error occured (eg Out of memory). ALWAYS CALL THE BASE CLASS' FUNCTION FROM YOUR OVERRIDDEN FUNCTION. Reimplemented from Node. Reimplemented in AttrFractalFill. Definition at line 13814 of file fillattr.cpp. { // Call the base class first if (!AttrFillGeometry::ShowingNode()) return FALSE; GetBitmapRef()->AddtoTree(); return TRUE; }

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

Check to see which colour will be changed if dropped at this point. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 8/2/95 Reimplemented from AttrFillGeometry. Definition at line 5569 of file fillattr.cpp. { return AttrFillGeometry::TestColourDrop(ColDrop); }

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

Changes the Dpi of this bitmap by scaling the fill control points.Transform a grad fill attribute by moving the start and end points. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 23/8/94 Parameters: Trans  - the transform object to apply to this attribute. [INPUTS] See also: NodeRenderable::Transform Reimplemented from NodeRenderable. Reimplemented in AttrFractalFill. Definition at line 13920 of file fillattr.cpp. { if ( Trans.TransFills ) { Trans.Transform( GetStartPoint(), 1); Trans.Transform( GetEndPoint(), 1); Trans.Transform( GetEndPoint2(), 1); Trans.Transform( GetEndPoint3(), 1); // ValidateAttributeValue(); } }

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

Transform a grad fill attribute by moving the selected control points. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 23/8/94 Parameters: Trans  - the transform object to apply to this attribute. [INPUTS] See also: NodeRenderable::Transform Reimplemented from AttrFillGeometry. Definition at line 13945 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) if ( Trans.TransFills ) { ClickModifiers ClickMods; /* = ClickModifiers::GetClickModifiers();*/ ClickMods.Adjust = TRUE; DocCoord StartPoint = *GetStartPoint(); DocCoord EndPoint = *GetEndPoint(); DocCoord EndPoint2 = *GetEndPoint2(); DocCoord CentrePoint; DocCoord Drag2Blob; DocCoord Drag3Blob; GetBitmapVirtualPoints(StartPoint, EndPoint, EndPoint2, &CentrePoint, &Drag2Blob, &Drag3Blob); if (GetStartPoint() && IsSelected(FILLCONTROL_STARTPOINT)) { Trans.Transform( &CentrePoint, 1); FillControl Start = FILLCONTROL_STARTPOINT; OnControlDrag(CentrePoint, Start, ClickMods); } if (GetEndPoint() && IsSelected(FILLCONTROL_ENDPOINT)) { Trans.Transform( &Drag2Blob, 1); FillControl End = FILLCONTROL_ENDPOINT; OnControlDrag(Drag2Blob, End, ClickMods); } } #endif }

void AttrBitmapFill::TransformTranslateObject (  const ExtendParams &  ExtParams  )  [virtual]

Translate this bitmap fill, according to the offsets and flags defined in ExtParams, and a reference centre, defined by NodeRenderable::FindExtendCentre(). This function does nothing unless ExtParams uses X_EXTEND or Y_EXTEND. Author: Karim_MacDonald (Xara Group Ltd) <camelotdev@xara.com> Date: 09/12/1999 Parameters: ExtParams  description of how this bitmap fill should translate. [INPUTS] This  fill may be translated, depending on the flags held within ExtParams. [OUTPUTS] This function is identical to NodeRenderable::TransformObject, except that in all cases except when our parent is a group, it will have already applied ExtParams' doccOffset to us, so we can usually omit this step. See also: The Extender class; FindExtendCentre(). Reimplemented from AttrFillGeometry. Definition at line 14718 of file fillattr.cpp. { DocCoord doccCentre = FindExtendCentre(); // x-extension - we move the whole Node; behaviour determined by its centre. if (ExtParams.fExtendFlags & X_EXTEND) { // if our parent is a group, then it won't have applied any offset parameter to us, // so we need to do this ourself. Node* pParent = FindParent(); if (pParent != NULL && pParent->IsCompound()) { Trans2DMatrix baseXoffset(ExtParams.doccOffset.x, 0); Transform(baseXoffset); } // we only move anything if we're outside a buffer-zone around the centre // (necessary as objects can be misaligned by a millipoint or two). if (doccCentre.x > ExtParams.doccEndCentre.x + ExtParams.xincExtendBuffer) { Trans2DMatrix translateX(ExtParams.xinc, 0); Transform(translateX); } else if (doccCentre.x < ExtParams.doccEndCentre.x - ExtParams.xdecExtendBuffer) { Trans2DMatrix translateX(-ExtParams.xdec, 0); Transform(translateX); } } // y-extension - we move the whole Node; behaviour determined by its centre. if (ExtParams.fExtendFlags & Y_EXTEND) { // if our parent is a group, then it won't have applied any offset parameter to us, // so we need to do this ourself. Node* pParent = FindParent(); if (pParent != NULL && pParent->IsCompound()) { Trans2DMatrix baseYoffset(0, ExtParams.doccOffset.y); Transform(baseYoffset); } // only extend if we're outside the centre's buffer-zone. if (doccCentre.y > ExtParams.doccEndCentre.y + ExtParams.yincExtendBuffer) { Trans2DMatrix translateY(0, ExtParams.yinc); Transform(translateY); } else if (doccCentre.y < ExtParams.doccEndCentre.y - ExtParams.ydecExtendBuffer) { Trans2DMatrix translateY(0, -ExtParams.ydec); Transform(translateY); } } }

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

Makes sure the Coords of the Fill are sensible. Defaults to natural size of the bitmap. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 11/8/94 Reimplemented from AttrFillGeometry. Reimplemented in AttrFractalFill. Definition at line 14259 of file fillattr.cpp. { #if !defined(EXCLUDE_FROM_RALPH) if ((*GetStartPoint()) != DocCoord(0,0) && (*GetEndPoint()) != DocCoord(0,0) && (*GetEndPoint2()) != DocCoord(0,0)) return; // Make some 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(); } BitmapInfo Info; BOOL GotBitmap = FALSE; // if possible we base our default size on the bitmaps preferred size KernelBitmap* KerBmp = ((FillGeometryAttribute*)GetAttributeValue())->GetBitmap(); if (KerBmp && KerBmp->ActualBitmap) GotBitmap = KerBmp->ActualBitmap->GetInfo( &Info ); // Use the recommended Width and Height if possible INT32 BitmapWidth = (GotBitmap ? Info.RecommendedWidth : Width ); INT32 BitmapHeight = (GotBitmap ? Info.RecommendedHeight : Height ); // Find the middle of the Attributes Bounds DocCoord Centre = CentreOf(AttrBounds); // Get the current control positions DocCoord StartPoint = *GetStartPoint(); DocCoord EndPoint = *GetEndPoint(); DocCoord EndPoint2 = *GetEndPoint2(); // If the StartPoint is 'NULL' then make all points sensible if (StartPoint == DocCoord(0,0)) { // Start in the middle StartPoint = DocCoord(Centre.x - BitmapWidth/2, Centre.y - BitmapHeight/2); // End on the Middle Right EndPoint = DocCoord(StartPoint.x + BitmapWidth, StartPoint.y); // and Middle Top EndPoint2 = DocCoord(StartPoint.x, StartPoint.y + BitmapHeight); } // If the EndPoint is 'NULL' then make end points sensible if (EndPoint == DocCoord(0,0)) { EndPoint = DocCoord(StartPoint.x + BitmapWidth, StartPoint.y); EndPoint2 = DocCoord(StartPoint.x, StartPoint.y + BitmapHeight); } // If the EndPoint2 is 'NULL' then make it sensible if (EndPoint2 == DocCoord(0,0)) { EndPoint2 = DocCoord(StartPoint.x, StartPoint.y + BitmapHeight); } // Store the validated positions back SetStartPoint(&StartPoint); SetEndPoint(&EndPoint); SetEndPoint2(&EndPoint2); #endif }

DocRect AttrBitmapFill::ValidateExtend (  const ExtendParams &  ExtParams  )  [virtual]

Determine whether applying an extend to this Node is a reversible process. Author: Karim_MacDonald (Xara Group Ltd) <camelotdev@xara.com> Date: 08/12/1999 Parameters: ExtParams  description parameters for the extension. [INPUTS] [OUTPUTS]  Returns: TRUE if this bitmap fill may be reversible extended. FALSE otherwise. Errors: See also: class Extender; IsTypeExtendible(); Extend() Reimplemented from AttrFillGeometry. Definition at line 14638 of file fillattr.cpp. { // a bitmap fill is treated a bit like text - it should maintain its aspect ratio and // translate as a whole. therefore, we only validate its extend reference-centre. // it also has no children to test. DocCoord doccArray[1] = { FindExtendCentre() }; return Extender::ValidateControlPoints(1, doccArray, ExtParams); // return DocRect(INT32_MAX, INT32_MAX, INT32_MAX, INT32_MAX); }

---

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

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

---