pshalgo.h File Reference

#include "pshrec.h"
#include "pshglob.h"

Include dependency graph for pshalgo.h:

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

Go to the source code of this file.

Classes
struct	PSH_HintRec_
struct	PSH_ZoneRec_
struct	PSH_Hint_TableRec_
struct	PSH_PointRec_
struct	PSH_ContourRec_
struct	PSH_GlyphRec_

Macros
#define	PSH_HINT_GHOST   PS_HINT_FLAG_GHOST
#define	PSH_HINT_BOTTOM   PS_HINT_FLAG_BOTTOM
#define	PSH_HINT_ACTIVE   4U
#define	PSH_HINT_FITTED   8U
#define	psh_hint_is_active(x)   ( ( (x)->flags & PSH_HINT_ACTIVE ) != 0 )
#define	psh_hint_is_ghost(x)   ( ( (x)->flags & PSH_HINT_GHOST ) != 0 )
#define	psh_hint_is_fitted(x)   ( ( (x)->flags & PSH_HINT_FITTED ) != 0 )
#define	psh_hint_activate(x)   (x)->flags |= PSH_HINT_ACTIVE
#define	psh_hint_deactivate(x)   (x)->flags &= ~PSH_HINT_ACTIVE
#define	psh_hint_set_fitted(x)   (x)->flags |= PSH_HINT_FITTED
#define	PSH_DIR_HORIZONTAL   2
#define	PSH_DIR_VERTICAL   1
#define	PSH_DIR_COMPARE(d1, d2)   ( (d1) == (d2) || (d1) == -(d2) )
#define	PSH_DIR_IS_HORIZONTAL(d)   PSH_DIR_COMPARE( d, PSH_DIR_HORIZONTAL )
#define	PSH_DIR_IS_VERTICAL(d)   PSH_DIR_COMPARE( d, PSH_DIR_VERTICAL )
#define	PSH_POINT_OFF   1U /* point is off the curve */
#define	PSH_POINT_SMOOTH   2U /* point is smooth */
#define	PSH_POINT_INFLEX   4U /* point is inflection */
#define	psh_point_is_smooth(p)   ( (p)->flags & PSH_POINT_SMOOTH )
#define	psh_point_is_off(p)   ( (p)->flags & PSH_POINT_OFF )
#define	psh_point_is_inflex(p)   ( (p)->flags & PSH_POINT_INFLEX )
#define	psh_point_set_smooth(p)   (p)->flags |= PSH_POINT_SMOOTH
#define	psh_point_set_off(p)   (p)->flags |= PSH_POINT_OFF
#define	psh_point_set_inflex(p)   (p)->flags |= PSH_POINT_INFLEX
#define	PSH_POINT_STRONG   16U /* point is strong */
#define	PSH_POINT_FITTED   32U /* point is already fitted */
#define	PSH_POINT_EXTREMUM   64U /* point is local extremum */
#define	PSH_POINT_POSITIVE   128U /* extremum has positive contour flow */
#define	PSH_POINT_NEGATIVE   256U /* extremum has negative contour flow */
#define	PSH_POINT_EDGE_MIN   512U /* point is aligned to left/bottom stem edge */
#define	PSH_POINT_EDGE_MAX   1024U /* point is aligned to top/right stem edge */
#define	psh_point_is_strong(p)   ( (p)->flags2 & PSH_POINT_STRONG )
#define	psh_point_is_fitted(p)   ( (p)->flags2 & PSH_POINT_FITTED )
#define	psh_point_is_extremum(p)   ( (p)->flags2 & PSH_POINT_EXTREMUM )
#define	psh_point_is_positive(p)   ( (p)->flags2 & PSH_POINT_POSITIVE )
#define	psh_point_is_negative(p)   ( (p)->flags2 & PSH_POINT_NEGATIVE )
#define	psh_point_is_edge_min(p)   ( (p)->flags2 & PSH_POINT_EDGE_MIN )
#define	psh_point_is_edge_max(p)   ( (p)->flags2 & PSH_POINT_EDGE_MAX )
#define	psh_point_set_strong(p)   (p)->flags2 |= PSH_POINT_STRONG
#define	psh_point_set_fitted(p)   (p)->flags2 |= PSH_POINT_FITTED
#define	psh_point_set_extremum(p)   (p)->flags2 |= PSH_POINT_EXTREMUM
#define	psh_point_set_positive(p)   (p)->flags2 |= PSH_POINT_POSITIVE
#define	psh_point_set_negative(p)   (p)->flags2 |= PSH_POINT_NEGATIVE
#define	psh_point_set_edge_min(p)   (p)->flags2 |= PSH_POINT_EDGE_MIN
#define	psh_point_set_edge_max(p)   (p)->flags2 |= PSH_POINT_EDGE_MAX

Typedefs
typedef typedefFT_BEGIN_HEADER struct PSH_HintRec_ *	PSH_Hint
typedef struct PSH_HintRec_	PSH_HintRec
typedef struct PSH_ZoneRec_	PSH_ZoneRec
typedef struct PSH_ZoneRec_ *	PSH_Zone
typedef struct PSH_Hint_TableRec_	PSH_Hint_TableRec
typedef struct PSH_Hint_TableRec_ *	PSH_Hint_Table
typedef struct PSH_PointRec_ *	PSH_Point
typedef struct PSH_ContourRec_ *	PSH_Contour
typedef struct PSH_PointRec_	PSH_PointRec
typedef struct PSH_ContourRec_	PSH_ContourRec
typedef struct PSH_GlyphRec_	PSH_GlyphRec
typedef struct PSH_GlyphRec_ *	PSH_Glyph

Enumerations
enum	{   PSH_DIR_NONE = 4 , PSH_DIR_UP = -1 , PSH_DIR_DOWN = 1 , PSH_DIR_LEFT = -2 ,   PSH_DIR_RIGHT = 2 }

Functions
FT_Error	ps_hints_apply (PS_Hints ps_hints, FT_Outline *outline, PSH_Globals globals, FT_Render_Mode hint_mode)

Macro Definition Documentation

PSH_DIR_COMPARE

#define PSH_DIR_COMPARE	(		d1,
			d2
	)		( (d1) == (d2) || (d1) == -(d2) )

Definition at line 108 of file pshalgo.h.

PSH_DIR_HORIZONTAL

#define PSH_DIR_HORIZONTAL   2

Definition at line 105 of file pshalgo.h.

PSH_DIR_IS_HORIZONTAL

#define PSH_DIR_IS_HORIZONTAL

(

d

)

PSH_DIR_COMPARE( d, PSH_DIR_HORIZONTAL )

Definition at line 109 of file pshalgo.h.

PSH_DIR_IS_VERTICAL

#define PSH_DIR_IS_VERTICAL

(

d

)

PSH_DIR_COMPARE( d, PSH_DIR_VERTICAL )

Definition at line 110 of file pshalgo.h.

PSH_DIR_VERTICAL

#define PSH_DIR_VERTICAL   1

Definition at line 106 of file pshalgo.h.

psh_hint_activate

#define psh_hint_activate

(

x

)

(x)->flags |= PSH_HINT_ACTIVE

Definition at line 45 of file pshalgo.h.

PSH_HINT_ACTIVE

#define PSH_HINT_ACTIVE   4U

Definition at line 37 of file pshalgo.h.

PSH_HINT_BOTTOM

#define PSH_HINT_BOTTOM   PS_HINT_FLAG_BOTTOM

Definition at line 36 of file pshalgo.h.

psh_hint_deactivate

#define psh_hint_deactivate

(

x

)

(x)->flags &= ~PSH_HINT_ACTIVE

Definition at line 46 of file pshalgo.h.

PSH_HINT_FITTED

#define PSH_HINT_FITTED   8U

Definition at line 38 of file pshalgo.h.

PSH_HINT_GHOST

#define PSH_HINT_GHOST   PS_HINT_FLAG_GHOST

Definition at line 35 of file pshalgo.h.

psh_hint_is_active

#define psh_hint_is_active

(

x

)

( ( (x)->flags & PSH_HINT_ACTIVE ) != 0 )

Definition at line 41 of file pshalgo.h.

psh_hint_is_fitted

#define psh_hint_is_fitted

(

x

)

( ( (x)->flags & PSH_HINT_FITTED ) != 0 )

Definition at line 43 of file pshalgo.h.

psh_hint_is_ghost

#define psh_hint_is_ghost

(

x

)

( ( (x)->flags & PSH_HINT_GHOST ) != 0 )

Definition at line 42 of file pshalgo.h.

psh_hint_set_fitted

#define psh_hint_set_fitted

(

x

)

(x)->flags |= PSH_HINT_FITTED

Definition at line 47 of file pshalgo.h.

PSH_POINT_EDGE_MAX

#define PSH_POINT_EDGE_MAX   1024U /* point is aligned to top/right stem edge */

Definition at line 136 of file pshalgo.h.

PSH_POINT_EDGE_MIN

#define PSH_POINT_EDGE_MIN   512U /* point is aligned to left/bottom stem edge */

Definition at line 135 of file pshalgo.h.

PSH_POINT_EXTREMUM

#define PSH_POINT_EXTREMUM   64U /* point is local extremum */

Definition at line 132 of file pshalgo.h.

PSH_POINT_FITTED

#define PSH_POINT_FITTED   32U /* point is already fitted */

Definition at line 131 of file pshalgo.h.

PSH_POINT_INFLEX

#define PSH_POINT_INFLEX   4U /* point is inflection */

Definition at line 117 of file pshalgo.h.

psh_point_is_edge_max

#define psh_point_is_edge_max

(

p

)

( (p)->flags2 & PSH_POINT_EDGE_MAX )

Definition at line 145 of file pshalgo.h.

psh_point_is_edge_min

#define psh_point_is_edge_min

(

p

)

( (p)->flags2 & PSH_POINT_EDGE_MIN )

Definition at line 144 of file pshalgo.h.

psh_point_is_extremum

#define psh_point_is_extremum

(

p

)

( (p)->flags2 & PSH_POINT_EXTREMUM )

Definition at line 141 of file pshalgo.h.

psh_point_is_fitted

#define psh_point_is_fitted

(

p

)

( (p)->flags2 & PSH_POINT_FITTED )

Definition at line 140 of file pshalgo.h.

psh_point_is_inflex

#define psh_point_is_inflex

(

p

)

( (p)->flags & PSH_POINT_INFLEX )

Definition at line 122 of file pshalgo.h.

psh_point_is_negative

#define psh_point_is_negative

(

p

)

( (p)->flags2 & PSH_POINT_NEGATIVE )

Definition at line 143 of file pshalgo.h.

psh_point_is_off

#define psh_point_is_off

(

p

)

( (p)->flags & PSH_POINT_OFF )

Definition at line 121 of file pshalgo.h.

psh_point_is_positive

#define psh_point_is_positive

(

p

)

( (p)->flags2 & PSH_POINT_POSITIVE )

Definition at line 142 of file pshalgo.h.

psh_point_is_smooth

#define psh_point_is_smooth

(

p

)

( (p)->flags & PSH_POINT_SMOOTH )

Definition at line 120 of file pshalgo.h.

psh_point_is_strong

#define psh_point_is_strong

(

p

)

( (p)->flags2 & PSH_POINT_STRONG )

Definition at line 139 of file pshalgo.h.

PSH_POINT_NEGATIVE

#define PSH_POINT_NEGATIVE   256U /* extremum has negative contour flow */

Definition at line 134 of file pshalgo.h.

PSH_POINT_OFF

#define PSH_POINT_OFF   1U /* point is off the curve */

Definition at line 115 of file pshalgo.h.

PSH_POINT_POSITIVE

#define PSH_POINT_POSITIVE   128U /* extremum has positive contour flow */

Definition at line 133 of file pshalgo.h.

psh_point_set_edge_max

#define psh_point_set_edge_max

(

p

)

(p)->flags2 |= PSH_POINT_EDGE_MAX

Definition at line 153 of file pshalgo.h.

psh_point_set_edge_min

#define psh_point_set_edge_min

(

p

)

(p)->flags2 |= PSH_POINT_EDGE_MIN

Definition at line 152 of file pshalgo.h.

psh_point_set_extremum

#define psh_point_set_extremum

(

p

)

(p)->flags2 |= PSH_POINT_EXTREMUM

Definition at line 149 of file pshalgo.h.

psh_point_set_fitted

#define psh_point_set_fitted

(

p

)

(p)->flags2 |= PSH_POINT_FITTED

Definition at line 148 of file pshalgo.h.

psh_point_set_inflex

#define psh_point_set_inflex

(

p

)

(p)->flags |= PSH_POINT_INFLEX

Definition at line 126 of file pshalgo.h.

psh_point_set_negative

#define psh_point_set_negative

(

p

)

(p)->flags2 |= PSH_POINT_NEGATIVE

Definition at line 151 of file pshalgo.h.

psh_point_set_off

#define psh_point_set_off

(

p

)

(p)->flags |= PSH_POINT_OFF

Definition at line 125 of file pshalgo.h.

psh_point_set_positive

#define psh_point_set_positive

(

p

)

(p)->flags2 |= PSH_POINT_POSITIVE

Definition at line 150 of file pshalgo.h.

psh_point_set_smooth

#define psh_point_set_smooth

(

p

)

(p)->flags |= PSH_POINT_SMOOTH

Definition at line 124 of file pshalgo.h.

psh_point_set_strong

#define psh_point_set_strong

(

p

)

(p)->flags2 |= PSH_POINT_STRONG

Definition at line 147 of file pshalgo.h.

PSH_POINT_SMOOTH

#define PSH_POINT_SMOOTH   2U /* point is smooth */

Definition at line 116 of file pshalgo.h.

PSH_POINT_STRONG

#define PSH_POINT_STRONG   16U /* point is strong */

Definition at line 130 of file pshalgo.h.

Typedef Documentation

PSH_Contour

typedef struct PSH_ContourRec_* PSH_Contour

Definition at line 94 of file pshalgo.h.

PSH_ContourRec

typedef struct PSH_ContourRec_ PSH_ContourRec

PSH_Glyph

typedef struct PSH_GlyphRec_ * PSH_Glyph

PSH_GlyphRec

typedef struct PSH_GlyphRec_ PSH_GlyphRec

PSH_Hint

typedef typedefFT_BEGIN_HEADER struct PSH_HintRec_* PSH_Hint

Definition at line 31 of file pshalgo.h.

PSH_Hint_Table

typedef struct PSH_Hint_TableRec_ * PSH_Hint_Table

PSH_Hint_TableRec

typedef struct PSH_Hint_TableRec_ PSH_Hint_TableRec

PSH_HintRec

typedef struct PSH_HintRec_ PSH_HintRec

PSH_Point

typedef struct PSH_PointRec_* PSH_Point

Definition at line 93 of file pshalgo.h.

PSH_PointRec

typedef struct PSH_PointRec_ PSH_PointRec

PSH_Zone

typedef struct PSH_ZoneRec_ * PSH_Zone

PSH_ZoneRec

typedef struct PSH_ZoneRec_ PSH_ZoneRec

Enumeration Type Documentation

anonymous enum

anonymous enum

Enumerator
PSH_DIR_NONE
PSH_DIR_UP
PSH_DIR_DOWN
PSH_DIR_LEFT
PSH_DIR_RIGHT

Definition at line 96 of file pshalgo.h.

  {
    PSH_DIR_NONE  =  4,
    PSH_DIR_UP    = -1,
    PSH_DIR_DOWN  =  1,
    PSH_DIR_LEFT  = -2,
    PSH_DIR_RIGHT =  2
  };

Function Documentation

ps_hints_apply()

FT_Error ps_hints_apply	(	PS_Hints	ps_hints,
		FT_Outline *	outline,
		PSH_Globals	globals,
		FT_Render_Mode	hint_mode
	)

Definition at line 2070 of file pshalgo.c.

  {
    PSH_GlyphRec  glyphrec;
    PSH_Glyph     glyph = &glyphrec;
    FT_Error      error;
#ifdef DEBUG_HINTER
    FT_Memory     memory;
#endif
    FT_Int        dimension;
 
 
    /* something to do? */
    if ( outline->n_points == 0 || outline->n_contours == 0 )
      return FT_Err_Ok;
 
#ifdef DEBUG_HINTER
 
    memory = globals->memory;
 
    if ( ps_debug_glyph )
    {
      psh_glyph_done( ps_debug_glyph );
      FT_FREE( ps_debug_glyph );
    }
 
    if ( FT_NEW( glyph ) )
      return error;
 
    ps_debug_glyph = glyph;
 
#endif /* DEBUG_HINTER */
 
    error = psh_glyph_init( glyph, outline, ps_hints, globals );
    if ( error )
      goto Exit;
 
    /* try to optimize the y_scale so that the top of non-capital letters
     * is aligned on a pixel boundary whenever possible
     */
    {
      PSH_Dimension  dim_x = &glyph->globals->dimension[0];
      PSH_Dimension  dim_y = &glyph->globals->dimension[1];
 
      FT_Fixed  x_scale = dim_x->scale_mult;
      FT_Fixed  y_scale = dim_y->scale_mult;
 
      FT_Fixed  old_x_scale = x_scale;
      FT_Fixed  old_y_scale = y_scale;
 
      FT_Fixed  scaled;
      FT_Fixed  fitted;
 
      FT_Bool  rescale = FALSE;
 
 
      scaled = FT_MulFix( globals->blues.normal_top.zones->org_ref, y_scale );
      fitted = FT_PIX_ROUND( scaled );
 
      if ( fitted != 0 && scaled != fitted )
      {
        rescale = TRUE;
 
        y_scale = FT_MulDiv( y_scale, fitted, scaled );
 
        if ( fitted < scaled )
          x_scale -= x_scale / 50;
 
        psh_globals_set_scale( glyph->globals, x_scale, y_scale, 0, 0 );
      }
 
      glyph->do_horz_hints = 1;
      glyph->do_vert_hints = 1;
 
      glyph->do_horz_snapping = FT_BOOL( hint_mode == FT_RENDER_MODE_MONO ||
                                         hint_mode == FT_RENDER_MODE_LCD  );
 
      glyph->do_vert_snapping = FT_BOOL( hint_mode == FT_RENDER_MODE_MONO  ||
                                         hint_mode == FT_RENDER_MODE_LCD_V );
 
      glyph->do_stem_adjust   = FT_BOOL( hint_mode != FT_RENDER_MODE_LIGHT );
 
      for ( dimension = 0; dimension < 2; dimension++ )
      {
        /* load outline coordinates into glyph */
        psh_glyph_load_points( glyph, dimension );
 
        /* compute local extrema */
        psh_glyph_compute_extrema( glyph );
 
        /* compute aligned stem/hints positions */
        psh_hint_table_align_hints( &glyph->hint_tables[dimension],
                                    glyph->globals,
                                    dimension,
                                    glyph );
 
        /* find strong points, align them, then interpolate others */
        psh_glyph_find_strong_points( glyph, dimension );
        if ( dimension == 1 )
          psh_glyph_find_blue_points( &globals->blues, glyph );
        psh_glyph_interpolate_strong_points( glyph, dimension );
        psh_glyph_interpolate_normal_points( glyph, dimension );
        psh_glyph_interpolate_other_points( glyph, dimension );
 
        /* save hinted coordinates back to outline */
        psh_glyph_save_points( glyph, dimension );
 
        if ( rescale )
          psh_globals_set_scale( glyph->globals,
                                 old_x_scale, old_y_scale, 0, 0 );
      }
    }
 
  Exit:
 
#ifndef DEBUG_HINTER
    psh_glyph_done( glyph );
#endif
 
    return error;
  }

Referenced by t1_hints_funcs_init(), and t2_hints_funcs_init().