Element.h

Go to the documentation of this file.

//---------------------------------------------------------------------------------------
// Copyright (c) 2001-2012 by PDFTron Systems Inc. All Rights Reserved.
// Consult legal.txt regarding legal and license information.    
//---------------------------------------------------------------------------------------

#ifndef   H_CPPPDFElement
#define   H_CPPPDFElement

#include <SDF/Obj.h>
#include <PDF/GState.h>
#include <PDF/Rect.h>
#include <PDF/CharData.h> 
#include <PDF/PathData.h> 
#include <PDF/Struct/SElement.h>
#include <C/PDF/TRN_Element.h>

namespace pdftron { 
        namespace PDF {


class Element 
{
public:
        // Common Methods ---------------------------------------------------------------

        enum Type
        {
                e_null,                  // undefined element type
                e_path,                  // path object
                e_text_begin,            // marks the beginning of a text container
                e_text,                  // text object within a text container
                e_text_new_line,         // indicates the start of the new text line
                e_text_end,              // marks the end of text container
                e_image,                 // image XObject
                e_inline_image,          // inline image object
                e_shading,               // shading object
                e_form,                  // a form XObject 
                e_group_begin,           // push graphics state operator (q)
                e_group_end,             // pop graphics state operator (Q)
                e_marked_content_begin,  // marks the beginning of marked content sequence (BMC, BDC)
                e_marked_content_end,    // marks the end of marked content sequence (EMC)
                e_marked_content_point   // designate a marked-content point (MP, DP) 
        };

        Element();
        Element(const Element& c);
        Element& operator=(const Element&c);
        operator bool () { return mp_elem!=0;}

        Type GetType();

        GState GetGState();

        Common::Matrix2D GetCTM();

        Rect GetBBox();

#ifndef SWIG
        bool GetBBox(Rect& out_bbox);
#endif
        
        Struct::SElement GetParentStructElement();

        int GetStructMCID();

        bool IsOCVisible();
        
        // Path Element (e_path) Get Methods --------------------------------------------

        bool IsClippingPath();

        bool IsStroked();

        bool IsFilled();
        
         bool IsWindingFill();

         bool IsClipWindingFill();

         PathData GetPathData() const;
         
        // Path Element (e_path) Set Methods --------------------------------------------
         
         void SetPathData(const PathData& data);

         void SetPathClip(bool clip);

         void SetPathStroke(bool stroke);

         void SetPathFill(bool fill);

         void SetWindingFill(bool winding_rule);

         void SetClipWindingFill(bool winding_rule);

        // XObject Element (e_image or e_form_begin) Methods ----------------------------

         SDF::Obj GetXObject();


        // Image (e_image and e_inline_image) Element Methods ---------------------------

         Filters::Filter GetImageData() const;

         int GetImageDataSize() const;

        #if defined(_WIN32) && !defined(WINCE)
         Gdiplus::Bitmap* GetBitmap() const;
        #endif

         ColorSpace GetImageColorSpace() const;

         int GetImageWidth() const;

         int GetImageHeight() const;

         SDF::Obj GetDecodeArray() const;

         int GetBitsPerComponent() const;

         int GetComponentNum() const;


         bool IsImageMask() const;

         bool IsImageInterpolate() const; 

         SDF::Obj GetMask() const; 

         GState::RenderingIntent GetImageRenderingIntent() const;

        // Text Element (e_text) Get Methods --------------------------------------------

         UString GetTextString();

#ifdef SWIG
         std::vector<unsigned char> GetTextData();
#else
         const UChar* GetTextData();
#endif
        
         UInt32 GetTextDataSize();

         Common::Matrix2D GetTextMatrix();

         CharIterator GetCharIterator();

         double GetTextLength();
        
         double GetPosAdjustment();

        // Text New Line Element (e_text_new_line) Methods ------------------------------

         Point GetNewTextLineOffset();

#ifndef SWIG
         void GetNewTextLineOffset(double& out_x, double& out_y);
#endif

         void SetNewTextLineOffset(double dx, double dy);


        // Text Element (e_text and e_text_new_line) Methods ----------------------------

          bool HasTextMatrix();


        // Text Element (e_text) Set Methods --------------------------------------------

         void SetTextData(const UChar* text_data, int text_data_size);
        
         void SetTextMatrix(Common::Matrix2D& mtx);

         void SetTextMatrix(double a, double b, double c, double d, double h, double v);
        
         void SetPosAdjustment(double adjust);

         void UpdateTextMetrics();


        // Shading Element (e_shading) Methods ------------------------------------------

         Shading GetShading();

        // Marked Content Elements 
        // (e_marked_content_begin and e_marked_content_point) Methods ------------------

         SDF::Obj GetMCPropertyDict();
        
         SDF::Obj GetMCTag();
        
         ~Element() {}


#ifndef SWIGHIDDEN
         Element(TRN_Element impl);
        TRN_Element mp_elem;
#endif
};


#include <Impl/Element.inl>

        };      // namespace PDF
};      // namespace pdftron

#endif

---

© 2002-2012 PDFTron Systems Inc.