fthrattr.h

Go to the documentation of this file.

// $Id: fthrattr.h 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============================
 */

#ifndef INC_FEATHRATTR
#define INC_FEATHRATTR

// structs, typedefs, defines
//#include "unittype.h" - in camtypes.h [AUTOMATICALLY REMOVED]

// class definitions
//  1 - call classes member functions,
//  2 - use the class type for one of the members (not required if have pointer to class ??)
//  3 - to derive a superclass??
#include "offattr.h"
//#include "biasgain.h" - in camtypes.h [AUTOMATICALLY REMOVED]
//#include "cxfrech.h" - in camtypes.h [AUTOMATICALLY REMOVED]

// for MAX_SHADOW_BLUR
#include "bshadow.h"

// class predeclarations
class BitmapTranspFillAttribute;
class TranspFillMappingLinearAttribute;
class PaintingModeAttributeValue;
class KernelBitmap;
class BitmapFillAttribute;
class BitmapTranspFillAttribute;
class GRenderRegion;
class CCAttrMap;

// feather defaults (for zoom 100%; ie 750 MP per PIXEL == PX_MP_VAL)
#define DEFAULT_FEATHERSIZE_PIX             2
#define DEFAULT_FEATHERSIZE_MP              ((MILLIPOINT) (DEFAULT_FEATHERSIZE_PIX * PX_MP_VAL))
#define MAX_FEATHERSIZE_MP MAX_SHADOW_BLUR * PX_MP_VAL      // MAX_SHADOW_BLUR defined in bshadow.h .
                                                            // PX_MP_VAL defined in units.h = mp per pixels @ 100% zoom
#define DEFAULT_GAP_TOLERANCE_MP            ((MILLIPOINT) (PX_MP_VAL * 0.75))
                                                            // gaps less than 1.5 pixels wide @ 100% zoom 
                                                            // will not have feathering along their edges
                                                            // NB used as contour width hence min gap = 2*GapToleranceMP wide.

// NB Implications of MAX_FEATHERSIZE_MP:-
//  1   can't ever have greater than 40pixel feather size
//  2   at low zoom can't acheive full 40pix onscreen zoom
//      max pix @ view < 100% = 40pix * ViewScale
//      max pix @ view > 100% = 40pix

// debugging
// Create a bitmap copy of the feathered object for comparison with the bitmap generated
// via the offscreen rendering system (ie m_pOffscreenBitmapInfo/Bits inside OffscreenRenderingCompleted)
// NB Set _DEBUG_OFFSCREEN_PIXEL_WIDTH, leave _DEBUG_OFFSCREEN_MP_WIDTH as is
// ( See notes in fthrattr.cpp for useage guidelines )
//#define _DEBUG_OFFSCREEN_PIXEL_WIDTH      44
//#define _DEBUG_OFFSCREEN_MP_WIDTH         _DEBUG_OFFSCREEN_PIXEL_WIDTH * 750

//
//                              Helper functions
//
// Conversion between millipoints and pixels at current view scale
FIXED16 GetCurrentViewScale();
MILLIPOINT ConvertMeasurementToMillipointsAtCurrentViewScale(INT32 Width, UnitType type);
UINT32 ConvertMillipointsToPixelsAtCurrentViewScale(MILLIPOINT mp);
INT32 PixelsPerMeterAtCurrentViewScale();

// Ensuring contour code works correctly
BOOL CheckLineAttrs(CCAttrMap* pAttrMap);
BOOL MakeLineAttributeCompleteForContouring(Node* Context, Node* NodeToModify, CCAttrMap* pAttrMap);

//
//                              AttributeValue classes
//

/********************************************************************************************
>   class FeatherAttrValue : public AttributeValue
    Author:     Ilan_Copelyn (Xara Group Ltd) <camelotdev@xara.com>
    Created:    24/01/2000
    Purpose:    
    SeeAlso:    
 ********************************************************************************************/

class FeatherAttrValue : public OffscreenAttrValue
{
    CC_DECLARE_DYNCREATE( FeatherAttrValue )

public:

    FeatherAttrValue();
    ~FeatherAttrValue();

    // Standard functions required by Attribute framework 
    static BOOL Init();
    virtual void SimpleCopy(AttributeValue *);
//  virtual BOOL IsDifferent(AttributeValue*);  Not applicable
    virtual NodeAttribute *MakeNode();

    // Blending offscreen attrs
    virtual BOOL Blend(BlendAttrParam* pBlendParam);

    // Generic attr rendering functions
    // (rely on GRenderRegion offscreen rendering system create and swap bitmaps)
    virtual void Render(RenderRegion *, BOOL Temp = FALSE);
    virtual void Restore(RenderRegion *, BOOL);

    // Allow derived classes to overide integral parts of the offscreen bmp setup process
    virtual void GetMinimumOffscreenBmpDimensions(UINT32* RequiredWidth, UINT32* RequiredHeight);

    // Offscreen rendering functions.
    virtual void OffscreenRenderingCompleted(RenderRegion *pRender, LPBITMAPINFO lpBitmapInfo, LPBYTE lpBits, DocRect BitmapRect);
    virtual BOOL DoesOffscreenBmpRequireTransp(GRenderRegion* pGRR);
    virtual BOOL DoesOffscreenBMPCaptureBackground() {return TRUE;}     // Return TRUE if you can make this work
                                                                        // During rotated printing (it works on screen)
    virtual BOOL CreateFeatherTransp(GRenderRegion* pGRR,
                                     Path* pPath,
                                     double dPixelWidth,
                                     BitmapTranspFillAttribute** ppFeatherTransp,
                                     KernelBitmap** ppFeatherBitmap);

private:
    // Internal helper functions used in rendering the feather bitmap
    KernelBitmap*   CreateFeatherBitmap(GRenderRegion* pGRR, double pixBlurDiameter);
    LPBITMAPINFO    CreateSilhouetteBitmap(GRenderRegion* GRR, LPBYTE* ppBmpBits, Path* pOutline = NULL);

    void SetupFeatherBitmapPalette(KernelBitmap* pFeatherBMP);
    void CreateBitmapFill(KernelBitmap* pBitmap, DocRect* dr, BitmapFillAttribute* BmpFill);
    void CreateBitmapFillRot90(KernelBitmap* pBitmap, DocRect* dr, BitmapFillAttribute* BmpFill);
    void CreateBitmapTranspFill(KernelBitmap* pFeather, DocRect* dr, BitmapTranspFillAttribute* BmpTranspFill);
    Path* GetVisibleBoundingPath();

public:
    // Creation/modification triggered by Feather Ops
    BOOL SetupFeather(Node* pNode, INT32 Width = DEFAULT_FEATHERSIZE_MP, UnitType type = MILLIPOINTS);
    BOOL ChangeFeatherProfile(CProfileBiasGain &biasgain);
    BOOL ChangeFeatherSize(INT32 , UnitType );

public:
    // Queries to support feather control UI updating (feather only)

    MILLIPOINT GetFeatherSize();
    double GetFeatherPixelSize(double fPixelWidth);
    CProfileBiasGain GetProfile() { return m_Profile; }
    CProfileBiasGain* GetProfilePtr() { return &m_Profile; }        // return pointer to profile

    // Set functions for saving/loading feather attrs and change operations
    MILLIPOINT SetFeatherSize(MILLIPOINT sz);
    void SetFeatherProfile(CProfileBiasGain &biasgain);
    virtual void SetLinkedNode(NodeRenderableBounded* pNode);

public:
    //-------------------------------------------------------------------------------------------------------------
    //                                  New attribute systems support
    //
    // Feather attributes are linked to the objects geometry in the following ways:-
    //      need bounding rects of objects to determine offscreen bitmap size
    //      need bounding/outer contour path of objects to create feather mask
    //

    virtual BOOL CanBeRenderedDirectly();

    // Caching and regenerating objects outercontour.
    BOOL GenerateOuterContour();
    Path* GetOuterContour() { return m_pOuterContour; }
    BOOL RegenerateOuterContourOnNextRedraw(UndoableOperation* pOp=NULL);
    void SetOuterContour(Path* pNewOuterContour) { m_pOuterContour = pNewOuterContour; }
    //-------------------------------------------------------------------------------------------------------------

private:
    //-------------------------------------------------------------------------------------------------------------
    //                                      Member Variables
    // Feather Attribute state members:
    CProfileBiasGain            m_Profile;
    MILLIPOINT                  m_FeatherSize;
    MILLIPOINT                  m_GapSize;
    Path*                       m_pOuterContour;        // used only in rendering but is cached
                                                        // updated by AllowOps
    DocRect                     m_drFeatherBB;          // the rect we render the feather transp bmp through.

    BOOL                        m_bCached;

    // The maximum feather size which we allow the user to play with.
    // This constant is defined at the top of fthrattr.cpp .
    static const MILLIPOINT MaxUserFeatherSize;

#ifdef _DEBUG_OFFSCREEN_PIXEL_WIDTH
    // Debugging
    KernelBitmap*               md_ShadBmp; 
#endif
};


//
//                              NodeAttribute classes
//


/********************************************************************************************
>   class AttrFeather : public NodeAttribute
    Author:     Ilan_Copelyn (Xara Group Ltd) <camelotdev@xara.com>
    Created:    24/01/2000
    Purpose:    
    SeeAlso:    
 ********************************************************************************************/

class AttrFeather : public NodeAttribute
{
    CC_DECLARE_DYNAMIC( AttrFeather )
    
public:
    AttrFeather() {}
    ~AttrFeather() {}
    AttrFeather(Node* ContextNode,  
                 AttachNodeDirection Direction,    
                 BOOL Locked=FALSE, 
                 BOOL Mangled=FALSE,  
                 BOOL Marked=FALSE, 
                 BOOL Selected=FALSE) : 
        NodeAttribute(ContextNode, Direction, Locked, Mangled, Marked, Selected) {}

    // Traditional Node functionality
    virtual void Render( RenderRegion* pRender );
#ifdef _DEBUG
    void GetDebugDetails(StringBase* Str);
#endif

    // Traditional NodeAttribute functionality
    virtual AttributeValue* GetAttributeValue() { return &Value; }
    Node* SimpleCopy();
    virtual UINT32 GetAttrNameID();
    virtual AttrIndex GetAttributeIndex () { return ATTR_FEATHER; }
    virtual UINT32 GetNodeSize();
    virtual INT32 operator==(const NodeAttribute& NodeAttrib);
    // nb op== is also involved in redundant attribute removal

    // Node charateristics tests
    virtual BOOL NeedsTransparency() const { return TRUE; }
    virtual BOOL IsAFeatherAttr() const;

    // OpFeather triggered functions
    BOOL DoFeather(Node* pNode, INT32 size = DEFAULT_FEATHERSIZE_MP, UnitType type = MILLIPOINTS);
    BOOL DoSetProfile(CProfileBiasGain bg);

    // prevent feathering in incompatible circumstances
    virtual SubtreeRenderState RenderSubtree(RenderRegion* pRender, Node** ppNextNode = NULL, BOOL bClip = TRUE);

    // support layering and remove redundant attrs
    virtual BOOL CanBeMultiplyApplied()     { return TRUE; }
    virtual BOOL ShouldBeOptimized();

    // dynamic attribute functions and flags
    virtual void Transform(TransformBase& Trans);
    virtual BOOL Blend(BlendAttrParam* pBlendParam);
    virtual BOOL IsLinkedToNodeGeometry() { return TRUE; }
    virtual BOOL IsLinkedToThisNode(Node* pNode);

    // support dynamic attribute creation
    virtual BOOL PostDynCreateInit(CCAttrMap* pMap, Path* InkPath, CCRuntimeClass* pCreatorClass);
    virtual BOOL PostDynCreateInit(CCAttrMap* pMap, Node* pNode, CCRuntimeClass* pCreatorClass);
    virtual void PostDynCreateDeInit();

    // gla support
    virtual BOOL LinkedNodeGeometryHasChanged(UndoableOperation* pOp);
    virtual void NewlyCreatedDefaultAttr(NodeDocument* pNode);
    virtual BOOL LinkToGeometry(Node* pContext);
    virtual BOOL ContainsAttributeValue(AttributeValue* pVal);

    // Karim 15/11/2000
    // ID function for attributes which divert rendering offscreen, such as ourself.
    virtual BOOL IsAnOffscreenAttribute() { return TRUE; }
    virtual void PolyCopyNodeContents(NodeRenderable* pNodeCopy);

    // Version 2 file format functions
    virtual BOOL WritePreChildrenWeb(BaseCamelotFilter* pFilter);
    virtual BOOL WritePreChildrenNative(BaseCamelotFilter* pFilter);

private:
    void CopyNodeContents(NodeAttribute *pCopy);

public:

    FeatherAttrValue Value;

};


//
//                              Saving and loading
//


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

>   class FeatherRecordHandler : public CamelotRecordHandler

    Author:     Mark_Howitt (Xara Group Ltd) <camelotdev@xara.com>
    Created:    30/5/96
    Purpose:    Handles the reading of all feather records in the v2 file format
    SeeAlso:    -

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

class FeatherRecordHandler : public CamelotRecordHandler
{
    // Give my name in memory dumps
    CC_DECLARE_DYNAMIC(FeatherRecordHandler);

public:
    FeatherRecordHandler() : CamelotRecordHandler() {}
    ~FeatherRecordHandler() {}

    virtual UINT32* GetTagList();
    virtual BOOL    HandleRecord(CXaraFileRecord* pCXaraFileRecord);

private:
    BOOL HandleFeatherRecord(CXaraFileRecord* pCXaraFileRecord);
};

#endif //INC_FEATHRATTR

---