NodeBitmap Class Reference

A class for including bitmap objects within the tree. More...

#include <nodebmp.h>

Inheritance diagram for NodeBitmap:

List of all members.

Public Member Functions
	NodeBitmap ()
	This constructor creates a NodeBitmap linked to no other with all status flags false and an uninitialized bounding rectangle.
	NodeBitmap (Node *ContextNode, AttachNodeDirection Direction, BOOL Locked=FALSE, BOOL Mangled=FALSE, BOOL Marked=FALSE, BOOL Selected=FALSE)
	This constructor initialises the nodes flags and links it to ContextNode in the direction specified by Direction. All neccesary tree links are updated.
virtual Node *	SimpleCopy ()
	Makes a copy of all the data in the node.
void	CopyNodeContents (NodeBitmap *NodeCopy)
	Copies the data in the node by first calling the base class to get it to copy its stuff, and then copying its own stuff Scope: protected.
virtual void	PolyCopyNodeContents (NodeRenderable *pNodeCopy)
	Polymorphically copies the contents of this node to another.
virtual String	Describe (BOOL Plural, BOOL Verbose)
	To return a description of the NodeBitmap object in either the singular or the plural. This method is called by the DescribeRange method. The description will always begin with a lower case letter.
virtual KernelBitmap *	EnumerateBitmaps (UINT32 Count)
	Find out what bitmaps, if any, are used by this node.
virtual double	GetEffectiveBitmapMinDPI (KernelBitmap *pBitmap)
virtual BOOL	ReplaceBitmap (KernelBitmap *pOrigBitmap, KernelBitmap *pNewBitmap)
virtual BOOL	SupportsClipboardFormat (InternalClipboardFormat *Format) const
	Determine if a node supports a given internal data type. This is used by the clipboard when exporting to other applications in order to determine if certain data types can be supplied.
UINT32	GetBitmapDPI ()
	Caculates the actual DPI of the bitmap on the page.
virtual void	Render (RenderRegion *pRender)
	Will render the bitmap contained within the object to the given render region.
virtual void	PreExportRender (RenderRegion *pRender)
	Prevent the base class NodeRect::PreExportRender() function from exporting anything to mark this as a rectangle object - because it's not; it's a bitmap object.
virtual BOOL	ExportRender (RenderRegion *pRender)
	Export a bitmap object to a file.
virtual INT32	GetSizeOfExport (Filter *)
	Determine how many 'nodes' this bitmap is equivalent to. We use the rough approximation that each scanline taks the same amount of space as a typical node. This gives us enough granularity for a reasonably accurate and smooth progress display update.
virtual BOOL	RequiresAttrib (NodeAttribute *pAttrib, BOOL Search=FALSE)
	Determine which attributes a bitmap object supports a particular type of attribute. A bitmap only supports transparent fill geometries, mappings, and effects - all other attributes are rejected.
virtual BOOL	ApplyDefaultBitmapAttrs (UndoableOperation *pOp, AttrBitmapTranspFill *pTranspBitmap=NULL)
	Apply the default attributes that a NodeBitmap needs. This is specific to Bitmap Nodes, which need the Start and End colours to be NONE initially, and also need to ensure the line width is 0. There is now an optional pointer to a transparent bitmap fill to be applied over the current bitmap node. This is used by the transparent GIF import code.
virtual BOOL	OnNodePopUp (Spread *pSpread, DocCoord PointerPos, ContextMenu *pMenu)
	Allows the Node to respond to pop up menu clicks on it (rather than its blobs).
virtual UINT32	GetNodeSize () const
	For finding the size of the node.
virtual BOOL	IsABitmap () const
virtual BOOL	NeedsTransparency () const
	Called.
virtual BOOL	CanBecomeA (BecomeA *pBecomeA)
	This function is used by the convert to shapes operation. It determines if the node or any of its children can convert themselves into an InkClass object. In the case of a node bitmap we must stop it from it having the make shapes applied as otherwise we will loose the bitmap from view. NodeSimpleShape overrides the baseclass function to return True.
virtual BOOL	DoBecomeA (BecomeA *pBecomeA)
	Transforms the object into another type of object. Note: changed 7/10/94 by MarkN to take the pBecomeA param, so that more data could be passed to these functions in the future without causing massive rebuilds due to the editing of node.h.
BOOL	AllowOp (ObjChangeParam *, BOOL)
	This is the way to ask a node if you can do an op to it.
BOOL	MakeContoneBitmap (UndoableOperation *)
	Make this NodeBitmap into a grey level version of itself.
virtual KernelBitmapRef *	GetBitmapRef ()
virtual KernelBitmap *	GetBitmap ()
	Get the bitmap referenced by this node.
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 void	SetStartColour (DocColour *)
	Set the start colour of a bitmap palette.
virtual void	SetEndColour (DocColour *)
	Set the end colour of a bitmap palette.
virtual DocColour *	GetStartColour ()
	Gets the start colour of the bitmap palette.
virtual DocColour *	GetEndColour ()
	Gets the end colour of the bitmap palette.
virtual BOOL	GetApplyContoneColour ()
BOOL	HasSimpleOrientation (RenderRegion *)
	Determine if a bitmap is classified as a 'simple' bitmap, for use during the complex rendering of a view - if the render region can support simple bitmaps and this function returns TRUE, then we render the bitmap directly, otherwise it goes into the masked GDraw bitmap and is rendered that way.
virtual BOOL	OnClick (DocCoord PointerPos, ClickType Click, ClickModifiers ClickMods, Spread *pSpread)
	Allows the Node to respond to clicks by selecting its blobs or starting drags etc. This functions should be overridden in the all the NodeRenderableInk classes so that this version never gets called. Eg the NodePath class might claim the click if it happened over one of its unselected blobs.
virtual TCHAR *	GetDefaultOpToken ()
virtual void	SetAspectRatio (double dExWidth, double dExHeight, BOOL bPathAndFill)
	To reset the stored path and Parallelogram to retain their shape and scale but to take on a new aspect ratio.
virtual BOOL	ReleaseCached (BOOL bAndParents=TRUE, BOOL bAndChildren=TRUE, BOOL bSelf=TRUE, BOOL bAndDerived=TRUE)
	Get rid of cached data held in the tree.
virtual DocRect	GetOriginalBitmapRect ()
	Find the starting point for the instance transform.
virtual Matrix	GetInstanceTransform ()
	Find the instance transform matrix Notes: Parallelogram format includes 4 coords and is stored in this format: 0-------1 | | 3-------2 (Why?).
virtual BOOL	CanSupplyDirectBitmap ()
virtual BOOL	GetDirectBitmap (RenderRegion *pRender, LPBITMAPINFO *plpInfo, LPBYTE *plpBits, DocRect *pRect, Matrix *pMat, double *pdRes)
	Return details of direct bitmap to caller (caller is usually a NodeBitmapEffect).
virtual BOOL	WritePreChildrenWeb (BaseCamelotFilter *pFilter)
	saves a NodeBitmap to the filter
virtual BOOL	WritePreChildrenNative (BaseCamelotFilter *pFilter)
Static Public Member Functions
static KernelBitmap *	CheckGreyscaleBitmap (KernelBitmap *pBitmap, UINT32 PromptID, UINT32 OkID)
	Checks a bitmap to see if can be applied as a texture, and gives the option to create a grey level version if not.
Public Attributes
KernelBitmapRef	BitmapRef
Protected Member Functions
virtual BOOL	HasBitmapAttrs ()
	Test whether we need to render this bitmap before we can return it from GetDirectBitmap.
Protected Attributes
DocColour	Colour
DocColour	EndColour
BOOL	ApplyContoneColour
Private Member Functions
	CC_DECLARE_DYNCREATE (NodeBitmap)

---

Detailed Description

A class for including bitmap objects within the tree.

Author:

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

Date:

08/03/94

See also:

NodeRect, KernelBitmap

Definition at line 124 of file nodebmp.h.

---

Constructor & Destructor Documentation

NodeBitmap::NodeBitmap (   )

This constructor creates a NodeBitmap linked to no other with all status flags false and an uninitialized bounding rectangle. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 30/08/94 NB. SetUpPath() must be called before the NodeBitmap is in a state in which it can be used. See also: SetUpPath Definition at line 266 of file nodebmp.cpp. : NodeRect() { Colour = COLOUR_NONE; EndColour = COLOUR_NONE; ApplyContoneColour = FALSE; }

NodeBitmap::NodeBitmap (  Node *  ContextNode, AttachNodeDirection  Direction, BOOL  Locked = FALSE, BOOL  Mangled = FALSE, BOOL  Marked = FALSE, BOOL  Selected = FALSE )

This constructor initialises the nodes flags and links it to ContextNode in the direction specified by Direction. All neccesary tree links are updated. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 30/08/94 Parameters: ContextNode,:  Pointer to a node which this node is to be attached to. [INPUTS] Direction: Specifies the direction in which the node is to be attached to the ContextNode. The values this variable can take are as follows: PREV : Attach node as a previous sibling of the context node NEXT : Attach node as a next sibling of the context node FIRSTCHILD: Attach node as the first child of the context node LASTCHILD : Attach node as a last child of the context node The remaining inputs specify the status of the node: Locked: Is node locked ? Mangled: Is node mangled ? Marked: Is node marked ? Selected: Is node selected ? Note: SetUpPath() must be called before the NodeBitmap is in a state in which it can be used. See also: SetUpPath Returns: Errors: An assertion error will occur if ContextNode is NULL Definition at line 235 of file nodebmp.cpp. :NodeRect(ContextNode, Direction, Locked, Mangled, Marked, Selected ) { Colour = COLOUR_NONE; EndColour = COLOUR_NONE; ApplyContoneColour = FALSE; }

---

Member Function Documentation

BOOL NodeBitmap::AllowOp (  ObjChangeParam *  pParam, BOOL  SetOpPermissionState )

This is the way to ask a node if you can do an op to it. Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com> Date: 3/02/95 Parameters: pParam  = describes the way an op wants to change the node [INPUTS] SetOpPermissionState = if TRUE the Op permission state of this node will be set according to the outcome of the call -  [OUTPUTS] Returns: TRUE means the node and all its parents are happy with this op, FALSE means don't do it The ObjChangeParam class contains flags that describe how it will change the node For example, the op could change the node's appearence (e.g. attr application, editing a path), replace the node with another node (e.g. because it uses hidden nodes to hide the original and put another node in its place, or "make shapes"), delete the node (e.g. the delete and cut ops), etc. This function gives the node a chance to say NO. It also gives the parents a chance to say no too. E.g. a blend node will allow itself to be deleted, but it will NOT allow a child of itself to be deleted). This call should only be made on selected, or parents of selected, nodes. It makes a decision as a straight node if it is selected. It makes a decision as a parent if it has selected children. E.g. NodeBlend::AllowOp(...op delete...) if the node is selected, then it will return TRUE (parents permitting), i.e. I can be deleted if the node is a parent of selected it will return FALSE (i.e. can't delete children of blends). So when the node is selected, you are asking the node if you can do the op to it. When the node is a parent of a selected node, you are asking if you can do the op to one of its children. If the 'SetOpPermissionState' param is TRUE, the following indented lines applies: The node's op permission state is set according to the result of this function. If TRUE is returned, then the node's op permission state will be left unchanged. AND the parent's op permission state will be set to PERMISSION_ALLOWED if FALSE is returned, then the node's op permission state will be PERMISSION_DENIED, AND all it's parents (up to the layer) will be set to PERMISSION_DENIED Also, all parents of this node are called via their AllowOp() func with the same state as this node. This means that after this call, you can guarantee that all of its parents will have either a PERMISSION_DENIED or PERMISSION_ALLOWED state. Note: Even if this node tries to set all it's parents to have a PERMISSION_DENIED state, if any of its parents have previously been set to PERMISSION_ALLOWED they will remain in that state (see SetOpPermission()). Why? Well, it is possible for a parent node to have one child with a PERMISSION_DENIED and another child with a PERMISSION_ALLOWED. It this state the parent MUST be in state PERMISSION_ALLOWED, because at least one of its children will allow the op to happen to it. So, after this call: The op permission state for this node will be either left unchanged (and therefore remain PERMISSION_UNDEFINED), or PERMISSION_DENIED. The parent's op permission state will be either PERMISSION_ALLOWED, or PERMISSION_DENIED. This is so UndoableOperation::UpdateChangedNodes() will only call OnChildChange() on parent nodes, because it only calls that func for nodes that have an op permission state of PERMISSION_ALLOWED. See also: GetOpPermission(),SetOpPermission(); Definition at line 1479 of file nodebmp.cpp. { BOOL AnyAllowed=AllowOp_AccountForCompound(pParam, SetOpPermissionState); // if called by a parent, just pass this result back if (pParam->GetDirection()==OBJCHANGE_CALLEDBYPARENT) return AnyAllowed; } else { // clean out the calling-child ptr, so it doesn't get passed around unintentionally. pParam->SetCallingChild(NULL); } // at this point we must have been called directly by the op or via a child AllowOp() // decide if we allow it ... BOOL allowed=TRUE; ObjChangeFlags Flags = pParam->GetChangeFlags(); if (Flags.Attribute) { // Someone is applying an attribute ..... // We really need to check the actual attribute, so for // now we'll rely on the fact that the 'RequiresAttrib()' // function will have been called before this one. // If we are applying a contone colour, then make sure we // are a Grey level bitmap, and give the user the option // of making one if not. if (ApplyContoneColour) { // 'ApplyContoneColour' is set in the 'RequiresAttrib()' // function if a contone colour change attr is applied. allowed = MakeContoneBitmap(pParam->GetOpPointer()); } } // if we allowed it, see if our parents do ... if (allowed && Parent!=NULL) { ObjChangeDirection OldDirection=pParam->GetDirection(); pParam->SetCallingChild(this); pParam->SetDirection(OBJCHANGE_CALLEDBYCHILD); allowed=Parent->AllowOp(pParam,SetOpPermissionState); pParam->SetDirection(OldDirection); } // if setting permisions ... if (SetOpPermissionState) { // if allowed, mark parent accordingly, else mark child as denied and update parents if (allowed) Parent->SetOpPermission(PERMISSION_ALLOWED); else SetOpPermission(PERMISSION_DENIED,TRUE); } // return result (directly, or indirectly via a child AllowOp()) to op return allowed; } /******************************************************************************************** > BOOL NodeBitmap::MakeContoneBitmap(UndoableOperation* pOperation) Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>

BOOL NodeBitmap::ApplyDefaultBitmapAttrs (  UndoableOperation *  pOp, AttrBitmapTranspFill *  pTranspBitmap = NULL )  [virtual]

Apply the default attributes that a NodeBitmap needs. This is specific to Bitmap Nodes, which need the Start and End colours to be NONE initially, and also need to ensure the line width is 0. There is now an optional pointer to a transparent bitmap fill to be applied over the current bitmap node. This is used by the transparent GIF import code. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 19/4/95 Parameters: pOp  - the undoable operation in which this Node has been created. [INPUTS] pTranspBitmap - optional bitmap to apply as transparency. (Default = NULL) Returns: TRUE => Default attribute where applied ok. FALSE => Apply failed. Definition at line 997 of file nodebmp.cpp. { if (pTranspBitmap != NULL) { pTranspBitmap->AttachNode(this, FIRSTCHILD); // Apply it as a single tiled fill. Otherwise in the GIF transparency case // the repeating can give ghost pixels along the edges. AttrTranspFillMappingLinear *pNoRepeatAttr = new AttrTranspFillMappingLinear; if (pNoRepeatAttr == NULL) return FALSE; pNoRepeatAttr->Value.Repeat = 1; pNoRepeatAttr->AttachNode(this, FIRSTCHILD); } Node* pLineColAttr = new AttrStrokeColour(); if (pLineColAttr == NULL) return FALSE; /* Node* pLineTranspAttr = new AttrStrokeTransp(); if (pLineTranspAttr == NULL) { delete pLineColAttr; return FALSE; } */ Node* pFillColAttr = new AttrFlatColourFill(); if (pFillColAttr == NULL) { delete pLineColAttr; // delete pLineTranspAttr; return FALSE; } Node* pLineWidthAttr = new AttrLineWidth(); if (pFillColAttr == NULL) { delete pLineColAttr; // delete pLineTranspAttr; delete pFillColAttr; return FALSE; } DocColour colorNull(COLOUR_NONE); ((AttrFillGeometry*)pLineColAttr)->SetStartColour( &colorNull ); ((AttrFillGeometry*)pFillColAttr)->SetStartColour( &colorNull ); ((AttrLineWidth*)pLineWidthAttr)->Value.LineWidth = 0; // UINT32 LineTransp = 255; // ((AttrFillGeometry*)pLineTranspAttr)->SetStartTransp(&LineTransp); // ((AttrFillGeometry*)pLineTranspAttr)->SetTranspType(1); pLineColAttr->AttachNode(this, FIRSTCHILD); // pLineTranspAttr->AttachNode(this, FIRSTCHILD); pFillColAttr->AttachNode(this, FIRSTCHILD); pLineWidthAttr->AttachNode(this, FIRSTCHILD); return TRUE; }

BOOL NodeBitmap::CanBecomeA (  BecomeA *  pBecomeA  )  [virtual]

This function is used by the convert to shapes operation. It determines if the node or any of its children can convert themselves into an InkClass object. In the case of a node bitmap we must stop it from it having the make shapes applied as otherwise we will loose the bitmap from view. NodeSimpleShape overrides the baseclass function to return True. Author: Neville_Humphrys (Xara Group Ltd) <camelotdev@xara.com> Date: 13/1/95 Parameters: pClass,:  The class of object [INPUTS] pNumObjects = ptr to place number of objects of type pClass that will be created (Note: can be NULL). pNumObects in undefined on entry Returns: TRUE if the node, or any of its children can transmogrify themselves to become an InkClass object The number you put into pNumObjects (if it's not NULL) should exactly equal the total number of pClass objects you create. It should NOT contain any additional objects you may produce such as group objects for containing the pClass object, or attributes. Also, the entry value of *pNumObjects cannot be assumed to be 0. Reimplemented from NodeSimpleShape. Definition at line 1087 of file nodebmp.cpp. { // The NodeBitmap can become a NodePath (with a bitmap fill) if (pBecomeA->BAPath()) { pBecomeA->AddCount(1); return TRUE; } return FALSE; }

virtual BOOL NodeBitmap::CanSupplyDirectBitmap (   )  [inline, virtual]

Reimplemented from NodeRenderableInk. Definition at line 217 of file nodebmp.h. {return TRUE;}

NodeBitmap::CC_DECLARE_DYNCREATE (  NodeBitmap   )  [private]

KernelBitmap * NodeBitmap::CheckGreyscaleBitmap (  KernelBitmap *  pBitmap, UINT32  PromptID, UINT32  OkID )  [static]

Checks a bitmap to see if can be applied as a texture, and gives the option to create a grey level version if not. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 27/6/95 Definition at line 1578 of file nodebmp.cpp. : Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>

void NodeBitmap::CopyNodeContents (  NodeBitmap *  NodeCopy  )

Copies the data in the node by first calling the base class to get it to copy its stuff, and then copying its own stuff Scope: protected. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 26/5/93 Parameters: NodeCopy  - The node to copy [INPUTS] See also: NodeRect::CopyNodeContents Definition at line 312 of file nodebmp.cpp. { NodeRect::CopyNodeContents(NodeCopy); // Copy contents specific to derived class here // Copy KernelBitmap reference NodeCopy->BitmapRef = BitmapRef; // We need to copy the cached bitmaps into the new node // But since this cached (option 2) bitmap is only ever used as an intermediate stage // in producing another cached bitmap, we probably don't need to copy it //CopyCached(pCopyOfNode, GetPixelWidth(), 2); // Copy cached bitmaps, options 0, 1 and 2 (original and processed) }

String NodeBitmap::Describe (  BOOL  Plural, BOOL  Verbose )  [virtual]

To return a description of the NodeBitmap object in either the singular or the plural. This method is called by the DescribeRange method. The description will always begin with a lower case letter. Author: Simon_Maneggio (Xara Group Ltd) <camelotdev@xara.com> Date: 25/6/93 Parameters: Plural,:  Flag indicating if the string description should be plural or [INPUTS] singular. Returns: Description of the object Errors: A resource exception will be thrown if a problem occurs when loading the string resource. Reimplemented from NodeRect. Reimplemented in NodeAnimatingBitmap. Definition at line 370 of file nodebmp.cpp. { #if !defined(EXCLUDE_FROM_RALPH) if (Plural) { return(String(_R(IDS_BITMAP_DESCRP))); } else { if (GetBitmap() == NULL || GetBitmap()->ActualBitmap == NULL) return(String(_R(IDS_BITMAP_DESCRS))); // If we have a bitmap, then include it's name and actual dpi // in the desciption String_256 BmpName = GetBitmap()->ActualBitmap->GetName(); String_64 TrunkName; if (BmpName.Length() > 12) { BmpName.Left(&TrunkName, 9); TrunkName += _T("..."); } else { BmpName.Left(&TrunkName, 12); } String_256 DpiText; UINT32 dpi = GetBitmapDPI(); if (dpi > 0) { String_256 jcf(_R(IDS_NODEBMP_DPI_FORMAT)); camSnprintf(DpiText, 256, jcf, dpi); } String_64 TrunkDpi; DpiText.Left(&TrunkDpi, 11); String_256 Desc(_R(IDS_BITMAP_DESCRS)); String_64 TrunkDesc; Desc.Left(&TrunkDesc, 6); if (Verbose) { String_32 ret = TrunkDesc; ret += TEXT(" '"); ret += TrunkName; ret += TEXT("'"); ret += TrunkDpi; return ret; // return(String(TrunkDesc+TEXT(" '")+TrunkName+TEXT("'")+TrunkDpi)); } else { String_32 ret = TrunkDesc; ret += TEXT(" "); ret += TrunkName; return ret; // return(String(TrunkDesc+TEXT(" ")+TrunkName)); } } #else return(String(_R(IDS_BITMAP_DESCRP))); #endif }

BOOL NodeBitmap::DoBecomeA (  BecomeA *  pBecomeA  )  [virtual]

Transforms the object into another type of object. Note: changed 7/10/94 by MarkN to take the pBecomeA param, so that more data could be passed to these functions in the future without causing massive rebuilds due to the editing of node.h. Author: Will_Cowling (Xara Group Ltd) <camelotdev@xara.com> Date: 16/2/95 Parameters: pBecomeA  = ptr to a class that contains all the info needed to become a new [INPUTS] type of node. -  [OUTPUTS] Returns: TRUE if the object has been transformed, FALSE if we run out of memory See also: NodeSimpleShape::CanBecomeA Reimplemented from NodeSimpleShape. Definition at line 1118 of file nodebmp.cpp. { // Check for a NULL entry param ERROR2IF_PF(pBecomeA == NULL,FALSE,("pBecomeA is NULL")); // This lump checks that the Reason is one that we understand // It also makes sure that we don't have a NULL UndoOp ptr BOOL ValidReason = (pBecomeA->GetReason() == BECOMEA_REPLACE || pBecomeA->GetReason() == BECOMEA_PASSBACK); ERROR2IF_PF(!ValidReason,FALSE,("Unkown BecomeA reason %d",pBecomeA->GetReason())); // pBecomeA->Reason is one that we understand. UndoableOperation* pUndoOp = pBecomeA->GetUndoOp(); BOOL Success = TRUE; // Our success flag (Important that this defaults to TRUE) NodePath* pNewNodePath = NULL; // Ptr to a new NodePath, if we get to make one. if (pBecomeA->BAPath()) { // We need to create a new NodePath, no matter what the reason. // Allocate a new NodePath node ALLOC_WITH_FAIL(pNewNodePath, (new NodePath), pBecomeA->GetUndoOp()); Success = (pNewNodePath != NULL); // Initialise the path if (Success) CALL_WITH_FAIL(pNewNodePath->InkPath.Initialise(InkPath.GetNumCoords(),12), pBecomeA->GetUndoOp(), Success); if (Success) CALL_WITH_FAIL(pNewNodePath->InkPath.CopyPathDataFrom(&InkPath), pBecomeA->GetUndoOp(), Success); if (Success) pNewNodePath->InkPath.IsFilled = TRUE; // If Success is TRUE, then we now have a new NodePath object that contains this shape's path if (Success) { // Remember the contone colours before we go and hide the applied attributes DocColour* ContoneStart = GetStartColour(); DocColour* ContoneEnd = GetEndColour(); switch (pBecomeA->GetReason()) { case BECOMEA_REPLACE : { // It's a BECOMEA_REPLACE, so replace this node with the new NodePath in an undoable way // Can't do it in an undoable way without an Undo Op // ERROR2IF_PF(pBecomeA->GetUndoOp() == NULL,FALSE,("GetUndoOp() returned NULL")); // The NodeBitmap uses the Fill and line colours to set it's // contone colours. // But the bitmap fill doesn't need them, so we will Hide // any of these attributes that we find applied Node* pChild = FindFirstChild(); while (pChild != NULL) { Node* pThisChild = pChild; pChild = pChild->FindNext(); // Find next before we hide this child if (pThisChild->IsAnAttribute()) { NodeAttribute* pAttr = (NodeAttribute*)pThisChild; if (pAttr->IsAColourFill() || pAttr->IsAStrokeColour() ) { if (pUndoOp) { // Hide and Fill or Line colour attributes NodeHidden* pNodeHidden; Success = pBecomeA->GetUndoOp()->DoHideNode(pAttr, TRUE, &pNodeHidden); } else { pAttr->CascadeDelete(); delete pAttr; } } } } // Now make a Bitmap Fill that is equivalent to this NodeBitmap AttrFillGeometry* pBitmapFill; ALLOC_WITH_FAIL(pBitmapFill , new AttrBitmapColourFill(), pBecomeA->GetUndoOp()); if (pBitmapFill) { pBitmapFill->AttachBitmap(GetBitmap()); // Set any contone colours that we have pBitmapFill->SetStartColour(ContoneStart); pBitmapFill->SetEndColour(ContoneEnd); // Set the control points from the NodeBitmap Parallelogram pBitmapFill->SetStartPoint(&Parallel[3]); pBitmapFill->SetEndPoint(&Parallel[2]); pBitmapFill->SetEndPoint2(&Parallel[0]); pBitmapFill->AttachNode(this, FIRSTCHILD); if (pUndoOp) { // Create a hide node action to hide the node when we undo HideNodeAction* UndoHideNodeAction; Success = (HideNodeAction::Init(pBecomeA->GetUndoOp(), pBecomeA->GetUndoOp()->GetUndoActionList(), pBitmapFill, TRUE, // Include subtree size ( Action**)(&UndoHideNodeAction)) != AC_FAIL); } } // We also need to make sure it has no line colour AttrFillGeometry* pStrokeColour; ALLOC_WITH_FAIL(pStrokeColour , new AttrStrokeColour(), pBecomeA->GetUndoOp()); if (pStrokeColour) { // Ensure the line colour is set to NONE DocColour NoCol = COLOUR_NONE; pStrokeColour->SetStartColour(&NoCol); pStrokeColour->AttachNode(this, FIRSTCHILD); if (pUndoOp) { // Create a hide node action to hide the node when we undo HideNodeAction* UndoHideNodeAction; Success = (HideNodeAction::Init(pBecomeA->GetUndoOp(), pBecomeA->GetUndoOp()->GetUndoActionList(), pStrokeColour, TRUE, // Include subtree size ( Action**)(&UndoHideNodeAction)) != AC_FAIL); } } // Copy the node's attributes CALL_WITH_FAIL(CopyChildrenTo(pNewNodePath), pBecomeA->GetUndoOp(), Success); // Insert the new NodePath into the tree, next to this node pNewNodePath->AttachNode(this,NEXT); if (Success) { // Set the bounds pNewNodePath->InvalidateBoundingRect(); pNewNodePath->SetSelected(IsSelected()); if (pUndoOp) { // Create a hide node action to hide the node when we undo HideNodeAction* UndoHideNodeAction; Success = (HideNodeAction::Init(pBecomeA->GetUndoOp(), pBecomeA->GetUndoOp()->GetUndoActionList(), pNewNodePath, TRUE, // Include subtree size ( Action**)(&UndoHideNodeAction)) != AC_FAIL); } } if (Success) { CCAttrMap AttrMap; CCAttrMap* pAttrMap = NULL; BOOL bFoundAttrs = pNewNodePath->FindAppliedAttributes(&AttrMap); if (bFoundAttrs) pAttrMap = AttrMap.Copy(); pBecomeA->PassBack(pNewNodePath, this, pAttrMap); } // Now hide this NodeBitmap if (pUndoOp) { NodeHidden* pNodeHidden; Success = pBecomeA->GetUndoOp()->DoHideNode(this, TRUE, &pNodeHidden); } else { CascadeDelete(); delete this; // Scary! } } break; case BECOMEA_PASSBACK : { // First find all attributes applied to this node... // 30 is a default value - this will grow if it needs more space CCAttrMap* pAttribMap = new CCAttrMap(30); CCAttrMap* pCopyOfAttrMap = NULL; // Now find any attributes that are applied to this node. /*BOOL FoundAttrs =*/ FindAppliedAttributes(pAttribMap); // size_t AttrCount = FoundAttrs ? pAttribMap->GetCount() : 30; // Now make a copy of the applied attributes map pCopyOfAttrMap = pAttribMap->Copy ();//new CCAttrMap(AttrCount); if (pCopyOfAttrMap != NULL) { // We've made a copy of the Attr map now, so we don't need // the old one anymore delete pAttribMap; // Replace the Fill and Line Colour attributes // in the Attr Map copy AttrFillGeometry* pBitmapFill = new AttrBitmapColourFill(); if (pBitmapFill) { // Make a Bitmap Fill that is equivalent to this // node bitmap pBitmapFill->AttachBitmap(GetBitmap()); // Set any contone colours that we have pBitmapFill->SetStartColour(ContoneStart); pBitmapFill->SetEndColour(ContoneEnd); // Set the control points from the NodeBitmap Parallelogram pBitmapFill->SetStartPoint(&Parallel[3]); pBitmapFill->SetEndPoint(&Parallel[2]); pBitmapFill->SetEndPoint2(&Parallel[0]); void* pOldFill; if( pCopyOfAttrMap->Lookup( CC_RUNTIME_CLASS(AttrFillGeometry), pOldFill ) ) { // We need to Remove and Delete the existing Fill Attr pCopyOfAttrMap->RemoveKey( CC_RUNTIME_CLASS(AttrFillGeometry) ); delete (AttrFillGeometry*)pOldFill; } // Add the Bitmap fill into the Attr Map pCopyOfAttrMap->SetAt( CC_RUNTIME_CLASS(AttrFillGeometry), (void*)pBitmapFill ); } AttrFillGeometry* pStrokeColour = new AttrStrokeColour(); if (pStrokeColour) { // Ensure the line colour is set to NONE DocColour NoCol = COLOUR_NONE; pStrokeColour->SetStartColour(&NoCol); void* pOldStroke; if( pCopyOfAttrMap->Lookup( CC_RUNTIME_CLASS(AttrStrokeColour), pOldStroke ) ) { // We need to Remove and Delete the existing Stroke Colour Attr pCopyOfAttrMap->RemoveKey( CC_RUNTIME_CLASS(AttrStrokeColour) ); delete (AttrFillGeometry*)pOldStroke; } // Add the new Stroke Colour into the Attr Map pCopyOfAttrMap->SetAt( CC_RUNTIME_CLASS(AttrStrokeColour), (void*)pStrokeColour ); } } Success = pBecomeA->PassBack(pNewNodePath, this, pCopyOfAttrMap); } break; case BECOMEA_TEST: // Do nothing break; default: { ERROR3("Unhandled BecomeA type in NodeBitmap::DoBecomeA"); } } } } if (!Success) { if (pNewNodePath != NULL) { // Delete all the NodePath's children (if it has any) and unlink it from the tree (if it's linked) // This is all done by CascadeDelete() pNewNodePath->CascadeDelete(); delete pNewNodePath; pNewNodePath = NULL; } } return Success; } /******************************************************************************************** > virtual BOOL NodeBitmap::AllowOp(ObjChangeParam* pParam,BOOL SetOpPermissionState = TRUE) Author: Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>

KernelBitmap * NodeBitmap::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. Reimplemented in NodeAnimatingBitmap. Definition at line 2444 of file nodebmp.cpp. : Gerry_Iles (Xara Group Ltd) <camelotdev@xara.com>

BOOL NodeBitmap::ExportRender (  RenderRegion *  pRegion  )  [virtual]

Export a bitmap object to a file. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 01/09/94 Parameters: pRegion  - the export render region to export to. [INPUTS] Returns: TRUE if the bitmap was exported ok; FALSE if not. Errors: Usual disk/file errors. See also: Filter::ExportBitmap Reimplemented from NodeRenderableInk. Definition at line 625 of file nodebmp.cpp. { #ifdef DO_EXPORT if (pRegion->IsKindOf(CC_RUNTIME_CLASS(CamelotEPSRenderRegion))) { // Get valid transparency fill for this object CamelotEPSRenderRegion *pCamelotRegion = (CamelotEPSRenderRegion *) pRegion; pCamelotRegion->GetValidPathAttributes(); // Output bitmap object position and keyword... EPSExportDC *pDC = (EPSExportDC *) pRegion->GetRenderDC(); DocCoord *Coords = InkPath.GetCoordArray(); // Bodge Code // So this is some Bodge code to make Bitmaps in moulds, save themselves // correctly if a Line colour is applied to the Mould. // This line colour makes the Bitmap think it has been contoned, so we save out // a contoned version, which is looks incorrect when re-loaded. // To get around this problem, this code checks specifically for the situation, // and forces the bitmap to be saved as a non-contoned version. BOOL CanSaveAsContoned = TRUE; BOOL LineColourIsAppliedToMould = FALSE; if (GetBitmap() && GetBitmap()->GetBPP() <= 8) { // We only need to worry about this for < 8BPP NodeAttribute* pLineAttr; // So we find the applied Stroke Colour ... if (FindAppliedAttribute(CC_RUNTIME_CLASS(AttrStrokeColour), &pLineAttr)) { Node* pParent = pLineAttr->FindParent(); // And if it has been applied to a Mould ... if (pParent && IS_A(pParent, NodeMould)) { LineColourIsAppliedToMould = TRUE; // and there is no Flat Colour Applied to the Bitmap, // then this flag will be FALSE, stopping the bitmap // from being saved as contone. CanSaveAsContoned = (GetEndColour() != NULL); } } } if (CanSaveAsContoned && (GetStartColour() || GetEndColour())) { // Must be a contone bitmap // If either the start or end colour is NULL, we need // to output a dummy colour, because 'No_Colour' doesn't // get saved if (LineColourIsAppliedToMould || GetStartColour() == NULL) { DocColour StartCol; AttributeManager::FindDefaultColour(ColourManager::GetCurrentColourList(), _R(IDS_BLACKNAME), &StartCol); if (*GetEndColour() == StartCol) { AttributeManager::FindDefaultColour(ColourManager::GetCurrentColourList(), _R(IDS_WHITENAME), &StartCol); } // Output dummy start colour here if (StartCol.FindParentIndexedColour() == NULL) { // Unnamed colour PColourCMYK CMYK; StartCol.GetCMYKValue(&CMYK); pDC->OutputColour(&CMYK); pDC->OutputToken(_T("K")); } else { // Named colour pDC->OutputNamedColour(&StartCol); pDC->OutputToken(_T("X")); } pDC->OutputNewLine(); } else if (GetEndColour() == NULL) { DocColour EndCol; AttributeManager::FindDefaultColour(ColourManager::GetCurrentColourList(), _R(IDS_WHITENAME), &EndCol); if (*GetStartColour() == EndCol) { AttributeManager::FindDefaultColour(ColourManager::GetCurrentColourList(), _R(IDS_BLACKNAME), &EndCol); } // Output dummy end colour here if (EndCol.FindParentIndexedColour() == NULL) { // Unnamed colour PColourCMYK CMYK; EndCol.GetCMYKValue(&CMYK); pDC->OutputColour(&CMYK); pDC->OutputToken(_T("k")); } else { // Named colour pDC->OutputNamedColour(&EndCol); pDC->OutputToken(_T("x")); } pDC->OutputNewLine(); } // Co-ords first, for (INT32 i = 0; i <= 3; i++) pDC->OutputCoord(Coords[i]); // ...then the bitmap object token. pDC->OutputToken(_T("cbm")); pDC->OutputNewLine(); // ...and then the bitmap data itself. pDC->GetParentFilter()->ExportBitmap(*GetBitmap()); } else { // It's not a contone bitmap.