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. */ |
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'. */ |
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. */ |
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, |
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, |