ftstroke.h File Reference

#include <freetype/ftoutln.h>
#include <freetype/ftglyph.h>

Include dependency graph for ftstroke.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Typedefs
typedef typedefFT_BEGIN_HEADER struct FT_StrokerRec_ *	FT_Stroker
typedef enum FT_Stroker_LineJoin_	FT_Stroker_LineJoin
typedef enum FT_Stroker_LineCap_	FT_Stroker_LineCap
typedef enum FT_StrokerBorder_	FT_StrokerBorder

Enumerations
enum	FT_Stroker_LineJoin_ {   FT_STROKER_LINEJOIN_ROUND = 0 , FT_STROKER_LINEJOIN_BEVEL = 1 , FT_STROKER_LINEJOIN_MITER_VARIABLE = 2 , FT_STROKER_LINEJOIN_MITER = FT_STROKER_LINEJOIN_MITER_VARIABLE ,   FT_STROKER_LINEJOIN_MITER_FIXED = 3 }
enum	FT_Stroker_LineCap_ { FT_STROKER_LINECAP_BUTT = 0 , FT_STROKER_LINECAP_ROUND , FT_STROKER_LINECAP_SQUARE }
enum	FT_StrokerBorder_ { FT_STROKER_BORDER_LEFT = 0 , FT_STROKER_BORDER_RIGHT }

Functions
	FT_Outline_GetInsideBorder (FT_Outline *outline)
	FT_Outline_GetOutsideBorder (FT_Outline *outline)
	FT_Stroker_New (FT_Library library, FT_Stroker *astroker)
	FT_Stroker_Set (FT_Stroker stroker, FT_Fixed radius, FT_Stroker_LineCap line_cap, FT_Stroker_LineJoin line_join, FT_Fixed miter_limit)
	FT_Stroker_Rewind (FT_Stroker stroker)
	FT_Stroker_ParseOutline (FT_Stroker stroker, FT_Outline *outline, FT_Bool opened)
	FT_Stroker_BeginSubPath (FT_Stroker stroker, FT_Vector *to, FT_Bool open)
	FT_Stroker_EndSubPath (FT_Stroker stroker)
	FT_Stroker_LineTo (FT_Stroker stroker, FT_Vector *to)
	FT_Stroker_ConicTo (FT_Stroker stroker, FT_Vector *control, FT_Vector *to)
	FT_Stroker_CubicTo (FT_Stroker stroker, FT_Vector *control1, FT_Vector *control2, FT_Vector *to)
	FT_Stroker_GetBorderCounts (FT_Stroker stroker, FT_StrokerBorder border, FT_UInt *anum_points, FT_UInt *anum_contours)
	FT_Stroker_ExportBorder (FT_Stroker stroker, FT_StrokerBorder border, FT_Outline *outline)
	FT_Stroker_GetCounts (FT_Stroker stroker, FT_UInt *anum_points, FT_UInt *anum_contours)
	FT_Stroker_Export (FT_Stroker stroker, FT_Outline *outline)
	FT_Stroker_Done (FT_Stroker stroker)
	FT_Glyph_Stroke (FT_Glyph *pglyph, FT_Stroker stroker, FT_Bool destroy)
	FT_Glyph_StrokeBorder (FT_Glyph *pglyph, FT_Stroker stroker, FT_Bool inside, FT_Bool destroy)

Typedef Documentation

FT_Stroker

typedef typedefFT_BEGIN_HEADER struct FT_StrokerRec_* FT_Stroker

Definition at line 91 of file ftstroke.h.

FT_Stroker_LineCap

typedef enum FT_Stroker_LineCap_ FT_Stroker_LineCap

FT_Stroker_LineJoin

typedef enum FT_Stroker_LineJoin_ FT_Stroker_LineJoin

FT_StrokerBorder

typedef enum FT_StrokerBorder_ FT_StrokerBorder

Enumeration Type Documentation

FT_Stroker_LineCap_

enum FT_Stroker_LineCap_

Enumerator
FT_STROKER_LINECAP_BUTT
FT_STROKER_LINECAP_ROUND
FT_STROKER_LINECAP_SQUARE

Definition at line 165 of file ftstroke.h.

  {
    FT_STROKER_LINECAP_BUTT = 0,
    FT_STROKER_LINECAP_ROUND,
    FT_STROKER_LINECAP_SQUARE
 
  } FT_Stroker_LineCap;

FT_Stroker_LineJoin_

enum FT_Stroker_LineJoin_

Enumerator
FT_STROKER_LINEJOIN_ROUND
FT_STROKER_LINEJOIN_BEVEL
FT_STROKER_LINEJOIN_MITER_VARIABLE
FT_STROKER_LINEJOIN_MITER
FT_STROKER_LINEJOIN_MITER_FIXED

Definition at line 134 of file ftstroke.h.

  {
    FT_STROKER_LINEJOIN_ROUND          = 0,
    FT_STROKER_LINEJOIN_BEVEL          = 1,
    FT_STROKER_LINEJOIN_MITER_VARIABLE = 2,
    FT_STROKER_LINEJOIN_MITER          = FT_STROKER_LINEJOIN_MITER_VARIABLE,
    FT_STROKER_LINEJOIN_MITER_FIXED    = 3
 
  } FT_Stroker_LineJoin;

FT_StrokerBorder_

enum FT_StrokerBorder_

Enumerator
FT_STROKER_BORDER_LEFT
FT_STROKER_BORDER_RIGHT

Definition at line 199 of file ftstroke.h.

  {
    FT_STROKER_BORDER_LEFT = 0,
    FT_STROKER_BORDER_RIGHT
 
  } FT_StrokerBorder;

Function Documentation

FT_Glyph_Stroke()

FT_Glyph_Stroke	(	FT_Glyph *	pglyph,
		FT_Stroker	stroker,
		FT_Bool	destroy
	)

Definition at line 2270 of file ftstroke.c.

  {
    FT_Error  error = FT_ERR( Invalid_Argument );
    FT_Glyph  glyph = NULL;
 
 
    if ( !pglyph )
      goto Exit;
 
    glyph = *pglyph;
    if ( !glyph || glyph->clazz != &ft_outline_glyph_class )
      goto Exit;
 
    {
      FT_Glyph  copy;
 
 
      error = FT_Glyph_Copy( glyph, &copy );
      if ( error )
        goto Exit;
 
      glyph = copy;
    }
 
    {
      FT_OutlineGlyph  oglyph  = (FT_OutlineGlyph)glyph;
      FT_Outline*      outline = &oglyph->outline;
      FT_UInt          num_points, num_contours;
 
 
      error = FT_Stroker_ParseOutline( stroker, outline, FALSE );
      if ( error )
        goto Fail;
 
      FT_Stroker_GetCounts( stroker, &num_points, &num_contours );
 
      FT_Outline_Done( glyph->library, outline );
 
      error = FT_Outline_New( glyph->library,
                              num_points,
                              (FT_Int)num_contours,
                              outline );
      if ( error )
        goto Fail;
 
      outline->n_points   = 0;
      outline->n_contours = 0;
 
      FT_Stroker_Export( stroker, outline );
    }
 
    if ( destroy )
      FT_Done_Glyph( *pglyph );
 
    *pglyph = glyph;
    goto Exit;
 
  Fail:
    FT_Done_Glyph( glyph );
    glyph = NULL;
 
    if ( !destroy )
      *pglyph = NULL;
 
  Exit:
    return error;
  }

FT_Glyph_StrokeBorder()

FT_Glyph_StrokeBorder	(	FT_Glyph *	pglyph,
		FT_Stroker	stroker,
		FT_Bool	inside,
		FT_Bool	destroy
	)

Definition at line 2344 of file ftstroke.c.

  {
    FT_Error  error = FT_ERR( Invalid_Argument );
    FT_Glyph  glyph = NULL;
 
 
    if ( !pglyph )
      goto Exit;
 
    glyph = *pglyph;
    if ( !glyph || glyph->clazz != &ft_outline_glyph_class )
      goto Exit;
 
    {
      FT_Glyph  copy;
 
 
      error = FT_Glyph_Copy( glyph, &copy );
      if ( error )
        goto Exit;
 
      glyph = copy;
    }
 
    {
      FT_OutlineGlyph   oglyph  = (FT_OutlineGlyph)glyph;
      FT_StrokerBorder  border;
      FT_Outline*       outline = &oglyph->outline;
      FT_UInt           num_points, num_contours;
 
 
      border = FT_Outline_GetOutsideBorder( outline );
      if ( inside )
      {
        if ( border == FT_STROKER_BORDER_LEFT )
          border = FT_STROKER_BORDER_RIGHT;
        else
          border = FT_STROKER_BORDER_LEFT;
      }
 
      error = FT_Stroker_ParseOutline( stroker, outline, FALSE );
      if ( error )
        goto Fail;
 
      FT_Stroker_GetBorderCounts( stroker, border,
                                  &num_points, &num_contours );
 
      FT_Outline_Done( glyph->library, outline );
 
      error = FT_Outline_New( glyph->library,
                              num_points,
                              (FT_Int)num_contours,
                              outline );
      if ( error )
        goto Fail;
 
      outline->n_points   = 0;
      outline->n_contours = 0;
 
      FT_Stroker_ExportBorder( stroker, border, outline );
    }
 
    if ( destroy )
      FT_Done_Glyph( *pglyph );
 
    *pglyph = glyph;
    goto Exit;
 
  Fail:
    FT_Done_Glyph( glyph );
    glyph = NULL;
 
    if ( !destroy )
      *pglyph = NULL;
 
  Exit:
    return error;
  }

FT_Outline_GetInsideBorder()

FT_Outline_GetInsideBorder

(

FT_Outline *

outline

)

Definition at line 35 of file ftstroke.c.

  {
    FT_Orientation  o = FT_Outline_Get_Orientation( outline );
 
 
    return o == FT_ORIENTATION_TRUETYPE ? FT_STROKER_BORDER_RIGHT
                                        : FT_STROKER_BORDER_LEFT;
  }

FT_Outline_GetOutsideBorder()

FT_Outline_GetOutsideBorder

(

FT_Outline *

outline

)

Definition at line 48 of file ftstroke.c.

  {
    FT_Orientation  o = FT_Outline_Get_Orientation( outline );
 
 
    return o == FT_ORIENTATION_TRUETYPE ? FT_STROKER_BORDER_LEFT
                                        : FT_STROKER_BORDER_RIGHT;
  }

Referenced by FT_Glyph_StrokeBorder().

FT_Stroker_BeginSubPath()

FT_Stroker_BeginSubPath	(	FT_Stroker	stroker,
		FT_Vector *	to,
		FT_Bool	open
	)

Definition at line 1757 of file ftstroke.c.

  {
    if ( !stroker || !to )
      return FT_THROW( Invalid_Argument );
 
    /* We cannot process the first point, because there is not enough      */
    /* information regarding its corner/cap.  The latter will be processed */
    /* in the `FT_Stroker_EndSubPath' routine.                             */
    /*                                                                     */
    stroker->first_point  = TRUE;
    stroker->center       = *to;
    stroker->subpath_open = open;
 
    /* Determine if we need to check whether the border radius is greater */
    /* than the radius of curvature of a curve, to handle this case       */
    /* specially.  This is only required if bevel joins or butt caps may  */
    /* be created, because round & miter joins and round & square caps    */
    /* cover the negative sector created with wide strokes.               */
    stroker->handle_wide_strokes =
      FT_BOOL( stroker->line_join != FT_STROKER_LINEJOIN_ROUND  ||
               ( stroker->subpath_open                        &&
                 stroker->line_cap == FT_STROKER_LINECAP_BUTT ) );
 
    /* record the subpath start point for each border */
    stroker->subpath_start = *to;
 
    stroker->angle_in = 0;
 
    return FT_Err_Ok;
  }

Referenced by FT_Stroker_ParseOutline().

FT_Stroker_ConicTo()

FT_Stroker_ConicTo	(	FT_Stroker	stroker,
		FT_Vector *	control,
		FT_Vector *	to
	)

Definition at line 1340 of file ftstroke.c.

  {
    FT_Error    error = FT_Err_Ok;
    FT_Vector   bez_stack[34];
    FT_Vector*  arc;
    FT_Vector*  limit = bez_stack + 30;
    FT_Bool     first_arc = TRUE;
 
 
    if ( !stroker || !control || !to )
    {
      error = FT_THROW( Invalid_Argument );
      goto Exit;
    }
 
    /* if all control points are coincident, this is a no-op; */
    /* avoid creating a spurious corner                       */
    if ( FT_IS_SMALL( stroker->center.x - control->x ) &&
         FT_IS_SMALL( stroker->center.y - control->y ) &&
         FT_IS_SMALL( control->x        - to->x      ) &&
         FT_IS_SMALL( control->y        - to->y      ) )
    {
       stroker->center = *to;
       goto Exit;
    }
 
    arc    = bez_stack;
    arc[0] = *to;
    arc[1] = *control;
    arc[2] = stroker->center;
 
    while ( arc >= bez_stack )
    {
      FT_Angle  angle_in, angle_out;
 
 
      /* initialize with current direction */
      angle_in = angle_out = stroker->angle_in;
 
      if ( arc < limit                                             &&
           !ft_conic_is_small_enough( arc, &angle_in, &angle_out ) )
      {
        if ( stroker->first_point )
          stroker->angle_in = angle_in;
 
        ft_conic_split( arc );
        arc += 2;
        continue;
      }
 
      if ( first_arc )
      {
        first_arc = FALSE;
 
        /* process corner if necessary */
        if ( stroker->first_point )
          error = ft_stroker_subpath_start( stroker, angle_in, 0 );
        else
        {
          stroker->angle_out = angle_in;
          error = ft_stroker_process_corner( stroker, 0 );
        }
      }
      else if ( ft_pos_abs( FT_Angle_Diff( stroker->angle_in, angle_in ) ) >
                  FT_SMALL_CONIC_THRESHOLD / 4                             )
      {
        /* if the deviation from one arc to the next is too great, */
        /* add a round corner                                      */
        stroker->center    = arc[2];
        stroker->angle_out = angle_in;
        stroker->line_join = FT_STROKER_LINEJOIN_ROUND;
 
        error = ft_stroker_process_corner( stroker, 0 );
 
        /* reinstate line join style */
        stroker->line_join = stroker->line_join_saved;
      }
 
      if ( error )
        goto Exit;
 
      /* the arc's angle is small enough; we can add it directly to each */
      /* border                                                          */
      {
        FT_Vector        ctrl, end;
        FT_Angle         theta, phi, rotate, alpha0 = 0;
        FT_Fixed         length;
        FT_StrokeBorder  border;
        FT_Int           side;
 
 
        theta  = FT_Angle_Diff( angle_in, angle_out ) / 2;
        phi    = angle_in + theta;
        length = FT_DivFix( stroker->radius, FT_Cos( theta ) );
 
        /* compute direction of original arc */
        if ( stroker->handle_wide_strokes )
          alpha0 = FT_Atan2( arc[0].x - arc[2].x, arc[0].y - arc[2].y );
 
        for ( border = stroker->borders, side = 0;
              side <= 1;
              side++, border++ )
        {
          rotate = FT_SIDE_TO_ROTATE( side );
 
          /* compute control point */
          FT_Vector_From_Polar( &ctrl, length, phi + rotate );
          ctrl.x += arc[1].x;
          ctrl.y += arc[1].y;
 
          /* compute end point */
          FT_Vector_From_Polar( &end, stroker->radius, angle_out + rotate );
          end.x += arc[0].x;
          end.y += arc[0].y;
 
          if ( stroker->handle_wide_strokes )
          {
            FT_Vector  start;
            FT_Angle   alpha1;
 
 
            /* determine whether the border radius is greater than the */
            /* radius of curvature of the original arc                 */
            start = border->points[border->num_points - 1];
 
            alpha1 = FT_Atan2( end.x - start.x, end.y - start.y );
 
            /* is the direction of the border arc opposite to */
            /* that of the original arc? */
            if ( ft_pos_abs( FT_Angle_Diff( alpha0, alpha1 ) ) >
                   FT_ANGLE_PI / 2                             )
            {
              FT_Angle   beta, gamma;
              FT_Vector  bvec, delta;
              FT_Fixed   blen, sinA, sinB, alen;
 
 
              /* use the sine rule to find the intersection point */
              beta  = FT_Atan2( arc[2].x - start.x, arc[2].y - start.y );
              gamma = FT_Atan2( arc[0].x - end.x,   arc[0].y - end.y );
 
              bvec.x = end.x - start.x;
              bvec.y = end.y - start.y;
 
              blen = FT_Vector_Length( &bvec );
 
              sinA = ft_pos_abs( FT_Sin( alpha1 - gamma ) );
              sinB = ft_pos_abs( FT_Sin( beta - gamma ) );
 
              alen = FT_MulDiv( blen, sinA, sinB );
 
              FT_Vector_From_Polar( &delta, alen, beta );
              delta.x += start.x;
              delta.y += start.y;
 
              /* circumnavigate the negative sector backwards */
              border->movable = FALSE;
              error = ft_stroke_border_lineto( border, &delta, FALSE );
              if ( error )
                goto Exit;
              error = ft_stroke_border_lineto( border, &end, FALSE );
              if ( error )
                goto Exit;
              error = ft_stroke_border_conicto( border, &ctrl, &start );
              if ( error )
                goto Exit;
              /* and then move to the endpoint */
              error = ft_stroke_border_lineto( border, &end, FALSE );
              if ( error )
                goto Exit;
 
              continue;
            }
 
            /* else fall through */
          }
 
          /* simply add an arc */
          error = ft_stroke_border_conicto( border, &ctrl, &end );
          if ( error )
            goto Exit;
        }
      }
 
      arc -= 2;
 
      stroker->angle_in = angle_out;
    }
 
    stroker->center = *to;
 
  Exit:
    return error;
  }

Referenced by FT_Stroker_ParseOutline().

FT_Stroker_CubicTo()

FT_Stroker_CubicTo	(	FT_Stroker	stroker,
		FT_Vector *	control1,
		FT_Vector *	control2,
		FT_Vector *	to
	)

Definition at line 1541 of file ftstroke.c.

  {
    FT_Error    error = FT_Err_Ok;
    FT_Vector   bez_stack[37];
    FT_Vector*  arc;
    FT_Vector*  limit = bez_stack + 32;
    FT_Bool     first_arc = TRUE;
 
 
    if ( !stroker || !control1 || !control2 || !to )
    {
      error = FT_THROW( Invalid_Argument );
      goto Exit;
    }
 
    /* if all control points are coincident, this is a no-op; */
    /* avoid creating a spurious corner */
    if ( FT_IS_SMALL( stroker->center.x - control1->x ) &&
         FT_IS_SMALL( stroker->center.y - control1->y ) &&
         FT_IS_SMALL( control1->x       - control2->x ) &&
         FT_IS_SMALL( control1->y       - control2->y ) &&
         FT_IS_SMALL( control2->x       - to->x       ) &&
         FT_IS_SMALL( control2->y       - to->y       ) )
    {
       stroker->center = *to;
       goto Exit;
    }
 
    arc    = bez_stack;
    arc[0] = *to;
    arc[1] = *control2;
    arc[2] = *control1;
    arc[3] = stroker->center;
 
    while ( arc >= bez_stack )
    {
      FT_Angle  angle_in, angle_mid, angle_out;
 
 
      /* initialize with current direction */
      angle_in = angle_out = angle_mid = stroker->angle_in;
 
      if ( arc < limit                                         &&
           !ft_cubic_is_small_enough( arc, &angle_in,
                                      &angle_mid, &angle_out ) )
      {
        if ( stroker->first_point )
          stroker->angle_in = angle_in;
 
        ft_cubic_split( arc );
        arc += 3;
        continue;
      }
 
      if ( first_arc )
      {
        first_arc = FALSE;
 
        /* process corner if necessary */
        if ( stroker->first_point )
          error = ft_stroker_subpath_start( stroker, angle_in, 0 );
        else
        {
          stroker->angle_out = angle_in;
          error = ft_stroker_process_corner( stroker, 0 );
        }
      }
      else if ( ft_pos_abs( FT_Angle_Diff( stroker->angle_in, angle_in ) ) >
                  FT_SMALL_CUBIC_THRESHOLD / 4                             )
      {
        /* if the deviation from one arc to the next is too great, */
        /* add a round corner                                      */
        stroker->center    = arc[3];
        stroker->angle_out = angle_in;
        stroker->line_join = FT_STROKER_LINEJOIN_ROUND;
 
        error = ft_stroker_process_corner( stroker, 0 );
 
        /* reinstate line join style */
        stroker->line_join = stroker->line_join_saved;
      }
 
      if ( error )
        goto Exit;
 
      /* the arc's angle is small enough; we can add it directly to each */
      /* border                                                          */
      {
        FT_Vector        ctrl1, ctrl2, end;
        FT_Angle         theta1, phi1, theta2, phi2, rotate, alpha0 = 0;
        FT_Fixed         length1, length2;
        FT_StrokeBorder  border;
        FT_Int           side;
 
 
        theta1  = FT_Angle_Diff( angle_in,  angle_mid ) / 2;
        theta2  = FT_Angle_Diff( angle_mid, angle_out ) / 2;
        phi1    = ft_angle_mean( angle_in,  angle_mid );
        phi2    = ft_angle_mean( angle_mid, angle_out );
        length1 = FT_DivFix( stroker->radius, FT_Cos( theta1 ) );
        length2 = FT_DivFix( stroker->radius, FT_Cos( theta2 ) );
 
        /* compute direction of original arc */
        if ( stroker->handle_wide_strokes )
          alpha0 = FT_Atan2( arc[0].x - arc[3].x, arc[0].y - arc[3].y );
 
        for ( border = stroker->borders, side = 0;
              side <= 1;
              side++, border++ )
        {
          rotate = FT_SIDE_TO_ROTATE( side );
 
          /* compute control points */
          FT_Vector_From_Polar( &ctrl1, length1, phi1 + rotate );
          ctrl1.x += arc[2].x;
          ctrl1.y += arc[2].y;
 
          FT_Vector_From_Polar( &ctrl2, length2, phi2 + rotate );
          ctrl2.x += arc[1].x;
          ctrl2.y += arc[1].y;
 
          /* compute end point */
          FT_Vector_From_Polar( &end, stroker->radius, angle_out + rotate );
          end.x += arc[0].x;
          end.y += arc[0].y;
 
          if ( stroker->handle_wide_strokes )
          {
            FT_Vector  start;
            FT_Angle   alpha1;
 
 
            /* determine whether the border radius is greater than the */
            /* radius of curvature of the original arc                 */
            start = border->points[border->num_points - 1];
 
            alpha1 = FT_Atan2( end.x - start.x, end.y - start.y );
 
            /* is the direction of the border arc opposite to */
            /* that of the original arc? */
            if ( ft_pos_abs( FT_Angle_Diff( alpha0, alpha1 ) ) >
                   FT_ANGLE_PI / 2                             )
            {
              FT_Angle   beta, gamma;
              FT_Vector  bvec, delta;
              FT_Fixed   blen, sinA, sinB, alen;
 
 
              /* use the sine rule to find the intersection point */
              beta  = FT_Atan2( arc[3].x - start.x, arc[3].y - start.y );
              gamma = FT_Atan2( arc[0].x - end.x,   arc[0].y - end.y );
 
              bvec.x = end.x - start.x;
              bvec.y = end.y - start.y;
 
              blen = FT_Vector_Length( &bvec );
 
              sinA = ft_pos_abs( FT_Sin( alpha1 - gamma ) );
              sinB = ft_pos_abs( FT_Sin( beta - gamma ) );
 
              alen = FT_MulDiv( blen, sinA, sinB );
 
              FT_Vector_From_Polar( &delta, alen, beta );
              delta.x += start.x;
              delta.y += start.y;
 
              /* circumnavigate the negative sector backwards */
              border->movable = FALSE;
              error = ft_stroke_border_lineto( border, &delta, FALSE );
              if ( error )
                goto Exit;
              error = ft_stroke_border_lineto( border, &end, FALSE );
              if ( error )
                goto Exit;
              error = ft_stroke_border_cubicto( border,
                                                &ctrl2,
                                                &ctrl1,
                                                &start );
              if ( error )
                goto Exit;
              /* and then move to the endpoint */
              error = ft_stroke_border_lineto( border, &end, FALSE );
              if ( error )
                goto Exit;
 
              continue;
            }
 
            /* else fall through */
          }
 
          /* simply add an arc */
          error = ft_stroke_border_cubicto( border, &ctrl1, &ctrl2, &end );
          if ( error )
            goto Exit;
        }
      }
 
      arc -= 3;
 
      stroker->angle_in = angle_out;
    }
 
    stroker->center = *to;
 
  Exit:
    return error;
  }

Referenced by FT_Stroker_ParseOutline().

FT_Stroker_Done()

FT_Stroker_Done

(

FT_Stroker

stroker

)

Definition at line 865 of file ftstroke.c.

  {
    if ( stroker )
    {
      FT_Memory  memory = stroker->library->memory;
 
 
      ft_stroke_border_done( &stroker->borders[0] );
      ft_stroke_border_done( &stroker->borders[1] );
 
      stroker->library = NULL;
      FT_FREE( stroker );
    }
  }

FT_Stroker_EndSubPath()

FT_Stroker_EndSubPath

(

FT_Stroker

stroker

)

Definition at line 1859 of file ftstroke.c.

  {
    FT_Error  error = FT_Err_Ok;
 
 
    if ( !stroker )
    {
      error = FT_THROW( Invalid_Argument );
      goto Exit;
    }
 
    if ( stroker->subpath_open )
    {
      FT_StrokeBorder  right = stroker->borders;
 
 
      /* All right, this is an opened path, we need to add a cap between */
      /* right & left, add the reverse of left, then add a final cap     */
      /* between left & right.                                           */
      error = ft_stroker_cap( stroker, stroker->angle_in, 0 );
      if ( error )
        goto Exit;
 
      /* add reversed points from `left' to `right' */
      error = ft_stroker_add_reverse_left( stroker, TRUE );
      if ( error )
        goto Exit;
 
      /* now add the final cap */
      stroker->center = stroker->subpath_start;
      error = ft_stroker_cap( stroker,
                              stroker->subpath_angle + FT_ANGLE_PI, 0 );
      if ( error )
        goto Exit;
 
      /* Now end the right subpath accordingly.  The left one is */
      /* rewind and doesn't need further processing.             */
      ft_stroke_border_close( right, FALSE );
    }
    else
    {
      FT_Angle  turn;
      FT_Int    inside_side;
 
 
      /* close the path if needed */
      if ( stroker->center.x != stroker->subpath_start.x ||
           stroker->center.y != stroker->subpath_start.y )
      {
         error = FT_Stroker_LineTo( stroker, &stroker->subpath_start );
         if ( error )
           goto Exit;
      }
 
      /* process the corner */
      stroker->angle_out = stroker->subpath_angle;
      turn               = FT_Angle_Diff( stroker->angle_in,
                                          stroker->angle_out );
 
      /* no specific corner processing is required if the turn is 0 */
      if ( turn != 0 )
      {
        /* when we turn to the right, the inside side is 0 */
        /* otherwise, the inside side is 1 */
        inside_side = ( turn < 0 );
 
        error = ft_stroker_inside( stroker,
                                   inside_side,
                                   stroker->subpath_line_length );
        if ( error )
          goto Exit;
 
        /* process the outside side */
        error = ft_stroker_outside( stroker,
                                    !inside_side,
                                    stroker->subpath_line_length );
        if ( error )
          goto Exit;
      }
 
      /* then end our two subpaths */
      ft_stroke_border_close( stroker->borders + 0, FALSE );
      ft_stroke_border_close( stroker->borders + 1, TRUE );
    }
 
  Exit:
    return error;
  }

Referenced by FT_Stroker_ParseOutline().

FT_Stroker_Export()

FT_Stroker_Export	(	FT_Stroker	stroker,
		FT_Outline *	outline
	)

Definition at line 2047 of file ftstroke.c.

  {
    FT_Stroker_ExportBorder( stroker, FT_STROKER_BORDER_LEFT, outline );
    FT_Stroker_ExportBorder( stroker, FT_STROKER_BORDER_RIGHT, outline );
  }

Referenced by FT_Glyph_Stroke().

FT_Stroker_ExportBorder()

FT_Stroker_ExportBorder	(	FT_Stroker	stroker,
		FT_StrokerBorder	border,
		FT_Outline *	outline
	)

Definition at line 2025 of file ftstroke.c.

  {
    if ( !stroker || !outline )
      return;
 
    if ( border == FT_STROKER_BORDER_LEFT  ||
         border == FT_STROKER_BORDER_RIGHT )
    {
      FT_StrokeBorder  sborder = & stroker->borders[border];
 
 
      if ( sborder->valid )
        ft_stroke_border_export( sborder, outline );
    }
  }

Referenced by FT_Glyph_StrokeBorder(), and FT_Stroker_Export().

FT_Stroker_GetBorderCounts()

FT_Stroker_GetBorderCounts	(	FT_Stroker	stroker,
		FT_StrokerBorder	border,
		FT_UInt *	anum_points,
		FT_UInt *	anum_contours
	)

Definition at line 1952 of file ftstroke.c.

  {
    FT_UInt   num_points = 0, num_contours = 0;
    FT_Error  error;
 
 
    if ( !stroker || border > 1 )
    {
      error = FT_THROW( Invalid_Argument );
      goto Exit;
    }
 
    error = ft_stroke_border_get_counts( stroker->borders + border,
                                         &num_points, &num_contours );
  Exit:
    if ( anum_points )
      *anum_points = num_points;
 
    if ( anum_contours )
      *anum_contours = num_contours;
 
    return error;
  }

Referenced by FT_Glyph_StrokeBorder().

FT_Stroker_GetCounts()

FT_Stroker_GetCounts	(	FT_Stroker	stroker,
		FT_UInt *	anum_points,
		FT_UInt *	anum_contours
	)

Definition at line 1983 of file ftstroke.c.

  {
    FT_UInt   count1, count2, num_points   = 0;
    FT_UInt   count3, count4, num_contours = 0;
    FT_Error  error;
 
 
    if ( !stroker )
    {
      error = FT_THROW( Invalid_Argument );
      goto Exit;
    }
 
    error = ft_stroke_border_get_counts( stroker->borders + 0,
                                         &count1, &count2 );
    if ( error )
      goto Exit;
 
    error = ft_stroke_border_get_counts( stroker->borders + 1,
                                         &count3, &count4 );
    if ( error )
      goto Exit;
 
    num_points   = count1 + count3;
    num_contours = count2 + count4;
 
  Exit:
    if ( anum_points )
      *anum_points   = num_points;
 
    if ( anum_contours )
      *anum_contours = num_contours;
 
    return error;
  }

Referenced by FT_Glyph_Stroke().

FT_Stroker_LineTo()

FT_Stroker_LineTo	(	FT_Stroker	stroker,
		FT_Vector *	to
	)

Definition at line 1264 of file ftstroke.c.

  {
    FT_Error         error = FT_Err_Ok;
    FT_StrokeBorder  border;
    FT_Vector        delta;
    FT_Angle         angle;
    FT_Int           side;
    FT_Fixed         line_length;
 
 
    if ( !stroker || !to )
      return FT_THROW( Invalid_Argument );
 
    delta.x = to->x - stroker->center.x;
    delta.y = to->y - stroker->center.y;
 
    /* a zero-length lineto is a no-op; avoid creating a spurious corner */
    if ( delta.x == 0 && delta.y == 0 )
       goto Exit;
 
    /* compute length of line */
    line_length = FT_Vector_Length( &delta );
 
    angle = FT_Atan2( delta.x, delta.y );
    FT_Vector_From_Polar( &delta, stroker->radius, angle + FT_ANGLE_PI2 );
 
    /* process corner if necessary */
    if ( stroker->first_point )
    {
      /* This is the first segment of a subpath.  We need to     */
      /* add a point to each border at their respective starting */
      /* point locations.                                        */
      error = ft_stroker_subpath_start( stroker, angle, line_length );
      if ( error )
        goto Exit;
    }
    else
    {
      /* process the current corner */
      stroker->angle_out = angle;
      error = ft_stroker_process_corner( stroker, line_length );
      if ( error )
        goto Exit;
    }
 
    /* now add a line segment to both the `inside' and `outside' paths */
    for ( border = stroker->borders, side = 1; side >= 0; side--, border++ )
    {
      FT_Vector  point;
 
 
      point.x = to->x + delta.x;
      point.y = to->y + delta.y;
 
      /* the ends of lineto borders are movable */
      error = ft_stroke_border_lineto( border, &point, TRUE );
      if ( error )
        goto Exit;
 
      delta.x = -delta.x;
      delta.y = -delta.y;
    }
 
    stroker->angle_in    = angle;
    stroker->center      = *to;
    stroker->line_length = line_length;
 
  Exit:
    return error;
  }

Referenced by FT_Stroker_EndSubPath(), and FT_Stroker_ParseOutline().

FT_Stroker_New()

FT_Stroker_New	(	FT_Library	library,
		FT_Stroker *	astroker
	)

Definition at line 790 of file ftstroke.c.

  {
    FT_Error    error;           /* assigned in FT_NEW */
    FT_Memory   memory;
    FT_Stroker  stroker = NULL;
 
 
    if ( !library )
      return FT_THROW( Invalid_Library_Handle );
 
    if ( !astroker )
      return FT_THROW( Invalid_Argument );
 
    memory = library->memory;
 
    if ( !FT_NEW( stroker ) )
    {
      stroker->library = library;
 
      ft_stroke_border_init( &stroker->borders[0], memory );
      ft_stroke_border_init( &stroker->borders[1], memory );
    }
 
    *astroker = stroker;
 
    return error;
  }

FT_Stroker_ParseOutline()

FT_Stroker_ParseOutline	(	FT_Stroker	stroker,
		FT_Outline *	outline,
		FT_Bool	opened
	)

Definition at line 2062 of file ftstroke.c.

  {
    FT_Vector   v_last;
    FT_Vector   v_control;
    FT_Vector   v_start;
 
    FT_Vector*  point;
    FT_Vector*  limit;
    char*       tags;
 
    FT_Error    error;
 
    FT_Int      n;         /* index of contour in outline     */
    FT_UInt     first;     /* index of first point in contour */
    FT_Int      tag;       /* current point's state           */
 
 
    if ( !outline )
      return FT_THROW( Invalid_Outline );
 
    if ( !stroker )
      return FT_THROW( Invalid_Argument );
 
    FT_Stroker_Rewind( stroker );
 
    first = 0;
 
    for ( n = 0; n < outline->n_contours; n++ )
    {
      FT_UInt  last;  /* index of last point in contour */
 
 
      last  = (FT_UInt)outline->contours[n];
      limit = outline->points + last;
 
      /* skip empty points; we don't stroke these */
      if ( last <= first )
      {
        first = last + 1;
        continue;
      }
 
      v_start = outline->points[first];
      v_last  = outline->points[last];
 
      v_control = v_start;
 
      point = outline->points + first;
      tags  = outline->tags   + first;
      tag   = FT_CURVE_TAG( tags[0] );
 
      /* A contour cannot start with a cubic control point! */
      if ( tag == FT_CURVE_TAG_CUBIC )
        goto Invalid_Outline;
 
      /* check first point to determine origin */
      if ( tag == FT_CURVE_TAG_CONIC )
      {
        /* First point is conic control.  Yes, this happens. */
        if ( FT_CURVE_TAG( outline->tags[last] ) == FT_CURVE_TAG_ON )
        {
          /* start at last point if it is on the curve */
          v_start = v_last;
          limit--;
        }
        else
        {
          /* if both first and last points are conic, */
          /* start at their middle                    */
          v_start.x = ( v_start.x + v_last.x ) / 2;
          v_start.y = ( v_start.y + v_last.y ) / 2;
        }
        point--;
        tags--;
      }
 
      error = FT_Stroker_BeginSubPath( stroker, &v_start, opened );
      if ( error )
        goto Exit;
 
      while ( point < limit )
      {
        point++;
        tags++;
 
        tag = FT_CURVE_TAG( tags[0] );
        switch ( tag )
        {
        case FT_CURVE_TAG_ON:  /* emit a single line_to */
          {
            FT_Vector  vec;
 
 
            vec.x = point->x;
            vec.y = point->y;
 
            error = FT_Stroker_LineTo( stroker, &vec );
            if ( error )
              goto Exit;
            continue;
          }
 
        case FT_CURVE_TAG_CONIC:  /* consume conic arcs */
          v_control.x = point->x;
          v_control.y = point->y;
 
        Do_Conic:
          if ( point < limit )
          {
            FT_Vector  vec;
            FT_Vector  v_middle;
 
 
            point++;
            tags++;
            tag = FT_CURVE_TAG( tags[0] );
 
            vec = point[0];
 
            if ( tag == FT_CURVE_TAG_ON )
            {
              error = FT_Stroker_ConicTo( stroker, &v_control, &vec );
              if ( error )
                goto Exit;
              continue;
            }
 
            if ( tag != FT_CURVE_TAG_CONIC )
              goto Invalid_Outline;
 
            v_middle.x = ( v_control.x + vec.x ) / 2;
            v_middle.y = ( v_control.y + vec.y ) / 2;
 
            error = FT_Stroker_ConicTo( stroker, &v_control, &v_middle );
            if ( error )
              goto Exit;
 
            v_control = vec;
            goto Do_Conic;
          }
 
          error = FT_Stroker_ConicTo( stroker, &v_control, &v_start );
          goto Close;
 
        default:  /* FT_CURVE_TAG_CUBIC */
          {
            FT_Vector  vec1, vec2;
 
 
            if ( point + 1 > limit                             ||
                 FT_CURVE_TAG( tags[1] ) != FT_CURVE_TAG_CUBIC )
              goto Invalid_Outline;
 
            point += 2;
            tags  += 2;
 
            vec1 = point[-2];
            vec2 = point[-1];
 
            if ( point <= limit )
            {
              FT_Vector  vec;
 
 
              vec = point[0];
 
              error = FT_Stroker_CubicTo( stroker, &vec1, &vec2, &vec );
              if ( error )
                goto Exit;
              continue;
            }
 
            error = FT_Stroker_CubicTo( stroker, &vec1, &vec2, &v_start );
            goto Close;
          }
        }
      }
 
    Close:
      if ( error )
        goto Exit;
 
      /* don't try to end the path if no segments have been generated */
      if ( !stroker->first_point )
      {
        error = FT_Stroker_EndSubPath( stroker );
        if ( error )
          goto Exit;
      }
 
      first = last + 1;
    }
 
    return FT_Err_Ok;
 
  Exit:
    return error;
 
  Invalid_Outline:
    return FT_THROW( Invalid_Outline );
  }

Referenced by FT_Glyph_Stroke(), and FT_Glyph_StrokeBorder().

FT_Stroker_Rewind()

FT_Stroker_Rewind

(

FT_Stroker

stroker

)

Definition at line 852 of file ftstroke.c.

  {
    if ( stroker )
    {
      ft_stroke_border_reset( &stroker->borders[0] );
      ft_stroke_border_reset( &stroker->borders[1] );
    }
  }

Referenced by FT_Stroker_ParseOutline(), and FT_Stroker_Set().

FT_Stroker_Set()

FT_Stroker_Set	(	FT_Stroker	stroker,
		FT_Fixed	radius,
		FT_Stroker_LineCap	line_cap,
		FT_Stroker_LineJoin	line_join,
		FT_Fixed	miter_limit
	)

Definition at line 823 of file ftstroke.c.

  {
    if ( !stroker )
      return;
 
    stroker->radius      = radius;
    stroker->line_cap    = line_cap;
    stroker->line_join   = line_join;
    stroker->miter_limit = miter_limit;
 
    /* ensure miter limit has sensible value */
    if ( stroker->miter_limit < 0x10000L )
      stroker->miter_limit = 0x10000L;
 
    /* save line join style:                                           */
    /* line join style can be temporarily changed when stroking curves */
    stroker->line_join_saved = line_join;
 
    FT_Stroker_Rewind( stroker );
  }