doc/get_put_pixel.txt

   1 GetPixel and PutPixel
   2 ---------------------
   3
   4 [source,c]
   5 --------------------------------------------------------------------------------
   6 #include <GP.h>
   7 /* or */
   8 #include <core/GP_GetPutPixel.h>
   9
  10 GP_Pixel GP_GetPixel(const GP_Context *context, GP_Coord x, GP_Coord y);
  11
  12 void GP_PutPixel(GP_Context *context, GP_Coord x, GP_Coord y, GP_Pixel p);
  13 --------------------------------------------------------------------------------
  14
  15 Gets, puts a pixel value. GP_Pixel is a number which holds a pixel value.
  16
  17 This functions are clipped, GetPixel outside of the context returns zero,
  18 PutPixel outside the context is no-op.
  19
  20 This functions honour link:context.html[context rotation flags].
  21
  22 Generally these function are safe to use but rather slow in innner cycles.
  23
  24 [source,c]
  25 --------------------------------------------------------------------------------
  26 #include <GP.h>
  27 /* or */
  28 #include <core/GP_GetPutPixel.h>
  29
  30 GP_Pixel GP_GetPixel_Raw(const GP_Context *context, GP_Coord x, GP_Coord y);
  31
  32 void GP_PutPixel_Raw(GP_Context *context, GP_Coord x, GP_Coord y, GP_Pixel p);
  33
  34 /*
  35  * Substitute {{ bpp }} for specific bits per pixel (1BPP_LE, 24BPP, ...)
  36  *
  37  * These macros are generated to core/GP_GetPutPixel.gen.h
  38  */
  39 GP_Pixel GP_GetPixel_Raw_{{ bpp }}(const GP_Context *c, int x, int y);
  40
  41 void GP_PutPixel_Raw_{{ bpp }}(GP_Context *c, GP_Coord x, GP_Coord y,
  42                                GP_Pixel p);
  43 --------------------------------------------------------------------------------
  44
  45 These functions are generally fast, but does not honour context rotation flags
  46 and do not check that coordinates are inside of the context.
  47
  48 They are intended as basic building blocks for other GFX primitives, filters,
  49 etc.