The 'COLR' v1 API will no longer be experimental in the next release.

This commit is contained in:
Werner Lemberg 2023-01-19 07:16:07 +01:00
parent 0982d3ecc6
commit 82ce172669
2 changed files with 34 additions and 91 deletions

View File

@ -1,4 +1,4 @@
CHANGES BETWEEN 2.12.1 and 2.12.2 CHANGES BETWEEN 2.12.1 and 2.13
I. IMPORTANT CHANGES I. IMPORTANT CHANGES

View File

@ -456,6 +456,9 @@ FT_BEGIN_HEADER
* &iterator ) ); * &iterator ) );
* } * }
* ``` * ```
*
* @since:
* 2.10
*/ */
FT_EXPORT( FT_Bool ) FT_EXPORT( FT_Bool )
FT_Get_Color_Glyph_Layer( FT_Face face, FT_Get_Color_Glyph_Layer( FT_Face face,
@ -489,9 +492,7 @@ FT_BEGIN_HEADER
* structures. * structures.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef enum FT_PaintFormat_ typedef enum FT_PaintFormat_
{ {
@ -543,9 +544,7 @@ FT_BEGIN_HEADER
* read. Set by @FT_Get_Paint. * read. Set by @FT_Get_Paint.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_ColorStopIterator_ typedef struct FT_ColorStopIterator_
{ {
@ -576,9 +575,7 @@ FT_BEGIN_HEADER
* Alpha transparency value multiplied with the value from 'CPAL'. * Alpha transparency value multiplied with the value from 'CPAL'.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_ColorIndex_ typedef struct FT_ColorIndex_
{ {
@ -606,9 +603,7 @@ FT_BEGIN_HEADER
* The color information for this stop, see @FT_ColorIndex. * The color information for this stop, see @FT_ColorIndex.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_ColorStop_ typedef struct FT_ColorStop_
{ {
@ -629,9 +624,7 @@ FT_BEGIN_HEADER
* It describes how the gradient fill continues at the other boundaries. * It describes how the gradient fill continues at the other boundaries.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef enum FT_PaintExtend_ typedef enum FT_PaintExtend_
{ {
@ -661,9 +654,7 @@ FT_BEGIN_HEADER
* actual @FT_ColorStop's. * actual @FT_ColorStop's.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_ColorLine_ typedef struct FT_ColorLine_
{ {
@ -707,9 +698,7 @@ FT_BEGIN_HEADER
* y translation. * y translation.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_Affine_23_ typedef struct FT_Affine_23_
{ {
@ -730,9 +719,7 @@ FT_BEGIN_HEADER
* 'https://www.w3.org/TR/compositing-1/#porterduffcompositingoperators'. * 'https://www.w3.org/TR/compositing-1/#porterduffcompositingoperators'.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef enum FT_Composite_Mode_ typedef enum FT_Composite_Mode_
{ {
@ -794,9 +781,7 @@ FT_BEGIN_HEADER
* to be provided. Do not set this value. * to be provided. Do not set this value.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_Opaque_Paint_ typedef struct FT_Opaque_Paint_
{ {
@ -823,9 +808,7 @@ FT_BEGIN_HEADER
* The layer iterator that describes the layers of this paint. * The layer iterator that describes the layers of this paint.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintColrLayers_ typedef struct FT_PaintColrLayers_
{ {
@ -850,9 +833,7 @@ FT_BEGIN_HEADER
* The color information for this solid paint, see @FT_ColorIndex. * The color information for this solid paint, see @FT_ColorIndex.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintSolid_ typedef struct FT_PaintSolid_
{ {
@ -891,9 +872,7 @@ FT_BEGIN_HEADER
* Otherwise equal to~p0. * Otherwise equal to~p0.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintLinearGradient_ typedef struct FT_PaintLinearGradient_
{ {
@ -940,9 +919,7 @@ FT_BEGIN_HEADER
* units represented as a 16.16 fixed-point value. * units represented as a 16.16 fixed-point value.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintRadialGradient_ typedef struct FT_PaintRadialGradient_
{ {
@ -990,9 +967,7 @@ FT_BEGIN_HEADER
* given counter-clockwise, starting from the (positive) y~axis. * given counter-clockwise, starting from the (positive) y~axis.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintSweepGradient_ typedef struct FT_PaintSweepGradient_
{ {
@ -1023,9 +998,7 @@ FT_BEGIN_HEADER
* information that is filled with paint. * information that is filled with paint.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintGlyph_ typedef struct FT_PaintGlyph_
{ {
@ -1049,9 +1022,7 @@ FT_BEGIN_HEADER
* this paint. * this paint.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintColrGlyph_ typedef struct FT_PaintColrGlyph_
{ {
@ -1077,9 +1048,7 @@ FT_BEGIN_HEADER
* 16.16 fixed-point values. * 16.16 fixed-point values.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintTransform_ typedef struct FT_PaintTransform_
{ {
@ -1112,9 +1081,7 @@ FT_BEGIN_HEADER
* 16.16 fixed-point value. * 16.16 fixed-point value.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintTranslate_ typedef struct FT_PaintTranslate_
{ {
@ -1163,9 +1130,7 @@ FT_BEGIN_HEADER
* 16.16 fixed-point value. * 16.16 fixed-point value.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward-compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintScale_ typedef struct FT_PaintScale_
{ {
@ -1208,9 +1173,7 @@ FT_BEGIN_HEADER
* units represented as a 16.16 fixed-point value. * units represented as a 16.16 fixed-point value.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintRotate_ typedef struct FT_PaintRotate_
@ -1259,9 +1222,7 @@ FT_BEGIN_HEADER
* represented as a 16.16 fixed-point value. * represented as a 16.16 fixed-point value.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintSkew_ typedef struct FT_PaintSkew_
{ {
@ -1299,9 +1260,7 @@ FT_BEGIN_HEADER
* `source_paint` is composited onto. * `source_paint` is composited onto.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_PaintComposite_ typedef struct FT_PaintComposite_
{ {
@ -1345,9 +1304,7 @@ FT_BEGIN_HEADER
* * @FT_PaintColrGlyph * * @FT_PaintColrGlyph
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_COLR_Paint_ typedef struct FT_COLR_Paint_
{ {
@ -1392,9 +1349,7 @@ FT_BEGIN_HEADER
* Do not output an initial root transform. * Do not output an initial root transform.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef enum FT_Color_Root_Transform_ typedef enum FT_Color_Root_Transform_
{ {
@ -1435,9 +1390,7 @@ FT_BEGIN_HEADER
* fixed-point coordinates in 26.6 format. * fixed-point coordinates in 26.6 format.
* *
* @since: * @since:
* 2.12 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
typedef struct FT_ClipBox_ typedef struct FT_ClipBox_
{ {
@ -1530,9 +1483,7 @@ FT_BEGIN_HEADER
* error, value~0 is returned also. * error, value~0 is returned also.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
FT_EXPORT( FT_Bool ) FT_EXPORT( FT_Bool )
FT_Get_Color_Glyph_Paint( FT_Face face, FT_Get_Color_Glyph_Paint( FT_Face face,
@ -1574,9 +1525,7 @@ FT_BEGIN_HEADER
* and remove transforms configured using @FT_Set_Transform. * and remove transforms configured using @FT_Set_Transform.
* *
* @since: * @since:
* 2.12 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
FT_EXPORT( FT_Bool ) FT_EXPORT( FT_Bool )
FT_Get_Color_Glyph_ClipBox( FT_Face face, FT_Get_Color_Glyph_ClipBox( FT_Face face,
@ -1623,9 +1572,7 @@ FT_BEGIN_HEADER
* object can not be retrieved or any other error occurs. * object can not be retrieved or any other error occurs.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
FT_EXPORT( FT_Bool ) FT_EXPORT( FT_Bool )
FT_Get_Paint_Layers( FT_Face face, FT_Get_Paint_Layers( FT_Face face,
@ -1666,9 +1613,7 @@ FT_BEGIN_HEADER
* also. * also.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
FT_EXPORT( FT_Bool ) FT_EXPORT( FT_Bool )
FT_Get_Colorline_Stops( FT_Face face, FT_Get_Colorline_Stops( FT_Face face,
@ -1704,9 +1649,7 @@ FT_BEGIN_HEADER
* this paint or any other error occured. * this paint or any other error occured.
* *
* @since: * @since:
* 2.11 -- **currently experimental only!** There might be changes * 2.13
* without retaining backward compatibility of both the API and ABI.
*
*/ */
FT_EXPORT( FT_Bool ) FT_EXPORT( FT_Bool )
FT_Get_Paint( FT_Face face, FT_Get_Paint( FT_Face face,