Werner Lemberg pushed to branch master at FreeType / FreeType
Commits:
-
6d19b29f
by Werner Lemberg at 2021-09-23T08:46:01+02:00
1 changed file:
Changes:
... | ... | @@ -2099,7 +2099,8 @@ FT_BEGIN_HEADER |
2099 | 2099 |
* The size in bytes of the file in memory.
|
2100 | 2100 |
*
|
2101 | 2101 |
* pathname ::
|
2102 |
- * A pointer to an 8-bit file pathname. The pointer is not owned by
|
|
2102 |
+ * A pointer to an 8-bit file pathname, which must be a C~string (i.e.,
|
|
2103 |
+ * no NULL bytes except at the very end). The pointer is not owned by
|
|
2103 | 2104 |
* FreeType.
|
2104 | 2105 |
*
|
2105 | 2106 |
* stream ::
|
... | ... | @@ -2186,9 +2187,12 @@ FT_BEGIN_HEADER |
2186 | 2187 |
* FreeType error code. 0~means success.
|
2187 | 2188 |
*
|
2188 | 2189 |
* @note:
|
2189 |
- * The `pathname` string should be reconizable as such by a standard
|
|
2190 |
- * `fopen()` call on your system. If that is not sufficient to address
|
|
2191 |
- * all file name possiblities, you can use @FT_Open_Face.
|
|
2190 |
+ * The `pathname` string should be recognizable as such by a standard
|
|
2191 |
+ * `fopen` call on your system; in particular, this means that `pathname`
|
|
2192 |
+ * must not contain NULL bytes. If that is not sufficient to address all
|
|
2193 |
+ * file name possibilities (for example, to handle wide character file
|
|
2194 |
+ * names on Windows in UTF-16 encoding) you might use @FT_Open_Face to
|
|
2195 |
+ * pass a memory array or a stream object instead.
|
|
2192 | 2196 |
*
|
2193 | 2197 |
* Use @FT_Done_Face to destroy the created @FT_Face object (along with
|
2194 | 2198 |
* its slot and sizes).
|