/usr/include/Nux-4.0/NuxGraphics/CairoGraphics.h

/*
 * Copyright 2010, 2011 Inalogic® Inc.
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License, as
 * published by the  Free Software Foundation; either version 2.1 or 3.0
 * of the License.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranties of
 * MERCHANTABILITY, SATISFACTORY QUALITY or FITNESS FOR A PARTICULAR
 * PURPOSE.  See the applicable version of the GNU Lesser General Public
 * License for more details.
 *
 * You should have received a copy of both the GNU Lesser General Public
 * License along with this program. If not, see <http://www.gnu.org/licenses/>
 *
 * Authored by: Jay Taoko <jaytaoko@inalogic.com>
 *
 */


#ifndef CAIROGRAPHICS_H
#define CAIROGRAPHICS_H

#ifdef NUX_ARCH_ARM
#include "cairo.h"
#else
#include "cairo/cairo.h"
#endif
#include "BitmapFormats.h"
#include "ImageSurface.h"

#include <stack>

namespace nux
{
class CairoFontOptions
{
public:
  CairoFontOptions()
    : font_options_(::cairo_font_options_create())
    {}

  ~CairoFontOptions()
  {
    ::cairo_font_options_destroy(font_options_);
  }

  operator cairo_font_options_t*()
  {
    return font_options_;
  }

private:
  cairo_font_options_t* font_options_;
};


//! A cairo graphics container
  /*!
      CairoGraphics encapsulates a cairo surface and context.
  */
  class CairoGraphics
  {
  public:
    CairoGraphics(cairo_format_t format, int width, int height);
    ~CairoGraphics();

    //! Return a cairo context to the encapsulated surface.
    /*!
        Return the cairo context of this object. Call cairo_destroy to destroy the context when you are done with it.
        @return A cairo context.
    */
    cairo_t *GetContext();

    //! Return an internal cairo context to the encapsulated surface. Should not be destroyed.
    /*!
        Return the cairo context of this object. This cairo context should not be destroyed with cairo_destroy.
        @return A cairo context.
    */
    cairo_t *GetInternalContext();

    cairo_surface_t* GetSurface();
    //! Create a NBitmapData pointer to a 2D texture data.
    /*!
        The returned data must be destroyed with delete.
        @return A pointer to a 2D texture data.
    */
    NBitmapData *GetBitmap();

    int GetWidth() const;
    int GetHeight() const;

    bool PushState();
    bool PopState();

    bool ClearCanvas();

    bool ClearRect(double x, double y, double w, double h);

    bool DrawLine(double x0, double y0, double x1, double y1, double width, const Color &c);

    void TranslateCoordinates(double dx, double dy);

    bool DrawFilledRect(double x, double y, double w, double h, const Color &c);

    bool DrawCanvas(double x, double y, CairoGraphics *cg);

    bool DrawRoundedRectangle(cairo_t* cr,
                               double   aspect,
                               double   x,
                               double   y,
                               double   cornerRadius,
                               double   width,
                               double   height,
                               bool     align = false);

    bool BlurSurface(unsigned int radius, cairo_surface_t* surf = NULL);

    bool IntersectRectClipRegion(double x, double y, double w, double h);

    bool IntersectGeneralClipRegion(std::list<Rect> &region);

  /**
   * Enum used to specify horizontal alignment.
   */
  enum Alignment {
    ALIGN_LEFT,
    ALIGN_CENTER,
    ALIGN_RIGHT,
    ALIGN_JUSTIFY
  };

  /**
   * Enum used to specify vertical alignment.
   */
  enum VAlignment {
    VALIGN_TOP,
    VALIGN_MIDDLE,
    VALIGN_BOTTOM
  };

  /**
   * Enum used to specify trimming type.
   */
  enum Trimming {
    TRIMMING_NONE,
    TRIMMING_CHARACTER,
    TRIMMING_WORD,
    TRIMMING_CHARACTER_ELLIPSIS,
    TRIMMING_WORD_ELLIPSIS,
    TRIMMING_PATH_ELLIPSIS
  };

  /**
   * Enum used to specify text flags.
   */
  enum TextFlag {
    TEXT_FLAGS_NONE = 0,
    TEXT_FLAGS_UNDERLINE = 1,
    TEXT_FLAGS_STRIKEOUT = 2,
    TEXT_FLAGS_WORDWRAP = 4
  };

  private:
    //! Cairo surface format
    cairo_format_t m_surface_format;
    //! Cairo surface
    cairo_surface_t *_cairo_surface;

    cairo_t * _cr;
    int _width; //!< Surface width.
    int _height; //!< Surface height.

    double _zoom;
    float _opacity;
    std::stack<float> _opacity_stack;
  };

}

#endif // CAIROGRAPHICS_H
libnux-4.0-dev 4.0.6+14.04.20140409-0ubuntu1 / usr / include / Nux-4.0 / NuxGraphics / CairoGraphics.h
