• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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
ft_raster1_init(FT_Renderer render)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
ft_raster1_set_mode(FT_Renderer render,FT_ULong mode_tag,FT_Pointer data)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
ft_raster1_transform(FT_Renderer render,FT_GlyphSlot slot,const FT_Matrix * matrix,const FT_Vector * delta)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
ft_raster1_get_cbox(FT_Renderer render,FT_GlyphSlot slot,FT_BBox * cbox)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
ft_raster1_render(FT_Renderer render,FT_GlyphSlot slot,FT_Render_Mode mode,const FT_Vector * origin)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 */
300