Edit

kc3-lang/freetype/src/base/ftoutln.c

Branch :

  • Show log

    Commit

  • Author : Werner Lemberg
    Date : 2001-06-28 17:49:10
    Hash : 415235df
    Message : finishing function header formatting updating copyrights

  • src/base/ftoutln.c
  • /***************************************************************************/
    /*                                                                         */
    /*  ftoutln.c                                                              */
    /*                                                                         */
    /*    FreeType outline management (body).                                  */
    /*                                                                         */
    /*  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.                                        */
    /*                                                                         */
    /***************************************************************************/
    
    
      /*************************************************************************/
      /*                                                                       */
      /* All functions are declared in freetype.h.                             */
      /*                                                                       */
      /*************************************************************************/
    
    
    #include <ft2build.h>
    #include FT_OUTLINE_H
    #include FT_INTERNAL_OBJECTS_H
    
    
      /*************************************************************************/
      /*                                                                       */
      /* The macro FT_COMPONENT is used in trace mode.  It is an implicit      */
      /* parameter of the FT_TRACE() and FT_ERROR() macros, used to print/log  */
      /* messages during execution.                                            */
      /*                                                                       */
    #undef  FT_COMPONENT
    #define FT_COMPONENT  trace_outline
    
    
      static
      const FT_Outline  null_outline = { 0, 0, 0, 0, 0, 0 };
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( FT_Error )
      FT_Outline_Decompose( FT_Outline*              outline,
                            const FT_Outline_Funcs*  interface,
                            void*                    user )
      {
    #undef SCALED
    #define SCALED( x )  ( ( (x) << shift ) - delta )
    
        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           */
    
        FT_Int   shift;
        FT_Pos   delta;
    
    
        if ( !outline || !interface )
          return FT_Err_Invalid_Argument;
    
        shift = interface->shift;
        delta = interface->delta;
        first = 0;
    
        for ( n = 0; n < outline->n_contours; n++ )
        {
          FT_Int  last;  /* index of last point in contour */
    
    
          last  = outline->contours[n];
          limit = outline->points + last;
    
          v_start = outline->points[first];
          v_last  = outline->points[last];
    
          v_start.x = SCALED( v_start.x ); v_start.y = SCALED( v_start.y );
          v_last.x  = SCALED( v_last.x );  v_last.y  = SCALED( v_last.y );
    
          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 and record its position    */
              /* for closure                                      */
              v_start.x = ( v_start.x + v_last.x ) / 2;
              v_start.y = ( v_start.y + v_last.y ) / 2;
    
              v_last = v_start;
            }
            point--;
            tags--;
          }
    
          error = interface->move_to( &v_start, user );
          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 = SCALED( point->x );
                vec.y = SCALED( point->y );
    
                error = interface->line_to( &vec, user );
                if ( error )
                  goto Exit;
                continue;
              }
    
            case FT_Curve_Tag_Conic:  /* consume conic arcs */
              v_control.x = SCALED( point->x );
              v_control.y = SCALED( point->y );
    
            Do_Conic:
              if ( point < limit )
              {
                FT_Vector  vec;
                FT_Vector  v_middle;
    
    
                point++;
                tags++;
                tag = FT_CURVE_TAG( tags[0] );
    
                vec.x = SCALED( point->x );
                vec.y = SCALED( point->y );
    
                if ( tag == FT_Curve_Tag_On )
                {
                  error = interface->conic_to( &v_control, &vec, user );
                  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 = interface->conic_to( &v_control, &v_middle, user );
                if ( error )
                  goto Exit;
    
                v_control = vec;
                goto Do_Conic;
              }
    
              error = interface->conic_to( &v_control, &v_start, user );
              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.x = SCALED( point[-2].x ); vec1.y = SCALED( point[-2].y );
                vec2.x = SCALED( point[-1].x ); vec2.y = SCALED( point[-1].y );
    
                if ( point <= limit )
                {
                  FT_Vector  vec;
    
    
                  vec.x = SCALED( point->x );
                  vec.y = SCALED( point->y );
    
                  error = interface->cubic_to( &vec1, &vec2, &vec, user );
                  if ( error )
                    goto Exit;
                  continue;
                }
    
                error = interface->cubic_to( &vec1, &vec2, &v_start, user );
                goto Close;
              }
            }
          }
    
          /* close the contour with a line segment */
          error = interface->line_to( &v_start, user );
    
        Close:
          if ( error )
            goto Exit;
    
          first = last + 1;
        }
    
        return 0;
    
      Exit:
        return error;
    
      Invalid_Outline:
        return FT_Err_Invalid_Outline;
      }
    
    
      FT_EXPORT_DEF( FT_Error )
      FT_Outline_New_Internal( FT_Memory    memory,
                               FT_UInt      numPoints,
                               FT_Int       numContours,
                               FT_Outline  *anoutline )
      {
        FT_Error  error;
    
    
        if ( !anoutline || !memory )
          return FT_Err_Invalid_Argument;
    
        *anoutline = null_outline;
    
        if ( ALLOC_ARRAY( anoutline->points,   numPoints * 2L, FT_Pos    ) ||
             ALLOC_ARRAY( anoutline->tags,     numPoints,      FT_Byte   ) ||
             ALLOC_ARRAY( anoutline->contours, numContours,    FT_UShort ) )
          goto Fail;
    
        anoutline->n_points    = (FT_UShort)numPoints;
        anoutline->n_contours  = (FT_Short)numContours;
        anoutline->flags      |= ft_outline_owner;
    
        return FT_Err_Ok;
    
      Fail:
        anoutline->flags |= ft_outline_owner;
        FT_Outline_Done_Internal( memory, anoutline );
    
        return error;
      }
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( FT_Error )
      FT_Outline_New( FT_Library   library,
                      FT_UInt      numPoints,
                      FT_Int       numContours,
                      FT_Outline  *anoutline )
      {
        if ( !library )
          return FT_Err_Invalid_Library_Handle;
    
        return FT_Outline_New_Internal( library->memory, numPoints,
                                        numContours, anoutline );
      }
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( FT_Error )
      FT_Outline_Copy( FT_Outline*  source,
                       FT_Outline  *target )
      {
        FT_Int  is_owner;
    
    
        if ( !source            || !target            ||
             source->n_points   != target->n_points   ||
             source->n_contours != target->n_contours )
          return FT_Err_Invalid_Argument;
    
        MEM_Copy( target->points, source->points,
                  source->n_points * sizeof ( FT_Vector ) );
    
        MEM_Copy( target->tags, source->tags,
                  source->n_points * sizeof ( FT_Byte ) );
    
        MEM_Copy( target->contours, source->contours,
                  source->n_contours * sizeof ( FT_Short ) );
    
        /* copy all flags, except the `ft_outline_owner' one */
        is_owner      = target->flags & ft_outline_owner;
        target->flags = source->flags;
    
        target->flags &= ~ft_outline_owner;
        target->flags |= is_owner;
    
        return FT_Err_Ok;
      }
    
    
      FT_EXPORT_DEF( FT_Error )
      FT_Outline_Done_Internal( FT_Memory    memory,
                                FT_Outline*  outline )
      {
        if ( outline )
        {
          if ( outline->flags & ft_outline_owner )
          {
            FREE( outline->points   );
            FREE( outline->tags     );
            FREE( outline->contours );
          }
          *outline = null_outline;
    
          return FT_Err_Ok;
        }
        else
          return FT_Err_Invalid_Argument;
      }
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( FT_Error )
      FT_Outline_Done( FT_Library   library,
                       FT_Outline*  outline )
      {
        /* check for valid `outline' in FT_Outline_Done_Internal() */
    
        if ( !library )
          return FT_Err_Invalid_Library_Handle;
    
        return FT_Outline_Done_Internal( library->memory, outline );
      }
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( void )
      FT_Outline_Get_CBox( FT_Outline*  outline,
                           FT_BBox     *acbox )
      {
        FT_Pos  xMin, yMin, xMax, yMax;
    
    
        if ( outline && acbox )
        {
          if ( outline->n_points == 0 )
          {
            xMin = 0;
            yMin = 0;
            xMax = 0;
            yMax = 0;
          }
          else
          {
            FT_Vector*  vec   = outline->points;
            FT_Vector*  limit = vec + outline->n_points;
    
    
            xMin = xMax = vec->x;
            yMin = yMax = vec->y;
            vec++;
    
            for ( ; vec < limit; vec++ )
            {
              FT_Pos  x, y;
    
    
              x = vec->x;
              if ( x < xMin ) xMin = x;
              if ( x > xMax ) xMax = x;
    
              y = vec->y;
              if ( y < yMin ) yMin = y;
              if ( y > yMax ) yMax = y;
            }
          }
          acbox->xMin = xMin;
          acbox->xMax = xMax;
          acbox->yMin = yMin;
          acbox->yMax = yMax;
        }
      }
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( void )
      FT_Outline_Translate( FT_Outline*  outline,
                            FT_Pos       xOffset,
                            FT_Pos       yOffset )
      {
        FT_UShort   n;
        FT_Vector*  vec = outline->points;
    
    
        for ( n = 0; n < outline->n_points; n++ )
        {
          vec->x += xOffset;
          vec->y += yOffset;
          vec++;
        }
      }
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( void )
      FT_Outline_Reverse( FT_Outline*  outline )
      {
        FT_UShort  n;
        FT_Int     first, last;
    
    
        first = 0;
    
        for ( n = 0; n < outline->n_contours; n++ )
        {
          last  = outline->contours[n];
    
          /* reverse point table */
          {
            FT_Vector*  p = outline->points + first;
            FT_Vector*  q = outline->points + last;
            FT_Vector   swap;
    
    
            while ( p < q )
            {
              swap = *p;
              *p   = *q;
              *q   = swap;
              p++;
              q--;
            }
          }
    
          /* reverse tags table */
          {
            char*  p = outline->tags + first;
            char*  q = outline->tags + last;
            char   swap;
    
    
            while ( p < q )
            {
              swap = *p;
              *p   = *q;
              *q   = swap;
              p++;
              q--;
            }
          }
    
          first = last + 1;
        }
    
        outline->flags ^= ft_outline_reverse_fill;
      }
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( FT_Error )
      FT_Outline_Render( FT_Library         library,
                         FT_Outline*        outline,
                         FT_Raster_Params*  params )
      {
        FT_Error     error;
        FT_Bool      update = 0;
        FT_Renderer  renderer;
        FT_ListNode  node;
    
    
        if ( !library )
          return FT_Err_Invalid_Library_Handle;
    
        if ( !params )
          return FT_Err_Invalid_Argument;
    
        renderer = library->cur_renderer;
        node     = library->renderers.head;
    
        params->source = (void*)outline;
    
        error = FT_Err_Cannot_Render_Glyph;
        while ( renderer )
        {
          error = renderer->raster_render( renderer->raster, params );
          if ( !error || FT_ERROR_BASE( error ) != FT_Err_Cannot_Render_Glyph )
            break;
    
          /* FT_Err_Cannot_Render_Glyph is returned if the render mode   */
          /* is unsupported by the current renderer for this glyph image */
          /* format                                                      */
    
          /* now, look for another renderer that supports the same */
          /* format                                                */
          renderer = FT_Lookup_Renderer( library, ft_glyph_format_outline,
                                         &node );
          update   = 1;
        }
    
        /* if we changed the current renderer for the glyph image format */
        /* we need to select it as the next current one                  */
        if ( !error && update && renderer )
          FT_Set_Renderer( library, renderer, 0, 0 );
    
        return error;
      }
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( FT_Error )
      FT_Outline_Get_Bitmap( FT_Library   library,
                             FT_Outline*  outline,
                             FT_Bitmap   *abitmap )
      {
        FT_Raster_Params  params;
    
    
        if ( !abitmap )
          return FT_Err_Invalid_Argument;
    
        /* other checks are delayed to FT_Outline_Render() */
    
        params.target = abitmap;
        params.flags  = 0;
    
        if ( abitmap->pixel_mode == ft_pixel_mode_grays )
          params.flags |= ft_raster_flag_aa;
    
        return FT_Outline_Render( library, outline, &params );
      }
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( void )
      FT_Vector_Transform( FT_Vector*  vector,
                           FT_Matrix*  matrix )
      {
        FT_Pos xz, yz;
    
    
        if ( !vector || !matrix )
          return;
    
        xz = FT_MulFix( vector->x, matrix->xx ) +
             FT_MulFix( vector->y, matrix->xy );
    
        yz = FT_MulFix( vector->x, matrix->yx ) +
             FT_MulFix( vector->y, matrix->yy );
    
        vector->x = xz;
        vector->y = yz;
      }
    
    
      /* documentation is in ftoutln.h */
    
      FT_EXPORT_DEF( void )
      FT_Outline_Transform( FT_Outline*  outline,
                            FT_Matrix*   matrix )
      {
        FT_Vector*  vec = outline->points;
        FT_Vector*  limit = vec + outline->n_points;
    
    
        for ( ; vec < limit; vec++ )
          FT_Vector_Transform( vec, matrix );
      }
    
    
    /* END */