summaryrefslogtreecommitdiff
path: root/tests/make_png/README
blob: 91c4d340dfc15c72b6f319feb6874f17a0bfa436 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
INSTRUCTIONS

NOTE: One version of FreeType is referred as "base" version and the
      other as the "test" version.

  1. Get the two versions ready
  -------------------------------------

    Download an older version of FreeType (For example : 2.6.5)
    ( This being the "base" version of the two)
    Go to 'include/freetype/ftoption.h' and uncomment this line

        #define FT_CONFIG_OPTION_SUBPIXEL_RENDERING
  
  2. Compile the two versions 
  -------------------------------------     
   Go to the "base" version's folder and compile the library.

      ./configure --enable-shared --disable-static
      make

    Repeat step 2. for the "test" version as well.

 3. Compile the code
  -------------------------------------     
    Return to this folder and make the binary

      make tests

 4. Run the executable
  ------------------------------------- 

    => Set resolution in DPI by passing argument to variable FT_TEST_DPI.

    => Set the Rendering mode by passing FT_TEST_RENDER_MODE.
       FT_TEST_RENDER_MODE can take values 1. MONO
                             2. AA
                             3. RGB
                             4. BGR
                             5. VRGB
                             6. VBGR

    => Set the variables FT_TEST_BASE_DLL and FT_TEST_TEST_DLL to
       point to the libfreetype.so file of the base and the test
       versions respectively.

       By default, the folders '$(HOME)/base/' and '$(HOME)/test/'
       folders are set for FT_TEST_BASE_DIR and FT_TEST_TEST_DIR
       respectively. If FT_TEST_XXX_DLL isn't defined, these values
       are taken to search for DLL files.

    => Set FT_TEST_FONT_FILE to the path to font files needed.

    => set FT_TEST_PT_SIZE as a number to denote the font size.

    EXAMPLE:    FT_TEST_BASE_DIR=/home/wl/kushal/base \
          FT_TEST_TEST_DIR=/home/wl/kushal/test \
          FT_TEST_DPI="72 96" \
          FT_TEST_FONT_FILE="test.ttf" \
          FT_TEST_RENDER_MODE="AA RGB" \
          FT_TEST_PT_SIZE="16 20" \
          ./runme.sh
    ( The values in the above example denote the default values
    for the variables )

  Open ./html/top.html for the web interface.
---------------------------------------------------------------------

FEATURES

  Creates an interactive web interface to visualize glyphs.
  (html/top.html)

  View lists of glyphs in tables in the left iFrame accessed by
  selecting values from the drop-box.

  By clicking on the Headers of the respective columns,they can be
  arranged (in increasing/decreasing order) based on
    ->  Glyph-Index
    ->  Name
    ->  Difference Metric

  When clicked on any image in the table, a detailed visualization
  page for the glyph is shown in the right iFrame.

  Click on the Buttons below the iframe for the animations.

  To be Added ...