cntrtool.cpp

Go to the documentation of this file.

// $Id: cntrtool.cpp 1386 2006-06-28 17:49:55Z alex $
/* @@tag:xara-cn@@ DO NOT MODIFY THIS LINE
================================XARAHEADERSTART===========================
 
               Xara LX, a vector drawing and manipulation program.
                    Copyright (C) 1993-2006 Xara Group Ltd.
       Copyright on certain contributions may be held in joint with their
              respective authors. See AUTHORS file for details.

LICENSE TO USE AND MODIFY SOFTWARE
----------------------------------

This file is part of Xara LX.

Xara LX is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 as published
by the Free Software Foundation.

Xara LX and its component source files are distributed in the hope
that it will be useful, but WITHOUT ANY WARRANTY; without even the
implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with Xara LX (see the file GPL in the root directory of the
distribution); if not, write to the Free Software Foundation, Inc., 51
Franklin St, Fifth Floor, Boston, MA  02110-1301 USA


ADDITIONAL RIGHTS
-----------------

Conditional upon your continuing compliance with the GNU General Public
License described above, Xara Group Ltd grants to you certain additional
rights. 

The additional rights are to use, modify, and distribute the software
together with the wxWidgets library, the wxXtra library, and the "CDraw"
library and any other such library that any version of Xara LX relased
by Xara Group Ltd requires in order to compile and execute, including
the static linking of that library to XaraLX. In the case of the
"CDraw" library, you may satisfy obligation under the GNU General Public
License to provide source code by providing a binary copy of the library
concerned and a copy of the license accompanying it.

Nothing in this section restricts any of the rights you have under
the GNU General Public License.


SCOPE OF LICENSE
----------------

This license applies to this program (XaraLX) and its constituent source
files only, and does not necessarily apply to other Xara products which may
in part share the same code base, and are subject to their own licensing
terms.

This license does not apply to files in the wxXtra directory, which
are built into a separate library, and are subject to the wxWindows
license contained within that directory in the file "WXXTRA-LICENSE".

This license does not apply to the binary libraries (if any) within
the "libs" directory, which are subject to a separate license contained
within that directory in the file "LIBS-LICENSE".


ARRANGEMENTS FOR CONTRIBUTION OF MODIFICATIONS
----------------------------------------------

Subject to the terms of the GNU Public License (see above), you are
free to do whatever you like with your modifications. However, you may
(at your option) wish contribute them to Xara's source tree. You can
find details of how to do this at:
  http://www.xaraxtreme.org/developers/

Prior to contributing your modifications, you will need to complete our
contributor agreement. This can be found at:
  http://www.xaraxtreme.org/developers/contribute/

Please note that Xara will not accept modifications which modify any of
the text between the start and end of this header (marked
XARAHEADERSTART and XARAHEADEREND).


MARKS
-----

Xara, Xara LX, Xara X, Xara X/Xtreme, Xara Xtreme, the Xtreme and Xara
designs are registered or unregistered trademarks, design-marks, and/or
service marks of Xara Group Ltd. All rights in these marks are reserved.


      Xara Group Ltd, Gaddesden Place, Hemel Hempstead, HP2 6EX, UK.
                        http://www.xara.com/

=================================XARAHEADEREND============================
 */
// Implementation of the blend tool

/*
*/

#include "camtypes.h"
#include "oilfiles.h"
#include "csrstack.h"
//#include "docview.h" - in camtypes.h [AUTOMATICALLY REMOVED]
//#include "markn.h"
//#include "spread.h" - in camtypes.h [AUTOMATICALLY REMOVED]
#include "nodepath.h"
#include "progress.h"
#include "nodeblnd.h"
#include "nodebldr.h"
//#include "simon.h"
#include "blobs.h"
//#include "blndres.h"
#include "objchge.h"
//#include "resource.h"
//#include "barsdlgs.h"
//#include "will.h"
#include "filltool.h"
#include "bubbleid.h"
//#include "becomea.h" - in camtypes.h [AUTOMATICALLY REMOVED]
#include "attrmap.h"
#include "ndbldpth.h"
#include "pathedit.h"
#include "keypress.h"
#include "vkextra.h"
#include "ezmodule.h"
#include "opbevel.h"
//#include "will2.h"
//#include "biasres.h"
#include "opcntr.h"
#include "cntrtool.h"
#include "ppbevel.h"
#include "nodetxts.h"   // for TextStory.
//#include "camvw.h"
#include "layer.h"
#include "ophist.h"
// the resources headers
//#include "cntres.h"
#include "gclips.h"

// for bevels & shadows
#include "nodecont.h"
#include "nodecntr.h"
#include "ncntrcnt.h"
//#include "rikdlg.h"
#include "nodemold.h"
#include "ndclpcnt.h"
#include "biasdlg.h"
#include "helpuser.h"
//#include "xshelpid.h"
//#include "helppath.h"
#include "dragmgr.h"
#include "lineattr.h"
#include "effects_stack.h"
#include "blndtool.h"
#include "nbevcont.h"

DECLARE_SOURCE( "$Revision: 1386 $" );
                                                
CC_IMPLEMENT_MEMDUMP(ContourTool,Tool_v1)
CC_IMPLEMENT_DYNCREATE(ContourInfoBarOp,InformationBarOp)
CC_IMPLEMENT_DYNCREATE(OpContourNodes,SelOperation)

// Must come after the last CC_IMPLEMENT.. macro
#define new CAM_DEBUG_NEW     

// These are still char* while we wait for resource technology to be developed for modules
TCHAR* ContourTool::FamilyName  = _T("Contour Tools");
TCHAR* ContourTool::ToolName    = _T("Contour Tool");
TCHAR* ContourTool::Purpose     = _T("Contour manipulation");
TCHAR* ContourTool::Author      = _T("David Mc");

// Init those other useful static vars
ContourInfoBarOp*   ContourTool::pContourInfoBarOp          = NULL;
BlendToolRef*   ContourTool::pRefStart              = NULL;
BlendToolRef*   ContourTool::pRefEnd                = NULL;
Cursor*         ContourTool::pcNormalCursor         = NULL;
Cursor*         ContourTool::pcOverBlob             = NULL;
Cursor*         ContourTool::pcCurrentCursor            = NULL;
INT32           ContourTool::CurrentCursorID            = 0;
UINT32          ContourTool::StatusID                   = _R(IDS_CONTOURDRAGHELP);

OpContourNodes      *ContourTool::m_pOpContourNodes = NULL;

// maximum & minimum values for the contour slider
#define CONTOUR_DEPTH_MIN 10
#define CONTOUR_DEPTH_MAX 250000

//#define Swap(a,b)       { (a)^=(b), (b)^=(a), (a)^=(b); }

#define SWAP(type,a,b) { type x=a; a=b; b=x; }

// Flatness settings
const INT32 ContourToolFlatness=2048;

// Profile for the logarithmic width slider
CProfileBiasGain SliderProfile((AFp)0.7, (AFp)0.0);


/********************************************************************************************

>   ContourTool::ContourTool()

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Purpose:    Default Constructor.
                Other initialisation is done in ContourTool::Init which is called by the Tool Manager
    SeeAlso:    ContourTool::Init

********************************************************************************************/

ContourTool::ContourTool()
{
    pcCurrentCursor = NULL;
    m_bDisableBlobRenderingFlag = FALSE;
}

/********************************************************************************************

>   ContourTool::~ContourTool()

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Purpose:    Destructor.

********************************************************************************************/

ContourTool::~ContourTool()
{
    if (pRefStart != NULL)
    {
        delete pRefStart;
        pRefStart = NULL;
    }

    if (pRefEnd != NULL)
    {
        delete pRefEnd;
        pRefEnd = NULL;
    }

    if (m_pOpContourNodes)
    {
        delete m_pOpContourNodes;
        m_pOpContourNodes = NULL;
    }
}


/********************************************************************************************

>   BOOL ContourTool::Init( INT32 Pass )

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Returns:    FALSE if it does not want to be created, TRUE otherwise
    Purpose:    Used to check if the Tool was properly constructed
    SeeAlso:    ContourTool::ContourTool

********************************************************************************************/

BOOL ContourTool::Init()
{
    // Declare all your ops here and only succeed if all declarations succeed
    BOOL ok =   OpContourNodes::Declare() &&
        OpChangeContourToInner::Declare() &&
        OpChangeContourToOuter::Declare() &&
        OpRemoveContour::Declare() &&
        OpChangeContourSteps::Declare() &&
        OpChangeContourColourType::Declare() &&
        OpChangeContourAttributeProfile::Declare() &&
        OpChangeContourObjectProfile::Declare() &&
        OpChangeContourStepDistance::Declare() &&
        OpToggleContourInsetPath::Declare();
    
    if (!ok) return FALSE;

    m_pOpContourNodes = new OpContourNodes;

    if (!m_pOpContourNodes)
        return FALSE;

    // We need two BlendToolRef objects
    ContourTool::pRefStart = new BlendToolRef;
    ContourTool::pRefEnd   = new BlendToolRef;

    ok = (ContourTool::pRefStart != NULL && ContourTool::pRefEnd != NULL);

    // This section reads in the infobar definition and creates an instance of
    // ContourInfoBarOp.  Also pContourInfoBarOp, the ptr to the tool's infobar, is set up
    // after the infobar is successfully read and created.
    if (ok)
    {
#if 0       
        CCResTextFile       file;               // Resource File
        ContourInfoBarOpCreate BarCreate;           // Object that creates ContourInfoBarOp objects

//              ok = file.open(_R(IDM_BLEND_BAR), _R(IDT_INFO_BAR_RES));        // Open resource
                ok = file.open( _R(IDM_CONTOUR_BAR), _R(IDT_INFO_BAR_RES) );
        if (ok) ok = DialogBarOp::ReadBarsFromFile(file,BarCreate); // Read and create info bar
        if (ok) file.close();                                       // Close resource

        ENSURE(ok,"Unable to load blendbar.ini from resource\n"); 

        if (ok)
        {
            // Info bar now exists.  Now get a pointer to it
            String_32 str = String_32(_R(IDS_CONTOURTOOL_INFOBARNAME));
            DialogBarOp* pDialogBarOp = DialogBarOp::FindDialogBarOp(str);

                    ok = (pDialogBarOp != NULL);
            if (ok) ok = pDialogBarOp->IsKindOf(CC_RUNTIME_CLASS(ContourInfoBarOp));
            if (ok) pContourInfoBarOp = (ContourInfoBarOp*)pDialogBarOp;

            ENSURE(ok,"Error finding the blend tool info bar");
        }
#endif
        pContourInfoBarOp = new ContourInfoBarOp();
        ok = (pContourInfoBarOp != NULL);

    }

    return (ok);
}


/********************************************************************************************

>   void ContourTool::Describe(void *InfoPtr)

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Inputs:     InfoPtr -   A pointer to a tool info block. It is passed cast to void* as
                            the version of the tool is unknown at this point. Later versions 
                            of the Tool class may have more items in this block, that this 
                            tool will not use
    Outputs:    InfoPtr -   The structure pointed to by InfoPtr will have had all the info
                            that this version of the Tool knows about
    Purpose:    Allows the tool manager to extract information about the tool

********************************************************************************************/

void ContourTool::Describe(void *InfoPtr)
{
    // Cast structure into the latest one we understand.
    ToolInfo_v1 *Info = (ToolInfo_v1 *) InfoPtr;

    Info->InfoVersion = 1;
    
    Info->InterfaceVersion = GetToolInterfaceVersion();  // You should always have this line.
        
    // These are all arbitrary at present.
    Info->Version = 1;
    Info->ID      = GetID();
    Info->TextID  = _R(IDS_CONTOUR_TOOL);

    Info->Family  = FamilyName;
    Info->Name    = ToolName;
    Info->Purpose = Purpose;
    Info->Author  = Author;

    Info->BubbleID = _R(IDBBL_CONTOUR_TOOLBOX);
}

/********************************************************************************************

>   virtual void ContourTool::SelectChange(BOOL isSelected)

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Inputs:     isSelected  - TRUE  = tool has been selected
                            - FALSE = tool has been deselected
    Outputs:    -
    Returns:    -
    Purpose:    Starts up and closes down the blend tool
    Errors:     Debug warning if creating the cursor fails.
    SeeAlso:    -

********************************************************************************************/

void ContourTool::SelectChange(BOOL isSelected)
{
// Stub out this function if the tool isn't wanted
#ifndef NO_ADVANCED_TOOLS
    if (isSelected)
    {
        if (!CreateCursors()) return;
        CurrentCursorID = CursorStack::GPush(pcNormalCursor, FALSE);        // Push cursor but don't display now
        pcCurrentCursor = pcNormalCursor;

        // Create and display the tool's info bar
        pContourInfoBarOp->Create();

        // Which blobs do I want displayed
        BlobManager* BlobMgr = GetApplication()->GetBlobManager();
        if (BlobMgr != NULL)
        {
            // Decide which blobs we will display
            BlobStyle MyBlobs;
            MyBlobs.Object = FALSE;
            MyBlobs.Tiny = TRUE;
            // Tell the blob manager
            BlobMgr->ToolInterest(MyBlobs);
        }

        Document* pDoc = Document::GetCurrent();
        SetupToolBlobs();

        if (pDoc != NULL)
            RenderToolBlobs(pDoc->GetSelectedSpread(),NULL);

        pContourInfoBarOp->m_pTool = this;
    }
    else
    {
        // Deselection - destroy the tool's cursors, if they exist.
        if (pcCurrentCursor != NULL)
        {
            CursorStack::GPop(CurrentCursorID);
            pcCurrentCursor = NULL;
            CurrentCursorID = 0;
        }
        DestroyCursors();

        pContourInfoBarOp->CloseProfileDialog (pContourInfoBarOp->m_BiasGainObjectGadget);
        pContourInfoBarOp->CloseProfileDialog (pContourInfoBarOp->m_BiasGainAttrGadget);

        // Remove the info bar from view by deleting the actual underlying window
        pContourInfoBarOp->Delete();

        // ensure any tool object blobs are removed.
        BlobManager* BlobMgr = GetApplication()->GetBlobManager();
        if (BlobMgr != NULL)
        {
            BlobStyle bsRemoves;
            bsRemoves.ToolObject = TRUE;
            BlobMgr->RemoveInterest(bsRemoves);
        }

        Document* pDoc = Document::GetCurrent();
        if (pDoc != NULL)
            RenderToolBlobs(pDoc->GetSelectedSpread(),NULL);
    }
#endif  // NO_ADVANCED_TOOLS
}

/********************************************************************************************

>   void ContourTool::SetupToolBlobs()

    Author:     David_McClarnon (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Inputs:     -
    Outputs:    -
    Returns:    
    Purpose:    Sets up the tool blobs for the current selection.

                Karim 28/07/2000
                Contour tool blobs are laid out like so relative to the selection:

                        2   4   3

                        6   *   7

                        0   5   1

                with corner blobs positioned 1 pixel out from the bounds rect
                and middle blobs positioned 2 pixels out from the bounds rect.

    SeeAlso:    -

********************************************************************************************/
void ContourTool::SetupToolBlobs()
{
    // reset the blob positions.
    for (INT32 i = 0 ; i < 8; i++)
    {
        m_BlobPoints[i].x = 0;
        m_BlobPoints[i].y = 0;
    }

    // give up if we there is no selection or we can't get the info we need.
    if (GetApplication()->FindSelection() == NULL)
        return;

    if (GetApplication()->FindSelection()->IsEmpty())
        return;

    BlobManager * pBlobMgr = GetApplication()->GetBlobManager();
    if (pBlobMgr == NULL)
        return;

    // figure out the blob offsets, in millipoints.
    INT32 BlobGap = 0;
    DocView* pDocView = DocView::GetSelected();
    if (pDocView != NULL)
        BlobGap = pDocView->GetScaledPixelWidth().MakeLong();

    // ok, get the bounds of the selection, including contours.
    SelRange Sel(*(GetApplication()->FindSelection()));
    DocRect drBounds;
    Node* pN = Sel.FindFirst();
    while (pN != NULL)
    {
        if (pN->IsBounded())
        {
            Node* pParent = pN->FindParent();
            while (pParent != NULL && pParent->IS_KIND_OF(NodeContourController))
            {
                pN = pParent;
                pParent = pN->FindParent();
            }

            drBounds = drBounds.Union( ((NodeRenderableBounded*)pN)->GetBoundingRect() );
        }
        pN = Sel.FindNext(pN);
    }

    // lets set up those blobs!
    DocCoord dc;
    drBounds.Inflate(BlobGap);
    INT32 BlobSize = pBlobMgr->GetBlobSize();

    dc.x = drBounds.lo.x - BlobSize;
    dc.y = drBounds.lo.y - BlobSize;
    m_BlobPoints[0] = dc;

    dc.x = drBounds.hi.x + BlobSize;
    dc.y = drBounds.lo.y - BlobSize;
    m_BlobPoints[1] = dc;

    dc.x = drBounds.lo.x - BlobSize;
    dc.y = drBounds.hi.y + BlobSize;
    m_BlobPoints[2] = dc;

    dc.x = drBounds.hi.x + BlobSize;
    dc.y = drBounds.hi.y + BlobSize;
    m_BlobPoints[3] = dc;

    dc.x = (drBounds.lo.x + drBounds.hi.x) / 2;
    dc.y = drBounds.hi.y + BlobSize + BlobGap;
    m_BlobPoints[4] = dc;

    dc.x = (drBounds.lo.x + drBounds.hi.x) / 2;
    dc.y = drBounds.lo.y - BlobSize - BlobGap;
    m_BlobPoints[5] = dc;

    dc.x = drBounds.lo.x - BlobSize - BlobGap;
    dc.y = (drBounds.lo.y + drBounds.hi.y) / 2;
    m_BlobPoints[6] = dc;

    dc.x = drBounds.hi.x + BlobSize + BlobGap;
    dc.y = (drBounds.lo.y + drBounds.hi.y) / 2;
    m_BlobPoints[7] = dc;
}



/********************************************************************************************

>   BOOL ContourTool::CreateCursors()

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Inputs:     -
    Outputs:    -
    Returns:    TRUE if all the blend tool cursors have been successfully created
    Purpose:    Creates all the blend tool cursors
    SeeAlso:    -

********************************************************************************************/

BOOL ContourTool::CreateCursors()
{
    // This tool has just been selected.  Create the cursors.
    pcNormalCursor          = new Cursor(this, _R(IDC_POINTER_CONTOUR));
    pcOverBlob              = new Cursor(this, _R(IDC_SELECT_CONTOUR));
    
    if ( pcNormalCursor         ==NULL || !pcNormalCursor->IsValid() ||
        pcOverBlob== NULL || !pcOverBlob->IsValid()
       )
    {
        DestroyCursors();
        return FALSE;
    }
    else
        return TRUE;
}

/********************************************************************************************

>   BOOL ContourTool::IsPointOverBlob(DocCoord &Point, DocRect * pBlobRect)

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Inputs:     A point in document coordinates, and the doc rect variable to
                put the blob rect into
    Outputs:    -
    Returns:    TRUE if the point is over a blob, false otherwise
    Purpose:    Creates all the blend tool cursors
    SeeAlso:    -

********************************************************************************************/
BOOL ContourTool::IsPointOverBlob(DocCoord &Point, DocRect * pBlobRect)
{
    // check to see if I'm over a blob
    BlobManager * pBlobMgr = GetApplication()->GetBlobManager();

    INT32 BlobSize = 0;

    // Karim 18/09/2000
    // The contour blobs are about twice the size of normal blobs,
    // so I'm doubling the value of BlobSize when checking for them.
    if (pBlobMgr)
        BlobSize = pBlobMgr->GetBlobSize();
//      BlobSize = pBlobMgr->GetBlobSize()/2;

    for (INT32 i = 0; i < 8; i++)
    {
        DocRect dr( m_BlobPoints[i].x - BlobSize,
                    m_BlobPoints[i].y - BlobSize,
                    m_BlobPoints[i].x + BlobSize,
                    m_BlobPoints[i].y + BlobSize);

        if (dr.ContainsCoord(Point))
        {
            if (pBlobRect)
                *pBlobRect = dr;
            return TRUE;
        }
    }

    return FALSE;
}

/********************************************************************************************

>   void ContourTool::DestroyCursors()

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Inputs:     -
    Outputs:    -
    Returns:    -
    Purpose:    Destroys all the blend tool cursors
    SeeAlso:    -

********************************************************************************************/

void ContourTool::DestroyCursors()
{
    if (pcNormalCursor          != NULL) delete pcNormalCursor;
    if (pcOverBlob              != NULL) delete pcOverBlob;

    pcNormalCursor = NULL;
    pcOverBlob = NULL;
}

/********************************************************************************************

>   BOOL ContourTool::OnKeyPress(KeyPress* pKeyPress)

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    1/6/99
    Inputs:     pKeyPress - pointer to a keypress object
    Returns:    TRUE if it handled the keypress, FALSE otherwise
    Purpose:    To handle keypress events for the Blend Tool.

********************************************************************************************/

BOOL ContourTool::OnKeyPress(KeyPress* pKeyPress)
{
#ifdef _DEBUG
    if (pKeyPress == NULL)
        return FALSE;

    if (pKeyPress->IsRepeat())
        return FALSE;

    if (pKeyPress->IsRelease())
        return FALSE;

    AFp BiasDelta = 0.0;
    AFp GainDelta = 0.0;
    BOOL Reset = FALSE;
    if (*pKeyPress == KeyPress(CAMKEY(Z)))  { BiasDelta = -0.1; TRACEUSER( "Markn", _T("Decrease Bias by 0.1\n"));}
    if (*pKeyPress == KeyPress(CAMKEY(X)))  { BiasDelta =  0.1; TRACEUSER( "Markn", _T("Increase Bias by 0.1\n"));}
    if (*pKeyPress == KeyPress(CAMKEY(N)))  { GainDelta = -0.1; TRACEUSER( "Markn", _T("Decrease Gain by 0.1\n"));}
    if (*pKeyPress == KeyPress(CAMKEY(M)))  { GainDelta =  0.1; TRACEUSER( "Markn", _T("Increase Gain by 0.1\n"));}

    if (*pKeyPress == KeyPress(CAMKEY(R)))  { Reset = TRUE;     TRACEUSER( "Markn", _T("Resetting Bias and Gain\n"));}

    SelRange* pSelRange = GetApplication()->FindSelection();
    Node* pNode = pSelRange->FindFirst();
    while (pNode)
    {
        if (IS_A(pNode,NodeBlend))
        {
            NodeBlend* pNodeBlend = (NodeBlend*)pNode;

            // This alters the Attribute profile, but can easily be modified to alter the Object profile if necessary
            CProfileBiasGain* pProfile = pNodeBlend->GetAttrProfile();
            if (pProfile)
            {
                AFp Bias = pProfile->GetBias() + BiasDelta;
                AFp Gain = pProfile->GetGain() + GainDelta;
                if (Reset)
                    Bias = Gain = 0.0;

                if (Bias < -0.9)    Bias = -0.9;
                if (Bias >  0.9)    Bias =  0.9;
                if (Gain < -0.9)    Gain = -0.9;
                if (Gain >  0.9)    Gain =  0.9;

                pProfile->SetBiasGain(Bias,Gain);
            }
        }
        // Now find the next selected node
        pNode = pSelRange->FindNext(pNode);
    }
#endif // _DEBUG

    return FALSE;
}

/********************************************************************************************

>   void ContourTool::OnClick( DocCoord PointerPos, ClickType Click, ClickModifiers ClickMods,
                        Spread* pSpread )

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Inputs:     PointerPos  -   The DocCoord of the point where the mouse button was clicked
                Click       -   Describes the type of click that was detected. 
                ClickMods   -   Indicates which buttons caused the click and which modifers were
                                pressed at the same time
                pSpread     -   The spread in which the click happened
    Returns:    -
    Purpose:    To handle a Mouse Click event for the Blend Tool.
    SeeAlso:    Tool::MouseClick; ClickType; ClickModifiers

********************************************************************************************/

void ContourTool::OnClick( DocCoord PointerPos, ClickType Click, ClickModifiers ClickMods,
                        Spread* pSpread )
{
// Stub out this function if the tool isn't wanted
#ifndef NO_ADVANCED_TOOLS
    if (ClickMods.Menu) return;                         // Don't do anything if the user clicked the Menu button

    ERROR3IF_PF(pSpread==NULL,("pSpread is NULL"));

//  NodeCompound * pCompound = NULL;

    DocRect BlobRect;

    switch (Click)
    {
        // if a drag was started, we alter or create a contour.
        case CLICKTYPE_DRAG:
        {
            if (m_pOpContourNodes)
            {
                m_pOpContourNodes->DoDrag(this, pContourInfoBarOp, PointerPos,
                    IsPointOverBlob(PointerPos, &BlobRect), &BlobRect);
                return;
            }
        }
        break;

        // we ignore all other click types, but note that they aren't drag-clicks.
        case CLICKTYPE_SINGLE:
        {
            // check for bevels existing
            List BevelList;
            BevelTools::BuildListOfSelectedNodes(&BevelList, CC_RUNTIME_CLASS(NodeBevelController));
            
            if (!BevelList.IsEmpty())
            {
                BevelList.DeleteAll();
                
                DocRect BlobRect;

                // disable the drag
                if (IsPointOverBlob(PointerPos, &BlobRect))
                {
                    DocView * pView = DocView::GetCurrent();

                    if (pView)
                        pView->EndDrag(NULL);               
                    
                    InformWarningBevelExistsInSelection();
                }
            }

            // call the base class ....

            DragTool::OnClick (PointerPos, Click, ClickMods, pSpread);
        }
        break;
        
        default:
            // call the base class ....
            
            DragTool::OnClick (PointerPos, Click, ClickMods, pSpread);
        break;
    }
#endif  // NO_ADVANCED_TOOLS
}

/********************************************************************************************

>   void ContourTool::InformWarningBevelExistsInSelection()

    Author:     David_McClarnon (Xara Group Ltd) <camelotdev@xara.com>
    Created:    7/4/2000
    Purpose:    Brings up the associated warning dialog
    SeeAlso:    Tool::MouseClick; ClickType; ClickModifiers

********************************************************************************************/
void ContourTool::InformWarningBevelExistsInSelection()
{
    String_256 QueryString(_R(IDS_CANTCONTOURBEVEL));

    Error::SetError(0, QueryString, 0);             
    // The only way of bringing up a box with a string in it
    INT32 DlgResult = InformError(_R(IDS_CANTCONTOURBEVEL),
        _R(IDS_OK), _R(IDS_HELP));
                
    if (DlgResult == 2)
    {
        HelpUserTopic(_R(IDS_HELPPATH_Message__Bevel_already_applied));
    }
}


/********************************************************************************************

>   void ContourTool::OnMouseMove( DocCoord PointerPos,Spread* pSpread, ClickModifiers ClickMods)

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    3/10/94
    Inputs:     PointerPos  -   The DocCoord of the point where the mouse has moved to
                pSpread     -   The spread in which the move occurred
    Returns:    TRUE if it handled the Click, FALSE otherwise
    Purpose:    To handle a Mouse Move event for the Blend Tool.
    SeeAlso:    Tool::MouseClick; ClickType; ClickModifiers

********************************************************************************************/

void ContourTool::OnMouseMove(DocCoord PointerPos,Spread* pSpread,ClickModifiers ClickMods)
{
// Stub out this function if the tool isn't wanted
#ifndef NO_ADVANCED_TOOLS
    ERROR3IF_PF(pSpread==NULL,("pSpread is NULL"));

//  BlobManager * pBlobMgr = GetApplication()->GetBlobManager();
//  INT32 BlobSize = pBlobMgr->GetBlobSize();

    if (IsPointOverBlob(PointerPos))
    {
        // change the cursor
        if (pcCurrentCursor != pcOverBlob )
        {
            if (pcCurrentCursor)
            {
                CursorStack::GPop(CurrentCursorID);
            }
            
            CurrentCursorID = CursorStack::GPush(pcOverBlob, TRUE);
            pcCurrentCursor = pcOverBlob;
            DisplayStatusBarHelp(_R(IDS_CONTOUROVERBLOBHELP));
        }
    }
    else
    {
        // change the cursor back
        if (pcCurrentCursor != pcNormalCursor )
        {
            if (pcCurrentCursor)
            {
                CursorStack::GPop(CurrentCursorID);
            }
            
            CurrentCursorID = CursorStack::GPush(pcNormalCursor, TRUE);
            pcCurrentCursor = pcNormalCursor;
            DisplayStatusBarHelp(_R(IDS_CONTOURDRAGHELP));
        }
    }
#endif  // NO_ADVANCED_TOOLS
}

/********************************************************************************************
>   void ContourTool::UpdateRef(    BlendToolRef* pRef,
                                Spread* pSpread, 
                                DocCoord PointerPos,
                                BOOL CheckNodeUnderPoint = TRUE)

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    10/10/94
    Inputs:     pRef                = ptr to a reference struct to update
                pSpread             = ptr to spread click occurred
                PointerPos          = the DocCoord of the click
                CheckNodeUnderPoint = TRUE to revert to click-detection search for underlying node
    Outputs:    The members of pRef are updated.
    Returns:    -
    Purpose:    This will update the blend tool ref depending on the current pointer pos.
                If CheckNodeUnderPoint is TRUE, then the routine will revert to a click-detection search
                to find out which node lies under the given point.  This is potentially very time-consuming.
    Errors:     -
    SeeAlso:    -
********************************************************************************************/

void ContourTool::UpdateRef(BlendToolRef* pRef,Spread* pSpread, DocCoord PointerPos,BOOL CheckNodeUnderPoint)
{
    ERROR3IF_PF(pRef   ==NULL,("pRef is NULL"));
    ERROR3IF_PF(pSpread==NULL,("pSpread is NULL"));

    // Set the spread and pointer pos members
    pRef->pSpread    = pSpread;
    pRef->PointerPos = PointerPos;
}

/********************************************************************************************
>   void ContourTool::UpdateCursorAndStatus()

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    10/10/94
    Inputs:     -
    Outputs:    -
    Returns:    -
    Purpose:    This will update the cursor and status line text depending on the data in the 
                two blend tool references within ContourTool.

                Copes with the following scenarios:
                    Pointer over an object
                    Dragging to another object
                    Pointer over a selected path's blob
                    Dragging to another blob in a selected path
                    Pointer over a blend blob
                    Dragging to a corresponding blend blob for remapping

    Errors:     -
    SeeAlso:    -
********************************************************************************************/

void ContourTool::UpdateCursorAndStatus()
{
    ERROR3IF_PF(pRefStart==NULL,("pRefStart is NULL"));
    ERROR3IF_PF(pRefEnd  ==NULL,("pRefEnd   is NULL"));

    DisplayStatusBarHelp(StatusID);
}

/********************************************************************************************

>   virtual BOOL ContourTool::GetStatusLineText(    String_256* ptext, 
                                                Spread* pSpread,
                                                DocCoord DocPos, 
                                                ClickModifiers ClickMods)
    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    19/12/94
    Inputs:     pStr        - ptr to string to place text in
                pSpread     - ptr to the spread in question
                DocPos      - position of mouse in doc (in spread coords)
                ClickMods   - mouse click modifiers
    Outputs:    *pStr - text for status line
    Returns:    TRUE if outputting valid text
    Purpose:    generate up-to-date text for the status line (called on idles)

********************************************************************************************/

BOOL ContourTool::GetStatusLineText(String_256* pStr,Spread* pSpread,DocCoord DocPos,ClickModifiers ClickMods)
{
    if (StatusID != 0)
    {
        *pStr = String_256(StatusID);
    }
    else
    {
        *pStr = String_256(_R(IDS_CONTOURDRAGHELP));
    }

    return TRUE;
}

/********************************************************************************************

>   BOOL ContourTool::IsPointOverPathBlob(DocCoord* pPointerPos,BlendToolRef* pRef)

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    10/10/94
    Inputs:     pPointerPos = ptr to position of mouse in DocCoords
                pRef        = ptr to blend tool ref to update
    Outputs:    Updates pRef->pNode and pRef->pIndex if a path blob was found.
                Also, if blob found, *pPointerPos is snapped to coord of blob
    Returns:    TRUE if the coord is over a blob of a selected path
    Purpose:    Scans for selected paths.  If the coord is over a selected path's blob,
                it returns TRUE and pRef->pNode points to the path, and pRef->Index contains
                the element index of the blob.
                Also, *pPointerPos is snapped to the coord of the centre of the blob, if found.

********************************************************************************************/

BOOL ContourTool::IsPointOverPathBlob(DocCoord* pPointerPos,BlendToolRef* pRef)
{
    if (pRef == NULL) return FALSE;

    // Find the selected range of objects
    SelRange* pSelRange = GetApplication()->FindSelection();
    Node* pNode = pSelRange->FindFirst();

    BOOL BlobFound = FALSE;

    // Scan the selection for NodePath objects
    while (!BlobFound && pNode != NULL && pNode->FindParent() != NULL)
    {
        // Only look at selected NodePaths that are NOT selected inside another node.
        if (IS_A(pNode,NodePath) && IS_A(pNode->FindParent(),Layer))
        {
            NodePath* pNodePath = (NodePath*)pNode;

            if (pNodePath->GetUnionBlobBoundingRect().ContainsCoord(*pPointerPos))
            {
                // Get a pointer to the Path object within the NodePath
                Path* pPath = &(pNodePath->InkPath);

                // Is it over a blob? (Only check end points. Forget about control points)
                BlobFound = pPath->FindNearestPoint(*pPointerPos,POINTFLAG_ENDPOINTS,&(pRef->Index));

                // If a blob is found, store ptr to the node
                if (BlobFound)
                {
                    pRef->pNode = pNodePath;
                    pPath->SetPathPosition(pRef->Index);
                    *pPointerPos = pPath->GetCoord();
                }
            }
        }

        // Now find the next selected node
        pNode = pSelRange->FindNext(pNode);
    }

    return BlobFound;
}

/********************************************************************************************

>   BOOL ContourTool::IsPointOverBlendBlob(DocCoord* pPointerPos,NodeRenderableInk** ppNodePath,INT32* pIndex)

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    10/11/94
    Inputs:     pPointerPos = ptr to position of mouse in DocCoords
                pRef        = ptr to blend tool ref to update
    Outputs:    Updates pRef->pNode pRef->pNodeBlend and pRef->Index if a blend blob was found.
                Also, if found, *pPointerPos = centre of blob
    Returns:    TRUE if the coord is over a blob of a selected blend
    Purpose:    Scans for selected blends.  If the coord is over a selected blend's blob,
                it returns TRUE and pRef->pNode points to the path, pRef->pNodeBlend points to the blend
                containing the path, and *pIndex contains the element index of the blob.
                Also, if found, *pPointerPos = centre of blob.

********************************************************************************************/

BOOL ContourTool::IsPointOverBlendBlob(DocCoord* pPointerPos,BlendToolRef* pRef)
{
    if (pRef == NULL) return FALSE;

    // Find the selected range of objects
    SelRange* pSelRange = GetApplication()->FindSelection();
    Node* pNode = pSelRange->FindFirst();

    BOOL BlobFound = FALSE;

    // Scan the selection for NodePath objects
    while (pNode != NULL && !BlobFound)
    {
        if (pNode->GetRuntimeClass() == CC_RUNTIME_CLASS(NodeBlend))
        {
            NodeBlend* pNodeBlend = (NodeBlend*)pNode;

            if (pNodeBlend->GetUnionBlobBoundingRect().ContainsCoord(*pPointerPos))
            {
                BlobFound = pNodeBlend->IsPointOverBlob(pPointerPos,
                                                        &(pRef->pBlendPath),
                                                        &(pRef->Index),
                                                        &(pRef->AStartNode),
                                                        &(pRef->RemapRef));

                if (BlobFound)
                {
                    pRef->pNode      = pNodeBlend;
                    pRef->pNodeBlend = pNodeBlend;
//                  *pPointerPos = pRef->pBlendPath->GetPathCoord(pRef->Index);
                }
            }
        }

        // Now find the next selected node
        pNode = pSelRange->FindNext(pNode);
    }

    return BlobFound;
}

/********************************************************************************************

>   void ContourTool::CheckNodeRemapping(BlendToolRef* pRefStart, BlendToolRef* pRefEnd)

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    6/12/94
    Inputs:     pRefStart = ptr to start ref
                pRefEnd   = ptr to end ref
    Outputs:    Potentailly updates pRefStart and pRefEnd, so that if they represent a remapping of nodes,
                they have the same remap reference
    Returns:    -
    Purpose:    This checks to see if the two references actually represent a node remapping within a blend.
                In order to cope with multi-stage blends, both references have to be looked at the same time.

                This is not the neatest way of doing it, but it's the quickest and safest method, given that
                it has to work for the gamma release it a few days time.

********************************************************************************************/

void ContourTool::CheckNodeRemapping(BlendToolRef* pRefStart, BlendToolRef* pRefEnd)
{
    ERROR3IF(pRefStart == NULL,"pRefStart == NULL");
    ERROR3IF(pRefEnd   == NULL,"pRefEnd == NULL");
}

/********************************************************************************************
>   NodeRenderableInk* ContourTool::FindObject(Spread* pSpread, DocCoord PointerPos)

    Author:     Mark_Neves (Xara Group Ltd) <camelotdev@xara.com>
    Created:    7/10/94
    Inputs:     pSpread  = ptr to spread click occurred
                PointerPos = the DocCoord of the click
    Outputs:    -
    Returns:    -
    Purpose:    Looks for a (possibly grouped) node(s) in the given spread at the
                given mouse-click position.  Convenient shorthand for the hit-testing
                functions.
    Errors:     -
    SeeAlso:    -
********************************************************************************************/

NodeRenderableInk* ContourTool::FindObject(Spread* pSpread, DocCoord PointerPos)
{
    return NodeRenderableInk::FindCompoundAtPoint(pSpread,PointerPos,NULL);
}

/********************************************************************************************

>   void ContourTool::RenderToolBlobs(Spread* pSpread,DocRect* pDocRect)

    Author:     Karim_MacDonald (Xara Group Ltd) <camelotdev@xara.com>
    Created:    28/07/2000
    Inputs:     pSpread     ptr to a spread.
                pDocRect    ptr to DocRect of spread to render in.
    Returns:    -
    Purpose:    Handles the RenderToolBlobs method.
                Renders the tool's blobs into the current doc view.

                In case you were wondering, this is how contour blobs are arranged:

                    2   4   3

                    6   *   7

                    0   5   1
    SeeAlso:    

********************************************************************************************/

void ContourTool::RenderToolBlobs(Spread* pSpread,DocRect* pDocRect)
{
//  BlobManager * pBlobMgr = GetApplication()->GetBlobManager();

    if (m_bDisableBlobRenderingFlag)
        return;

    // check the blobs to see if they're valid
    BOOL bZeroBlobs = TRUE;

    for (UINT32 i = 0 ; i < 8; i++)
    {
        if (m_BlobPoints[i].x != 0 ||
            m_BlobPoints[i].y != 0)
        {
            bZeroBlobs = FALSE;
            break;
        }