render2/render.h

   1 #ifndef __render_h__
   2 #define __render_h__
   3
   4 #include <glib.h>
   5 #include <X11/Xlib.h>
   6
   7 /* instances */
   8
   9 struct RrInstance;
  10
  11 /*! Returns a struct to be used when calling members of the library.
  12   If the library fails to initialize, NULL is returned.
  13   @param display The X Display to use.
  14   @param screen The number of the screen to use.
  15 */
  16 struct RrInstance *RrInstanceNew(Display *display,
  17                                  int screen);
  18
  19 /*! Destroys an instance of the library. The instance should not be used after
  20   calling this function.
  21   @param inst The instance to destroy.
  22 */
  23 void RrInstanceFree(struct RrInstance *inst);
  24
  25 int RrInstanceDepth(struct RrInstance *inst);
  26 Colormap RrInstanceColormap(struct RrInstance *inst);
  27 Visual *RrInstanceVisual(struct RrInstance *inst);
  28
  29 /* colors */
  30
  31 /*! A Color (including alpha component) for the Render library. This should be
  32   treated as an opaque data type, and be accessed only via the available
  33   functions. */
  34 struct RrColor {
  35     /*! The red component. */
  36     float r;
  37     /*! The green component. */
  38     float g;
  39     /*! The blue component. */
  40     float b;
  41     /*! The alpha component. */
  42     float a;
  43 };
  44
  45 /*! Returns if an RrColor is non-opaque */
  46 #define RrColorHasAlpha(c) ((c).a > 0.0000001)
  47
  48 /*! Sets the values of all components for an RrColor */
  49 #define RrColorSet(c, w, x, y, z) (c)->r = (w), (c)->g = (x), \
  50                                   (c)->b = (y), (c)->a = z
  51
  52
  53 /*! Gets color values from a colorname.
  54   @param inst An instance of the library
  55   @param colorname The name of the color.
  56   @param ret The RrColor to set the colorvalues in.
  57   @return nonzero if the colorname could be parsed; on error, it returns zero.
  58 */
  59 int RrColorParse(struct RrInstance *inst, const char *colorname,
  60                  struct RrColor *ret);
  61
  62 /* fonts */
  63
  64 struct RrFont;
  65
  66 struct RrFont *RrFontOpen(struct RrInstance *inst, const char *fontstring);
  67 void RrFontClose(struct RrFont *font);
  68
  69 int RrFontMeasureString(struct RrFont *font, const char *string);
  70 int RrFontHeight(struct RrFont *font);
  71 int RrFontMaxCharWidth(struct RrFont *font);
  72
  73 /* surfaces */
  74
  75 struct RrSurface;
  76
  77 enum RrSurfaceType {
  78     RR_SURFACE_NONE,
  79     RR_SURFACE_PLANAR,
  80     RR_SURFACE_NONPLANAR
  81 };
  82
  83 /*! Create a new RrSurface prototype that can't render. A prototype can be
  84  copied to a new RrSurface that can render. */
  85 struct RrSurface *RrSurfaceNewProto(enum RrSurfaceType type,
  86                                     int numtex);
  87 /*! Create a new top-level RrSurface for a Window. The new RrSurface defaults
  88   to a non-visible state.*/
  89 struct RrSurface *RrSurfaceNew(struct RrInstance *inst,
  90                                enum RrSurfaceType type,
  91                                Window win,
  92                                int numtex);
  93 /*! Create a new RrSurface which is a child of another. The new RrSurface
  94   defaults to a visible state. */
  95 struct RrSurface *RrSurfaceNewChild(enum RrSurfaceType type,
  96                                     struct RrSurface *parent,
  97                                     int numtex);
  98 /*! Copy an RrSurface, creating a new top-level RrSurface for a Window. The
  99   new RrSurface defaults to a non-visible state.*/
 100 struct RrSurface *RrSurfaceCopy(struct RrInstance *inst,
 101                                 struct RrSurface *sur,
 102                                 Window win);
 103 /*! Copy an RrSurface, creating a nwe RrSurface which is a child of another.
 104   The new RrSurface defaults to a visible state.*/
 105 struct RrSurface *RrSurfaceCopyChild(struct RrSurface *sur,
 106                                      struct RrSurface *parent);
 107 /*! Destroys an RrSurface. */
 108 void RrSurfaceFree(struct RrSurface *sur);
 109
 110 void RrSurfaceSetArea(struct RrSurface *sur,
 111                       int x,
 112                       int y,
 113                       int w,
 114                       int h);
 115
 116 Window RrSurfaceWindow(struct RrSurface *sur);
 117
 118 void RrSurfaceShow(struct RrSurface *sur);
 119 void RrSurfaceHide(struct RrSurface *sur);
 120 int RrSurfaceVisible(struct RrSurface *sur);
 121
 122 void RrSurfaceMinSize(struct RrSurface *sur, int *w, int *h);
 123
 124 /* planar surfaces */
 125
 126 /*! The options available for the background of an RrSurface */
 127 enum RrSurfaceColorType {
 128     /*! No rendering on the surface background, its contents will be
 129       undefined. */
 130     RR_PLANAR_NONE,
 131     /*! Solid color fill. */
 132     RR_PLANAR_SOLID,
 133     /*! Horizontal gradient. */
 134     RR_PLANAR_HORIZONTAL,
 135     /*! Vertical gradient. */
 136     RR_PLANAR_VERTICAL,
 137     /*! Diagonal (TL->BR) gradient. */
 138     RR_PLANAR_DIAGONAL,
 139     /*! Cross-Diagonal (TR->BL) gradient. */
 140     RR_PLANAR_CROSSDIAGONAL,
 141     /*! Pipecross gradient. */
 142     RR_PLANAR_PIPECROSS,
 143     /*! Rectangle gradient. */
 144     RR_PLANAR_RECTANGLE,
 145     /*! Pyramid gradient. */
 146     RR_PLANAR_PYRAMID
 147 };
 148
 149 void RrPlanarSet(struct RrSurface *sur,
 150                  enum RrSurfaceColorType type,
 151                  struct RrColor *primary,
 152                  struct RrColor *secondary);
 153
 154 /* textures */
 155
 156 enum RrLayout {
 157     RR_TOP_LEFT,
 158     RR_TOP,
 159     RR_TOP_RIGHT,
 160     RR_LEFT,
 161     RR_CENTER,
 162     RR_RIGHT,
 163     RR_BOTTOM_LEFT,
 164     RR_BOTTOM,
 165     RR_BOTTOM_RIGHT
 166 };
 167
 168 #ifndef __LONG64
 169 typedef long RrData32;
 170 #else
 171 typedef int RrData32;
 172 #endif
 173
 174 void RrTextureSetRGBA(struct RrSurface *sur,
 175                       int texnum,
 176                       RrData32 *data,
 177                       int x,
 178                       int y,
 179                       int w,
 180                       int h);
 181 void RrTextureSetText(struct RrSurface *sur,
 182                       int texnum,
 183                       struct RrFont *font,
 184                       enum RrLayout layout,
 185                       const char *text);
 186 void RrTextureSetNone(struct RrSurface *sur,
 187                       int texnum);
 188
 189 /* drawing */
 190
 191 /*! Paints the surface, and all its children */
 192 void RrPaint(struct RrSurface *sur);
 193 /*! Paints the surface, and all its children, but only in the given area. */
 194 void RrPaintArea(struct RrSurface *sur,
 195                  int x,
 196                  int y,
 197                  int w,
 198                  int h);
 199 void RrExpose(struct RrInstance *inst, XExposeEvent *e);
 200
 201 #endif