[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[freetype2] master c90cc64: ftbitmap.h: Improve documentation.
From: |
Werner LEMBERG |
Subject: |
[freetype2] master c90cc64: ftbitmap.h: Improve documentation. |
Date: |
Thu, 23 Aug 2018 07:13:43 -0400 (EDT) |
branch: master
commit c90cc6443b2dc597aac64ae4a4bc45b1d5ca45d2
Author: Werner Lemberg <address@hidden>
Commit: Werner Lemberg <address@hidden>
ftbitmap.h: Improve documentation.
---
include/freetype/ftbitmap.h | 20 ++++++++++++++++++--
1 file changed, 18 insertions(+), 2 deletions(-)
diff --git a/include/freetype/ftbitmap.h b/include/freetype/ftbitmap.h
index c9370af..3d195cd 100644
--- a/include/freetype/ftbitmap.h
+++ b/include/freetype/ftbitmap.h
@@ -46,10 +46,16 @@ FT_BEGIN_HEADER
* Handling FT_Bitmap objects.
*
* @description:
- * This section contains functions for handling @FT_Bitmap objects.
+ * This section contains functions for handling @FT_Bitmap objects,
+ * automatically adjusting the target's bitmap buffer size as needed.
+ *
* Note that none of the functions changes the bitmap's `flow' (as
- * indicated by the sign of the `pitch' field in `FT_Bitmap').
+ * indicated by the sign of the `pitch' field in @FT_Bitmap).
*
+ * To set the flow, assign an appropriate positive or negative value to
+ * the `pitch' field of the target @FT_Bitmap object after calling
+ * @FT_Bitmap_Init but before calling any of the other functions
+ * described here.
*/
@@ -98,6 +104,10 @@ FT_BEGIN_HEADER
*
* @return:
* FreeType error code. 0~means success.
+ *
+ * @note:
+ * `source->buffer' and `target->buffer' must neither be equal nor
+ * overlap.
*/
FT_EXPORT( FT_Error )
FT_Bitmap_Copy( FT_Library library,
@@ -187,6 +197,9 @@ FT_BEGIN_HEADER
*
* The `library' argument is taken to have access to FreeType's
* memory handling functions.
+ *
+ * `source->buffer' and `target->buffer' must neither be equal nor
+ * overlap.
*/
FT_EXPORT( FT_Error )
FT_Bitmap_Convert( FT_Library library,
@@ -241,6 +254,9 @@ FT_BEGIN_HEADER
* `4~*~width'. Both `source' and `target' must have the same bitmap
* flow (as indicated by the sign of the `pitch' field).
*
+ * `source->buffer' and `target->buffer' must neither be equal nor
+ * overlap.
+ *
* @since:
* 2.10
*/
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [freetype2] master c90cc64: ftbitmap.h: Improve documentation.,
Werner LEMBERG <=