281 lines
8.9 KiB
C
281 lines
8.9 KiB
C
/* -*- mode: C; c-basic-offset: 2 -*-
|
|
*
|
|
* Pycairo - Python bindings for cairo
|
|
*
|
|
* Copyright © 2003 James Henstridge
|
|
* Copyright © 2004-2011 Steven Chaplin
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it either under the terms of the GNU Lesser General Public
|
|
* License version 2.1 as published by the Free Software Foundation
|
|
* (the "LGPL") or, at your option, under the terms of the Mozilla
|
|
* Public License Version 1.1 (the "MPL"). If you do not alter this
|
|
* notice, a recipient may use your version of this file under either
|
|
* the MPL or the LGPL.
|
|
*
|
|
* You should have received a copy of the LGPL along with this library
|
|
* in the file COPYING-LGPL-2.1; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
* You should have received a copy of the MPL along with this library
|
|
* in the file COPYING-MPL-1.1
|
|
*
|
|
* The contents of this file are subject to the Mozilla Public License
|
|
* Version 1.1 (the "License"); you may not use this file except in
|
|
* compliance with the License. You may obtain a copy of the License at
|
|
* http://www.mozilla.org/MPL/
|
|
*
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY
|
|
* OF ANY KIND, either express or implied. See the LGPL or the MPL for
|
|
* the specific language governing rights and limitations.
|
|
*/
|
|
|
|
#ifndef _PYCAIRO_H_
|
|
#define _PYCAIRO_H_
|
|
|
|
#include <Python.h>
|
|
|
|
#include <cairo.h>
|
|
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
cairo_t *ctx;
|
|
PyObject *base; /* base object used to create context, or NULL */
|
|
} PycairoContext;
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
cairo_font_face_t *font_face;
|
|
} PycairoFontFace;
|
|
|
|
#define PycairoToyFontFace PycairoFontFace
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
cairo_font_options_t *font_options;
|
|
} PycairoFontOptions;
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
cairo_matrix_t matrix;
|
|
} PycairoMatrix;
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
cairo_path_t *path;
|
|
} PycairoPath;
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
cairo_pattern_t *pattern;
|
|
PyObject *base; /* base object used to create pattern, or NULL */
|
|
} PycairoPattern;
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
cairo_rectangle_int_t rectangle_int;
|
|
} PycairoRectangleInt;
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
cairo_region_t *region;
|
|
} PycairoRegion;
|
|
|
|
#define PycairoSolidPattern PycairoPattern
|
|
#define PycairoSurfacePattern PycairoPattern
|
|
#define PycairoGradient PycairoPattern
|
|
#define PycairoLinearGradient PycairoPattern
|
|
#define PycairoRadialGradient PycairoPattern
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
cairo_scaled_font_t *scaled_font;
|
|
} PycairoScaledFont;
|
|
|
|
typedef struct {
|
|
PyObject_HEAD
|
|
cairo_surface_t *surface;
|
|
PyObject *base; /* base object used to create surface, or NULL */
|
|
} PycairoSurface;
|
|
|
|
#define PycairoImageSurface PycairoSurface
|
|
#define PycairoPDFSurface PycairoSurface
|
|
#define PycairoPSSurface PycairoSurface
|
|
#define PycairoRecordingSurface PycairoSurface
|
|
#define PycairoSVGSurface PycairoSurface
|
|
#define PycairoWin32Surface PycairoSurface
|
|
#define PycairoWin32PrintingSurface PycairoSurface
|
|
#define PycairoXCBSurface PycairoSurface
|
|
#define PycairoXlibSurface PycairoSurface
|
|
|
|
/* get C object out of the Python wrapper */
|
|
#define PycairoContext_GET(obj) (((PycairoContext *)(obj))->ctx)
|
|
|
|
/* Define structure for C API. */
|
|
typedef struct {
|
|
/* (type object, constructor) pairs */
|
|
PyTypeObject *Context_Type;
|
|
PyObject *(*Context_FromContext)(cairo_t *ctx, PyTypeObject *type,
|
|
PyObject *base);
|
|
PyTypeObject *FontFace_Type;
|
|
PyTypeObject *ToyFontFace_Type;
|
|
PyObject *(*FontFace_FromFontFace)(cairo_font_face_t *font_face);
|
|
PyTypeObject *FontOptions_Type;
|
|
PyObject *(*FontOptions_FromFontOptions)(
|
|
cairo_font_options_t *font_options);
|
|
PyTypeObject *Matrix_Type;
|
|
PyObject *(*Matrix_FromMatrix)(const cairo_matrix_t *matrix);
|
|
PyTypeObject *Path_Type;
|
|
PyObject *(*Path_FromPath)(cairo_path_t *path);
|
|
|
|
PyTypeObject *Pattern_Type;
|
|
PyTypeObject *SolidPattern_Type;
|
|
PyTypeObject *SurfacePattern_Type;
|
|
PyTypeObject *Gradient_Type;
|
|
PyTypeObject *LinearGradient_Type;
|
|
PyTypeObject *RadialGradient_Type;
|
|
PyObject *(*Pattern_FromPattern)(cairo_pattern_t *pattern, PyObject *base);
|
|
|
|
PyTypeObject *ScaledFont_Type;
|
|
PyObject *(*ScaledFont_FromScaledFont)(cairo_scaled_font_t *scaled_font);
|
|
|
|
PyTypeObject *Surface_Type;
|
|
PyTypeObject *ImageSurface_Type;
|
|
PyTypeObject *PDFSurface_Type;
|
|
PyTypeObject *PSSurface_Type;
|
|
PyTypeObject *SVGSurface_Type;
|
|
PyTypeObject *Win32Surface_Type;
|
|
PyTypeObject *Win32PrintingSurface_Type;
|
|
PyTypeObject *XCBSurface_Type;
|
|
PyTypeObject *XlibSurface_Type;
|
|
PyObject *(*Surface_FromSurface)(cairo_surface_t *surface, PyObject *base);
|
|
|
|
/* misc functions */
|
|
int (*Check_Status)(cairo_status_t status);
|
|
|
|
PyTypeObject *RectangleInt_Type;
|
|
PyObject *(*RectangleInt_FromRectangleInt)(
|
|
const cairo_rectangle_int_t *rectangle_int);
|
|
|
|
PyTypeObject *Region_Type;
|
|
PyObject *(*Region_FromRegion)(cairo_region_t *region);
|
|
|
|
PyTypeObject *RecordingSurface_Type;
|
|
} Pycairo_CAPI_t;
|
|
|
|
|
|
#ifndef _INSIDE_PYCAIRO_
|
|
|
|
/* Macros for accessing the C API */
|
|
#define PycairoContext_Type *(Pycairo_CAPI->Context_Type)
|
|
#define PycairoContext_FromContext (Pycairo_CAPI->Context_FromContext)
|
|
#define PycairoFontFace_Type *(Pycairo_CAPI->FontFace_Type)
|
|
#define PycairoToyFontFace_Type *(Pycairo_CAPI->ToyFontFace_Type)
|
|
#define PycairoFontFace_FromFontFace (Pycairo_CAPI->FontFace_FromFontFace)
|
|
#define PycairoFontOptions_Type *(Pycairo_CAPI->FontOptions_Type)
|
|
#define PycairoFontOptions_FromFontOptions \
|
|
(Pycairo_CAPI->FontOptions_FromFontOptions)
|
|
#define PycairoMatrix_Type *(Pycairo_CAPI->Matrix_Type)
|
|
#define PycairoMatrix_FromMatrix (Pycairo_CAPI->Matrix_FromMatrix)
|
|
#define PycairoPath_Type *(Pycairo_CAPI->Path_Type)
|
|
#define PycairoPath_FromPath (Pycairo_CAPI->Path_FromPath)
|
|
|
|
#define PycairoPattern_Type *(Pycairo_CAPI->Pattern_Type)
|
|
#define PycairoSolidPattern_Type *(Pycairo_CAPI->SolidPattern_Type)
|
|
#define PycairoSurfacePattern_Type *(Pycairo_CAPI->SurfacePattern_Type)
|
|
#define PycairoGradient_Type *(Pycairo_CAPI->Gradient_Type)
|
|
#define PycairoLinearGradient_Type *(Pycairo_CAPI->LinearGradient_Type)
|
|
#define PycairoRadialGradient_Type *(Pycairo_CAPI->RadialGradient_Type)
|
|
#define PycairoPattern_FromPattern (Pycairo_CAPI->Pattern_FromPattern)
|
|
|
|
#define PycairoRectangleInt_Type *(Pycairo_CAPI->RectangleInt_Type)
|
|
#define PycairoRectangleInt_FromRectangleInt \
|
|
(Pycairo_CAPI->RectangleInt_FromRectangleInt)
|
|
|
|
#define PycairoRegion_Type *(Pycairo_CAPI->Region_Type)
|
|
#define PycairoRegion_FromRegion (Pycairo_CAPI->Region_FromRegion)
|
|
|
|
#define PycairoScaledFont_Type *(Pycairo_CAPI->ScaledFont_Type)
|
|
#define PycairoScaledFont_FromScaledFont \
|
|
(Pycairo_CAPI->ScaledFont_FromScaledFont)
|
|
|
|
#define PycairoSurface_Type *(Pycairo_CAPI->Surface_Type)
|
|
#define PycairoImageSurface_Type *(Pycairo_CAPI->ImageSurface_Type)
|
|
|
|
#ifdef CAIRO_HAS_PDF_SURFACE
|
|
#define PycairoPDFSurface_Type *(Pycairo_CAPI->PDFSurface_Type)
|
|
#endif
|
|
|
|
#ifdef CAIRO_HAS_PS_SURFACE
|
|
#define PycairoPSSurface_Type *(Pycairo_CAPI->PSSurface_Type)
|
|
#endif
|
|
|
|
#ifdef CAIRO_HAS_RECORDING_SURFACE
|
|
#define PycairoRecordingSurface_Type \
|
|
*(Pycairo_CAPI->RecordingSurface_Type)
|
|
#endif
|
|
|
|
#ifdef CAIRO_HAS_SVG_SURFACE
|
|
#define PycairoSVGSurface_Type *(Pycairo_CAPI->SVGSurface_Type)
|
|
#endif
|
|
|
|
#ifdef CAIRO_HAS_WIN32_SURFACE
|
|
#define PycairoWin32Surface_Type *(Pycairo_CAPI->Win32Surface_Type)
|
|
#define PycairoWin32PrintingSurface_Type \
|
|
*(Pycairo_CAPI->Win32PrintingSurface_Type)
|
|
#endif
|
|
|
|
#ifdef CAIRO_HAS_XCB_SURFACE
|
|
#define PycairoXCBSurface_Type *(Pycairo_CAPI->XCBSurface_Type)
|
|
#endif
|
|
|
|
#ifdef CAIRO_HAS_XLIB_SURFACE
|
|
#define PycairoXlibSurface_Type *(Pycairo_CAPI->XlibSurface_Type)
|
|
#endif
|
|
|
|
#define PycairoSurface_FromSurface (Pycairo_CAPI->Surface_FromSurface)
|
|
|
|
#define Pycairo_Check_Status (Pycairo_CAPI->Check_Status)
|
|
|
|
#if PY_MAJOR_VERSION < 3
|
|
|
|
/* To access the Pycairo C API, edit the client module file to:
|
|
* 1) Add the following line to define a global variable for the C API
|
|
* static Pycairo_CAPI_t *Pycairo_CAPI;
|
|
* 2) Add 'Pycairo_IMPORT;' to the init<module> function
|
|
*/
|
|
#define Pycairo_IMPORT \
|
|
Pycairo_CAPI = (Pycairo_CAPI_t*) PyCObject_Import("cairo", "CAPI")
|
|
|
|
#else
|
|
|
|
#ifdef PYCAIRO_NO_IMPORT
|
|
|
|
extern Pycairo_CAPI_t *Pycairo_CAPI;
|
|
|
|
#else
|
|
|
|
/* To access the Pycairo C API, the client module should call 'import_cairo()'
|
|
* from the init<module> function, and check the return value, < 0 means the
|
|
* import failed.
|
|
*/
|
|
Pycairo_CAPI_t *Pycairo_CAPI;
|
|
|
|
/* Return -1 on error, 0 on success.
|
|
* PyCapsule_Import will set an exception if there's an error.
|
|
*/
|
|
static int
|
|
import_cairo(void)
|
|
{
|
|
Pycairo_CAPI = (Pycairo_CAPI_t*) PyCapsule_Import("cairo.CAPI", 0);
|
|
return (Pycairo_CAPI != 0) ? 0 : -1;
|
|
}
|
|
|
|
#endif
|
|
|
|
#endif
|
|
|
|
#endif /* ifndef _INSIDE_PYCAIRO_ */
|
|
|
|
#endif /* ifndef _PYCAIRO_H_ */
|