libipe-dev 7.1.4-2 / usr / include / ipedoc.h

// -*- C++ -*-
// --------------------------------------------------------------------
// The Ipe document.
// --------------------------------------------------------------------
/*

    This file is part of the extensible drawing editor Ipe.
    Copyright (C) 1993-2013  Otfried Cheong

    Ipe is free software; you can redistribute it and/or modify it
    under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 3 of the License, or
    (at your option) any later version.

    As a special exception, you have permission to link Ipe with the
    CGAL library and distribute executables, as long as you follow the
    requirements of the Gnu General Public License in regard to all of
    the software in the executable aside from CGAL.

    Ipe is 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 Ipe; if not, you can find it at
    "http://www.gnu.org/copyleft/gpl.html", or write to the Free
    Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

*/

#ifndef IPEDOC_H
#define IPEDOC_H

#include "ipeobject.h"
#include "ipepage.h"
#include "ipeimage.h"
#include "ipestyle.h"
#include "ipefontpool.h"

// --------------------------------------------------------------------

namespace ipe {

  class BitmapFinder;

  class Document {
  public:
    //! Properties of a document
    struct SProperties {
      SProperties();
      String iTitle;
      String iAuthor;
      String iSubject;
      String iKeywords;
      String iPreamble;
      bool iFullScreen;
      bool iNumberPages;
      //! Date/time in PDF style "D:20010428191400" format.
      String iCreated;
      String iModified;
      //! Program that created this document (e.g. "Ipe 7.5").
      String iCreator;
    };

    //! There are several Ipe document save formats.
    enum TFormat {
      EXml,  //!< Save as XML
      EPdf,  //!< Save as PDF
      EEps,  //!< Save as Encapsulated Postscript
      EIpe5,  //!< Ancient Ipe format
      EUnknown //!< Unknown file format
    };

    //! Options for saving Ipe documents (to PDF and Postscript)
    enum {
      ESaveNormal = 0, //!< Nothing special
      EExport = 1,     //!< Don't include Ipe markup
      ENoZip = 2,      //!< Do not compress streams
      EMarkedView = 4, //!< Create marked views only
      ENoColor = 8,    //!< No color commands in EPS output
    };

    //! Errors that can happen while loading documents
    enum LoadErrors {
      EVersionTooOld = -1,    //!< The version of the file is too old.
      EVersionTooRecent = -2, //!< The file version is newer than this Ipelib.
      EFileOpenError = -3,    //!< Error opening the file
    };

    Document();
    Document(const Document &rhs);
    ~Document();

    static TFormat fileFormat(DataSource &source);
    static TFormat formatFromFilename(String fn);

    static Document *load(DataSource &source, TFormat format, int &reason);

    static Document *load(const char *fname, int &reason);
    static Document *loadWithErrorReport(const char *fname);

    bool save(TellStream &stream, TFormat format, uint flags) const;
    bool save(const char *fname, TFormat format, uint flags) const;
    bool exportPages(const char *fname, uint flags,
		     int fromPage, int toPage) const;
    bool exportView(const char *fname, TFormat format,
		    uint flags, int pno, int vno) const;

    void saveAsXml(Stream &stream, bool usePdfBitmaps = false) const;

    //! Return number of pages of document.
    int countPages() const { return int(iPages.size()); }
    int countTotalViews() const;

    //! Return page (const version).
    /*! The first page is no 0. */
    const Page *page(int no) const { return iPages[no]; }
    //! Return page.
    /*! The first page is no 0. */
    Page *page(int no) { return iPages[no]; }

    Page *set(int no, Page *page);
    void insert(int no, Page *page);
    void push_back(Page *page);
    Page *remove(int no);

    //! Return document properties.
    inline SProperties properties() const { return iProperties; }
    void setProperties(const SProperties &info);

    //! Return stylesheet cascade.
    Cascade *cascade() { return iCascade; }
    //! Return stylesheet cascade (const version).
    const Cascade *cascade() const { return iCascade; }
    Cascade *replaceCascade(Cascade *cascade);

    void setFontPool(FontPool *fontPool);
    //! Return the current FontPool.
    inline const FontPool *fontPool() const { return iFontPool; }

    bool hasTrueTypeFonts() const;
    bool hasTransparency() const;
    bool hasTilings() const;
    bool hasGradients() const;

    void findBitmaps(BitmapFinder &bm) const;
    bool checkStyle(AttributeSeq &seq) const;

    //! Error codes returned by RunLatex.
    enum { ErrNone, ErrNoText, ErrNoDir, ErrWritingSource,
	   ErrOldPdfLatex, ErrRunLatex, ErrLatex, ErrLatexOutput,
	   ErrNoIconv };
    int runLatex(String &logFile);
    int runLatex();

  private:
    // disable assignment
    Document &operator=(const Document &rhs);

  private:
    std::vector<Page *> iPages;
    Cascade *iCascade;
    SProperties iProperties;
    FontPool *iFontPool;
  };

} // namespace

// --------------------------------------------------------------------
#endif