From 360fe27b55c93c9c6c86895dbbf5db3efc66cc43 Mon Sep 17 00:00:00 2001 From: Mike DePaulo Date: Sat, 28 Feb 2015 07:31:25 -0500 Subject: Updated to freetype 2.5.5 Conflicts: freetype/src/base/ftbdf.c freetype/src/base/fttype1.c freetype/src/pfr/pfrobjs.c --- freetype/docs/reference/ft2-ot_validation.html | 313 ++++++++++++++----------- 1 file changed, 176 insertions(+), 137 deletions(-) (limited to 'freetype/docs/reference/ft2-ot_validation.html') diff --git a/freetype/docs/reference/ft2-ot_validation.html b/freetype/docs/reference/ft2-ot_validation.html index 1d9be98de..a4988e183 100644 --- a/freetype/docs/reference/ft2-ot_validation.html +++ b/freetype/docs/reference/ft2-ot_validation.html @@ -3,115 +3,119 @@ -FreeType-2.5.3 API Reference +FreeType-2.5.5 API Reference - - -
[Index][TOC]
-

FreeType-2.5.3 API Reference

+
[Index][TOC]
+

FreeType-2.5.5 API Reference

-

-OpenType Validation -

+

OpenType Validation

Synopsis

- - -
FT_VALIDATE_OTXXXFT_OpenType_ValidateFT_OpenType_Free


+ + + +
FT_OpenType_Validate 
FT_OpenType_FreeFT_VALIDATE_OTXXX
+ -

This section contains the declaration of functions to validate some OpenType tables (BASE, GDEF, GPOS, GSUB, JSTF, MATH).

-

-
-

FT_VALIDATE_OTXXX

-
-Defined in FT_OPENTYPE_VALIDATE_H (ftotval.h). -

-
-
-#define FT_VALIDATE_BASE  0x0100
-#define FT_VALIDATE_GDEF  0x0200
-#define FT_VALIDATE_GPOS  0x0400
-#define FT_VALIDATE_GSUB  0x0800
-#define FT_VALIDATE_JSTF  0x1000
-#define FT_VALIDATE_MATH  0x2000
-
-#define FT_VALIDATE_OT  FT_VALIDATE_BASE | \
-                        FT_VALIDATE_GDEF | \
-                        FT_VALIDATE_GPOS | \
-                        FT_VALIDATE_GSUB | \
-                        FT_VALIDATE_JSTF | \
-                        FT_VALIDATE_MATH
-
-

-
-

A list of bit-field constants used with FT_OpenType_Validate to indicate which OpenType tables should be validated.

-

-
values
-

- - - - - - - - -
FT_VALIDATE_BASE -

Validate BASE table.

-
FT_VALIDATE_GDEF -

Validate GDEF table.

-
FT_VALIDATE_GPOS -

Validate GPOS table.

-
FT_VALIDATE_GSUB -

Validate GSUB table.

-
FT_VALIDATE_JSTF -

Validate JSTF table.

-
FT_VALIDATE_MATH -

Validate MATH table.

-
FT_VALIDATE_OT -

Validate all OpenType tables (BASE, GDEF, GPOS, GSUB, JSTF, MATH).

-
-
-
-
- - -
[Index][TOC]
- -
-

FT_OpenType_Validate

-
-Defined in FT_OPENTYPE_VALIDATE_H (ftotval.h). -

-
 
+

+
FT_OpenType_Validate

+
Defined in FT_OPENTYPE_VALIDATE_H (ftotval.h).

+
   FT_EXPORT( FT_Error )
   FT_OpenType_Validate( FT_Face    face,
                         FT_UInt    validation_flags,
@@ -120,89 +124,124 @@ Defined in FT_OPENTYPE_VALIDATE_H (ftotval.h).
                         FT_Bytes  *GPOS_table,
                         FT_Bytes  *GSUB_table,
                         FT_Bytes  *JSTF_table );
+

 
-

-

Validate various OpenType tables to assure that all offsets and indices are valid. The idea is that a higher-level library that actually does the text layout can access those tables without error checking (which can be quite time consuming).

-

-
input
-

- -
face + +

input

+ + -
face

A handle to the input face.

validation_flags +
validation_flags

A bit field that specifies the tables to be validated. See FT_VALIDATE_OTXXX for possible values.

-
-
output
-

- -
BASE_table + +

output

+ + - - - -
BASE_table

A pointer to the BASE table.

GDEF_table +
GDEF_table

A pointer to the GDEF table.

GPOS_table +
GPOS_table

A pointer to the GPOS table.

GSUB_table +
GSUB_table

A pointer to the GSUB table.

JSTF_table +
JSTF_table

A pointer to the JSTF table.

-
-
return
+ +

return

FreeType error code. 0 means success.

-
-
note
+ +

note

This function only works with OpenType fonts, returning an error otherwise.

After use, the application should deallocate the five tables with FT_OpenType_Free. A NULL value indicates that the table either doesn't exist in the font, or the application hasn't asked for validation.

-
-
-
- - -
[Index][TOC]
- -
-

FT_OpenType_Free

-
-Defined in FT_OPENTYPE_VALIDATE_H (ftotval.h). -

-
 
+

+
[Index][Top][TOC]

+
+

+
FT_OpenType_Free

+
Defined in FT_OPENTYPE_VALIDATE_H (ftotval.h).

+
   FT_EXPORT( void )
   FT_OpenType_Free( FT_Face   face,
                     FT_Bytes  table );
+

 
-

-

Free the buffer allocated by OpenType validator.

-

-
input
-

- -
face + +

input

+ + -
face

A handle to the input face.

table +
table

The pointer to the buffer that is allocated by FT_OpenType_Validate.

-
-
note
+ +

note

This function must be used to free the buffer allocated by FT_OpenType_Validate only.

-
-
-
- - -
[Index][TOC]
+ +
+
[Index][Top][TOC]
+ +
+

FT_VALIDATE_OTXXX

+

Defined in FT_OPENTYPE_VALIDATE_H (ftotval.h).

+
+#define FT_VALIDATE_BASE  0x0100
+#define FT_VALIDATE_GDEF  0x0200
+#define FT_VALIDATE_GPOS  0x0400
+#define FT_VALIDATE_GSUB  0x0800
+#define FT_VALIDATE_JSTF  0x1000
+#define FT_VALIDATE_MATH  0x2000
+
+#define FT_VALIDATE_OT  FT_VALIDATE_BASE | \
+                        FT_VALIDATE_GDEF | \
+                        FT_VALIDATE_GPOS | \
+                        FT_VALIDATE_GSUB | \
+                        FT_VALIDATE_JSTF | \
+                        FT_VALIDATE_MATH
+
+ +

A list of bit-field constants used with FT_OpenType_Validate to indicate which OpenType tables should be validated.

+ +

values

+ + + + + + + + +
FT_VALIDATE_BASE +

Validate BASE table.

+
FT_VALIDATE_GDEF +

Validate GDEF table.

+
FT_VALIDATE_GPOS +

Validate GPOS table.

+
FT_VALIDATE_GSUB +

Validate GSUB table.

+
FT_VALIDATE_JSTF +

Validate JSTF table.

+
FT_VALIDATE_MATH +

Validate MATH table.

+
FT_VALIDATE_OT +

Validate all OpenType tables (BASE, GDEF, GPOS, GSUB, JSTF, MATH).

+
+ +
+
[Index][Top][TOC]
-- cgit v1.2.3