---

/home/micah/picogui/pg1/client/c/include/picogui/pgfx.h

Go to the documentation of this file.

/* $Id: pgfx.h 3806 2003-05-04 06:11:21Z micah $
 *
 * picogui/pgfx.h - The PicoGUI abstract graphics interface
 * 
 * This is a thin wrapper providing a set of primitives that can render to
 * a canvas (persistant or immediate mode) and other fast graphics interfaces
 *
 * PicoGUI small and efficient client/server GUI
 * Copyright (C) 2000-2003 Micah Dowty <micahjd@users.sourceforge.net>
 *
 * This library 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 of the License, or (at your option) any later version.
 * 
 * This library 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
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA 
 * 
 * Contributors: 
 * 
 * 
 * 
 */

#ifndef _H_PG_PGFX
#define _H_PG_PGFX

/************ Data structures */


typedef int pgu;

typedef int pgprim;


typedef struct pgfx_context {
   struct pgfx_lib *lib;   
   pghandle device;        
   pgcolor color;          
   pgu cx;                 
   pgu cy;                 
   unsigned long flags;    
   int sequence;           
} *pgcontext;


struct pgfx_lib {
   pgprim (*pixel)     (pgcontext c, pgu x,  pgu y);
   pgprim (*line)      (pgcontext c, pgu x1, pgu y1, pgu x2, pgu y2);
   pgprim (*rect)      (pgcontext c, pgu x,  pgu y,  pgu w,  pgu h);
   pgprim (*frame)     (pgcontext c, pgu x,  pgu y,  pgu w,  pgu h);
   pgprim (*slab)      (pgcontext c, pgu x,  pgu y,  pgu w);
   pgprim (*bar)       (pgcontext c, pgu x,  pgu y,  pgu h);
   pgprim (*ellipse)   (pgcontext c, pgu x,  pgu y,  pgu w,  pgu h); 
   pgprim (*fellipse)  (pgcontext c, pgu x,  pgu y,  pgu w,  pgu h);  
   pgprim (*fpolygon)  (pgcontext c, pghandle array);   
   pgprim (*text)      (pgcontext c, pgu x,  pgu y,  pghandle string);
   pgprim (*bitmap)    (pgcontext c, pgu x,  pgu y,  pgu w,  pgu h,
                        pghandle bitmap);
   pgprim (*rotatebitmap) (pgcontext c, pgu x,  pgu y,  pgu w,  pgu h,
                           pghandle bitmap);
   pgprim (*tilebitmap)(pgcontext c, pgu x,  pgu y,  pgu w,  pgu h,
                        pghandle bitmap);
   pgprim (*gradient)  (pgcontext c, pgu x,  pgu y,  pgu w,  pgu h,
                        pgu angle, pgcolor c1, pgcolor c2);
   pgprim (*blur)(pgcontext c, pgu x,pgu y,pgu w,pgu h,pgu radius);

   /* Nonvisual primitives */
   
   pgprim (*setcolor)(pgcontext c, pgcolor color);
   pgprim (*setfont)(pgcontext c, pghandle font);
   pgprim (*setlgop)(pgcontext c, short lgop);
   pgprim (*setangle)(pgcontext c, pgu angle);              /* For text */
   pgprim (*setsrc)(pgcontext c, pgu x,pgu y,pgu w,pgu h);  /* For bitmaps */
   pgprim (*setmapping)(pgcontext c, pgu x,pgu y,pgu w,pgu h,short type);
   pgprim (*setclip)(pgcontext c, pgu x,pgu y,pgu w,pgu h);
   
   void (*update)(pgcontext c);
   
   /* FIXME: add functions to manipulate grops after they're created 
    * also update documentation when this is done. */
};


/************ Primitives */


inline pgprim pgPixel(pgcontext c,pgu x,pgu y);
inline pgprim pgLine(pgcontext c,pgu x1,pgu y1,pgu x2,pgu y2);
inline pgprim pgRect(pgcontext c,pgu x,pgu y,pgu w,pgu h);
inline pgprim pgFrame(pgcontext c,pgu x,pgu y,pgu w,pgu h);
inline pgprim pgSlab(pgcontext c,pgu x,pgu y,pgu w);
inline pgprim pgBar(pgcontext c,pgu x,pgu y,pgu h);
inline pgprim pgEllipse(pgcontext c,pgu x,pgu y,pgu w,pgu h);
inline pgprim pgFEllipse(pgcontext c,pgu x,pgu y,pgu w,pgu h);
inline pgprim pgFPolygon(pgcontext c, pghandle array); 
inline pgprim pgBlur(pgcontext c, pgu x, pgu y, pgu w, pgu h, pgu radius); 
inline pgprim pgText(pgcontext c,pgu x,pgu y,pghandle string);
inline pgprim pgBitmap(pgcontext c,pgu x,pgu y,pgu w,pgu h,pghandle bitmap);
inline pgprim pgRotateBitmap(pgcontext c,pgu x,pgu y,pgu w,pgu h,pghandle bitmap);
inline pgprim pgTileBitmap(pgcontext c,pgu x,pgu y,pgu w,pgu h,pghandle bitmap);
inline pgprim pgGradient(pgcontext c,pgu x,pgu y,pgu w,pgu h,
                         pgu angle,pgcolor c1,pgcolor c2);
inline pgprim pgSetColor(pgcontext c,pgcolor color);
inline pgprim pgSetFont(pgcontext c,pghandle font);
inline pgprim pgSetLgop(pgcontext c,short lgop);
inline pgprim pgSetAngle(pgcontext c,pgu angle);
inline pgprim pgSetSrc(pgcontext c,pgu x,pgu y,pgu w,pgu h);
inline pgprim pgSetMapping(pgcontext c,pgu x,pgu y,pgu w,pgu h,short type);

inline pgprim pgSetClip(pgcontext c,pgu x,pgu y,pgu w,pgu h);

inline void pgContextUpdate(pgcontext c);

void    pgMoveTo(pgcontext c, pgu x, pgu y);
pgprim  pgLineTo(pgcontext c, pgu x, pgu y);


/************ Constants */

#define PGFX_IMMEDIATE    1

#define PGFX_PERSISTENT   2

/************ Context management functions */

pgcontext pgNewCanvasContext(pghandle canvas,short mode);

pgcontext pgNewBitmapContext(pghandle bitmap);

void pgDeleteContext(pgcontext c);


#endif /* _H_PG_PGFX */

/* The End */

---