/[freetype]/freetype2/include/freetype/freetype.h
ViewVC logotype

Diff of /freetype2/include/freetype/freetype.h

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.164 by wl, Fri Nov 4 06:58:48 2005 UTC revision 1.165 by wl, Fri Nov 4 11:33:32 2005 UTC
# Line 1842  FT_BEGIN_HEADER Line 1842  FT_BEGIN_HEADER
1842    /*                  first face has index 0.                              */    /*                  first face has index 0.                              */
1843    /*                                                                       */    /*                                                                       */
1844    /* <Output>                                                              */    /* <Output>                                                              */
1845    /*    aface      :: A handle to a new face object.                       */    /*    aface      :: A handle to a new face object.  If `face_index' is   */
1846      /*                  greater than or equal to zero, it must be non-NULL.  */
1847      /*                  See note below.                                      */
1848    /*                                                                       */    /*                                                                       */
1849    /* <Return>                                                              */    /* <Return>                                                              */
1850    /*    FreeType error code.  0 means success.                             */    /*    FreeType error code.  0 means success.                             */
# Line 1852  FT_BEGIN_HEADER Line 1854  FT_BEGIN_HEADER
1854    /*    slot for the face object which can be accessed directly through    */    /*    slot for the face object which can be accessed directly through    */
1855    /*    `face->glyph'.                                                     */    /*    `face->glyph'.                                                     */
1856    /*                                                                       */    /*                                                                       */
1857    /*    @FT_New_Face can be used to determine and/or check the font format */    /*    @FT_New_Face can be used to quickly check whether the font         */
1858    /*    of a given font resource.  If the `face_index' field is negative,  */    /*    format  of a given font resource is supported by FreeType.  If the */
1859    /*    the function does _not_ return any face handle in `aface';  the    */    /*    `face_index' field is negative, the function's return value is 0   */
1860    /*    return value is 0 if the font format is recognized, or non-zero    */    /*    if the font format is recognized, or non-zero otherwise;           */
1861    /*    otherwise.                                                         */    /*    the function returns a more or less empty face handle in `*aface'  */
1862      /*    (if `aface' isn't NULL).  The only useful field in this special    */
1863      /*    case is `face->num_faces' which gives the number of faces within   */
1864      /*    the font file.  After examination, the returned @FT_Face structure */
1865      /*    should be deallocated with a call to @FT_Done_Face.                */
1866    /*                                                                       */    /*                                                                       */
1867    /*    Each new face object created with this function also owns a        */    /*    Each new face object created with this function also owns a        */
1868    /*    default @FT_Size object, accessible as `face->size'.               */    /*    default @FT_Size object, accessible as `face->size'.               */
# Line 1889  FT_BEGIN_HEADER Line 1895  FT_BEGIN_HEADER
1895    /*                  first face has index 0.                              */    /*                  first face has index 0.                              */
1896    /*                                                                       */    /*                                                                       */
1897    /* <Output>                                                              */    /* <Output>                                                              */
1898    /*    aface      :: A handle to a new face object.                       */    /*    aface      :: A handle to a new face object.  If `face_index' is   */
1899      /*                  greater than or equal to zero, it must be non-NULL.  */
1900      /*                  See note below.                                      */
1901    /*                                                                       */    /*                                                                       */
1902    /* <Return>                                                              */    /* <Return>                                                              */
1903    /*    FreeType error code.  0 means success.                             */    /*    FreeType error code.  0 means success.                             */
# Line 1904  FT_BEGIN_HEADER Line 1912  FT_BEGIN_HEADER
1912    /*    slot for the face object which can be accessed directly through    */    /*    slot for the face object which can be accessed directly through    */
1913    /*    `face->glyph'.                                                     */    /*    `face->glyph'.                                                     */
1914    /*                                                                       */    /*                                                                       */
1915    /*    @FT_New_Memory_Face can be used to determine and/or check the font */    /*    @FT_New_Memory_Face can be used to quickly check whether the font  */
1916    /*    format of a given font resource.  If the `face_index' field is     */    /*    format of a given font resource is supported by FreeType.  If the  */
1917    /*    negative, the function does _not_ return any face handle in        */    /*    `face_index' field is negative, the function's return value is 0   */
1918    /*    `aface'; the return value is 0 if the font format is recognized,   */    /*    if the font format is recognized, or non-zero otherwise;           */
1919    /*    or non-zero otherwise.                                             */    /*    the function returns a more or less empty face handle in `*aface'  */
1920      /*    (if `aface' isn't NULL).  The only useful field in this special    */
1921      /*    case is `face->num_faces' which gives the number of faces within   */
1922      /*    the font file.  After examination, the returned @FT_Face structure */
1923      /*    should be deallocated with a call to @FT_Done_Face.                */
1924    /*                                                                       */    /*                                                                       */
1925    FT_EXPORT( FT_Error )    FT_EXPORT( FT_Error )
1926    FT_New_Memory_Face( FT_Library      library,    FT_New_Memory_Face( FT_Library      library,
# Line 1951  FT_BEGIN_HEADER Line 1963  FT_BEGIN_HEADER
1963    /*    slot for the face object which can be accessed directly through    */    /*    slot for the face object which can be accessed directly through    */
1964    /*    `face->glyph'.                                                     */    /*    `face->glyph'.                                                     */
1965    /*                                                                       */    /*                                                                       */
1966    /*    @FT_Open_Face can be used to quickly check whether the font format */    /*    @FT_Open_Face can be used to quickly check whether the font        */
1967    /*    of a given font resource is supported by FreeType.  If the         */    /*    format of a given font resource is supported by FreeType.  If the  */
1968    /*    `face_index' field is negative, the function returns a more or     */    /*    `face_index' field is negative, the function's return value is 0   */
1969    /*    less empty face handle in `*aface' (if `aface' isn't NULL); the    */    /*    if the font format is recognized, or non-zero otherwise;           */
1970    /*    function's return value is 0 if the font format is recognized, or  */    /*    the function returns a more or less empty face handle in `*aface'  */
1971    /*    non-zero otherwise.  The only useful field in this special case is */    /*    (if `aface' isn't NULL).  The only useful field in this special    */
1972    /*    `face->num_faces' which gives the number of faces within the font  */    /*    case is `face->num_faces' which gives the number of faces within   */
1973    /*    file.  After examination, the returned @FT_Face structure should   */    /*    the font file.  After examination, the returned @FT_Face structure */
1974    /*    be deallocated with a call to @FT_Done_Face.                       */    /*    should be deallocated with a call to @FT_Done_Face.                */
1975    /*                                                                       */    /*                                                                       */
1976    FT_EXPORT( FT_Error )    FT_EXPORT( FT_Error )
1977    FT_Open_Face( FT_Library           library,    FT_Open_Face( FT_Library           library,

Legend:
Removed from v.1.164  
changed lines
  Added in v.1.165

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26