adding a new glyph viewer program to better understand the

hinting errors

note: depends on Nirvana, which is not publicly available !!

3 files changed, 471 insertions, 0 deletions

diff --git a/Jamfile b/Jamfile
index c8467b416..fa774b3b9 100644
--- a/Jamfile
+++ b/Jamfile
@@ -38,4 +38,8 @@ HDRMACRO  [ FT2_SubDir  include freetype internal internal.h ] ;
 SubInclude  FT2_TOP src ;
 
 
+# tests files
+#
+SubInclude FT2_TOP tests ;
+
 # end of top Jamfile
diff --git a/tests/Jamfile b/tests/Jamfile
new file mode 100644
index 000000000..74d3aef23
--- /dev/null
+++ b/tests/Jamfile
@@ -0,0 +1,31 @@
+SubDir FT2_TOP tests ;
+
+test_programs = gview ;
+
+SubDirHdrs [ FT2_SubDir .. .. nirvana include ] ;
+
+NV_TOP = [ FT2_SubDir .. .. .. nirvana ] ;
+
+NIRVANA_LINKLIBS = $(NV_TOP)\\objs\\nirvana$(SUFLIB) ;
+
+{
+  local t ;
+  
+  for t in $(test_programs)
+  {
+    Main  $(t) : $(t).c ;
+    
+    LinkLibraries $(t) : $(FT2_LIB) ;
+
+    if $(TOOLSET) = MINGW
+    {
+      LINKKLIBS on $(t)$(SUFEXE) = "-luser32 -lgdi32" ;
+    }
+    else
+    {
+      LINKLIBS on $(t)$(SUFEXE) = user32.lib gdi32.lib ;
+    }
+    
+    NEEDLIBS on $(t)$(SUFEXE) += $(NIRVANA_LINKLIBS) ;
+  }
+}
diff --git a/tests/gview.c b/tests/gview.c
new file mode 100644
index 000000000..c78184268
--- /dev/null
+++ b/tests/gview.c
@@ -0,0 +1,436 @@
+#include <nirvana.h>
+#include NV_VIEWPORT_H
+#include <stdio.h>
+
+#include <ft2build.h>
+#include FT_FREETYPE_H
+
+#include <time.h>    /* for clock() */
+
+/* SunOS 4.1.* does not define CLOCKS_PER_SEC, so include <sys/param.h> */
+/* to get the HZ macro which is the equivalent.                         */
+#if defined(__sun__) && !defined(SVR4) && !defined(__SVR4)
+#include <sys/param.h>
+#define CLOCKS_PER_SEC HZ
+#endif
+
+static int  depth = 0;
+
+static NV_Renderer   renderer;
+static NV_Painter    painter;
+static NV_Pixmap     target;
+static NV_Error      error;
+static NV_Memory     memory;
+static NVV_Display   display;
+static NVV_Surface   surface;
+
+static FT_Library    freetype;
+static FT_Face       face;
+
+
+static  NV_Pos        glyph_scale;
+static  NV_Pos        glyph_org_x;
+static  NV_Pos        glyph_org_y;
+static  NV_Transform  glyph_transform;  /* font units -> device pixels */
+static  NV_Transform  size_transform;   /* subpixels  -> device pixels */
+
+static  NV_Scale      grid_scale = 1.0;
+
+static  int   glyph_index;
+static  int   pixel_size = 12;
+static  int   option_show_axis   = 1;
+static  int   option_show_dots   = 1;
+static  int   option_show_stroke = 1;
+static  int   option_show_glyph  = 1;
+static  int   option_show_grid   = 1;
+static  int   option_show_em     = 0;
+
+static  int   option_hinting = 1;
+
+#define  AXIS_COLOR        0xFFFF0000
+#define  GRID_COLOR        0xFFD0D0D0
+#define  ON_COLOR          0xFFFF2000
+#define  OFF_COLOR         0xFFFF0080
+#define  BACKGROUND_COLOR  0xFFFFFFFF
+#define  TEXT_COLOR        0xFF000000
+#define  EM_COLOR          0x80008000
+
+/* print message and abort program */
+static void
+Panic( const char*  message )
+{
+  fprintf( stderr, "PANIC: %s\n", message );
+  exit(1);
+}
+
+
+
+static void
+reset_scale( NV_Scale  scale )
+{ 
+ /* compute font units -> grid pixels scale factor */
+  glyph_scale = target->width*0.75 / face->units_per_EM * scale;
+ 
+ /* setup font units -> grid pixels transform */
+  nv_transform_set_scale( &glyph_transform, glyph_scale, -glyph_scale );
+  glyph_org_x = glyph_transform.delta.x = target->width*0.125;
+  glyph_org_y = glyph_transform.delta.y = target->height*0.875;
+ 
+ /* setup subpixels -> grid pixels transform */
+  nv_transform_set_scale( &size_transform,
+                            glyph_scale/nv_fromfixed(face->size->metrics.x_scale),
+                          - glyph_scale/nv_fromfixed(face->size->metrics.y_scale) );
+
+  size_transform.delta = glyph_transform.delta;
+}
+           
+           
+static void
+reset_size( int  pixel_size, NV_Scale  scale )
+{
+  FT_Set_Pixel_Sizes( face, pixel_size, pixel_size );
+  reset_scale( scale );
+}
+
+
+static void
+clear_background( void )
+{
+  nv_pixmap_fill_rect( target, 0, 0, target->width, target->height,
+                       BACKGROUND_COLOR );
+}
+
+
+static void
+draw_grid( void )
+{
+  int  x = (int)glyph_org_x;
+  int  y = (int)glyph_org_y;
+
+  /* draw grid */
+  if ( option_show_grid )
+  {
+    NV_Scale  min, max, x, step;
+    
+    /* draw vertical grid bars */
+    step = 64. * size_transform.matrix.xx;
+    if (step > 1.)
+    {
+      min  = max = glyph_org_x;
+      while ( min - step >= 0 )             min -= step;
+      while ( max + step < target->width )  max += step;
+        
+      for ( x = min; x <= max; x += step )
+        nv_pixmap_fill_rect( target, (NV_Int)(x+.5), 0,
+                             1, target->height, GRID_COLOR );
+    }
+                                
+    /* draw horizontal grid bars */
+    step = -64. * size_transform.matrix.yy;
+    if (step > 1.)
+    {
+      min  = max = glyph_org_y;
+      while ( min - step >= 0 )              min -= step;
+      while ( max + step < target->height )  max += step;
+        
+      for ( x = min; x <= max; x += step )
+        nv_pixmap_fill_rect( target, 0, (NV_Int)(x+.5),
+                             target->width, 1, GRID_COLOR );
+    }
+  }  
+  
+  /* draw axis */
+  if ( option_show_axis )
+  {
+    nv_pixmap_fill_rect( target, x, 0, 1, target->height, AXIS_COLOR );
+    nv_pixmap_fill_rect( target, 0, y, target->width, 1, AXIS_COLOR );
+  }
+  
+  if ( option_show_em )
+  {
+    NV_Path  path;
+    NV_Path  stroke;
+    NV_UInt  units = (NV_UInt)face->units_per_EM;
+    
+    nv_path_new_rectangle( renderer, 0, 0, units, units, 0, 0, &path );
+    nv_path_transform( path, &glyph_transform );
+    
+    nv_path_stroke( path, 1.5, nv_path_linecap_butt, nv_path_linejoin_miter,
+                    4.0, &stroke );
+
+    nv_painter_set_color( painter, EM_COLOR, 256 );
+    nv_painter_fill_path( painter, NULL, 0, stroke );
+
+    nv_path_destroy( stroke );
+    nv_path_destroy( path );
+  }
+
+}
+
+
+static void
+draw_glyph( int  glyph_index )
+{
+  NV_Path   path;
+  NV_Scale  scale;
+
+  error = FT_Load_Glyph( face, glyph_index, option_hinting
+                                          ? FT_LOAD_NO_BITMAP
+                                          : FT_LOAD_NO_BITMAP | FT_LOAD_NO_HINTING );
+  if (error) Panic( "could not load glyph" );
+  
+  if ( face->glyph->format != ft_glyph_format_outline )
+    Panic( "could not load glyph outline" );
+  
+  error = nv_path_new_from_outline( renderer,
+                                    (NV_Outline*)&face->glyph->outline,
+                                    &size_transform,
+                                    &path );
+  if (error) Panic( "could not create glyph path" );
+  
+  /* tracé du glyphe plein */
+  if ( option_show_glyph )
+  {
+    nv_painter_set_color ( painter, 0xFF404080, 128 );
+    nv_painter_fill_path ( painter, 0, 0, path );
+  }
+
+  if ( option_show_stroke )
+  {
+    NV_Path   stroke;
+    
+    error = nv_path_stroke( path, 0.6,
+                            nv_path_linecap_butt,
+                            nv_path_linejoin_miter,
+                            1.0, &stroke );
+    if (error) Panic( "could not stroke glyph path" );
+  
+    nv_painter_set_color ( painter, 0xFF000040, 256 );
+    nv_painter_fill_path ( painter, 0, 0, stroke );
+  
+    nv_path_destroy( stroke );
+  }
+
+  /* tracé des points de controle */
+  if ( option_show_dots )
+  {
+    NV_Path     plot;
+    NV_Outline  out;
+    NV_Scale    r = 2;
+    NV_Int      n, first, last;
+
+    nv_path_new_circle( renderer, 0, 0, 2., &plot );
+    nv_path_get_outline( path, NULL, memory, &out );
+    
+    first = 0;
+    for ( n = 0; n < out.n_contours; n++ )
+    {
+      int            m;
+      NV_Transform   trans;
+      NV_Color       color;
+      NV_SubVector*  vec;
+      
+      last  = out.contours[n];
+      
+      for ( m = first; m <= last; m++ )
+      {
+        color = (out.tags[m] & FT_Curve_Tag_On)
+              ? ON_COLOR
+              : OFF_COLOR;
+              
+        vec = out.points + m;
+
+        nv_transform_set_translate( &trans, vec->x/64.0, vec->y/64.0 );        
+        nv_painter_set_color( painter, color, 256 );
+        nv_painter_fill_path( painter, &trans, 0, plot );
+      }
+      
+      first = last + 1;
+    }
+
+    nv_path_destroy( plot );
+  }
+
+  nv_path_destroy( path );
+  
+  /* autre infos */
+  {
+    char  temp[1024];
+    char  temp2[64];
+    
+    sprintf( temp, "font name : %s (%s)", face->family_name, face->style_name );
+    nv_pixmap_cell_text( target, 0, 0, temp, TEXT_COLOR );
+    
+    FT_Get_Glyph_Name( face, glyph_index, temp2, 63 );
+    temp2[63] = 0;
+    
+    sprintf( temp, "glyph %4d: %s", glyph_index, temp2 );
+    nv_pixmap_cell_text( target, 0, 8, temp, TEXT_COLOR );
+  }
+}
+
+
+static void
+handle_event( NVV_EventRec*   ev )
+{
+  switch (ev->key)
+  {
+    case NVV_Key_Left:
+      {
+        if ( glyph_index > 0 )
+          glyph_index--;
+        break;
+      }
+
+    case NVV_Key_Right:
+      {
+        if ( glyph_index+1 < face->num_glyphs )
+          glyph_index++;
+        break;
+      }
+
+    case NVV_KEY('a'):
+      {
+        option_show_axis = !option_show_axis;
+        break;
+      }
+
+    case NVV_KEY('s'):
+      {
+        option_show_stroke = !option_show_stroke;
+        break;
+      }
+    
+    case NVV_KEY('g'):
+      {
+        option_show_glyph = !option_show_glyph;
+        break;
+      }
+      
+    case NVV_KEY('d'):
+      {
+        option_show_dots = !option_show_dots;
+        break;
+      }
+      
+    case NVV_KEY('e'):
+      {
+        option_show_em = !option_show_em;
+        break;
+      }
+    
+    case NVV_KEY('+'):
+      {
+        grid_scale *= 1.2;
+        reset_scale( grid_scale );
+        break;
+      }
+      
+    case NVV_KEY('-'):
+      {
+        if (grid_scale > 0.3)
+        {
+          grid_scale /= 1.2;
+          reset_scale( grid_scale );
+        }
+        break;
+      }
+
+    case NVV_Key_Up:
+      {
+        pixel_size++;
+        reset_size( pixel_size, grid_scale );
+        break;
+      }
+
+    case NVV_Key_Down:
+      {
+        if (pixel_size > 1)
+        {
+          pixel_size--;
+          reset_size( pixel_size, grid_scale );
+        }
+        break;
+      }
+
+
+    case NVV_KEY('h'):
+      {
+        option_hinting = !option_hinting;
+        break;
+      }      
+  }
+}
+
+
+int  main( int  argc, char**  argv )
+{
+  /* create library */
+  error = nv_renderer_new( 0, &renderer );
+  if (error) Panic( "could not create Nirvana renderer" );
+  
+  memory = nv_renderer_get_memory( renderer );
+
+  error = nvv_display_new( renderer, &display );
+  if (error) Panic( "could not create display" );
+  
+  error = nvv_surface_new( display, 400, 400, nv_pixmap_type_argb, &surface );
+  if (error) Panic( "could not create surface" );
+
+  target = nvv_surface_get_pixmap( surface );
+
+  error = nv_painter_new( renderer, &painter );
+  if (error) Panic( "could not create painter" );
+  
+  nv_painter_set_target( painter, target );
+  
+  clear_background();
+
+  error = FT_Init_FreeType( &freetype );
+  if (error) Panic( "could not initialise FreeType" );
+  
+  error = FT_New_Face( freetype, "c:/winnt/fonts/times.ttf", 0, &face );
+  if (error) Panic( "could not open font face" );
+
+  reset_size( pixel_size, grid_scale );
+ 
+
+  nvv_surface_set_title( surface, "FreeType Glyph Viewer" );
+
+  {
+    NVV_EventRec  event;
+
+    glyph_index = 0;    
+    for ( ;; )
+    {
+      clear_background();
+      draw_grid();
+      draw_glyph( glyph_index );
+      nvv_surface_refresh( surface, NULL );
+
+      nvv_surface_listen( surface, 0, &event );
+      if ( event.key == NVV_Key_Esc )
+        break;
+        
+      handle_event( &event );
+      switch (event.key)
+      {
+        case NVV_Key_Esc:
+          goto Exit;
+          
+        default:
+          ;
+      }
+    }
+  }
+ 
+ Exit:
+  /* wait for escape */
+      
+  
+  /* destroy display (and surface) */
+  nvv_display_unref( display );
+  nv_renderer_unref( renderer );
+
+  return 0;
+}