diff options
Diffstat (limited to 'freetype2/docs/tutorial/step1.html')
-rw-r--r-- | freetype2/docs/tutorial/step1.html | 52 |
1 files changed, 26 insertions, 26 deletions
diff --git a/freetype2/docs/tutorial/step1.html b/freetype2/docs/tutorial/step1.html index ed1b54c..79f8fbd 100644 --- a/freetype2/docs/tutorial/step1.html +++ b/freetype2/docs/tutorial/step1.html @@ -116,7 +116,7 @@ pkg-config --cflags freetype2</pre> header files of the FreeType 2 API.</p> <p>You can - read <a href="../reference/site/ft2-header_file_macros.html">this + read <a href="../reference/ft2-header_file_macros.html">this section of the FreeType 2 API Reference</a> for a complete listing of the header macros.</p> </li> @@ -144,9 +144,9 @@ pkg-config --cflags freetype2</pre> <h3 id="section-2">2. Library Initialization</h3> <p>To initialize the FreeType library, create a variable of - type <a href="../reference/site/ft2-base_interface.html#ft_library"><code>FT_Library</code></a> + type <a href="../reference/ft2-base_interface.html#ft_library"><code>FT_Library</code></a> named, for example, <code>library</code>, and call the - function <a href="../reference/site/ft2-base_interface.html#ft_init_freetype"><code>FT_Init_FreeType</code></a>.</p> + function <a href="../reference/ft2-base_interface.html#ft_init_freetype"><code>FT_Init_FreeType</code></a>.</p> <pre> #include <ft2build.h> @@ -192,7 +192,7 @@ if ( error ) <h4>a. From a Font File</h4> <p>Create a new <code>face</code> object by - calling <a href="../reference/site/ft2-base_interface.html#ft_new_face"><code>FT_New_Face</code></a>. + calling <a href="../reference/ft2-base_interface.html#ft_new_face"><code>FT_New_Face</code></a>. A <em>face</em> describes a given typeface and style. For example, ‘Times New Roman Regular’ and ‘Times New Roman Italic’ correspond to two @@ -264,7 +264,7 @@ else if ( error ) <p>In the case where you have already loaded the font file into memory, you can similarly create a new face object for it by - calling <a href="../reference/site/ft2-base_interface.html#ft_new_memory_face"><code>FT_New_Memory_Face</code></a>.</p> + calling <a href="../reference/ft2-base_interface.html#ft_new_memory_face"><code>FT_New_Memory_Face</code></a>.</p> <pre> FT_Library library; <span class="comment">/* handle to library */</span> @@ -289,7 +289,7 @@ if ( error ) { ... }</pre> <p>Note that you must not deallocate the font file buffer before calling - <a href="../reference/site/ft2-base_interface.html#ft_done_face"><code>FT_Done_Face</code></a>.</p> + <a href="../reference/ft2-base_interface.html#ft_done_face"><code>FT_Done_Face</code></a>.</p> <h4>c. From Other Sources (Compressed Files, Network, etc.)</h4> @@ -300,12 +300,12 @@ if ( error ) { ... }</pre> implementation of I/O routines.</p> <p>This is done through - the <a href="../reference/site/ft2-base_interface.html#ft_open_face"><code>FT_Open_Face</code></a> + the <a href="../reference/ft2-base_interface.html#ft_open_face"><code>FT_Open_Face</code></a> function, which can be used to open a new font face with a custom input stream, select a specific driver for opening, or even pass extra parameters to the font driver when creating the object. We advise you to look up - the <a href="../reference/site/index.html">FreeType 2 + the <a href="../reference/index.html">FreeType 2 reference manual</a> in order to learn how to use it.</p> @@ -317,7 +317,7 @@ if ( error ) { ... }</pre> in <code>face−>num_glyphs</code>.</p> <p>The complete list of available fields is in - the <a href="../reference/site/ft2-base_interface.html#ft_facerec"><code>FT_FaceRec</code></a> + the <a href="../reference/ft2-base_interface.html#ft_facerec"><code>FT_FaceRec</code></a> structure description. However, we describe here a few of them in more detail.</p> @@ -335,7 +335,7 @@ if ( error ) { ... }</pre> face's font format is scalable and that glyph images can be rendered for all character pixel sizes. For more information on face flags, please read - the <a href="../reference/site/ft2-base_interface.html#ft_face_flag_xxx">FreeType 2 + the <a href="../reference/ft2-base_interface.html#ft_face_flag_xxx">FreeType 2 API Reference</a>.</dd> <dt>units_per_EM</dt> @@ -354,7 +354,7 @@ if ( error ) { ... }</pre> <dt>available_sizes</dt> <dd> <p>A pointer to an array - of <a href="../reference/site/ft2-base_interface.html#ft_bitmap_size"><code>FT_Bitmap_Size</code></a> + of <a href="../reference/ft2-base_interface.html#ft_bitmap_size"><code>FT_Bitmap_Size</code></a> elements. Each <code>FT_Bitmap_Size</code> indicates the horizontal and vertical <em>character pixel sizes</em> for each of the strikes that are present in @@ -392,7 +392,7 @@ if ( error ) { ... }</pre> <p>When a new face object is created, all elements are set to 0 during initialization. To populate the structure with sensible values, you should - call <a href="../reference/site/ft2-base_interface.html#ft_set_char_size"><code>FT_Set_Char_Size</code></a>. + call <a href="../reference/ft2-base_interface.html#ft_set_char_size"><code>FT_Set_Char_Size</code></a>. Here is an example, setting the character size to 16pt for a 300×300dpi device:</p> @@ -442,7 +442,7 @@ error = FT_Set_Char_Size( <p>If you want to specify the (integer) pixel sizes yourself, you can call - <a href="../reference/site/ft2-base_interface.html#ft_set_pixel_sizes"><code>FT_Set_Pixel_Sizes</code></a>.</p> + <a href="../reference/ft2-base_interface.html#ft_set_pixel_sizes"><code>FT_Set_Pixel_Sizes</code></a>.</p> <pre> error = FT_Set_Pixel_Sizes( @@ -503,7 +503,7 @@ error = FT_Set_Pixel_Sizes( contains at least a Unicode charmap that was selected during a call to <code>FT_New_Face</code>. To convert a Unicode character code to a font glyph index, we use - <a href="../reference/site/ft2-base_interface.html#ft_get_char_index"><code>FT_Get_Char_Index</code></a>.</p> + <a href="../reference/ft2-base_interface.html#ft_get_char_index"><code>FT_Get_Char_Index</code></a>.</p> <pre> glyph_index = FT_Get_Char_Index( face, charcode );</pre> @@ -546,11 +546,11 @@ glyph_index = FT_Get_Char_Index( face, charcode );</pre> face object has a single glyph slot object that can be accessed as <code>face->glyph</code>. Its fields are explained by - the <a href="../reference/site/ft2-base_interface.html#ft_glyphslotrec"><code>FT_GlyphSlotRec</code></a> + the <a href="../reference/ft2-base_interface.html#ft_glyphslotrec"><code>FT_GlyphSlotRec</code></a> structure documentation.</p> <p>Loading a glyph image into the slot is performed by - calling <a href="../reference/site/ft2-base_interface.html#ft_load_glyph"><code>FT_Load_Glyph</code></a>.</p> + calling <a href="../reference/ft2-base_interface.html#ft_load_glyph"><code>FT_Load_Glyph</code></a>.</p> <pre> error = FT_Load_Glyph( @@ -585,7 +585,7 @@ error = FT_Load_Glyph( the slot. If it is not <code>FT_GLYPH_FORMAT_BITMAP</code>, one can immediately convert it to a bitmap - through <a href="../reference/site/ft2-base_interface.html#ft_render_glyph"><code>FT_Render_Glyph</code></a>.</p> + through <a href="../reference/ft2-base_interface.html#ft_render_glyph"><code>FT_Render_Glyph</code></a>.</p> <pre> error = FT_Render_Glyph( face->glyph, <span class="comment">/* glyph slot */</span> @@ -599,7 +599,7 @@ error = FT_Render_Glyph( face->glyph, <span class="comment">/* glyph slot can alternatively use <code>FT_RENDER_MODE_MONO</code> if you want to generate a 1-bit monochrome bitmap. More values are available for - the <a href="../reference/site/ft2-base_interface.html#ft_render_mode"><code>FT_Render_Mode</code></a> + the <a href="../reference/ft2-base_interface.html#ft_render_mode"><code>FT_Render_Mode</code></a> enumeration value.</p> <p>Once you have a bitmapped glyph image, you can access it @@ -635,7 +635,7 @@ error = FT_Render_Glyph( face->glyph, <span class="comment">/* glyph slot in <code>FT_FREETYPE_H</code>, for example <code>FT_ENCODING_BIG5</code>. In this case, you can call - <a href="../reference/site/ft2-base_interface.html#ft_select_charmap"><code>FT_Select_Charmap</code></a>.</p> + <a href="../reference/ft2-base_interface.html#ft_select_charmap"><code>FT_Select_Charmap</code></a>.</p> <pre> error = FT_Select_Charmap( @@ -693,14 +693,14 @@ if ( error ) { ... }</pre> <p>Once a charmap has been selected, either through <code>FT_Select_Charmap</code> - or <a href="../reference/site/ft2-base_interface.html#ft_set_charmap"><code>FT_Set_Charmap</code></a>, + or <a href="../reference/ft2-base_interface.html#ft_set_charmap"><code>FT_Set_Charmap</code></a>, it is used by all subsequent calls to <code>FT_Get_Char_Index</code>.</p> <h4>d. Glyph Transformations</h4> <p>It is possible to specify an affine transformation with - <a href="../reference/site/ft2-base_interface.html#ft_set_transform"><code>FT_Set_Transform</code></a>, + <a href="../reference/ft2-base_interface.html#ft_set_transform"><code>FT_Set_Transform</code></a>, to be applied to glyph images when they are loaded. Of course, this only works for scalable (vectorial) font formats.</p> @@ -713,10 +713,10 @@ error = FT_Set_Transform( <p>This function sets the current transformation for a given face object. Its second parameter is a pointer to an - <a href="../reference/site/ft2-basic_types.html#ft_matrix"><code>FT_Matrix</code></a> + <a href="../reference/ft2-basic_types.html#ft_matrix"><code>FT_Matrix</code></a> structure that describes a 2×2 affine matrix. The third parameter is a pointer to - an <a href="../reference/site/ft2-basic_types.html#ft_vector"><code>FT_Vector</code></a> + an <a href="../reference/ft2-basic_types.html#ft_vector"><code>FT_Vector</code></a> structure, describing a two-dimensional vector that translates the glyph image <em>after</em> the 2×2 transformation.</p> @@ -814,7 +814,7 @@ for ( n = 0; n < num_chars; n++ ) <ul> <li>We define a handle named <code>slot</code> that points to the face object's glyph slot. (The - type <a href="../reference/site/ft2-base_interface.html#ft_glyphslot"><code>FT_GlyphSlot</code></a> + type <a href="../reference/ft2-base_interface.html#ft_glyphslot"><code>FT_GlyphSlot</code></a> is a pointer). That is a convenience to avoid using <code>face->glyph->XXX</code> every time.</li> @@ -829,7 +829,7 @@ for ( n = 0; n < num_chars; n++ ) of FreeType but must be provided by the application to draw the bitmap to the target surface. In this example, it takes a pointer to - an <a href="../reference/site/ft2-basic_types.html#ft_bitmap"><code>FT_Bitmap</code></a> + an <a href="../reference/ft2-basic_types.html#ft_bitmap"><code>FT_Bitmap</code></a> descriptor and the position of its top-left corner as arguments. For ideal rendering on a screen this function should perform linear blending with gamma @@ -885,7 +885,7 @@ for ( n = 0; n < num_chars; n++ ) <ul> <li>We use the - function <a href="../reference/site/ft2-base_interface.html#ft_load_char"><code>FT_Load_Char</code></a> + function <a href="../reference/ft2-base_interface.html#ft_load_char"><code>FT_Load_Char</code></a> instead of <code>FT_Load_Glyph</code>. As you probably imagine, it is equivalent to calling <code>FT_Get_Char_Index</code>, then |