sgbitmap.cpp

Go to the documentation of this file.

// $Id: sgbitmap.cpp 1664 2006-08-04 10:06:16Z gerry $
/* @@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============================
 */
// SGBitmap.cpp - Bitmap SuperGallery classes - BitmapSGallery and SGDisplayBitmap

#include "camtypes.h"

//#include "app.h"      // For GetApplication() - in camtypes.h [AUTOMATICALLY REMOVED]
//nclude "gallery.h"    // For _R(IDC_GALLERY_LISTBOX)
//#include "galstr.h"
//#include "galres.h"
#include "sgbitmap.h"   
#include "sginit.h" 
#include "sgmenu.h"

//nclude "ccdc.h"       // For render-into-dialogue support
//nclude "fillval.h"
//nclude "grnddib.h"
//#include "will.h"     // For OpShowBitmapGallery ID's
//nclude "bitmap.h" 
#include "bitmpinf.h"   
//#include "fillattr.h"  - in camtypes.h [AUTOMATICALLY REMOVED]
//nclude "attrmgr.h"    
#include "nodebmp.h"    
//nclude "convert.h"    
//#include "resource.h" // For _R(IDS_CANCEL)

#include "dragmgr.h"
#include "dragbmp.h"
//nclude "viewrc.h"     // FOR _R(IDC_CANDROPONPAGE)

//#include "docview.h" - in camtypes.h [AUTOMATICALLY REMOVED]
//#include "spread.h" - in camtypes.h [AUTOMATICALLY REMOVED]
#include "tracedlg.h"
#include "bfxdlg.h"
//nclude "bfxalu.h"
//nclude "bitmapfx.h"
#include "impexpop.h"   // Import/Export ops
//#include "scrcamvw.h"
//#include "fixmem.h" - in camtypes.h [AUTOMATICALLY REMOVED]

//nclude "sglib.h"

//#include "richard2.h" // extra resource strings
#include "bmpcomp.h"    
//#include "will3.h"    
//#include "phil.h"

#include "comattrmsg.h"
#include "bmpsdlg.h"
//#include "bmpdlgr.h"
//#include "bmpsdlgr.h"
#include "giffiltr.h"
#include "bmpsrc.h"

#include "plugop.h"     // PlugInsContextMenu
#include "backgrnd.h"   // OpBackground
#include "keypress.h"   // KeyPress
#include "impexpop.h"   // BitmapExportParam
#include "prevwdlg.h"   // PreviewDialog::Init()
#include "bmpexprw.h"   // BitmapExportPreviewDialog::Init()

#include "helpuser.h"       //For the help button
//#include "xshelpid.h"     //For the help button
//#include "helppath.h"
//#include "xpehost.h"      // For OPTOKEN_XPE_EDIT
#include "qualattr.h"
#include "bfxop.h"          // useful BFX plug-in related operations
#include "fillattr2.h"

#ifdef PHOTOSHOPPLUGINS
#include "plugmngr.h"   // CheckHaveDetailsOnPlugIns
#endif //PHOTOSHOPPLUGINS

#include "camview.h"

// Implement the dynamic class bits...
CC_IMPLEMENT_DYNCREATE(BitmapSGallery, SuperGallery)
CC_IMPLEMENT_DYNAMIC(SGDisplayKernelBitmap, SGDisplayItem)
CC_IMPLEMENT_DYNCREATE(OpDisplayBitmapGallery,Operation);
CC_IMPLEMENT_DYNAMIC(SGBitmapDragTarget, SGListDragTarget);

CC_IMPLEMENT_DYNCREATE(GalleryBitmapDragInfo, BitmapDragInformation)

// Enable Background redraw in the bitmap gallery...
//#define SGBITMAP_BACKGROUND_REDRAW

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


BOOL BitmapSGallery::IgnoreBmpListChange = FALSE;


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

>   SGBitmapDragTarget::SGBitmapDragTarget(DialogOp *TheDialog, CGadgetID TheGadget = NULL)
     
    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    25/3/95
    Inputs:     TheDialog - The kernel dialog in which the target exists
                TheGadget - The gadget within that dialogue which is the target

    Purpose:    Constructor

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

SGBitmapDragTarget::SGBitmapDragTarget(DialogOp *TheDialog, CGadgetID TheGadget)
                    : SGListDragTarget(TheDialog, TheGadget)
{
    ERROR3IF(!TheDialog->IsKindOf(CC_RUNTIME_CLASS(BitmapSGallery)),
            "You can only use SGBitmapDragTargets with BitmapSGallery dialogues!");
}



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

    BOOL SGBitmapDragTarget::ProcessEvent(DragEventType Event, DragInformation *pDragInfo,
                                            OilCoord *pMousePos, KeyPress* pKeyPress)

    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    25/3/95
    Inputs:     Event - Indicates what has happened
                pDragInfo - points to drag information describing this drag. This
                should be a BitmapDragInformation or derivation thereof
                pMousePos - points to information on the current mouse position, in OIL coords
                pKeyPress - NULL, or if for a keypress event, keypress information

    Returns:    TRUE to claim the event, FALSE to let it through to other targets

    Purpose:    Event Handler for SuperGallery listitem drag events. Overrides the
                base class handler to enable it to sort out the node being dragged
                for Bitmap drags.

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

BOOL SGBitmapDragTarget::ProcessEvent(DragEventType Event, DragInformation *pDragInfo,
                                        OilCoord *pMousePos, KeyPress* pKeyPress)
{
    if (!pDragInfo->IsKindOf(CC_RUNTIME_CLASS(BitmapDragInformation)))
        return(FALSE);

    SGDisplayNode *DraggedNode = NULL;
    BOOL IsSimpleBitmapDrag = TRUE;         // Only one bitmap is being dragged

    if (IS_A(pDragInfo, GalleryBitmapDragInfo))
    {
        DraggedNode = ((GalleryBitmapDragInfo *)pDragInfo)->GetDraggedBitmap();

        IsSimpleBitmapDrag = FALSE;         // We started the drag, so we will accept multiple
                                            // bitmaps being dragged in a single operation
    }

    if (DraggedNode != NULL)
    {
        switch(Event)
        {
            case DRAGEVENT_COMPLETED:
                HandleDragCompleted((SuperGallery *) TargetDialog,
                                    DraggedNode, pMousePos, IsSimpleBitmapDrag);
                return(TRUE);


            case DRAGEVENT_MOUSESTOPPED:
            case DRAGEVENT_MOUSEMOVED:
            case DRAGEVENT_MOUSEIDLE:
                // Call a subroutine to work out and set our current cursor shape
                return(DetermineCursorShape((SuperGallery *) TargetDialog,
                                            DraggedNode, pMousePos));
            default:
                break;
        }
    }
    // Otherwise, we aren't interested in the event, so we don't claim it
    return(FALSE);
}

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

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

    Purpose:    Default constructor - do not call this constructor

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

GalleryBitmapDragInfo::GalleryBitmapDragInfo()
{
    ERROR3("Default GalleryBitmapDragInfo constructor called"); 
}



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

>   GalleryBitmapDragInfo::GalleryBitmapDragInfo(SGDisplayKernelBitmap *pSourceItem,
                                            SGMouseInfo *pMouseInfo, SGMiscInfo *pMiscInfo,
                                            BOOL IsAdjust = FALSE)
     
    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    19/3/95       

    Inputs:     pSourceItem - The gallery item from which the drag originated
                pMouseInfo  - The mouse info which made the item start the drag
                pMiscInfo   - The MiscInfo which accompanied the mouse event
                IsAdjust    - TRUE if this is an adjust (line-Bitmap) drag

    Purpose:    Constructor

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

GalleryBitmapDragInfo::GalleryBitmapDragInfo(SGDisplayKernelBitmap *pSourceItem,
                                            SGMouseInfo *pMouseInfo, SGMiscInfo *pMiscInfo,
                                            BOOL IsAdjust)
                    : BitmapDragInformation(pSourceItem->GetDisplayedKernelBitmap(),
                                            120, 0, 0, 0, IsAdjust)
{
    SourceItem  = pSourceItem;  // Copy the source item pointer

    MouseInfo   = *pMouseInfo;  // Duplicate the structures (they may cease to exist
    MiscInfo    = *pMiscInfo;   // soon after the drag is started)
}

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

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

    Purpose:    Destructor

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

GalleryBitmapDragInfo::~GalleryBitmapDragInfo()
{
}


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

>   void GalleryBitmapDragInfo::OnClick(INT32 Flags,POINT Point) 
     
    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    19/3/95       
    Inputs:     -
    Outputs:    -
    Returns:    -
    Purpose:    This is called if a drag was attempted but never started because it was a 
                click all along. It calls back the SourceItem SGDisplayBitmap, to get it
                to handle the click.
    Errors:     -
    SeeAlso:    -

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

void GalleryBitmapDragInfo::OnClick(INT32 Flags ,POINT Point)
{
    if (SourceItem != NULL)
        SourceItem->DragWasReallyAClick(&MouseInfo, &MiscInfo);
}

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

>   void GalleryBitmapDragInfo::GetCursorID(DragTarget* pDragTarget)

    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    25/3/95
    Purpose:    Set cursor over this target


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

UINT32 GalleryBitmapDragInfo::GetCursorID(DragTarget* pDragTarget)
{
    if (pDragTarget && pDragTarget->IS_KIND_OF(ViewDragTarget))
    {
        PageDropInfo PageDropInfo;
        ((ViewDragTarget*)pDragTarget)->GetDropInfo(&PageDropInfo);

        NodeRenderableInk* pObjectHit   = PageDropInfo.pObjectHit;
        ObjectDragTarget TargetHit      = PageDropInfo.TargetHit;

        if (pObjectHit && pObjectHit->IS_KIND_OF(NodeBitmap))
            TargetHit = NO_TARGET;              // Ignore NodeBitmap objects

        ClickModifiers ClickMods = ClickModifiers::GetClickModifiers();
        BOOL IsInside = ClickMods.Constrain;

        if (!IsInside && pObjectHit && pObjectHit->IsCompound())
        {
            TargetHit = MANY_TARGET;
        }

        UINT32 CanFill = IsInside ? _R(IDC_DROPINSIDEONFILL) : _R(IDC_CANDROPONFILL);

        switch (TargetHit)
        {
            case FILL_TARGET:
            case LINE_TARGET:
            case STARTCOL_TARGET:
            case ENDCOL_TARGET:
            case ENDCOL2_TARGET:
            case ENDCOL3_TARGET:
            case MANY_TARGET:
                return CanFill;

            case NO_TARGET:
                // bitmap gallery - drop = add bitmap, CTRL + drop = page fill
                return IsInside ? _R(IDC_CANFILLPAGE) : _R(IDC_CANDROPONPAGE);
                //return _R(IDC_CANDROPONPAGE);
        };

        return _R(IDC_CANDROPONPAGE);
    }

    return _R(IDC_CANTDROP);
}

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

>   virtual BOOL GalleryBitmapDragInfo::GetStatusLineText(String_256 * TheText, DragTarget* pDragTarget)

    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    25/3/95
    Returns:    Whether String is valid
    Purpose:    provide status line text for this target
   
********************************************************************************************/

BOOL GalleryBitmapDragInfo::GetStatusLineText(String_256 * TheText, DragTarget* pDragTarget)
{
    ERROR2IF(TheText==NULL,FALSE,"NULL string in GetStatusLineText()");

    if (TheBitmap == NULL || TheBitmap->ActualBitmap == NULL)
        return FALSE;

    String_256 DragString;
    String_256 BmpName(TheBitmap->ActualBitmap->GetName());
    DragString.MakeMsg(_R(IDS_SGBITMAP_DRAGGING_BITMAP), (TCHAR *)BmpName); // "Dragging Bitmap 'Bitmap' : ");

    if (pDragTarget && pDragTarget->IS_KIND_OF(ViewDragTarget))
    {
        PageDropInfo PageDropInfo;
        ((ViewDragTarget*)pDragTarget)->GetDropInfo(&PageDropInfo);

        NodeRenderableInk* pObjectHit   = PageDropInfo.pObjectHit;
        ObjectDragTarget TargetHit      = PageDropInfo.TargetHit;

        String_256 ObjectDesc = String_32(_R(IDS_SGBITMAP_THIS_OBJECT)); // " this object";

        if (pObjectHit)
        {
            ObjectDesc = pObjectHit->Describe(FALSE);
        }

        if (pObjectHit && pObjectHit->IS_KIND_OF(NodeBitmap))
            TargetHit = NO_TARGET;              // Ignore NodeBitmap objects

        ClickModifiers ClickMods = ClickModifiers::GetClickModifiers();
        BOOL IsInside = ClickMods.Constrain;

        if (!IsInside && pObjectHit && pObjectHit->IsCompound())
        {
            TargetHit = MANY_TARGET;
        }

        switch (TargetHit)
        {
            case FILL_TARGET:
            case LINE_TARGET:
            case STARTCOL_TARGET:
            case ENDCOL_TARGET:
            case ENDCOL2_TARGET:
            case ENDCOL3_TARGET:
                DragString += String_256(_R(IDS_SGBITMAP_DROP_APPLY_FILL)); // "Drop to apply a Bitmap fill to this ";
                DragString += ObjectDesc;
                if (IsInside)
                    DragString += String_16(_R(IDS_SGBITMAP_ALONE)); // " alone";
                break;
            case MANY_TARGET:
                DragString += String_256(_R(IDS_SGBITMAP_DROP_APPLY_FILL)); // "Drop to apply a Bitmap fill to this ";
                DragString += ObjectDesc;
                DragString += String_256(_R(IDS_SGBITMAP_CONTROL_DROP_INSIDE)); // "; Press 'Control' to drop 'Inside'";
                break;
            case NO_TARGET:
                if (IsInside)
                {
                    DragString += String_256(_R(IDS_DRAGBMP_DROP_SETPAGEBACKGROUND)); // "Drop to set the Bitmap fill of the page background";
                }
                else
                {
                    DragString += String_256(_R(IDS_SGBITMAP_DROP_INSERT_BITMAP)); // "Drop to Insert a new Bitmap object on the Page";
                }
                break;
        };

        *TheText = DragString;
        return TRUE;
    }
    
    return FALSE;
}

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

>   BOOL GalleryBitmapDragInfo::OnPageDrop(ViewDragTarget* pDragTarget)
 
    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    19/3/95       
    Inputs:     -
    Outputs:    -
    Returns:    -
    Purpose:    Called when a bitmap is dropped onto the page.
    Errors:     -
    SeeAlso:    -

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

BOOL GalleryBitmapDragInfo::OnPageDrop(ViewDragTarget* pDragTarget)
{
    PageDropInfo ThePageDropInfo;
    ((ViewDragTarget*)pDragTarget)->GetDropInfo(&ThePageDropInfo);
    NodeRenderableInk* pObjectHit = ThePageDropInfo.pObjectHit;

    // Find the bitmap to apply
    KernelBitmap* BitmapToApply = TheBitmap;
    TheBitmap = NULL;

    if(BitmapToApply == NULL)
        return FALSE;

    // See if the user dropped the bitmap onto an object(s) on the page
    // If so then try and apply that bitmap as a fill to that object(s).
    if (pObjectHit && !pObjectHit->IS_KIND_OF(NodeBitmap)) 
    {
        // Fill the object(s) with the dropped bitmap
        AttrBitmapColourFill* Attrib = new AttrBitmapColourFill;
        if (Attrib == NULL)
            return FALSE;

        Attrib->AttachBitmap(BitmapToApply);

        AttributeManager::ApplyAttribToNode(pObjectHit, Attrib);
    }
    else
    {
        // Not dropped onto an object on the page
        // See if the control key is pressed
        BOOL Constrain = KeyPress::IsConstrainPressed();
        if (Constrain)
        {
            // If the control key is pressed then apply the bitmap as a new background
            // We should use the document given to us by the page info class
            Document * pDocument = ThePageDropInfo.pDoc;
            if (pDocument == NULL)
                return FALSE;
            OpBackgroundParam Param;
            Param.pBitmap = BitmapToApply;
            Param.pDoc = pDocument;         
            Param.pSpread = ThePageDropInfo.pSpread;
            
            // Obtain a pointer to the op descriptor for the create operation 
            OpDescriptor* pOpDesc = OpDescriptor::FindOpDescriptor(OPTOKEN_BACKGROUND);

            // Invoke the operation, passing in our parameters
            if (pOpDesc)
                pOpDesc->Invoke(&Param);         
        }
        else
        {
            // Create a new bitmap on the page at the drop point

            // Obtain a pointer to the op descriptor for the create operation 
            OpDescriptor* OpDesc = OpDescriptor::FindOpDescriptor(CC_RUNTIME_CLASS(OpCreateNodeBitmap));

            if (OpDesc)
            {
                // Invoke the operation, passing DocView and Pos as parameters
                OpParam param((void *)BitmapToApply,(void *)&ThePageDropInfo);
                OpDesc->Invoke(&param);      
            }
        }
    }

    return TRUE;
}


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

>   SGDisplayKernelBitmap::SGDisplayKernelBitmap()

    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    27/1/95 (base generated in sgbase.cpp)

    Purpose:    SGDisplayKernelBitmap constructor
                DON'T call this constructor. It ERROR3's. Call the other constructor

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

SGDisplayKernelBitmap::SGDisplayKernelBitmap()
{
    ERROR3("Illegal call on default SGDisplayKernelBitmap constructor - call the other one!");
    TheKernelBitmap = NULL;
}


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

>   SGDisplayKernelBitmap::SGDisplayKernelBitmap(KernelBitmap *KernelBitmapToDisplay)

    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    27/1/95 (base generated in sgbase.cpp)

    Inputs:     KernelBitmapToDisplay - The KernelBitmap this item will display

    Purpose:    SGDisplayKernelBitmap constructor

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

SGDisplayKernelBitmap::SGDisplayKernelBitmap(KernelBitmap *KernelBitmapToDisplay)
{
    ERROR3IF(KernelBitmapToDisplay == NULL,
                "SGDisplayKernelBitmap - trying to construct me with a NULL parameter is bad");

    TheKernelBitmap = KernelBitmapToDisplay;
}



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

>   virtual void SGDisplayKernelBitmap::CalculateMyRect(SGFormatInfo *FormatInfo,
                                                SGMiscInfo *MiscInfo)

    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    27/1/95 (base generated in sgbase.cpp)

    Inputs:     FormatInfo - The formatting info from which to calculate my position/size
                MiscInfo - As usual, the useful misc info struct

    Outputs:    member variable FormatRect - is returned filled in with the size/position of
                this KernelBitmap item's display area. This is dependent upon the current display
                mode and format state

                FormatInfo will be updated as a result of the formatting operation

    Purpose:    Shared code for KernelBitmap items to calculate where they will appear in the
                grand scheme of things

    Notes:      KernelBitmaps supply only one display mode ("full info")

    Scope:      private (for use of SGDisplayKernelBitmap class only)

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

void SGDisplayKernelBitmap::CalculateMyRect(SGFormatInfo *FormatInfo, SGMiscInfo *MiscInfo)
{
    INT32 XSize;
    INT32 YSize;

    switch (MiscInfo->DisplayMode)
    {
        case 1:                     // 1 - Small full info
            XSize = GridLock(MiscInfo, SG_InfiniteWidth);
            YSize = GridLock(MiscInfo, SG_DefaultSmallBmp);
            break;

        case 2:                     // 2 - Large icon with name
            XSize = GridLock(MiscInfo, SG_DefaultLargeBmpText);
            YSize = GridLock(MiscInfo, SG_DefaultLargeBmp);
            break;

        default:                    // 0 - Full Info
            XSize = GridLock(MiscInfo, SG_InfiniteWidth);
            YSize = GridLock(MiscInfo, SG_DefaultLargeBmp);
            break;
    }

    BitmapInfo Info;
    INT32 MaxYSize = YSize;

    if (TheKernelBitmap->ActualBitmap &&
        TheKernelBitmap->ActualBitmap->GetInfo( &Info )
        )
    {
        // We will adjust the Height of the format rect
        // according to the Height of the bitmap.

        double BitmapWidth  = Info.RecommendedWidth;
        double BitmapHeight = Info.RecommendedHeight;

        // Calculate the spect ratio of the bitmap
        double Ratio = BitmapHeight/BitmapWidth;

        YSize = INT32(YSize * Ratio);

        // ... set a minimum height for each item
        INT32 SelHeight = 16000;

        if (YSize < SelHeight*3)
            YSize = SelHeight*3;

        if (YSize > MaxYSize)
            YSize = MaxYSize;
    }

    CalculateFormatRect(FormatInfo, MiscInfo, XSize, YSize);
}



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

>   virtual void SGDisplayKernelBitmap::HandleRedraw(SGRedrawInfo *RedrawInfo,
                                                SGFormatInfo *FormatInfo)

    Author:     Will_Cowling (Xara Group Ltd) <camelotdev@xara.com>
    Created:    27/1/95 (base generated in sgbase.cpp)

    Inputs:     RedrawInfo  - The information on the kernel-rendered redraw area
                FormatInfo  - The formatting information structure

                member variable FormatRect should be set up (before calling this method)
                to be the rectangle in which to draw this item

    Purpose:    SGDisplayKernelBitmap item redraw method - removed from the main HandleEvent
                method merely to make the code tidier.

    Scope:      private

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

void SGDisplayKernelBitmap::HandleRedraw(SGRedrawInfo *RedrawInfo, SGMiscInfo *MiscInfo)
{
    if (TheKernelBitmap == NULL || TheKernelBitmap->ActualBitmap == NULL)
        return;

    StartRendering(RedrawInfo, MiscInfo);

    DocRect MyRect(FormatRect);     // Get my redraw position from the cached FormatRect


    // Is this a valid format rectangle ?
    if (MyRect.IsEmpty() || !MyRect.IsValid())
    {
        // No, so just ignore it
        // Erroring here is not good, as we are in the middle of a redraw loop
        StopRendering(RedrawInfo, MiscInfo);
        return;
    }

    // Check the rectangle is at least our minimum height,
    // and adjust it if not
    //INT32 SelHeight = 16000; 
    // Changed to allow a third line of text.
    INT32 SelHeight = 23000; 

    if (MyRect.Height() < SelHeight*3)
    {
        INT32 diff = SelHeight*3 - MyRect.Height();
        MyRect.Inflate(0, diff);
    }

    RenderRegion *Renderer = RedrawInfo->Renderer;

    INT32 OnePixel          = (INT32) DevicePixels(MiscInfo, 1);
    INT32 TwoPixels         = (INT32) DevicePixels(MiscInfo, 2);
    INT32 ThreePixels   = (INT32) DevicePixels(MiscInfo, 3);

    Renderer->SetLineWidth(0);
    Renderer->SetLineColour(RedrawInfo->Transparent);

    // Now calculate the rectangle to plot the bitmap into
    DocRect IconRect(MyRect);

    BitmapInfo Info;

    BOOL bScaleDown = FALSE;

    if (TheKernelBitmap->ActualBitmap &&
        TheKernelBitmap->ActualBitmap->GetInfo( &Info ))
    {
        // We will try and make all the bitmaps the same width on screen.
        double BitmapWidth  = Info.RecommendedWidth;
        double BitmapHeight = Info.RecommendedHeight;

        // Calculate the spect ratio of the bitmap
        double Ratio = BitmapWidth/BitmapHeight;

        INT32 IconWidth = INT32(IconRect.Height() * Ratio);

        INT32 YSize;
        switch (MiscInfo->DisplayMode)
        {
            case 1:                     // 1 - Small full info
                YSize = GridLock(MiscInfo, SG_DefaultSmallBmp);
                break;

            case 2:                     // 2 - Large icon with name
                YSize = GridLock(MiscInfo, SG_DefaultLargeBmp);
                break;

            default:                    // 0 - Full Info
                YSize = GridLock(MiscInfo, SG_DefaultLargeBmp);
                break;
        }
        
        // If the bitmap is very Wide and Thin, then we need to scale it
        // so it fits into out maximum icon width
        if (IconWidth > YSize)
        {
            Matrix Scale;
            Ratio = double(IconWidth)/double(YSize);

            Scale = Matrix(FIXED16(1)/Ratio, FIXED16(1)/Ratio);

            DocCoord Centre;
            Centre.x = IconRect.lo.x;
            Centre.y = IconRect.lo.y + IconRect.Height()/2;

            // Scale the bitmap rectangle about the Left Middle so
            // that it is always 'YSize' in Width
            IconRect.Translate(-Centre.x, -Centre.y);
            Scale.transform(&IconRect.lo);
            Scale.transform(&IconRect.hi);
            IconRect.Translate(Centre.x, Centre.y);

            IconWidth = YSize;
            bScaleDown = TRUE;
        }

        INT32 RightSpace = 0;

        if (IconWidth < YSize)
        {
            INT32 LeftSpace = TwoPixels * 4;
            RightSpace = YSize - IconWidth - LeftSpace;
            IconRect.Translate(LeftSpace, 0);   // Move it over a bit
        }

        // Now setup the IconRect
        IconRect.hi.x = IconRect.lo.x + IconWidth;

        MyRect.lo.x = IconRect.hi.x + RightSpace + TwoPixels;   // And exclude it from 'MyRect'
        MyRect.lo.x += TwoPixels;

        // Now check the Icon isn't too tall

        INT32 MaxYSize = YSize;
        INT32 IconHeight = IconRect.Height();
        if (IconHeight > MaxYSize)
        {
            Matrix Scale;
            Ratio = double(IconHeight)/double(YSize);

            Scale = Matrix(FIXED16(1)/Ratio, FIXED16(1)/Ratio);

            DocCoord Centre;
            Centre.x = IconRect.lo.x + IconRect.Width()/2;
            Centre.y = IconRect.hi.y;

            // Scale the bitmap rectangle about the Middle so
            // that it is always 'YSize' in Height
            IconRect.Translate(-Centre.x, -Centre.y);
            Scale.transform(&IconRect.lo);
            Scale.transform(&IconRect.hi);
            IconRect.Translate(Centre.x, Centre.y);

            MyRect.lo.y = IconRect.lo.y;
            MyRect.hi.y = IconRect.hi.y;
            bScaleDown = TRUE;
        }
    }

    // This section doesn't currently do anything special as we 
    // have gone back to using an OSRenderRegion
    // If the display quality is too bad then we should modify 
    // this code to render a high quality thumbnail and store it 
    // for future use, rendering the thumbnail into an OSRenderRegion
/*  Renderer->SetUsingSmoothedBitmaps(bScaleDown);
    if (bScaleDown)
    {
        Quality qual;
        qual.SetQuality(QUALITY_MAX);
        QualityAttribute *pQuality = new QualityAttribute(qual);
        Renderer->SetQuality(pQuality, TRUE);           // Temp
    }
    else
    {
        Quality qual;   // QUALITY_DEFAULT is implied
        QualityAttribute *pQuality = new QualityAttribute(qual);
        Renderer->SetQuality(pQuality, TRUE);           // Temp
    }*/

    GridLockRect(MiscInfo, &MyRect);    // Ensure the new 'MyRect' is pixel-grid-aligned

    // If we can, we need to leave a little space around the
    // edges of the bitmap rect, so we can see the 'Selected' rectangle
    // behind it.  We only try this if the rectangle is big enough
    // otherwise the Inflate routine will create an invalid rectangle.

    if (IconRect.Height() > ThreePixels * 2)
        IconRect.Inflate(0, -ThreePixels);      // Leave a bit of space around the edge

    if (IconRect.Width() > ThreePixels * 2)
        IconRect.Inflate(-ThreePixels, 0);      // Leave a bit of space around the edge
    
    GridLockRect(MiscInfo, &IconRect);  // Ensure it maps exactly to specific pixels

    // Need to remember the icon rect size before the selection rectangle takes over...
    DocRect ThumbnailRect(IconRect);

    // In the bitmap gallery, it's better to show something than nothing
    // So if the thumbnail has become so thin as to be invisible
    // We will bodge it back into shape even if that distorts things a bit
    if (ThumbnailRect.Width()==0)
        ThumbnailRect.hi.x = ThumbnailRect.lo.x + OnePixel;
    if (ThumbnailRect.Height()==0)
        ThumbnailRect.hi.y = ThumbnailRect.lo.y + OnePixel;

    // Set up the colours for rendering our text, and fill the background if selected
    if (Flags.Selected)
    {
        // This Item is Selected

        // Fill the entire background with the 'selected' colour, so we don't
        // get gaps between bits of text or uneven rectangles in multiple selections
        Renderer->SetFillColour(RedrawInfo->SelBackground);

        Renderer->SetFillColour(COLOUR_BLACK);
        IconRect.Inflate(ThreePixels);

        // Draw a Three Pixel wide rectangle around the edge of the bitmap
        // (Actually we're plotting a filled rectangle which is three pixels
        //  bigger than the bitmap rectangle)
        Renderer->DrawRect(&IconRect);

        // If the icon rect is wider than the gallery, then MyRect could have become invalid,
        // so we only try to draw the selection background if any of it is actually visible
        if (MyRect.IsValid())
        {
            DocRect SelRect(MyRect);
            if (SelHeight > MyRect.Height()/2)
                SelHeight = MyRect.Height()/2;

            SelRect.hi.y = MyRect.lo.y + MyRect.Height()/2 + SelHeight;
            SelRect.lo.y = MyRect.lo.y + MyRect.Height()/2 - SelHeight;
            SelRect.lo.x += ThreePixels;
            GridLockRect(MiscInfo, &SelRect);   // Ensure it maps exactly to specific pixels

            Renderer->SetFillColour(RedrawInfo->SelBackground);
            Renderer->DrawRect(&SelRect);
        }

        Renderer->SetFixedSystemTextColours(&RedrawInfo->SelForeground, &RedrawInfo->SelBackground);
    }
    else
    {
        // This Item is Not Selected
        Renderer->SetFixedSystemTextColours(&RedrawInfo->Foreground, &RedrawInfo->Background);
    }


#ifdef SGBITMAP_BACKGROUND_REDRAW

    BOOL DrawnBitmap = FALSE;

    if (ShouldIDrawForeground(DrawnBitmap))
    {
        if(!DrawnBitmap)
        {
            // Now we need to create a temporary NodeBitmap, which we will
            // use to render the bitmap preview.
            NodeBitmap* DummyBmp = new NodeBitmap();
            if (DummyBmp == NULL)
            {
                // Just exit if we're out of memory
                SGLibDisplayItem::DrawNullBitmapRect(Renderer, MiscInfo, &ThumbnailRect, FALSE);
                StopRendering(RedrawInfo, MiscInfo);
                return;
            }

            // Set the NodeBitmap path to be our IconRect, 
            // and attach the Bitmap to it.
            DummyBmp->SetUpPath();
            DummyBmp->CreateShape(ThumbnailRect);
            DummyBmp->GetBitmapRef()->SetBitmap(TheKernelBitmap);

            // Now render the bitmap preview
            DummyBmp->Render(Renderer);

            delete DummyBmp;
        }
    }
    else
    {
        // We should background render, so we just draw a blank grey box
        if(!DrawnBitmap)
            SGLibDisplayItem::DrawNullBitmapRect(Renderer, MiscInfo, &ThumbnailRect, TRUE);
    }

#else

    // Now we need to create a temporary NodeBitmap, which we will
    // use to render the bitmap preview.
    NodeBitmap* DummyBmp = new NodeBitmap();
    if (DummyBmp == NULL)
    {
        // Just exit if we're out of memory
        StopRendering(RedrawInfo, MiscInfo);
        return;
    }

    // Set the NodeBitmap path to be our IconRect, 
    // and attach the Bitmap to it.
    DummyBmp->SetUpPath();
    DummyBmp->CreateShape(ThumbnailRect);
    DummyBmp->GetBitmapRef()->SetBitmap(TheKernelBitmap);

    // Now render the bitmap preview
    DummyBmp->Render(Renderer);

    delete DummyBmp;

#endif

    // Leave a small gap before text begins
    MyRect.lo.x += SG_GapBeforeText*2;

    // And now render the text describing the bitmap
    // ...but only if there is any space left (i.e. MyRect is still valid)
    if (MyRect.IsValid())
    {
        // First get the name of the bitmap
        String_256 BitmapName = TheKernelBitmap->ActualBitmap->GetName();

        // Now find how many colours it has
        String_256 BitmapCols;
        INT32 bpp = TheKernelBitmap->GetBPP();

        BOOL HasTransparency = FALSE;
        
        if (bpp <= 8)
        {
            // Check to see if this is a masked bitmap
            INT32 Index;

            if (TheKernelBitmap->GetTransparencyIndex(&Index))
                HasTransparency = TRUE;
        }

        switch (bpp)
        {
            case 1:
                if (HasTransparency)
                    BitmapCols = _R(IDS_SGBITMAP_MONOCHROME_T); // "Monochrome, transparent";
                else
                    BitmapCols = _R(IDS_SGBITMAP_MONOCHROME);   // "Monochrome";
                break;

            case 2:
                if (HasTransparency)
                    BitmapCols = _R(IDS_SGBITMAP_4COLOURS_T);   // "3 colours, transparent";
                else
                    BitmapCols = _R(IDS_SGBITMAP_4COLOURS);     // "4 colours";
                break;

            case 4:
                if (HasTransparency)
                    BitmapCols = _R(IDS_SGBITMAP_16COLOURS_T);  // "15 colours, transparent";
                else
                    BitmapCols = _R(IDS_SGBITMAP_16COLOURS);    // "16 colours";
                break;

            case 8:
                if (HasTransparency)
                    BitmapCols = _R(IDS_SGBITMAP_256COLOURS_T); // "255 colours, transparent";
                else
                    BitmapCols = _R(IDS_SGBITMAP_256COLOURS);   // "256 colours";
                break;

            case 16:
                BitmapCols = _R(IDS_SGBITMAP_65COLOURS);        // "65K colours";
                break;

            case 24:
                BitmapCols = _R(IDS_SGBITMAP_MILLIONS_COLOURS); // "Millions of colours";
                break;

            case 32:
                BitmapCols = _R(IDS_SGBITMAP_32_BIT); // "Millions of colours";
                break;

            default:
                BitmapCols = "";
                break;
        }

        // Now get its pixel Width and Height
        String_256 BitmapWidth;
        Convert::LongToString(Info.PixelWidth, &BitmapWidth);
        
        String_256 BitmapHeight;
        Convert::LongToString(Info.PixelHeight, &BitmapHeight);

        // Find the delay value;
        UINT32 BitmapDelay = TheKernelBitmap->ActualBitmap->GetBitmapAnimDelay();
        String_256 Delay;
        Convert::LongToString(BitmapDelay, &Delay);

        // And finally, work out how much memory it is using
        // The memory size depends on whether this is a bitmap or JPEG.

        INT32 Bytes = 0;
        BitmapSource* pSource = NULL;
        BaseBitmapFilter* pDummyFilter;

PORTNOTE("other", "Removed XPE hook")
#ifndef EXCLUDE_FROM_XARALX
        KernelBitmap* pMaster = NULL;
        IXMLDOMDocumentPtr pEdits = NULL;
        TheKernelBitmap->GetXPEInfo(pMaster, pEdits);
        BOOL bIsXPE = (pMaster!=NULL && pEdits!=NULL);
#else
        BOOL bIsXPE = FALSE;
#endif

        BOOL OriginalSourcePresent = TheKernelBitmap->GetOriginalSource(&pSource, &pDummyFilter);
        String_256 BitmapFormat;
        if(OriginalSourcePresent)
        {
            if (pSource != NULL)
            {
                if (pSource->IsJPEG())
                {
                    Bytes = pSource->GetSize();
                    BitmapFormat = _R(IDS_FORMAT_JPEG);
                }
            }
        }
        else if (bIsXPE)
        {
            BitmapFormat = _R(IDS_FORMAT_XPE);
        }
        else
        {
            Bytes = (Info.PixelWidth * Info.PixelHeight * bpp)/8;
            BitmapFormat = _R(IDS_FORMAT_BITMAP);
        }

        String_256 MemoryUsed;
        Convert::BytesToString(&MemoryUsed, Bytes);

        if (!BaseCamelotFilter::ShouldSaveXPEBitmaps() && bIsXPE)
        {
            // If the bitmap is generated from a Master and edit list
            // Then don't show size in bytes 'cos it's meaningless
            MemoryUsed.Load(_R(IDS_SGBITMAP_XPE));
        }

        // Now we are going to plot all that information
        // split into two lines of text
        DocRect TopRect(MyRect);
        DocRect MiddleRect(MyRect);
        DocRect BottomRect(MyRect);

        //TopRect.lo.y  += 11000;
        TopRect.lo.y    += 18000;
        MiddleRect.hi.y     -= 5000;
        //MiddleRect.hi.y   -= 16000; Down
        BottomRect.hi.y -= 26000; 

        // Plot the Name and Memory used on the Top Line
        String_256 TopLine; // = "'"+BitmapName+"', "+BitmapFormat", "+MemoryUsed;
        TopLine.MakeMsg(_R(IDS_SGBITMAP_FULLINFO_TOPLINE),(TCHAR *)BitmapName,(TCHAR*)BitmapFormat,(TCHAR *)MemoryUsed);
        Renderer->DrawFixedSystemText(&TopLine, TopRect);               


        // Plot the Dimensions and Colours on the Bottom Line
        String_256 MiddleLine; //  = BitmapWidth+" by "+BitmapHeight+" pixels,  "+BitmapCols;

        // Calculate the dpi of the original winbitmap...
        UINT32 hdpi = TheKernelBitmap->ActualBitmap->GetHorizontalDPI();
        UINT32 vdpi = TheKernelBitmap->ActualBitmap->GetVerticalDPI();

        if (hdpi == vdpi)
        {
            String_256 dpitext;
            Convert::LongToString(hdpi, &dpitext);
            MiddleLine.MakeMsg(_R(IDS_SGBITMAP_FULLINFO_BOTTOMLINE), (TCHAR *)BitmapWidth, (TCHAR *)BitmapHeight, (TCHAR *)BitmapCols, (TCHAR *)dpitext);
        }
        else
        {
            String_256 dpitext;
            camSnprintf(dpitext, 256, _T("%u x %u"), hdpi, vdpi);
            MiddleLine.MakeMsg(_R(IDS_SGBITMAP_FULLINFO_BOTTOMLINE), (TCHAR *)BitmapWidth, (TCHAR *)BitmapHeight, (TCHAR *)BitmapCols, (TCHAR *)dpitext);
        }
        Renderer->DrawFixedSystemText(&MiddleLine, MiddleRect);             


        // Find the Restore type 
        GIFDisposalMethod RestoreType = TheKernelBitmap->ActualBitmap->GetAnimationRestoreType();
        
        switch(RestoreType)
        {
            case GDM_NONE:
            {
                String_256 BottomLine;
                String_256 Nothing(_R(IDS_NOTHING));
                BottomLine.MakeMsg(_R(IDS_SGBITMAP_DELAY_RESTORE_BOTTOMLINE), (