1939 |
/* first face has index 0. */ |
/* first face has index 0. */ |
1940 |
/* */ |
/* */ |
1941 |
/* <Output> */ |
/* <Output> */ |
1942 |
/* aface :: A handle to a new face object. */ |
/* aface :: A handle to a new face object. If `face_index' is */ |
1943 |
|
/* greater than or equal to zero, it must be non-NULL. */ |
1944 |
|
/* See note below. */ |
1945 |
/* */ |
/* */ |
1946 |
/* <Return> */ |
/* <Return> */ |
1947 |
/* FreeType error code. 0 means success. */ |
/* FreeType error code. 0 means success. */ |
1951 |
/* slot for the face object which can be accessed directly through */ |
/* slot for the face object which can be accessed directly through */ |
1952 |
/* `face->glyph'. */ |
/* `face->glyph'. */ |
1953 |
/* */ |
/* */ |
1954 |
/* @FT_Open_Face can be used to determine and/or check the font */ |
/* @FT_Open_Face can be used to quickly check whether the font format */ |
1955 |
/* format of a given font resource. If the `face_index' field is */ |
/* of a given font resource is supported by FreeType. If the */ |
1956 |
/* negative, the function does _not_ return any face handle in */ |
/* `face_index' field is negative, the function returns a more or */ |
1957 |
/* `*aface'; the function's return value is 0 if the font format is */ |
/* less empty face handle in `*aface' (if `aface' isn't NULL); the */ |
1958 |
/* recognized, or non-zero otherwise. */ |
/* function's return value is 0 if the font format is recognized, or */ |
1959 |
|
/* non-zero otherwise. The only useful field in this special case is */ |
1960 |
|
/* `face->num_faces' which gives the number of faces within the font */ |
1961 |
|
/* file. After examination, the returned @FT_Face structure should */ |
1962 |
|
/* be deallocated with a call to @FT_Done_Face. */ |
1963 |
/* */ |
/* */ |
1964 |
FT_EXPORT( FT_Error ) |
FT_EXPORT( FT_Error ) |
1965 |
FT_Open_Face( FT_Library library, |
FT_Open_Face( FT_Library library, |