/***************************************************************************//*                                                                         *//*  ftimage.h                                                              *//*                                                                         *//*    FreeType glyph image formats and default raster interface            *//*    (specification).                                                     *//*                                                                         *//*  Copyright 1996-2001 by                                                 *//*  David Turner, Robert Wilhelm, and Werner Lemberg.                      *//*                                                                         *//*  This file is part of the FreeType project, and may only be used,       *//*  modified, and distributed under the terms of the FreeType project      *//*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     *//*  this file you indicate that you have read the license and              *//*  understand and accept it fully.                                        *//*                                                                         *//***************************************************************************/  /*************************************************************************/  /*                                                                       */  /* Note: A `raster' is simply a scan-line converter, used to render      */  /*       FT_Outlines into FT_Bitmaps.                                    */  /*                                                                       */  /*************************************************************************/#ifndef __FTIMAGE_H__#define __FTIMAGE_H__#include <ft2build.h>FT_BEGIN_HEADER  /*************************************************************************/  /*                                                                       */  /* <Section>                                                             */  /*    basic_types                                                        */  /*                                                                       */  /*************************************************************************/  /*************************************************************************/  /*                                                                       */  /* <Type>                                                                */  /*    FT_Pos                                                             */  /*                                                                       */  /* <Description>                                                         */  /*    The type FT_Pos is a 32-bit integer used to store vectorial        */  /*    coordinates.  Depending on the context, these can represent        */  /*    distances in integer font units, or 26.6 fixed float pixel         */  /*    coordinates.                                                       */  /*                                                                       */  typedef signed long  FT_Pos;  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    FT_Vector                                                          */  /*                                                                       */  /* <Description>                                                         */  /*    A simple structure used to store a 2D vector; coordinates are of   */  /*    the FT_Pos type.                                                   */  /*                                                                       */  /* <Fields>                                                              */  /*    x :: The horizontal coordinate.                                    */  /*    y :: The vertical coordinate.                                      */  /*                                                                       */  typedef struct  FT_Vector_  {    FT_Pos  x;    FT_Pos  y;  } FT_Vector;  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    FT_BBox                                                            */  /*                                                                       */  /* <Description>                                                         */  /*    A structure used to hold an outline's bounding box, i.e., the      */  /*    coordinates of its extrema in the horizontal and vertical          */  /*    directions.                                                        */  /*                                                                       */  /* <Fields>                                                              */  /*    xMin :: The horizontal minimum (left-most).                        */  /*                                                                       */  /*    yMin :: The vertical minimum (bottom-most).                        */  /*                                                                       */  /*    xMax :: The horizontal maximum (right-most).                       */  /*                                                                       */  /*    yMax :: The vertical maximum (top-most).                           */  /*                                                                       */  typedef struct  FT_BBox_  {    FT_Pos  xMin, yMin;    FT_Pos  xMax, yMax;  } FT_BBox;  /*************************************************************************/  /*                                                                       */  /* <Enum>                                                                */  /*    FT_Pixel_Mode                                                      */  /*                                                                       */  /* <Description>                                                         */  /*    An enumeration type used to describe the format of pixels in a     */  /*    given bitmap.  Note that additional formats may be added in the    */  /*    future.                                                            */  /*                                                                       */  /* <Fields>                                                              */  /*    ft_pixel_mode_mono  :: A monochrome bitmap (1 bit/pixel).          */  /*                                                                       */  /*    ft_pixel_mode_grays :: An 8-bit gray-levels bitmap.  Note that the */  /*                           total number of gray levels is given in the */  /*                           `num_grays' field of the FT_Bitmap          */  /*                           structure.                                  */  /*                                                                       */  /*    ft_pixel_mode_pal2  :: A 2-bit paletted bitmap.                    */  /*                           Currently unused by FreeType.               */  /*                                                                       */  /*    ft_pixel_mode_pal4  :: A 4-bit paletted bitmap.                    */  /*                           Currently unused by FreeType.               */  /*                                                                       */  /*    ft_pixel_mode_pal8  :: An 8-bit paletted bitmap.                   */  /*                           Currently unused by FreeType.               */  /*                                                                       */  /*    ft_pixel_mode_rgb15 :: A 15-bit RGB bitmap.  Uses 5:5:5 encoding.  */  /*                           Currently unused by FreeType.               */  /*                                                                       */  /*    ft_pixel_mode_rgb16 :: A 16-bit RGB bitmap.  Uses 5:6:5 encoding.  */  /*                           Currently unused by FreeType.               */  /*                                                                       */  /*    ft_pixel_mode_rgb24 :: A 24-bit RGB bitmap.                        */  /*                           Currently unused by FreeType.               */  /*                                                                       */  /*    ft_pixel_mode_rgb32 :: A 32-bit RGB bitmap.                        */  /*                           Currently unused by FreeType.               */  /*                                                                       */  /* <Note>                                                                */  /*    Some anti-aliased bitmaps might be embedded in TrueType fonts      */  /*    using formats pal2 or pal4, though no fonts presenting those have  */  /*    been found to date.                                                */  /*                                                                       */  typedef enum  FT_Pixel_Mode_  {    ft_pixel_mode_none = 0,    ft_pixel_mode_mono,    ft_pixel_mode_grays,    ft_pixel_mode_pal2,    ft_pixel_mode_pal4,    ft_pixel_mode_pal8,    ft_pixel_mode_rgb15,    ft_pixel_mode_rgb16,    ft_pixel_mode_rgb24,    ft_pixel_mode_rgb32,    ft_pixel_mode_max      /* do not remove */  } FT_Pixel_Mode;  /*************************************************************************/  /*                                                                       */  /* <Enum>                                                                */  /*    FT_Palette_Mode                                                    */  /*                                                                       */  /* <Description>                                                         */  /*    An enumeration type used to describe the format of a bitmap        */  /*    palette, used with ft_pixel_mode_pal4 and ft_pixel_mode_pal8.      */  /*                                                                       */  /* <Fields>                                                              */  /*    ft_palette_mode_rgb  :: The palette is an array of 3-bytes RGB     */  /*                            records.                                   */  /*                                                                       */  /*    ft_palette_mode_rgba :: The palette is an array of 4-bytes RGBA    */  /*                            records.                                   */  /*                                                                       */  /* <Note>                                                                */  /*    As ft_pixel_mode_pal2, pal4 and pal8 are currently unused by       */  /*    FreeType, these types are not handled by the library itself.       */  /*                                                                       */  typedef enum  FT_Palette_Mode_  {    ft_palette_mode_rgb = 0,    ft_palette_mode_rgba,    ft_palettte_mode_max   /* do not remove */  } FT_Palette_Mode;  /*************************************************************************/  /*                                                                       */  /* <Struct>                                                              */  /*    FT_Bitmap                                                          */  /*                                                                       */  /* <Description>                                                         */  /*    A structure used to describe a bitmap or pixmap to the raster.     */