ftglyph.c File Reference

#include <ft2build.h>
#include "basepic.h"

Include dependency graph for ftglyph.c:

Go to the source code of this file.

Macros
#define	FT_COMPONENT   trace_glyph

Functions
	ft_bitmap_glyph_init (FT_Glyph bitmap_glyph, FT_GlyphSlot slot)
	ft_bitmap_glyph_copy (FT_Glyph bitmap_source, FT_Glyph bitmap_target)
	ft_bitmap_glyph_done (FT_Glyph bitmap_glyph)
	ft_bitmap_glyph_bbox (FT_Glyph bitmap_glyph, FT_BBox *cbox)
	FT_DEFINE_GLYPH (ft_bitmap_glyph_class, sizeof(FT_BitmapGlyphRec), FT_GLYPH_FORMAT_BITMAP, ft_bitmap_glyph_init, ft_bitmap_glyph_done, ft_bitmap_glyph_copy, NULL, ft_bitmap_glyph_bbox, NULL)
	ft_outline_glyph_done (FT_Glyph outline_glyph)
	ft_outline_glyph_copy (FT_Glyph outline_source, FT_Glyph outline_target)
	ft_outline_glyph_transform (FT_Glyph outline_glyph, const FT_Matrix *matrix, const FT_Vector *delta)
	ft_outline_glyph_bbox (FT_Glyph outline_glyph, FT_BBox *bbox)
	ft_outline_glyph_prepare (FT_Glyph outline_glyph, FT_GlyphSlot slot)
	FT_DEFINE_GLYPH (ft_outline_glyph_class, sizeof(FT_OutlineGlyphRec), FT_GLYPH_FORMAT_OUTLINE, ft_outline_glyph_init, ft_outline_glyph_done, ft_outline_glyph_copy, ft_outline_glyph_transform, ft_outline_glyph_bbox, ft_outline_glyph_prepare)
	FT_Glyph_Copy (FT_Glyph source, FT_Glyph *target)
	FT_Get_Glyph (FT_GlyphSlot slot, FT_Glyph *aglyph)
	FT_Glyph_Transform (FT_Glyph glyph, FT_Matrix *matrix, FT_Vector *delta)
	FT_Glyph_Get_CBox (FT_Glyph glyph, FT_UInt bbox_mode, FT_BBox *acbox)
	FT_Glyph_To_Bitmap (FT_Glyph *the_glyph, FT_Render_Mode render_mode, FT_Vector *origin, FT_Bool destroy)
	FT_Done_Glyph (FT_Glyph glyph)

Macro Definition Documentation

FT_COMPONENT

#define FT_COMPONENT   trace_glyph

Definition at line 48 of file ftglyph.c.

Function Documentation

ft_bitmap_glyph_bbox()

ft_bitmap_glyph_bbox	(	FT_Glyph	bitmap_glyph,
		FT_BBox *	cbox
	)

Definition at line 122 of file ftglyph.c.

  {
    FT_BitmapGlyph  glyph = (FT_BitmapGlyph)bitmap_glyph;


    cbox->xMin = glyph->left * 64;
    cbox->xMax = cbox->xMin + (FT_Pos)( glyph->bitmap.width * 64 );
    cbox->yMax = glyph->top * 64;
    cbox->yMin = cbox->yMax - (FT_Pos)( glyph->bitmap.rows * 64 );
  }

ft_bitmap_glyph_copy()

ft_bitmap_glyph_copy	(	FT_Glyph	bitmap_source,
		FT_Glyph	bitmap_target
	)

Definition at line 95 of file ftglyph.c.

  {
    FT_Library      library = bitmap_source->library;
    FT_BitmapGlyph  source  = (FT_BitmapGlyph)bitmap_source;
    FT_BitmapGlyph  target  = (FT_BitmapGlyph)bitmap_target;


    target->left = source->left;
    target->top  = source->top;

    return FT_Bitmap_Copy( library, &source->bitmap, &target->bitmap );
  }

ft_bitmap_glyph_done()

ft_bitmap_glyph_done

(

FT_Glyph

bitmap_glyph

)

Definition at line 111 of file ftglyph.c.

  {
    FT_BitmapGlyph  glyph   = (FT_BitmapGlyph)bitmap_glyph;
    FT_Library      library = FT_GLYPH( glyph )->library;


    FT_Bitmap_Done( library, &glyph->bitmap );
  }

ft_bitmap_glyph_init()

ft_bitmap_glyph_init	(	FT_Glyph	bitmap_glyph,
		FT_GlyphSlot	slot
	)

Definition at line 60 of file ftglyph.c.

  {
    FT_BitmapGlyph  glyph   = (FT_BitmapGlyph)bitmap_glyph;
    FT_Error        error   = FT_Err_Ok;
    FT_Library      library = FT_GLYPH( glyph )->library;


    if ( slot->format != FT_GLYPH_FORMAT_BITMAP )
    {
      error = FT_THROW( Invalid_Glyph_Format );
      goto Exit;
    }

    glyph->left = slot->bitmap_left;
    glyph->top  = slot->bitmap_top;

    /* do lazy copying whenever possible */
    if ( slot->internal->flags & FT_GLYPH_OWN_BITMAP )
    {
      glyph->bitmap = slot->bitmap;
      slot->internal->flags &= ~FT_GLYPH_OWN_BITMAP;
    }
    else
    {
      FT_Bitmap_Init( &glyph->bitmap );
      error = FT_Bitmap_Copy( library, &slot->bitmap, &glyph->bitmap );
    }

  Exit:
    return error;
  }

Referenced by FT_Glyph_To_Bitmap().

FT_DEFINE_GLYPH() [1/2]

FT_DEFINE_GLYPH	(	ft_bitmap_glyph_class	,
		sizeof(FT_BitmapGlyphRec)	,
		FT_GLYPH_FORMAT_BITMAP	,
		ft_bitmap_glyph_init	,
		ft_bitmap_glyph_done	,
		ft_bitmap_glyph_copy	,
		NULL	,
		ft_bitmap_glyph_bbox	,
		NULL
	)

Definition at line 135 of file ftglyph.c.

  {
    FT_OutlineGlyph  glyph   = (FT_OutlineGlyph)outline_glyph;
    FT_Error         error   = FT_Err_Ok;
    FT_Library       library = FT_GLYPH( glyph )->library;
    FT_Outline*      source  = &slot->outline;
    FT_Outline*      target  = &glyph->outline;


    /* check format in glyph slot */
    if ( slot->format != FT_GLYPH_FORMAT_OUTLINE )
    {
      error = FT_THROW( Invalid_Glyph_Format );
      goto Exit;
    }

    /* allocate new outline */
    error = FT_Outline_New( library,
                            (FT_UInt)source->n_points,
                            source->n_contours,
                            &glyph->outline );
    if ( error )
      goto Exit;

    FT_Outline_Copy( source, target );

  Exit:
    return error;
  }

FT_DEFINE_GLYPH() [2/2]

FT_DEFINE_GLYPH	(	ft_outline_glyph_class	,
		sizeof(FT_OutlineGlyphRec)	,
		FT_GLYPH_FORMAT_OUTLINE	,
		ft_outline_glyph_init	,
		ft_outline_glyph_done	,
		ft_outline_glyph_copy	,
		ft_outline_glyph_transform	,
		ft_outline_glyph_bbox	,
		ft_outline_glyph_prepare
	)

Definition at line 265 of file ftglyph.c.

   {
     FT_Memory  memory = library->memory;
     FT_Error   error;
     FT_Glyph   glyph  = NULL;


     *aglyph = NULL;

     if ( !FT_ALLOC( glyph, clazz->glyph_size ) )
     {
       glyph->library = library;
       glyph->clazz   = clazz;
       glyph->format  = clazz->glyph_format;

       *aglyph = glyph;
     }

     return error;
   }

FT_Done_Glyph()

FT_Done_Glyph

(

FT_Glyph

glyph

)

Definition at line 633 of file ftglyph.c.

  {
    if ( glyph )
    {
      FT_Memory              memory = glyph->library->memory;
      const FT_Glyph_Class*  clazz  = glyph->clazz;


      if ( clazz->glyph_done )
        clazz->glyph_done( glyph );

      FT_FREE( glyph );
    }
  }

Referenced by FT_Get_Glyph(), FT_Glyph_Copy(), FT_Glyph_Stroke(), FT_Glyph_StrokeBorder(), FT_Glyph_To_Bitmap(), ftc_inode_free(), ftGdiGlyphCacheSet(), ftGdiGlyphSet(), IntExtTextOutW(), RemoveCachedEntry(), and TextIntGetTextExtentPoint().

FT_Get_Glyph()

FT_Get_Glyph	(	FT_GlyphSlot	slot,
		FT_Glyph *	aglyph
	)

Definition at line 363 of file ftglyph.c.

  {
    FT_Library  library;
    FT_Error    error;
    FT_Glyph    glyph;

    const FT_Glyph_Class*  clazz = NULL;


    if ( !slot )
      return FT_THROW( Invalid_Slot_Handle );

    library = slot->library;

    if ( !aglyph )
      return FT_THROW( Invalid_Argument );

    /* if it is a bitmap, that's easy :-) */
    if ( slot->format == FT_GLYPH_FORMAT_BITMAP )
      clazz = FT_BITMAP_GLYPH_CLASS_GET;

    /* if it is an outline */
    else if ( slot->format == FT_GLYPH_FORMAT_OUTLINE )
      clazz = FT_OUTLINE_GLYPH_CLASS_GET;

    else
    {
      /* try to find a renderer that supports the glyph image format */
      FT_Renderer  render = FT_Lookup_Renderer( library, slot->format, 0 );


      if ( render )
        clazz = &render->glyph_class;
    }

    if ( !clazz )
    {
      error = FT_THROW( Invalid_Glyph_Format );
      goto Exit;
    }

    /* create FT_Glyph object */
    error = ft_new_glyph( library, clazz, &glyph );
    if ( error )
      goto Exit;

    /* copy advance while converting 26.6 to 16.16 format */
    if ( slot->advance.x >=  0x8000L * 64 ||
         slot->advance.x <= -0x8000L * 64 )
    {
      FT_ERROR(( "FT_Get_Glyph: advance width too large\n" ));
      error = FT_THROW( Invalid_Argument );
      goto Exit2;
    }
    if ( slot->advance.y >=  0x8000L * 64 ||
         slot->advance.y <= -0x8000L * 64 )
    {
      FT_ERROR(( "FT_Get_Glyph: advance height too large\n" ));
      error = FT_THROW( Invalid_Argument );
      goto Exit2;
    }

    glyph->advance.x = slot->advance.x * 1024;
    glyph->advance.y = slot->advance.y * 1024;

    /* now import the image from the glyph slot */
    error = clazz->glyph_init( glyph, slot );

  Exit2:
    /* if an error occurred, destroy the glyph */
    if ( error )
      FT_Done_Glyph( glyph );
    else
      *aglyph = glyph;

  Exit:
    return error;
  }

Referenced by ftc_basic_family_load_glyph(), ftGdiGlyphCacheSet(), and ftGdiGlyphSet().

FT_Glyph_Copy()

FT_Glyph_Copy	(	FT_Glyph	source,
		FT_Glyph *	target
	)

Definition at line 316 of file ftglyph.c.

  {
    FT_Glyph               copy;
    FT_Error               error;
    const FT_Glyph_Class*  clazz;


    /* check arguments */
    if ( !target || !source || !source->clazz )
    {
      error = FT_THROW( Invalid_Argument );
      goto Exit;
    }

    *target = NULL;

    if ( !source || !source->clazz )
    {
      error = FT_THROW( Invalid_Argument );
      goto Exit;
    }

    clazz = source->clazz;
    error = ft_new_glyph( source->library, clazz, &copy );
    if ( error )
      goto Exit;

    copy->advance = source->advance;
    copy->format  = source->format;

    if ( clazz->glyph_copy )
      error = clazz->glyph_copy( source, copy );

    if ( error )
      FT_Done_Glyph( copy );
    else
      *target = copy;

  Exit:
    return error;
  }

Referenced by FT_Glyph_Stroke(), and FT_Glyph_StrokeBorder().

FT_Glyph_Get_CBox()

FT_Glyph_Get_CBox	(	FT_Glyph	glyph,
		FT_UInt	bbox_mode,
		FT_BBox *	acbox
	)

Definition at line 480 of file ftglyph.c.

  {
    const FT_Glyph_Class*  clazz;


    if ( !acbox )
      return;

    acbox->xMin = acbox->yMin = acbox->xMax = acbox->yMax = 0;

    if ( !glyph || !glyph->clazz )
      return;

    clazz = glyph->clazz;
    if ( !clazz->glyph_bbox )
      return;

    /* retrieve bbox in 26.6 coordinates */
    clazz->glyph_bbox( glyph, acbox );

    /* perform grid fitting if needed */
    if ( bbox_mode == FT_GLYPH_BBOX_GRIDFIT ||
         bbox_mode == FT_GLYPH_BBOX_PIXELS  )
    {
      acbox->xMin = FT_PIX_FLOOR( acbox->xMin );
      acbox->yMin = FT_PIX_FLOOR( acbox->yMin );
      acbox->xMax = FT_PIX_CEIL( acbox->xMax );
      acbox->yMax = FT_PIX_CEIL( acbox->yMax );
    }

    /* convert to integer pixels if needed */
    if ( bbox_mode == FT_GLYPH_BBOX_TRUNCATE ||
         bbox_mode == FT_GLYPH_BBOX_PIXELS   )
    {
      acbox->xMin >>= 6;
      acbox->yMin >>= 6;
      acbox->xMax >>= 6;
      acbox->yMax >>= 6;
    }
  }

FT_Glyph_To_Bitmap()

FT_Glyph_To_Bitmap	(	FT_Glyph *	the_glyph,
		FT_Render_Mode	render_mode,
		FT_Vector *	origin,
		FT_Bool	destroy
	)

Definition at line 527 of file ftglyph.c.

  {
    FT_GlyphSlotRec           dummy;
    FT_GlyphSlot_InternalRec  dummy_internal;
    FT_Error                  error = FT_Err_Ok;
    FT_Glyph                  b, glyph;
    FT_BitmapGlyph            bitmap = NULL;
    const FT_Glyph_Class*     clazz;

    /* FT_BITMAP_GLYPH_CLASS_GET dereferences `library' in PIC mode */
    FT_Library                library;


    /* check argument */
    if ( !the_glyph )
      goto Bad;
    glyph = *the_glyph;
    if ( !glyph )
      goto Bad;

    clazz   = glyph->clazz;
    library = glyph->library;
    if ( !library || !clazz )
      goto Bad;

    /* when called with a bitmap glyph, do nothing and return successfully */
    if ( clazz == FT_BITMAP_GLYPH_CLASS_GET )
      goto Exit;

    if ( !clazz->glyph_prepare )
      goto Bad;

    /* we render the glyph into a glyph bitmap using a `dummy' glyph slot */
    /* then calling FT_Render_Glyph_Internal()                            */

    FT_ZERO( &dummy );
    FT_ZERO( &dummy_internal );
    dummy.internal = &dummy_internal;
    dummy.library  = library;
    dummy.format   = clazz->glyph_format;

    /* create result bitmap glyph */
    error = ft_new_glyph( library, FT_BITMAP_GLYPH_CLASS_GET, &b );
    if ( error )
      goto Exit;
    bitmap = (FT_BitmapGlyph)b;

#if 1
    /* if `origin' is set, translate the glyph image */
    if ( origin )
      FT_Glyph_Transform( glyph, 0, origin );
#else
    FT_UNUSED( origin );
#endif

    /* prepare dummy slot for rendering */
    error = clazz->glyph_prepare( glyph, &dummy );
    if ( !error )
      error = FT_Render_Glyph_Internal( glyph->library, &dummy, render_mode );

#if 1
    if ( !destroy && origin )
    {
      FT_Vector  v;


      v.x = -origin->x;
      v.y = -origin->y;
      FT_Glyph_Transform( glyph, 0, &v );
    }
#endif

    if ( error )
      goto Exit;

    /* in case of success, copy the bitmap to the glyph bitmap */
    error = ft_bitmap_glyph_init( (FT_Glyph)bitmap, &dummy );
    if ( error )
      goto Exit;

    /* copy advance */
    bitmap->root.advance = glyph->advance;

    if ( destroy )
      FT_Done_Glyph( glyph );

    *the_glyph = FT_GLYPH( bitmap );

  Exit:
    if ( error && bitmap )
      FT_Done_Glyph( FT_GLYPH( bitmap ) );

    return error;

  Bad:
    error = FT_THROW( Invalid_Argument );
    goto Exit;
  }

Referenced by ftGdiGlyphCacheSet(), and ftGdiGlyphSet().

FT_Glyph_Transform()

FT_Glyph_Transform	(	FT_Glyph	glyph,
		FT_Matrix *	matrix,
		FT_Vector *	delta
	)

Definition at line 447 of file ftglyph.c.

  {
    FT_Error  error = FT_Err_Ok;


    if ( !glyph || !glyph->clazz )
      error = FT_THROW( Invalid_Argument );
    else
    {
      const FT_Glyph_Class*  clazz = glyph->clazz;


      if ( clazz->glyph_transform )
      {
        /* transform glyph image */
        clazz->glyph_transform( glyph, matrix, delta );

        /* transform advance vector */
        if ( matrix )
          FT_Vector_Transform( &glyph->advance, matrix );
      }
      else
        error = FT_THROW( Invalid_Glyph_Format );
    }
    return error;
  }

Referenced by FT_Glyph_To_Bitmap().

ft_outline_glyph_bbox()

ft_outline_glyph_bbox	(	FT_Glyph	outline_glyph,
		FT_BBox *	bbox
	)

Definition at line 240 of file ftglyph.c.

  {
    FT_OutlineGlyph  glyph = (FT_OutlineGlyph)outline_glyph;


    FT_Outline_Get_CBox( &glyph->outline, bbox );
  }

ft_outline_glyph_copy()

ft_outline_glyph_copy	(	FT_Glyph	outline_source,
		FT_Glyph	outline_target
	)

Definition at line 203 of file ftglyph.c.

  {
    FT_OutlineGlyph  source  = (FT_OutlineGlyph)outline_source;
    FT_OutlineGlyph  target  = (FT_OutlineGlyph)outline_target;
    FT_Error         error;
    FT_Library       library = FT_GLYPH( source )->library;


    error = FT_Outline_New( library,
                            (FT_UInt)source->outline.n_points,
                            source->outline.n_contours,
                            &target->outline );
    if ( !error )
      FT_Outline_Copy( &source->outline, &target->outline );

    return error;
  }

ft_outline_glyph_done()

ft_outline_glyph_done

(

FT_Glyph

outline_glyph

)

Definition at line 193 of file ftglyph.c.

  {
    FT_OutlineGlyph  glyph = (FT_OutlineGlyph)outline_glyph;


    FT_Outline_Done( FT_GLYPH( glyph )->library, &glyph->outline );
  }

ft_outline_glyph_prepare()

ft_outline_glyph_prepare	(	FT_Glyph	outline_glyph,
		FT_GlyphSlot	slot
	)

Definition at line 251 of file ftglyph.c.

  {
    FT_OutlineGlyph  glyph = (FT_OutlineGlyph)outline_glyph;


    slot->format         = FT_GLYPH_FORMAT_OUTLINE;
    slot->outline        = glyph->outline;
    slot->outline.flags &= ~FT_OUTLINE_OWNER;

    return FT_Err_Ok;
  }

ft_outline_glyph_transform()

ft_outline_glyph_transform	(	FT_Glyph	outline_glyph,
		const FT_Matrix *	matrix,
		const FT_Vector *	delta
	)

Definition at line 224 of file ftglyph.c.

  {
    FT_OutlineGlyph  glyph = (FT_OutlineGlyph)outline_glyph;


    if ( matrix )
      FT_Outline_Transform( &glyph->outline, matrix );

    if ( delta )
      FT_Outline_Translate( &glyph->outline, delta->x, delta->y );
  }