sglfills.cpp

Go to the documentation of this file.

// $Id: sglfills.cpp 1282 2006-06-09 09:46:49Z 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============================
 */

// SGLFills.cpp - LibFills SuperGallery classes

#include "camtypes.h"
#include "sglfills.h"

//#include "app.h"      // For GetApplication() - in camtypes.h [AUTOMATICALLY REMOVED]
//#include "galstr.h"
//#include "pathname.h" - in camtypes.h [AUTOMATICALLY REMOVED]
#include "sginit.h"
#include "sglfills.h"   // This .cpp file's corresponding header
#include "sglib.h"
#include "sgmenu.h"
//#include "thumb.h" - in camtypes.h [AUTOMATICALLY REMOVED]
#include "thumbmsg.h"

//#include "fillval.h" - in camtypes.h [AUTOMATICALLY REMOVED]
#include "grnddib.h"
//#include "galres.h"

//#include "richard.h"
#include "sgliboil.h"
//#include "errors.h" - in camtypes.h [AUTOMATICALLY REMOVED]
//#include "fixmem.h" - in camtypes.h [AUTOMATICALLY REMOVED]
//#include "selop.h" - in camtypes.h [AUTOMATICALLY REMOVED]

//#include "attrmgr.h" - in camtypes.h [AUTOMATICALLY REMOVED]
//#include "fillattr.h" - in camtypes.h [AUTOMATICALLY REMOVED]
#include "progress.h"
#include "camelot.h"

#include "dragmgr.h"
//#include "viewrc.h"       // FOR _R(IDC_CANDROPONPAGE)
//#include "resource.h"     // FOR _R(IDC_CANDROPONPAGE)
//#include "docview.h" - in camtypes.h [AUTOMATICALLY REMOVED]
//#include "spread.h" - in camtypes.h [AUTOMATICALLY REMOVED]
#include "nodebmp.h"

// For LibraryGallery
#include "sglbase.h"

//#include "sgscan.h" - in camtypes.h [AUTOMATICALLY REMOVED]
#include "sgscanf.h"

//#include "richard2.h"
#include "keypress.h"
#include "backgrnd.h"   // OpBackground
#include <io.h>
#include "inetop.h"
#include "helpuser.h"
//#include "xshelpid.h"
//#include "helppath.h"
#include "resdll.h"


// Implement the dynamic class bits...
CC_IMPLEMENT_DYNCREATE(LibFillsSGallery, LibraryGallery)
CC_IMPLEMENT_DYNCREATE(OpDisplayLibFillsGallery, Operation)
CC_IMPLEMENT_DYNCREATE(SGFillsItem, SGLibDisplayItem)

CC_IMPLEMENT_DYNCREATE(GalleryFillsDragInfo, BitmapDragInformation)
CC_IMPLEMENT_DYNAMIC(SGFillsDragTarget, SGListDragTarget)

// This line mustn't go before any CC_IMPLEMENT_... macros
#define new CAM_DEBUG_NEW

using namespace InetUtils;

// Static variables
#ifdef _DEBUG
//String_256 LibFillsSGallery::DefaultLibraryPath = TEXT("\\\\deepthought\\camelotcd\\cd\\fills");
//String_256 LibFillsSGallery::DefaultLibraryPath = TEXT("\\\\jimpc\\corelxra\\fills");
String_256 LibFillsSGallery::DefaultLibraryPath = TEXT("D:\\fills");
#else
String_256 LibFillsSGallery::DefaultLibraryPath = TEXT("D:\\fills");
#endif

// display mode setting for ini file
INT32 LibFillsSGallery::DefaultDisplayMode = 0;

// For keeping the sort keys constant when next loaded (default == sort alphabetically)
// 1st sort key = DefaultSortKeys & 0x8f
// 2nd sort key = ((DefaultSortKeys>>8) & 0x8f)
// 1st sort key reversed = ((DefaultSortKeys>>7) & 0x01)==1
// 2nd sort key reversed = ((DefaultSortKeys>>15) & 0x01)==1
// So 0 means no sorting at all
// and 1 means sort the gallery alphabetically
UINT32 LibFillsSGallery::DefaultSortKeys = 1;

// Pointer to the gallery itself...
LibFillsSGallery *LibFillsSGallery::ThisGallery = NULL;

// Quiet status of gallery
BOOL LibFillsSGallery::QuietStatus = FALSE;

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

>   LibFillsSGallery::LibFillsSGallery()
                                                 
    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    23/3/95
    Purpose:    LibFillsSGallery default constructor

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

LibFillsSGallery::LibFillsSGallery()
{
    LibFillsSGallery::ThisGallery = this;

    // Default gallery size
    CSize Size(((333 * 2) - 32) - 32, 256);
    SetGallerySize(Size);
} 



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

>   LibFillsSGallery::~LibFillsSGallery()

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    23/3/95
    Purpose:    LibFillsSGallery destructor.

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

LibFillsSGallery::~LibFillsSGallery()
{
    OpenLibFiles.DeleteAll();       // Ensure all open libraries are closed
    LibFillsSGallery::ThisGallery = NULL;
}



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

>   static BOOL LibFillsSGallery::Init(void)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    23/3/95
    Returns:    TRUE if the sgallery initialised successfully
                FALSE if it failed to initialise
    Purpose:

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

BOOL LibFillsSGallery::Init(void)
{
    return(TRUE);
}



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

>   BOOL LibFillsSGallery::PreCreate(void)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    23/3/95
    Returns:    TRUE if the Gallery initialised successfully
                FALSE if it should not be opened due to a failure to initialise

    Purpose:    The LibFillsSGallery PreCreate handler. This overrides the base class
                PreCreate function. It is called at the very beginning of the
                SuperGallery::Create method, before the window has been created.

    Notes:      As this is called before the window is open, it must not attempt to touch
                any of the button gadgets in the window, or force redraws, etc. Also,
                events cannot be passed to the tree, as the tree formatting relies on
                knowing the window size - however, the tree will be reformatted and
                redrawn automatically when the window is opened - this will happen shortly.

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

BOOL LibFillsSGallery::PreCreate(void)
{
    // If there isn't already one, create a DisplayTree
    if (DisplayTree == NULL)
    {
        DisplayTree = new SGDisplayRootScroll(this);    // New root node, with a scrollbar
        if (DisplayTree == NULL)
            return(FALSE);
    }

    // Add the library groups to the gallery if they're not there already
    if(OpenLibFiles.IsEmpty())
    {
        String_256 sLoc = DefaultLibraryPath;
        // Set DefaultLibraryPath to <ExeLocation>\Fills - the user might have installed
        // the fills to his hard disk:
        if(CResDll::GetExecutablePath((TCHAR*)DefaultLibraryPath))
        {
            // Look for the resources in the main Xara X folder first
            String_256 LibDirName;
            GetLibraryDirectoryName(&LibDirName);
            DefaultLibraryPath += "\\";
            DefaultLibraryPath += LibDirName;
            PathName ThisPath(DefaultLibraryPath);
            if(!SGLibOil::FileExists(&ThisPath))    // will also work for paths (not just paths with a filename on the end)
            {
                // Fills not on hard disk. Try the CD location
                if(!ScanForLocation(SGLib_Texture, NULL))
                {
                    // hard drive and CD location not found
                    // put the original path back
                    DefaultLibraryPath = sLoc;
                }
            }
        }

        LibraryGallery::AddLibraryGroups(SGLib_Texture, &DefaultLibraryPath);
    }

    // Use last time's display mode
    DisplayMode = LibFillsSGallery::DefaultDisplayMode;

    return TRUE;
}

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

>   void LibFillsSGallery::SortGallery(void)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    2/5/95

    Inputs:     
    Returns:

    Purpose:    Sorts the contents of the gallery in an alphabetical fashion, whilst keeping
                the old sort key status...
    Notes:      
    SeeAlso:

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

void LibFillsSGallery::SortGallery(void)
{
    LibraryGallery::SortGallery();
}

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

>   BOOL LibFillsSGallery::BrowseClicked(void)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    2/5/95

    Inputs:     
    Returns:    TRUE if the gallery has new stuff in it (FALSE if cancel clicked, etc)...

    Purpose:    Pops up the browse box and lets a new location be set for the data

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

BOOL LibFillsSGallery::BrowseClicked(void)
{
    return (LibraryGallery::BrowseClicked(&DefaultLibraryPath, SGLib_Texture, _R(IDS_REMOVE_OLD_GOUPS_FILLS)));
}

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

>   virtual BOOL LibFillsSGallery::CanCreateIndexes(void)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    18/12/95

    Returns:    TRUE to if index generation is possible

    Purpose:    To determine if this gallery can generate indexes or not

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

BOOL LibFillsSGallery::CanCreateIndexes(void)
{
    return TRUE;
}

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

>   virtual BOOL LibFillsSGallery::GetDefaults(String_256 *DefaultIndex, String_256 *IndexDesc, SGLibType *Type)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    18/12/95

    Outputs:    DefaultIndex    - The filename for the default index file (Xaraclip.txt)
                IndexDesc       - Description of the index / gallery (Clipart)
                Type            - Default library type associated with this gallery

    Returns:    TRUE if this was overridden successfully

    Purpose:    To determine various library gallery default properties

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

BOOL LibFillsSGallery::GetDefaults(String_256 *DefaultIndex, String_256 *IndexDesc, SGLibType *Type)
{
    if(DefaultIndex != NULL)
        *DefaultIndex = _R(IDS_LIBRARIES_FILLS_FILENAME);   // "XaraText.txt";

    if(IndexDesc != NULL)
        *IndexDesc = _R(IDS_LIBRARIES_FILLS_DESC);          // "Fills";

    if(Type != NULL)
        *Type = SGLib_Texture;

    return TRUE;
}


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

>   virtual BOOL LibFillsSGallery::GetLibraryDirectoryName(String_256 *LibDirName)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    19/12/95

    Outputs:    LibDirName  - Returns the Default directory (on the clipart CD) for the gallery
    Returns:    TRUE if overridden and directory obtained...

    Purpose:    Get the default CD directory name for the gallery

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

BOOL LibFillsSGallery::GetLibraryDirectoryName(String_256 *LibDirName)
{
    LibDirName->MakeMsg(_R(IDS_LIBRARIES_FILLS_DIRNAME));   
    return TRUE;
}

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

>   virtual BOOL LibFillsSGallery::GetQuietStatus(void)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    19/12/95
    Returns:    TRUE if Quiet has been pressed (SetQuiet status called with TRUE)
    Purpose:    Get the Quiet status of the gallery

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

BOOL LibFillsSGallery::GetQuietStatus(void)
{
    return LibFillsSGallery::QuietStatus;
}

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

>   virtual void LibFillsSGallery::SetQuietStatus(BOOL Status)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    19/12/95
    Inputs:     Status - Set to TRUE and call if Quiet has just been pressed on an 'adding
                         indexes' dialog
    Purpose:    Set the Quiet status of the gallery

********************************************************************************************/
        
void LibFillsSGallery::SetQuietStatus(BOOL Status)
{
    LibFillsSGallery::QuietStatus = Status;
}

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

>   virtual BOOL LibFillsSGallery::ScanForLocation(SGLibType Type, StringBase *Result = NULL);

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    19/12/95

    Inputs:     Type of library to scan for
    Outputs:    (We assume the library static strings exist and use them - bit yucky)
                If a Result pointer if given then we copy this into there as well..
    Returns:    FALSE if it fails; TRUE if we got a path

    Purpose:    Searches all the drives for a CDROM drive. If it finds the Camelot CD
                mount here at Xara HQ, we point to that instead.
    Notes:

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

BOOL LibFillsSGallery::ScanForLocation(SGLibType Type, StringBase *Result)
{
#ifndef STANDALONE
    // Search for a CD ROM drive
    String_256 DriveName;
    BOOL AreWeXara = FALSE;
    String_256 XaraDrive;

    BOOL Adjust = KeyPress::IsAdjustPressed();
#ifndef _DEBUG
    Adjust = FALSE;
#endif

    if(SGLibOil::LocateCDROMDrive(this, Type, &DriveName, &AreWeXara, &XaraDrive, Adjust))
    {
        if(AreWeXara)
            DriveName = XaraDrive;

        switch(Type)
        {
            case SGLib_Texture:
            case SGLib_Fractal:
                LibFillsSGallery::DefaultLibraryPath = DriveName;
#ifdef _DEBUG
                if(Adjust)
                {
                    LibFillsSGallery::DefaultLibraryPath += TEXT("Graphics\\Fills");
                }
                else
#endif
                {
                    String_256 LibDirName;
                    GetLibraryDirectoryName(&LibDirName);
                    LibFillsSGallery::DefaultLibraryPath += LibDirName;
                }
            
                if(Result)
                    *Result = LibFillsSGallery::DefaultLibraryPath;

                return TRUE;
        }
    }
#endif
    return FALSE;
}


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

>   virtual BOOL LibFillsSGallery::CheckForIndexMatch(StringBase *Txt)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    18/12/95

    Inputs:     Kind    - Last column entry in the index.txt file (" T")
    Returns:    TRUE if this signifies the gallery in question...

    Purpose:    To see whether we should add this line of the index.txt file to this gallery

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

BOOL LibFillsSGallery::CheckForIndexMatch(StringBase *Txt)
{
    BOOL Match = FALSE;

    // Textures (fills)
    if(((Txt->Sub(String_8("T"))!=-1) || (Txt->Sub(String_8("t"))!=-1)) ) Match = TRUE;

    return Match;
}


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

>   virtual BOOL LibFillsSGallery::ApplyAction(SGActionType Action)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    23/3/95

    Inputs:     Action - Indicates what action to apply

    Returns:    TRUE to indicate successful handling of the action, or
                FALSE to indicate failure

    Purpose:    Applies certain conventional gallery actions (usually associated with
                gallery buttons, for new, edit, delete, etc)

    SeeAlso:    SGActionType

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

BOOL LibFillsSGallery::ApplyAction(SGActionType Action)
{
    // No display tree? Better forget about it then!
    if (DisplayTree == NULL)
        return(FALSE);

    // Now, process the action  TO DO! - see Colour gallery for examples
    switch(Action)
    {
        case SGACTION_APPLYADJUST:
            // Drop through to SGACTION_APPLY handler

        case SGACTION_APPLY:
            // Import the current selection and apply it as a fill
            if(Document::GetSelected() == NULL)
                return FALSE;

            if(!FillUsingFillGallerySelection(ApplyToObject))
                return FALSE;
        
            break;

        case SGACTION_SETOPTIONS:   // Set values in the options dialogue as it is opened
            {
                if (CurrentOptionsDlg == NULL)
                    return(FALSE);

                CurrentOptionsDlg->AddDisplayModeName(_R(IDS_GALLERYDM_LARGE));     // 0
                CurrentOptionsDlg->AddDisplayModeName(_R(IDS_GALLERYDM_FULLINFO));  // 1
                CurrentOptionsDlg->AddDisplayModeName(_R(IDS_GALLERYDM_SMALL));     // 2
            }
            break;

        case SGACTION_SETSORTMODE:
            {
                if (CurrentSortDlg == NULL)
                    return(FALSE);

                CurrentSortDlg->AddSortKeyName(_R(IDS_SORTBY_NAME));
                CurrentSortDlg->AddSortKeyName(_R(IDS_SORTBY_MEMORY));
                CurrentSortDlg->AddSortKeyName(_R(IDS_SORTBY_NAMELENGTH));
                CurrentSortDlg->AddSortKeyName(_R(IDS_SORTBY_FILETYPE));
            }                                   
            break;


        case SGACTION_DISPLAYMODECHANGED:
            if(DisplayMode >= 3) DisplayMode = 0;
            DefaultDisplayMode = DisplayMode;
            InvalidateCachedFormat();
            ReformatAndRedrawIfNecessary();
            break;
    
        default:
            return(SuperGallery::ApplyAction(Action));
            break;
    }

    return(TRUE);
}



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

>   virtual MsgResult LibFillsSGallery::Message(Msg* Message)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    23/3/95
    Inputs:     Message - The message to handle

    Purpose:    A standard message handler, really.

    Notes:      Any messages that this does not handle must be passed down to the
                SuperGallery base class message handler.

                NOTE WELL that the SuperGallery base class handler does some funky things
                for us - see SuperGallery::Message - such as deleting our display subtree
                for any document which dies (which, uncannily, would explain why they go
                away like that when you close documents ;-), and shading the gallery when
                there are no documents present. [To override this behaviour in these cases,
                you should respond to the message, and return OK rather than calling the
                base class message handler]

    SeeAlso:    SuperGallery::Message

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

MsgResult LibFillsSGallery::Message(Msg* Message)
{
    // Added by Craig Hamilton 18/1/01.
    static HANDLE   handle = NULL;
    CString         mutexName = "autorunMutex";
    // End added.

    // If we have no displaytree, then we have not been shown, or something terrible has
    // happened, so we don't bother handling any of these messages.
    if (DisplayTree == NULL)
        return(LibraryGallery::Message(Message));

    KernelBitmap *SelectedBitmap = NULL;

    if (IS_OUR_DIALOG_MSG(Message))
    {
        DialogMsg* Msg = (DialogMsg*)Message;

        switch (Msg->DlgMsg)
        {
            case DIM_CREATE:
                // Added by Craig Hamilton 18/1/01.
                // This and the section of code of the same date in the DIM_CANCEL handler below
                // deal with the creation and destruction of a kernel object that is recognised by
                // the autorun. If this object exists then the autorun does not run. This is so
                // that the user can enter their resources cd while the gallery is open and not be
                // annoyed by the autorun appearing.
                handle = CreateMutex(NULL,TRUE,mutexName);
                // End added.

                SGInit::UpdateGalleryButton(OPTOKEN_DISPLAYFILLSGALLERY, TRUE);
                LibFillsSGallery::ThisGallery->GalleryAboutToReOpen();
                break;

            case DIM_CANCEL:
                // Added by Craig Hamilton 18/1/01.
                if(handle != NULL)
                {
                    CloseHandle(handle);
                }
                // End added.

                SGInit::UpdateGalleryButton(OPTOKEN_DISPLAYFILLSGALLERY, FALSE);

                // Flush the thumbnail cache
                BROADCAST_TO_CLASS(ThumbMessage(ThumbMessage::ThumbState::KILLCACHE, SGLib_Texture), DialogOp);
                BROADCAST_TO_CLASS(ThumbMessage(ThumbMessage::ThumbState::KILLCACHE, SGLib_Fractal), DialogOp);
                GalleryAboutToClose();
                break;

            case DIM_LFT_BN_CLICKED:
                switch (Msg->GadgetID)
                {
                    case _R(IDC_LIBGAL_OPEN):
                        if(Document::GetSelected() != NULL)
                            FillUsingFillGallerySelection(AddToPage);
                        break;
                    
                    case _R(IDC_LIBGAL_IMPORT):
                        FillUsingFillGallerySelection(AddToPage);
                        break;

                    case _R(IDC_LIBGAL_BROWSE):
                    case _R(IDC_LIBGAL_ADD_FILLS):
                        BrowseClicked();
                        break;

                    case _R(IDC_BMPGAL_FILL):
                        if(!FillUsingFillGallerySelection(ApplyToObject))
                        {
                            return(SuperGallery::Message(Message));
                        }
                        break;

                    case _R(IDC_BMPGAL_TEXTURE):
                        if(Document::GetSelected() != NULL)
                            if(!FillUsingFillGallerySelection(ApplyToObjectAsTransp))
                            {
                                return(SuperGallery::Message(Message));                 
                            }
                        break;

                    case _R(IDC_BMPGAL_BACKGROUND):
                        if(Document::GetSelected() != NULL)
                            if(!FillUsingFillGallerySelection(SetBackground))
                            {
                                return(SuperGallery::Message(Message));                 
                            }
                        break;

                    case _R(IDC_BMPGAL_SAVE):
#ifdef _DEBUG       
                        {
                            SGDisplayNode *Item = DisplayTree->FindNextSelectedItem(NULL);
                            if(Item != NULL && Item->IsKindOf(CC_RUNTIME_CLASS(SGLibDisplayItem)))
                            {
                                SGLibDisplayItem *LibItem = (SGLibDisplayItem *)Item;

                                Library *Parent = LibItem->GetParentLibrary();
                                if(Parent != NULL)
                                {
                                    PathName *Source = Parent->ReturnIndexLocation();
                                    PathName Dest(*Source);
                                    Dest.SetType((String_256)"BAK");
                                    SGLibOil::FileCopy(Source, &Dest);

                                    Parent->SaveIndexInDisplayedOrder(Source, TRUE);
                                }
                            }
                        }
#endif
                        break;

                    case _R(IDC_GALLERY_HELP):      // Show help page
                        HelpUserTopic(_R(IDS_HELPPATH_Gallery_Fill));
                        break;
    

                    
                    default:
                        break;
                }
        }
    }
    else if (MESSAGE_IS_A(Message, DocChangingMsg))
    {
        DocChangingMsg *Msg = (DocChangingMsg *) Message;
        switch (Msg->State)
        {
            case DocChangingMsg::DocState::SELCHANGED:
                if (Msg->pNewDoc == NULL)
                {
                    // There is no selected doc - this can only mean there are no docs
                    // at all, so we had better shade the gallery
                    DoShadeGallery(TRUE);
                    SuperGallery::ShadeGallery(TRUE);
                }
                else
                {
                    // Possibly a new document
                    DoShadeGallery(FALSE);
                    SuperGallery::ShadeGallery(FALSE);
                    SelectionHasChanged();
                }
                break;
        }
    }
    else if (MESSAGE_IS_A(Message, ThumbMessage) && DisplayTree != NULL)
    {
        ThumbMessage *Msg = (ThumbMessage *) Message;

        // If a library Thumb message comes around, flush the redraw stuff, etc
        if(Msg->State == ThumbMessage::ThumbState::CACHESIZECHANGED)
        {
            FlushBackgroundRedraws();
            ForceRedrawOfList();
        }
    }

    return(LibraryGallery::Message(Message));
}    


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

>   void LibFillsSGallery::SelectionHasChanged(void)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> (based on Jason code)
    Created:    28/3/95

    Purpose:    To inform the gallery that the selection has changed in some way.
                We need to grey different buttons on different occasions
    Notes:

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

void LibFillsSGallery::SelectionHasChanged(void)
{
    if (DisplayTree == NULL)
        return;

    // As we now allow the gallery to be closed and all the groups to remain, we must now
    // also check to see if the gallery is visible i.e. open or not. If not then get out now.
    // Required as SetStringGadgetValue will ERROR and memory leak if called when dialog closed.
    if (!IsVisible())
        return;

    INT32 Count = DisplayTree->GetSelectedItemCount();
    BOOL Documents = (Document::GetSelected() != NULL);

    // Set up button states

    // Enable the import button if there is a selection and valid documents
    EnableGadget(_R(IDC_LIBGAL_IMPORT), (Count > 0) && Documents);

    String_256 strCommand, strDummy;

    BOOL bEnable = Count == 1 && Documents;

    // Import button
    strCommand = SGCmd_Import; 
    EnableGadget(_R(IDC_LIBGAL_IMPORT),     bEnable && !((GetCommandState(&strCommand, &strDummy)).Greyed));

    // Fill button
    strCommand = SGCmd_Fill;
    EnableGadget(_R(IDC_BMPGAL_FILL),       bEnable && !((GetCommandState(&strCommand, &strDummy)).Greyed));

    // Transp button
    strCommand = SGCmd_Transp;
    EnableGadget(_R(IDC_BMPGAL_TEXTURE),    bEnable && !((GetCommandState(&strCommand, &strDummy)).Greyed));

    // Background button
    strCommand = SGCmd_SetBackground; 
    EnableGadget(_R(IDC_BMPGAL_BACKGROUND), bEnable && !((GetCommandState(&strCommand, &strDummy)).Greyed));

    EnableGadget(_R(IDC_LIBGAL_ADD_FILLS),  TRUE);

    LibraryGallery::SelectionHasChanged();
}

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

>   void LibFillsSGallery::DoShadeGallery(BOOL ShadeIt)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com> (based on Jason code)
    Created:    28/3/95

    Purpose:    To un-grey the options... button when there are no docs
    Notes:

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

void LibFillsSGallery::DoShadeGallery(BOOL ShadeIt)
{
    if (DisplayTree == NULL)
        return;

    // Keep this here always
    EnableGadget(_R(IDC_GALLERY_MENU), TRUE);

    EnableGadget(_R(IDC_LIBGAL_IMPORT), !ShadeIt);
    EnableGadget(_R(IDC_BMPGAL_FILL), !ShadeIt);
    EnableGadget(_R(IDC_BMPGAL_TEXTURE), !ShadeIt);

    EnableGadget(_R(IDC_BMPGAL_BACKGROUND), !ShadeIt);

    EnableGadget(_R(IDC_LIBGAL_ADD_FILLS), TRUE);

    LibraryGallery::DoShadeGallery(ShadeIt);
}

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

>   BOOL LibFillsSGallery::FillUsingFillGallerySelection(FillTypeEnum FillType)

    Author:     Jonathan_Payne (Xara Group Ltd) <camelotdev@xara.com>
    Created:    20/9/2000
    Inputs:     FillType - The type of fill required (see def. of FillTypeEnum)
    Returns:    TRUE if things went OK, false otherwise
    Purpose:    To import a fill into camelot, then apply it in the mannor selected
    SeeAlso:    OnPageDrop

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

bool LibFillsSGallery::FillUsingFillGallerySelection(FillTypeEnum FillType)
{
    PathName FileName;      
    
    UINT32 TagObjectToFill = 0; // used for ApplyToObject and ApplyToObjectAsTransp
                                // when downloading a fill

    if (GetSelectedItemCount() != 1 && FillType != AddToPage)
    {
        TRACEUSER( "Jonathan", _T("Fills: FillUsingGallerySelection failing due to multiple selection\n"));
        return false;
    }

    SGLibDisplayItem *FillItem = static_cast<SGLibDisplayItem *>(DisplayTree->FindNextSelectedItem());

    if (!FillItem->GetFileName(&FileName))
        return false;

    if (!FileName.IsValid(FileName.GetPath()))
    {
        ERROR3("Filename is invalid");
        return false;
    }

    bool NeedToDownload;
    if (_taccess(FileName.GetPath(), 0) == -1)
        NeedToDownload = true;
    else
        NeedToDownload = false;

    if (FillType == ApplyToObject || FillType == ApplyToObjectAsTransp)
    {
        SelRange* Sel = GetApplication()->FindSelection();
        if (Sel==0)
        {
            ERROR3("Can't find SelRange!");
            return false;
        }
        if (NeedToDownload)
        {
            Node *NodeToFill = Sel->FindFirst();
            if (Sel->FindNext(NodeToFill) != 0)
            {
                // If mulitple objects are selected, saving the tag of just one object is not
                // going to do much good so for now we just give up in this case
                InformError(_R(IDE_SGLFILLS_NOMULTI_DL_FILL));
                return false;
            }
            if (NodeToFill)
                TagObjectToFill = NodeToFill->GetTag();
            else
            {
                // No node selected.  This means the user has pressed fill from the gallery
                // with no selection, intending to set the default fill of the document.  To
                // do this we set TagObjectToFill to zero which results in TagObjectValid not
                // being set.  We do not have to use this logic in the case where the fill is
                // already downloaded as the ApplyFill(...) stuff just uses the current selection
                // (or the lack of current selection).
                TagObjectToFill = 0;
            }
        }
    }
    // Calculate where to put an imported object
    DocCoord DropPos;
    DocRect PageRect;
    Spread *s;
    if ((s = Document::GetSelectedSpread()) != 0)
    {
        if (s->GetPagesRect(&PageRect))
            DropPos = PageRect.Centre();
        else
            return false;
    }
    else
        return false;

    if (!NeedToDownload)
    // Don't need to download the fill
    {
        TRACEUSER( "Jonathan", _T("Fills: File in cache\n"));
        OpDescriptor* pOpDesc = OpDescriptor::FindOpDescriptor(CC_RUNTIME_CLASS(OpBitmapImport));

        if (pOpDesc != 0)
        {
            BitmapImportParam Param;

            Param.File              = &FileName;
            Param.Result            = TRUE;
            Param.pTargetDoc        = Document::GetSelected();
            Param.FillType          = FillType;
            Param.pSpread           = Document::GetSelectedSpread();
            Param.DropPos           = DropPos;
            Param.TagObjectValid    = false;
            Param.pObjectValid      = false;

            // Do it...
            pOpDesc->Invoke((OpParam *) &Param);

            if (!Param.Result)
            {
                ERROR3("Problem importing file from cache");
                return false;
            }
        }
    }
    else
    // Need to download the fill
    {
        TRACEUSER( "Jonathan", _T("Fills: File not in cache : downloading\n"));
        OpDescriptor* pOpDesc = OpDescriptor::FindOpDescriptor(CC_RUNTIME_CLASS(OpAsynchBitmapImport));

        if (pOpDesc != 0)
        {
            AsynchBitmapImportParam* Param = new AsynchBitmapImportParam;

            if (!Param)
                return false;
            Library* pLibrary       = FillItem->GetParentLibrary();
            String_256 strFileURL   = FileName.GetPath();
            pLibrary->LocalPath2URL(&strFileURL);
            Param->file             = FileName;
            Param->pTargetDoc       = Document::GetSelected();
            Param->strURL           = strFileURL;
            String_256 strDescription;
            FillItem->GetNameText(&strDescription);
            Param->strDescription   = _T("'");
            Param->strDescription   += strDescription;
            Param->strDescription   += _T("'");
            Param->type             = TYPE_FILL;
            Param->FillType         = FillType;
            Param->priority         = AsynchDownload::PRIORITY_HIGH;
            Param->pSpread          = Document::GetSelectedSpread();
            Param->DropPos          = DropPos;
            Param->TagObjectToFill  = TagObjectToFill;
            Param->pObjectValid     = false;
            // If TagObjectToFill == 0, don't set pObjectValid or TagObjectValid so
            // ApplyFill(...) just applies the fill to nothing (except if the user has
            // changed the selection during the download, in which case that object will
            // get filled - bit bad, but that is a very rare case).
            if (TagObjectToFill)
                Param->TagObjectValid   = true;
            else
                Param->TagObjectValid   = false;

            // Do it...
            pOpDesc->Invoke((OpParam *) Param);
        }
    }
    return true;
}


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

>   virtual SGDisplayItem *LibFillsSGallery::AddLibraryItem(SGDisplayGroup *LibraryGroup,
                                                Library *ParentLib,
                                                LibraryIndex ItemIndex)
    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    23/3/95

    Inputs:     LibraryGroup - The group to add the item into
                ParentLib - (For cross checking inputs) the library you allege the above
                group is for.
                ItemIndex - The Library generated index for this item

    Returns:    NULL, or a pointer to the created item

    Purpose:    Called by the Library class to create a display item for every item in 
                a newly-scanned library file. It is essentially a callback to the gallery
                which requested that the library be scanned.
                
    Notes:      This method MUST BE OVERRIDDEN by the derived gallery that opens the library,
                in order to create appropriate SGDisplayItem-derived nodes for the things
                in the library (e.g. a Fills library gallery will have to create items
                that display Fills thumbnails)

    SeeAlso:    SuperGallery::AddLibraryGroup; SuperGallery::RemoveLibraryGroup

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

SGDisplayItem *LibFillsSGallery::AddLibraryItem(SGDisplayGroup *LibraryGroup,
                                                    Library *ParentLib,
                                                    LibraryIndex ItemIndex, BOOL bNew)
{
    ERROR3IF(LibraryGroup == NULL || ParentLib == NULL,
                "LibFillsSGallery::AddLibraryItem - NULL params are illegal");

    ERROR3IF(LibraryGroup->GetParentLibrary() != ParentLib,
                "LibFillsSGallery::AddLibraryitem - The DisplayGroup is not for the same library!");

    // Create a Fills library item
    SGFillsItem *NewItem = new SGFillsItem(ItemIndex, bNew);

    // Alphabetic add...
/*  SGSortKey SortKeys[MaxSGSortKeys];
    for (INT32 i = 0; i < MaxSGSortKeys; i++)
    {
        SortKeys[i].SortKey  = 0;
        SortKeys[i].Reversed = FALSE;
    }

    SortKeys[0].SortKey  = 1;*/

    if (NewItem != NULL)
        LibraryGroup->AddItem(NewItem/*, (SGSortKey *)SortKeys*/);

    return(NewItem);
}


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

>   virtual BOOL LibFillsSGallery::CanSearchKeywords(void)

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    30/3/95

    Returns:    TRUE

    Purpose:    Used to determine if this type of gallery supports keyword searching.
                This one does
                
********************************************************************************************/

BOOL LibFillsSGallery::CanSearchKeywords(void)
{
    return(TRUE);
}


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

>   virtual void LibFillsSGallery::HandleDragStart(DragMessage *DragMsg)

    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    25/3/95

    Inputs:     DragMsg - The DRAGSTARTED message that we've just recieved, indicating
                the type of drag being started

    Purpose:    Checks a DragMessage to see if it is a colour drag.
                If it is, then it creates a drag target for this gallerys listbox.

    Notes:      Overrides the default base-class action. Calls down to the base class
                if it is not a colour drag, so that dragging of gallery groups is allowed

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

void LibFillsSGallery::HandleDragStart(DragMessage *DragMsg)
{
    // If it's a bitmap drag, add a target for our window. If not, let the base class
    // have a look at it (to see if it is a gallery item being dragged)
    if (DragMsg->pInfo->IsKindOf(CC_RUNTIME_CLASS(GalleryFillsDragInfo)))
        SGFillsDragTarget *NewTarget = new SGFillsDragTarget(this, GetListGadgetID());
    else
        SuperGallery::HandleDragStart(DragMsg);
}

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

>   virtual void LibFillsSGallery::WorkOutSectionName(String_256 *Section);

    Author:     Richard_Millican (Xara Group Ltd) <camelotdev@xara.com>
    Created:    28/5/95

    Outputs:    Section - String used to return the section name

    Purpose:    Returns the section name to use in the grm file

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

void LibFillsSGallery::WorkOutSectionName(String_256 *Section)
{
    if(Section)
        *Section =  _R(IDS_SGLFILLS_SECTION_NAME); // "FillsGallery";
}



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

>   virtual BOOL LibFillsSGallery::InitMenuCommands(void)
                                                 
    Author:     Jason_Williams (Xara Group Ltd) <camelotdev@xara.com>
    Created:    18/9/95

    Returns:    TRUE for success

    Purpose:    Initialises any menu commands that this gallery needs.

    Notes:      Will only create the menu commands once - further calls in the future
                will return TRUE immediately wihtout doing anything.

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

BOOL LibFillsSGallery::InitMenuCommands(void)
{
    static BOOL MenusInitialised = FALSE;

    BOOL ok = TRUE;

    if (!MenusInitialised)
    {
        // Initialise menu command Ops

        // "Standar