misc/libfreetype/src/raster/ftrend1.c
changeset 5172 88f2e05288ba
equal deleted inserted replaced
5171:f9283dc4860d 5172:88f2e05288ba
       
     1 /***************************************************************************/
       
     2 /*                                                                         */
       
     3 /*  ftrend1.c                                                              */
       
     4 /*                                                                         */
       
     5 /*    The FreeType glyph rasterizer interface (body).                      */
       
     6 /*                                                                         */
       
     7 /*  Copyright 1996-2001, 2002, 2003, 2005, 2006 by                         */
       
     8 /*  David Turner, Robert Wilhelm, and Werner Lemberg.                      */
       
     9 /*                                                                         */
       
    10 /*  This file is part of the FreeType project, and may only be used,       */
       
    11 /*  modified, and distributed under the terms of the FreeType project      */
       
    12 /*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
       
    13 /*  this file you indicate that you have read the license and              */
       
    14 /*  understand and accept it fully.                                        */
       
    15 /*                                                                         */
       
    16 /***************************************************************************/
       
    17 
       
    18 
       
    19 #include <ft2build.h>
       
    20 #include FT_INTERNAL_OBJECTS_H
       
    21 #include FT_OUTLINE_H
       
    22 #include "ftrend1.h"
       
    23 #include "ftraster.h"
       
    24 #include "rastpic.h"
       
    25 
       
    26 #include "rasterrs.h"
       
    27 
       
    28 
       
    29   /* initialize renderer -- init its raster */
       
    30   static FT_Error
       
    31   ft_raster1_init( FT_Renderer  render )
       
    32   {
       
    33     FT_Library  library = FT_MODULE_LIBRARY( render );
       
    34 
       
    35 
       
    36     render->clazz->raster_class->raster_reset( render->raster,
       
    37                                                library->raster_pool,
       
    38                                                library->raster_pool_size );
       
    39 
       
    40     return Raster_Err_Ok;
       
    41   }
       
    42 
       
    43 
       
    44   /* set render-specific mode */
       
    45   static FT_Error
       
    46   ft_raster1_set_mode( FT_Renderer  render,
       
    47                        FT_ULong     mode_tag,
       
    48                        FT_Pointer   data )
       
    49   {
       
    50     /* we simply pass it to the raster */
       
    51     return render->clazz->raster_class->raster_set_mode( render->raster,
       
    52                                                          mode_tag,
       
    53                                                          data );
       
    54   }
       
    55 
       
    56 
       
    57   /* transform a given glyph image */
       
    58   static FT_Error
       
    59   ft_raster1_transform( FT_Renderer       render,
       
    60                         FT_GlyphSlot      slot,
       
    61                         const FT_Matrix*  matrix,
       
    62                         const FT_Vector*  delta )
       
    63   {
       
    64     FT_Error error = Raster_Err_Ok;
       
    65 
       
    66 
       
    67     if ( slot->format != render->glyph_format )
       
    68     {
       
    69       error = Raster_Err_Invalid_Argument;
       
    70       goto Exit;
       
    71     }
       
    72 
       
    73     if ( matrix )
       
    74       FT_Outline_Transform( &slot->outline, matrix );
       
    75 
       
    76     if ( delta )
       
    77       FT_Outline_Translate( &slot->outline, delta->x, delta->y );
       
    78 
       
    79   Exit:
       
    80     return error;
       
    81   }
       
    82 
       
    83 
       
    84   /* return the glyph's control box */
       
    85   static void
       
    86   ft_raster1_get_cbox( FT_Renderer   render,
       
    87                        FT_GlyphSlot  slot,
       
    88                        FT_BBox*      cbox )
       
    89   {
       
    90     FT_MEM_ZERO( cbox, sizeof ( *cbox ) );
       
    91 
       
    92     if ( slot->format == render->glyph_format )
       
    93       FT_Outline_Get_CBox( &slot->outline, cbox );
       
    94   }
       
    95 
       
    96 
       
    97   /* convert a slot's glyph image into a bitmap */
       
    98   static FT_Error
       
    99   ft_raster1_render( FT_Renderer       render,
       
   100                      FT_GlyphSlot      slot,
       
   101                      FT_Render_Mode    mode,
       
   102                      const FT_Vector*  origin )
       
   103   {
       
   104     FT_Error     error;
       
   105     FT_Outline*  outline;
       
   106     FT_BBox      cbox;
       
   107     FT_UInt      width, height, pitch;
       
   108     FT_Bitmap*   bitmap;
       
   109     FT_Memory    memory;
       
   110 
       
   111     FT_Raster_Params  params;
       
   112 
       
   113 
       
   114     /* check glyph image format */
       
   115     if ( slot->format != render->glyph_format )
       
   116     {
       
   117       error = Raster_Err_Invalid_Argument;
       
   118       goto Exit;
       
   119     }
       
   120 
       
   121     /* check rendering mode */
       
   122 #ifndef FT_CONFIG_OPTION_PIC
       
   123     if ( mode != FT_RENDER_MODE_MONO )
       
   124     {
       
   125       /* raster1 is only capable of producing monochrome bitmaps */
       
   126       if ( render->clazz == &ft_raster1_renderer_class )
       
   127         return Raster_Err_Cannot_Render_Glyph;
       
   128     }
       
   129     else
       
   130     {
       
   131       /* raster5 is only capable of producing 5-gray-levels bitmaps */
       
   132       if ( render->clazz == &ft_raster5_renderer_class )
       
   133         return Raster_Err_Cannot_Render_Glyph;
       
   134     }
       
   135 #else /* FT_CONFIG_OPTION_PIC */
       
   136     /* When PIC is enabled, we cannot get to the class object      */
       
   137     /* so instead we check the final character in the class name   */
       
   138     /* ("raster5" or "raster1"). Yes this is a hack.               */
       
   139     /* The "correct" thing to do is have different render function */
       
   140     /* for each of the classes.                                    */
       
   141     if ( mode != FT_RENDER_MODE_MONO )
       
   142     {
       
   143       /* raster1 is only capable of producing monochrome bitmaps */
       
   144       if ( render->clazz->root.module_name[6] == '1' )
       
   145         return Raster_Err_Cannot_Render_Glyph;
       
   146     }
       
   147     else
       
   148     {
       
   149       /* raster5 is only capable of producing 5-gray-levels bitmaps */
       
   150       if ( render->clazz->root.module_name[6] == '5' )
       
   151         return Raster_Err_Cannot_Render_Glyph;
       
   152     }
       
   153 #endif /* FT_CONFIG_OPTION_PIC */
       
   154 
       
   155     outline = &slot->outline;
       
   156 
       
   157     /* translate the outline to the new origin if needed */
       
   158     if ( origin )
       
   159       FT_Outline_Translate( outline, origin->x, origin->y );
       
   160 
       
   161     /* compute the control box, and grid fit it */
       
   162     FT_Outline_Get_CBox( outline, &cbox );
       
   163 
       
   164     /* undocumented but confirmed: bbox values get rounded */
       
   165 #if 1
       
   166     cbox.xMin = FT_PIX_ROUND( cbox.xMin );
       
   167     cbox.yMin = FT_PIX_ROUND( cbox.yMin );
       
   168     cbox.xMax = FT_PIX_ROUND( cbox.xMax );
       
   169     cbox.yMax = FT_PIX_ROUND( cbox.yMax );
       
   170 #else
       
   171     cbox.xMin = FT_PIX_FLOOR( cbox.xMin );
       
   172     cbox.yMin = FT_PIX_FLOOR( cbox.yMin );
       
   173     cbox.xMax = FT_PIX_CEIL( cbox.xMax );
       
   174     cbox.yMax = FT_PIX_CEIL( cbox.yMax );
       
   175 #endif
       
   176 
       
   177     width  = (FT_UInt)( ( cbox.xMax - cbox.xMin ) >> 6 );
       
   178     height = (FT_UInt)( ( cbox.yMax - cbox.yMin ) >> 6 );
       
   179     bitmap = &slot->bitmap;
       
   180     memory = render->root.memory;
       
   181 
       
   182     /* release old bitmap buffer */
       
   183     if ( slot->internal->flags & FT_GLYPH_OWN_BITMAP )
       
   184     {
       
   185       FT_FREE( bitmap->buffer );
       
   186       slot->internal->flags &= ~FT_GLYPH_OWN_BITMAP;
       
   187     }
       
   188 
       
   189     /* allocate new one, depends on pixel format */
       
   190     if ( !( mode & FT_RENDER_MODE_MONO ) )
       
   191     {
       
   192       /* we pad to 32 bits, only for backwards compatibility with FT 1.x */
       
   193       pitch              = FT_PAD_CEIL( width, 4 );
       
   194       bitmap->pixel_mode = FT_PIXEL_MODE_GRAY;
       
   195       bitmap->num_grays  = 256;
       
   196     }
       
   197     else
       
   198     {
       
   199       pitch              = ( ( width + 15 ) >> 4 ) << 1;
       
   200       bitmap->pixel_mode = FT_PIXEL_MODE_MONO;
       
   201     }
       
   202 
       
   203     bitmap->width = width;
       
   204     bitmap->rows  = height;
       
   205     bitmap->pitch = pitch;
       
   206 
       
   207     if ( FT_ALLOC_MULT( bitmap->buffer, pitch, height ) )
       
   208       goto Exit;
       
   209 
       
   210     slot->internal->flags |= FT_GLYPH_OWN_BITMAP;
       
   211 
       
   212     /* translate outline to render it into the bitmap */
       
   213     FT_Outline_Translate( outline, -cbox.xMin, -cbox.yMin );
       
   214 
       
   215     /* set up parameters */
       
   216     params.target = bitmap;
       
   217     params.source = outline;
       
   218     params.flags  = 0;
       
   219 
       
   220     if ( bitmap->pixel_mode == FT_PIXEL_MODE_GRAY )
       
   221       params.flags |= FT_RASTER_FLAG_AA;
       
   222 
       
   223     /* render outline into the bitmap */
       
   224     error = render->raster_render( render->raster, &params );
       
   225 
       
   226     FT_Outline_Translate( outline, cbox.xMin, cbox.yMin );
       
   227 
       
   228     if ( error )
       
   229       goto Exit;
       
   230 
       
   231     slot->format      = FT_GLYPH_FORMAT_BITMAP;
       
   232     slot->bitmap_left = (FT_Int)( cbox.xMin >> 6 );
       
   233     slot->bitmap_top  = (FT_Int)( cbox.yMax >> 6 );
       
   234 
       
   235   Exit:
       
   236     return error;
       
   237   }
       
   238 
       
   239 
       
   240   FT_DEFINE_RENDERER(ft_raster1_renderer_class,
       
   241     
       
   242       FT_MODULE_RENDERER,
       
   243       sizeof( FT_RendererRec ),
       
   244 
       
   245       "raster1",
       
   246       0x10000L,
       
   247       0x20000L,
       
   248 
       
   249       0,    /* module specific interface */
       
   250 
       
   251       (FT_Module_Constructor)ft_raster1_init,
       
   252       (FT_Module_Destructor) 0,
       
   253       (FT_Module_Requester)  0
       
   254     ,
       
   255 
       
   256     FT_GLYPH_FORMAT_OUTLINE,
       
   257 
       
   258     (FT_Renderer_RenderFunc)   ft_raster1_render,
       
   259     (FT_Renderer_TransformFunc)ft_raster1_transform,
       
   260     (FT_Renderer_GetCBoxFunc)  ft_raster1_get_cbox,
       
   261     (FT_Renderer_SetModeFunc)  ft_raster1_set_mode,
       
   262 
       
   263     (FT_Raster_Funcs*)    &FT_STANDARD_RASTER_GET
       
   264   )
       
   265 
       
   266 
       
   267   /* This renderer is _NOT_ part of the default modules; you will need */
       
   268   /* to register it by hand in your application.  It should only be    */
       
   269   /* used for backwards-compatibility with FT 1.x anyway.              */
       
   270   /*                                                                   */
       
   271   FT_DEFINE_RENDERER(ft_raster5_renderer_class,
       
   272   
       
   273     
       
   274       FT_MODULE_RENDERER,
       
   275       sizeof( FT_RendererRec ),
       
   276 
       
   277       "raster5",
       
   278       0x10000L,
       
   279       0x20000L,
       
   280 
       
   281       0,    /* module specific interface */
       
   282 
       
   283       (FT_Module_Constructor)ft_raster1_init,
       
   284       (FT_Module_Destructor) 0,
       
   285       (FT_Module_Requester)  0
       
   286     ,
       
   287 
       
   288     FT_GLYPH_FORMAT_OUTLINE,
       
   289 
       
   290     (FT_Renderer_RenderFunc)   ft_raster1_render,
       
   291     (FT_Renderer_TransformFunc)ft_raster1_transform,
       
   292     (FT_Renderer_GetCBoxFunc)  ft_raster1_get_cbox,
       
   293     (FT_Renderer_SetModeFunc)  ft_raster1_set_mode,
       
   294 
       
   295     (FT_Raster_Funcs*)    &FT_STANDARD_RASTER_GET
       
   296   )
       
   297 
       
   298 
       
   299 /* END */