freetype-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Git][freetype/freetype][API-organization] API documentation: Re-organiz


From: Werner Lemberg (@wl)
Subject: [Git][freetype/freetype][API-organization] API documentation: Re-organize chapters and sections
Date: Sun, 30 Apr 2023 05:38:58 +0000

Werner Lemberg pushed to branch API-organization at FreeType / FreeType

Commits:

  • 9b8266da
    by Werner Lemberg at 2023-04-30T07:37:57+02:00
    API documentation: Re-organize chapters and sections
    
    * Split the very long 'Base Interface' section into smaller sections.
    * Split the 'Core API' chapter into two chapters.
    * Remove single enumeration values from `@order` fields since they have no
      effect.
    

2 changed files:

Changes:

  • include/freetype/freetype.h
    ... ... @@ -102,61 +102,25 @@ FT_BEGIN_HEADER
    102 102
        */
    
    103 103
     
    
    104 104
     
    
    105
    -
    
    106
    -  /*************************************************************************/
    
    107
    -  /*************************************************************************/
    
    108
    -  /*                                                                       */
    
    109
    -  /*                        B A S I C   T Y P E S                          */
    
    110
    -  /*                                                                       */
    
    111
    -  /*************************************************************************/
    
    112
    -  /*************************************************************************/
    
    113
    -
    
    114
    -
    
    115 105
       /**************************************************************************
    
    116 106
        *
    
    117 107
        * @section:
    
    118
    -   *   base_interface
    
    108
    +   *   font_testing_macros
    
    119 109
        *
    
    120 110
        * @title:
    
    121
    -   *   Base Interface
    
    111
    +   *   Font Testing Macros
    
    122 112
        *
    
    123 113
        * @abstract:
    
    124
    -   *   The FreeType~2 base font interface.
    
    114
    +   *   Macros to test various properties of fonts.
    
    125 115
        *
    
    126 116
        * @description:
    
    127
    -   *   This section describes the most important public high-level API
    
    128
    -   *   functions of FreeType~2.
    
    117
    +   *   Macros to test the most important font properties.
    
    129 118
        *
    
    130
    -   * @order:
    
    131
    -   *   FT_Library
    
    132
    -   *   FT_Face
    
    133
    -   *   FT_Size
    
    134
    -   *   FT_GlyphSlot
    
    135
    -   *   FT_CharMap
    
    136
    -   *   FT_Encoding
    
    137
    -   *   FT_ENC_TAG
    
    138
    -   *
    
    139
    -   *   FT_FaceRec
    
    140
    -   *
    
    141
    -   *   FT_FACE_FLAG_SCALABLE
    
    142
    -   *   FT_FACE_FLAG_FIXED_SIZES
    
    143
    -   *   FT_FACE_FLAG_FIXED_WIDTH
    
    144
    -   *   FT_FACE_FLAG_HORIZONTAL
    
    145
    -   *   FT_FACE_FLAG_VERTICAL
    
    146
    -   *   FT_FACE_FLAG_COLOR
    
    147
    -   *   FT_FACE_FLAG_SFNT
    
    148
    -   *   FT_FACE_FLAG_CID_KEYED
    
    149
    -   *   FT_FACE_FLAG_TRICKY
    
    150
    -   *   FT_FACE_FLAG_KERNING
    
    151
    -   *   FT_FACE_FLAG_MULTIPLE_MASTERS
    
    152
    -   *   FT_FACE_FLAG_VARIATION
    
    153
    -   *   FT_FACE_FLAG_GLYPH_NAMES
    
    154
    -   *   FT_FACE_FLAG_EXTERNAL_STREAM
    
    155
    -   *   FT_FACE_FLAG_HINTER
    
    156
    -   *   FT_FACE_FLAG_SVG
    
    157
    -   *   FT_FACE_FLAG_SBIX
    
    158
    -   *   FT_FACE_FLAG_SBIX_OVERLAY
    
    119
    +   *   It is recommended to use these high-level macros instead of directly
    
    120
    +   *   testing the corresponding flags, which are scattered over various
    
    121
    +   *   structures.
    
    159 122
        *
    
    123
    +   * @order:
    
    160 124
        *   FT_HAS_HORIZONTAL
    
    161 125
        *   FT_HAS_VERTICAL
    
    162 126
        *   FT_HAS_KERNING
    
    ... ... @@ -176,21 +140,58 @@ FT_BEGIN_HEADER
    176 140
        *   FT_IS_NAMED_INSTANCE
    
    177 141
        *   FT_IS_VARIATION
    
    178 142
        *
    
    179
    -   *   FT_STYLE_FLAG_BOLD
    
    180
    -   *   FT_STYLE_FLAG_ITALIC
    
    143
    +   */
    
    144
    +
    
    145
    +
    
    146
    +  /**************************************************************************
    
    147
    +   *
    
    148
    +   * @section:
    
    149
    +   *   library_setup
    
    181 150
        *
    
    182
    -   *   FT_SizeRec
    
    183
    -   *   FT_Size_Metrics
    
    151
    +   * @title:
    
    152
    +   *   Library Setup
    
    184 153
        *
    
    185
    -   *   FT_GlyphSlotRec
    
    186
    -   *   FT_Glyph_Metrics
    
    187
    -   *   FT_SubGlyph
    
    154
    +   * @abstract:
    
    155
    +   *   Functions to start and end the usage of the FreeType library.
    
    188 156
        *
    
    189
    -   *   FT_Bitmap_Size
    
    157
    +   * @description:
    
    158
    +   *   Functions to start and end the usage of the FreeType library.
    
    159
    +   *
    
    160
    +   *   Note that @FT_Library_Version and @FREETYPE_XXX are of limited use
    
    161
    +   *   because even a new release of FreeType with only documentation
    
    162
    +   *   changes increases the version number.
    
    190 163
        *
    
    164
    +   * @order:
    
    165
    +   *   FT_Library
    
    191 166
        *   FT_Init_FreeType
    
    192 167
        *   FT_Done_FreeType
    
    193 168
        *
    
    169
    +   *   FT_Library_Version
    
    170
    +   *   FREETYPE_XXX
    
    171
    +   */
    
    172
    +
    
    173
    +
    
    174
    +  /**************************************************************************
    
    175
    +   *
    
    176
    +   * @section:
    
    177
    +   *   face_creation
    
    178
    +   *
    
    179
    +   * @title:
    
    180
    +   *   Face Creation
    
    181
    +   *
    
    182
    +   * @abstract:
    
    183
    +   *   Functions to manage fonts.
    
    184
    +   *
    
    185
    +   * @description:
    
    186
    +   *   The functions and structures collected in this section operate on
    
    187
    +   *   fonts globally.
    
    188
    +   *
    
    189
    +   * @order:
    
    190
    +   *   FT_Face
    
    191
    +   *   FT_FaceRec
    
    192
    +   *   FT_FACE_FLAG_XXX
    
    193
    +   *   FT_STYLE_FLAG_XXX
    
    194
    +   *
    
    194 195
        *   FT_New_Face
    
    195 196
        *   FT_Done_Face
    
    196 197
        *   FT_Reference_Face
    
    ... ... @@ -198,10 +199,37 @@ FT_BEGIN_HEADER
    198 199
        *   FT_Face_Properties
    
    199 200
        *   FT_Open_Face
    
    200 201
        *   FT_Open_Args
    
    202
    +   *   FT_OPEN_XXX
    
    201 203
        *   FT_Parameter
    
    202 204
        *   FT_Attach_File
    
    203 205
        *   FT_Attach_Stream
    
    204 206
        *
    
    207
    +   *
    
    208
    +   */
    
    209
    +
    
    210
    +
    
    211
    +  /**************************************************************************
    
    212
    +   *
    
    213
    +   * @section:
    
    214
    +   *   sizing_and_scaling
    
    215
    +   *
    
    216
    +   * @title:
    
    217
    +   *   Sizing and Scaling
    
    218
    +   *
    
    219
    +   * @abstract:
    
    220
    +   *   Functions to manage font sizes.
    
    221
    +   *
    
    222
    +   * @description:
    
    223
    +   *   The functions and structures collected in this section are related to
    
    224
    +   *   selecting and manipulating the size of a font globally.
    
    225
    +   *
    
    226
    +   * @order:
    
    227
    +   *   FT_Size
    
    228
    +   *   FT_SizeRec
    
    229
    +   *   FT_Size_Metrics
    
    230
    +   *
    
    231
    +   *   FT_Bitmap_Size
    
    232
    +   *
    
    205 233
        *   FT_Set_Char_Size
    
    206 234
        *   FT_Set_Pixel_Sizes
    
    207 235
        *   FT_Request_Size
    
    ... ... @@ -209,44 +237,37 @@ FT_BEGIN_HEADER
    209 237
        *   FT_Size_Request_Type
    
    210 238
        *   FT_Size_RequestRec
    
    211 239
        *   FT_Size_Request
    
    240
    +   *
    
    212 241
        *   FT_Set_Transform
    
    213 242
        *   FT_Get_Transform
    
    214
    -   *   FT_Load_Glyph
    
    215
    -   *   FT_Get_Char_Index
    
    216
    -   *   FT_Get_First_Char
    
    217
    -   *   FT_Get_Next_Char
    
    218
    -   *   FT_Load_Char
    
    219 243
        *
    
    220
    -   *   FT_OPEN_MEMORY
    
    221
    -   *   FT_OPEN_STREAM
    
    222
    -   *   FT_OPEN_PATHNAME
    
    223
    -   *   FT_OPEN_DRIVER
    
    224
    -   *   FT_OPEN_PARAMS
    
    225
    -   *
    
    226
    -   *   FT_LOAD_DEFAULT
    
    227
    -   *   FT_LOAD_RENDER
    
    228
    -   *   FT_LOAD_MONOCHROME
    
    229
    -   *   FT_LOAD_LINEAR_DESIGN
    
    230
    -   *   FT_LOAD_NO_SCALE
    
    231
    -   *   FT_LOAD_NO_HINTING
    
    232
    -   *   FT_LOAD_NO_BITMAP
    
    233
    -   *   FT_LOAD_SBITS_ONLY
    
    234
    -   *   FT_LOAD_NO_AUTOHINT
    
    235
    -   *   FT_LOAD_COLOR
    
    236
    -   *
    
    237
    -   *   FT_LOAD_VERTICAL_LAYOUT
    
    238
    -   *   FT_LOAD_IGNORE_TRANSFORM
    
    239
    -   *   FT_LOAD_FORCE_AUTOHINT
    
    240
    -   *   FT_LOAD_NO_RECURSE
    
    241
    -   *   FT_LOAD_PEDANTIC
    
    242
    -   *
    
    243
    -   *   FT_LOAD_TARGET_NORMAL
    
    244
    -   *   FT_LOAD_TARGET_LIGHT
    
    245
    -   *   FT_LOAD_TARGET_MONO
    
    246
    -   *   FT_LOAD_TARGET_LCD
    
    247
    -   *   FT_LOAD_TARGET_LCD_V
    
    244
    +   */
    
    245
    +
    
    246
    +
    
    247
    +  /**************************************************************************
    
    248
    +   *
    
    249
    +   * @section:
    
    250
    +   *   glyph_retrieval
    
    251
    +   *
    
    252
    +   * @title:
    
    253
    +   *   Glyph Retrieval
    
    254
    +   *
    
    255
    +   * @abstract:
    
    256
    +   *   Functions to manage glyphs.
    
    257
    +   *
    
    258
    +   * @description:
    
    259
    +   *   The functions and structures collected in this section operate on
    
    260
    +   *   single glyphs, of which @FT_Load_Glyph is most important.
    
    248 261
        *
    
    262
    +   * @order:
    
    263
    +   *   FT_GlyphSlot
    
    264
    +   *   FT_GlyphSlotRec
    
    265
    +   *   FT_Glyph_Metrics
    
    266
    +   *
    
    267
    +   *   FT_Load_Glyph
    
    268
    +   *   FT_LOAD_XXX
    
    249 269
        *   FT_LOAD_TARGET_MODE
    
    270
    +   *   FT_LOAD_TARGET_XXX
    
    250 271
        *
    
    251 272
        *   FT_Render_Glyph
    
    252 273
        *   FT_Render_Mode
    
    ... ... @@ -254,34 +275,123 @@ FT_BEGIN_HEADER
    254 275
        *   FT_Kerning_Mode
    
    255 276
        *   FT_Get_Track_Kerning
    
    256 277
        *
    
    278
    +   *
    
    279
    +   */
    
    280
    +
    
    281
    +
    
    282
    +  /**************************************************************************
    
    283
    +   *
    
    284
    +   * @section:
    
    285
    +   *   character_mapping
    
    286
    +   *
    
    287
    +   * @title:
    
    288
    +   *   Character Mapping
    
    289
    +   *
    
    290
    +   * @abstract:
    
    291
    +   *   Functions to manage character-to-glyph maps.
    
    292
    +   *
    
    293
    +   * @description:
    
    294
    +   *   This section holds functions and structures that are related to
    
    295
    +   *   mapping character input codes to glyph indices.
    
    296
    +   *
    
    297
    +   *   Note that for many scripts the simplistic approach used by FreeType
    
    298
    +   *   of mapping a single character to a single glyph is not valid or
    
    299
    +   *   possible!  In general, a higher-level library like HarfBuzz or ICU
    
    300
    +   *   should be used for handling text strings.
    
    301
    +   *
    
    302
    +   * @order:
    
    303
    +   *   FT_CharMap
    
    257 304
        *   FT_CharMapRec
    
    305
    +   *   FT_Encoding
    
    306
    +   *   FT_ENC_TAG
    
    307
    +   *
    
    258 308
        *   FT_Select_Charmap
    
    259 309
        *   FT_Set_Charmap
    
    260 310
        *   FT_Get_Charmap_Index
    
    261 311
        *
    
    312
    +   *   FT_Get_Char_Index
    
    313
    +   *   FT_Get_First_Char
    
    314
    +   *   FT_Get_Next_Char
    
    315
    +   *   FT_Load_Char
    
    316
    +   *
    
    317
    +   *
    
    318
    +   */
    
    319
    +
    
    320
    +
    
    321
    +  /**************************************************************************
    
    322
    +   *
    
    323
    +   * @section:
    
    324
    +   *   information_retrieval
    
    325
    +   *
    
    326
    +   * @title:
    
    327
    +   *   Information Retrieval
    
    328
    +   *
    
    329
    +   * @abstract:
    
    330
    +   *   Functions to retrieve font and glyph information.
    
    331
    +   *
    
    332
    +   * @description:
    
    333
    +   *   Functions to retrieve font and glyph information.  Only some very
    
    334
    +   *   basic data is covered; see also the chapter on the format-specific
    
    335
    +   *   API for more.
    
    336
    +   *
    
    337
    +   *
    
    338
    +   * @order:
    
    262 339
        *   FT_Get_Name_Index
    
    263 340
        *   FT_Get_Glyph_Name
    
    264 341
        *   FT_Get_Postscript_Name
    
    265 342
        *   FT_Get_FSType_Flags
    
    343
    +   *   FT_FSTYPE_XXX
    
    266 344
        *   FT_Get_SubGlyph_Info
    
    345
    +   *   FT_SUBGLYPH_FLAG_XXX
    
    346
    +   *
    
    347
    +   */
    
    348
    +
    
    349
    +
    
    350
    +  /**************************************************************************
    
    351
    +   *
    
    352
    +   * @section:
    
    353
    +   *   other_api_data
    
    354
    +   *
    
    355
    +   * @title:
    
    356
    +   *   Other API Data
    
    267 357
        *
    
    358
    +   * @abstract:
    
    359
    +   *   Other structures, enumerations, and macros.
    
    360
    +   *
    
    361
    +   * @description:
    
    362
    +   *   Other structures, enumerations, and macros.  Deprecated functions are
    
    363
    +   *   also listed here.
    
    364
    +   *
    
    365
    +   * @order:
    
    268 366
        *   FT_Face_Internal
    
    269 367
        *   FT_Size_Internal
    
    270 368
        *   FT_Slot_Internal
    
    271 369
        *
    
    272
    -   *   FT_FACE_FLAG_XXX
    
    273
    -   *   FT_STYLE_FLAG_XXX
    
    274
    -   *   FT_OPEN_XXX
    
    275
    -   *   FT_LOAD_XXX
    
    276
    -   *   FT_LOAD_TARGET_XXX
    
    277
    -   *   FT_SUBGLYPH_FLAG_XXX
    
    278
    -   *   FT_FSTYPE_XXX
    
    370
    +   *   FT_SubGlyph
    
    279 371
        *
    
    280 372
        *   FT_HAS_FAST_GLYPHS
    
    373
    +   *   FT_Face_CheckTrueTypePatents
    
    374
    +   *   FT_Face_SetUnpatentedHinting
    
    281 375
        *
    
    282 376
        */
    
    283 377
     
    
    284 378
     
    
    379
    +  /*************************************************************************/
    
    380
    +  /*************************************************************************/
    
    381
    +  /*                                                                       */
    
    382
    +  /*                        B A S I C   T Y P E S                          */
    
    383
    +  /*                                                                       */
    
    384
    +  /*************************************************************************/
    
    385
    +  /*************************************************************************/
    
    386
    +
    
    387
    +
    
    388
    +  /**************************************************************************
    
    389
    +   *
    
    390
    +   * @section:
    
    391
    +   *   glyph_retrieval
    
    392
    +   *
    
    393
    +   */
    
    394
    +
    
    285 395
       /**************************************************************************
    
    286 396
        *
    
    287 397
        * @struct:
    
    ... ... @@ -349,6 +459,13 @@ FT_BEGIN_HEADER
    349 459
       } FT_Glyph_Metrics;
    
    350 460
     
    
    351 461
     
    
    462
    +  /**************************************************************************
    
    463
    +   *
    
    464
    +   * @section:
    
    465
    +   *   sizing_and_scaling
    
    466
    +   *
    
    467
    +   */
    
    468
    +
    
    352 469
       /**************************************************************************
    
    353 470
        *
    
    354 471
        * @struct:
    
    ... ... @@ -409,6 +526,13 @@ FT_BEGIN_HEADER
    409 526
       /*************************************************************************/
    
    410 527
       /*************************************************************************/
    
    411 528
     
    
    529
    +  /**************************************************************************
    
    530
    +   *
    
    531
    +   * @section:
    
    532
    +   *   library_setup
    
    533
    +   *
    
    534
    +   */
    
    535
    +
    
    412 536
       /**************************************************************************
    
    413 537
        *
    
    414 538
        * @type:
    
    ... ... @@ -483,7 +607,7 @@ FT_BEGIN_HEADER
    483 607
       /**************************************************************************
    
    484 608
        *
    
    485 609
        * @section:
    
    486
    -   *   base_interface
    
    610
    +   *   face_creation
    
    487 611
        *
    
    488 612
        */
    
    489 613
     
    
    ... ... @@ -519,6 +643,13 @@ FT_BEGIN_HEADER
    519 643
       typedef struct FT_FaceRec_*  FT_Face;
    
    520 644
     
    
    521 645
     
    
    646
    +  /**************************************************************************
    
    647
    +   *
    
    648
    +   * @section:
    
    649
    +   *   sizing_and_scaling
    
    650
    +   *
    
    651
    +   */
    
    652
    +
    
    522 653
       /**************************************************************************
    
    523 654
        *
    
    524 655
        * @type:
    
    ... ... @@ -551,6 +682,13 @@ FT_BEGIN_HEADER
    551 682
       typedef struct FT_SizeRec_*  FT_Size;
    
    552 683
     
    
    553 684
     
    
    685
    +  /**************************************************************************
    
    686
    +   *
    
    687
    +   * @section:
    
    688
    +   *   glyph_retrieval
    
    689
    +   *
    
    690
    +   */
    
    691
    +
    
    554 692
       /**************************************************************************
    
    555 693
        *
    
    556 694
        * @type:
    
    ... ... @@ -570,6 +708,13 @@ FT_BEGIN_HEADER
    570 708
       typedef struct FT_GlyphSlotRec_*  FT_GlyphSlot;
    
    571 709
     
    
    572 710
     
    
    711
    +  /**************************************************************************
    
    712
    +   *
    
    713
    +   * @section:
    
    714
    +   *   character_mapping
    
    715
    +   *
    
    716
    +   */
    
    717
    +
    
    573 718
       /**************************************************************************
    
    574 719
        *
    
    575 720
        * @type:
    
    ... ... @@ -877,6 +1022,13 @@ FT_BEGIN_HEADER
    877 1022
       /*************************************************************************/
    
    878 1023
     
    
    879 1024
     
    
    1025
    +  /**************************************************************************
    
    1026
    +   *
    
    1027
    +   * @section:
    
    1028
    +   *   other_api_data
    
    1029
    +   *
    
    1030
    +   */
    
    1031
    +
    
    880 1032
       /**************************************************************************
    
    881 1033
        *
    
    882 1034
        * @type:
    
    ... ... @@ -892,6 +1044,13 @@ FT_BEGIN_HEADER
    892 1044
       typedef struct FT_Face_InternalRec_*  FT_Face_Internal;
    
    893 1045
     
    
    894 1046
     
    
    1047
    +  /**************************************************************************
    
    1048
    +   *
    
    1049
    +   * @section:
    
    1050
    +   *   face_creation
    
    1051
    +   *
    
    1052
    +   */
    
    1053
    +
    
    895 1054
       /**************************************************************************
    
    896 1055
        *
    
    897 1056
        * @struct:
    
    ... ... @@ -1272,6 +1431,13 @@ FT_BEGIN_HEADER
    1272 1431
     #define FT_FACE_FLAG_SBIX_OVERLAY      ( 1L << 18 )
    
    1273 1432
     
    
    1274 1433
     
    
    1434
    +  /**************************************************************************
    
    1435
    +   *
    
    1436
    +   * @section:
    
    1437
    +   *   font_testing_macros
    
    1438
    +   *
    
    1439
    +   */
    
    1440
    +
    
    1275 1441
       /**************************************************************************
    
    1276 1442
        *
    
    1277 1443
        * @macro:
    
    ... ... @@ -1381,6 +1547,13 @@ FT_BEGIN_HEADER
    1381 1547
               ( !!( (face)->face_flags & FT_FACE_FLAG_FIXED_SIZES ) )
    
    1382 1548
     
    
    1383 1549
     
    
    1550
    +  /**************************************************************************
    
    1551
    +   *
    
    1552
    +   * @section:
    
    1553
    +   *   other_api_data
    
    1554
    +   *
    
    1555
    +   */
    
    1556
    +
    
    1384 1557
       /**************************************************************************
    
    1385 1558
        *
    
    1386 1559
        * @macro:
    
    ... ... @@ -1393,6 +1566,13 @@ FT_BEGIN_HEADER
    1393 1566
     #define FT_HAS_FAST_GLYPHS( face )  0
    
    1394 1567
     
    
    1395 1568
     
    
    1569
    +  /**************************************************************************
    
    1570
    +   *
    
    1571
    +   * @section:
    
    1572
    +   *   font_testing_macros
    
    1573
    +   *
    
    1574
    +   */
    
    1575
    +
    
    1396 1576
       /**************************************************************************
    
    1397 1577
        *
    
    1398 1578
        * @macro:
    
    ... ... @@ -1628,6 +1808,13 @@ FT_BEGIN_HEADER
    1628 1808
               ( !!( (face)->face_flags & FT_FACE_FLAG_SBIX_OVERLAY ) )
    
    1629 1809
     
    
    1630 1810
     
    
    1811
    +  /**************************************************************************
    
    1812
    +   *
    
    1813
    +   * @section:
    
    1814
    +   *   face_creation
    
    1815
    +   *
    
    1816
    +   */
    
    1817
    +
    
    1631 1818
       /**************************************************************************
    
    1632 1819
        *
    
    1633 1820
        * @enum:
    
    ... ... @@ -1654,6 +1841,13 @@ FT_BEGIN_HEADER
    1654 1841
     #define FT_STYLE_FLAG_BOLD    ( 1 << 1 )
    
    1655 1842
     
    
    1656 1843
     
    
    1844
    +  /**************************************************************************
    
    1845
    +   *
    
    1846
    +   * @section:
    
    1847
    +   *   other_api_data
    
    1848
    +   *
    
    1849
    +   */
    
    1850
    +
    
    1657 1851
       /**************************************************************************
    
    1658 1852
        *
    
    1659 1853
        * @type:
    
    ... ... @@ -1666,6 +1860,13 @@ FT_BEGIN_HEADER
    1666 1860
       typedef struct FT_Size_InternalRec_*  FT_Size_Internal;
    
    1667 1861
     
    
    1668 1862
     
    
    1863
    +  /**************************************************************************
    
    1864
    +   *
    
    1865
    +   * @section:
    
    1866
    +   *   sizing_and_scaling
    
    1867
    +   *
    
    1868
    +   */
    
    1869
    +
    
    1669 1870
       /**************************************************************************
    
    1670 1871
        *
    
    1671 1872
        * @struct:
    
    ... ... @@ -1817,6 +2018,13 @@ FT_BEGIN_HEADER
    1817 2018
       } FT_SizeRec;
    
    1818 2019
     
    
    1819 2020
     
    
    2021
    +  /**************************************************************************
    
    2022
    +   *
    
    2023
    +   * @section:
    
    2024
    +   *   other_api_data
    
    2025
    +   *
    
    2026
    +   */
    
    2027
    +
    
    1820 2028
       /**************************************************************************
    
    1821 2029
        *
    
    1822 2030
        * @struct:
    
    ... ... @@ -1848,6 +2056,13 @@ FT_BEGIN_HEADER
    1848 2056
       typedef struct FT_Slot_InternalRec_*  FT_Slot_Internal;
    
    1849 2057
     
    
    1850 2058
     
    
    2059
    +  /**************************************************************************
    
    2060
    +   *
    
    2061
    +   * @section:
    
    2062
    +   *   glyph_retrieval
    
    2063
    +   *
    
    2064
    +   */
    
    2065
    +
    
    1851 2066
       /**************************************************************************
    
    1852 2067
        *
    
    1853 2068
        * @struct:
    
    ... ... @@ -2092,6 +2307,13 @@ FT_BEGIN_HEADER
    2092 2307
       /*************************************************************************/
    
    2093 2308
     
    
    2094 2309
     
    
    2310
    +  /**************************************************************************
    
    2311
    +   *
    
    2312
    +   * @section:
    
    2313
    +   *   library_setup
    
    2314
    +   *
    
    2315
    +   */
    
    2316
    +
    
    2095 2317
       /**************************************************************************
    
    2096 2318
        *
    
    2097 2319
        * @function:
    
    ... ... @@ -2149,6 +2371,13 @@ FT_BEGIN_HEADER
    2149 2371
       FT_Done_FreeType( FT_Library  library );
    
    2150 2372
     
    
    2151 2373
     
    
    2374
    +  /**************************************************************************
    
    2375
    +   *
    
    2376
    +   * @section:
    
    2377
    +   *   face_creation
    
    2378
    +   *
    
    2379
    +   */
    
    2380
    +
    
    2152 2381
       /**************************************************************************
    
    2153 2382
        *
    
    2154 2383
        * @enum:
    
    ... ... @@ -2650,6 +2879,13 @@ FT_BEGIN_HEADER
    2650 2879
       FT_Done_Face( FT_Face  face );
    
    2651 2880
     
    
    2652 2881
     
    
    2882
    +  /**************************************************************************
    
    2883
    +   *
    
    2884
    +   * @section:
    
    2885
    +   *   sizing_and_scaling
    
    2886
    +   *
    
    2887
    +   */
    
    2888
    +
    
    2653 2889
       /**************************************************************************
    
    2654 2890
        *
    
    2655 2891
        * @function:
    
    ... ... @@ -2942,6 +3178,13 @@ FT_BEGIN_HEADER
    2942 3178
                           FT_UInt  pixel_height );
    
    2943 3179
     
    
    2944 3180
     
    
    3181
    +  /**************************************************************************
    
    3182
    +   *
    
    3183
    +   * @section:
    
    3184
    +   *   glyph_retrieval
    
    3185
    +   *
    
    3186
    +   */
    
    3187
    +
    
    2945 3188
       /**************************************************************************
    
    2946 3189
        *
    
    2947 3190
        * @function:
    
    ... ... @@ -2990,6 +3233,13 @@ FT_BEGIN_HEADER
    2990 3233
                      FT_Int32  load_flags );
    
    2991 3234
     
    
    2992 3235
     
    
    3236
    +  /**************************************************************************
    
    3237
    +   *
    
    3238
    +   * @section:
    
    3239
    +   *   character_mapping
    
    3240
    +   *
    
    3241
    +   */
    
    3242
    +
    
    2993 3243
       /**************************************************************************
    
    2994 3244
        *
    
    2995 3245
        * @function:
    
    ... ... @@ -3033,6 +3283,13 @@ FT_BEGIN_HEADER
    3033 3283
                     FT_Int32  load_flags );
    
    3034 3284
     
    
    3035 3285
     
    
    3286
    +  /**************************************************************************
    
    3287
    +   *
    
    3288
    +   * @section:
    
    3289
    +   *   glyph_retrieval
    
    3290
    +   *
    
    3291
    +   */
    
    3292
    +
    
    3036 3293
       /**************************************************************************
    
    3037 3294
        *
    
    3038 3295
        * @enum:
    
    ... ... @@ -3372,6 +3629,13 @@ FT_BEGIN_HEADER
    3372 3629
               FT_STATIC_CAST( FT_Render_Mode, ( (x) >> 16 ) & 15 )
    
    3373 3630
     
    
    3374 3631
     
    
    3632
    +  /**************************************************************************
    
    3633
    +   *
    
    3634
    +   * @section:
    
    3635
    +   *   sizing_and_scaling
    
    3636
    +   *
    
    3637
    +   */
    
    3638
    +
    
    3375 3639
       /**************************************************************************
    
    3376 3640
        *
    
    3377 3641
        * @function:
    
    ... ... @@ -3447,6 +3711,13 @@ FT_BEGIN_HEADER
    3447 3711
                         FT_Vector*  delta );
    
    3448 3712
     
    
    3449 3713
     
    
    3714
    +  /**************************************************************************
    
    3715
    +   *
    
    3716
    +   * @section:
    
    3717
    +   *   glyph_retrieval
    
    3718
    +   *
    
    3719
    +   */
    
    3720
    +
    
    3450 3721
       /**************************************************************************
    
    3451 3722
        *
    
    3452 3723
        * @enum:
    
    ... ... @@ -3841,6 +4112,13 @@ FT_BEGIN_HEADER
    3841 4112
                             FT_Fixed*  akerning );
    
    3842 4113
     
    
    3843 4114
     
    
    4115
    +  /**************************************************************************
    
    4116
    +   *
    
    4117
    +   * @section:
    
    4118
    +   *   character_mapping
    
    4119
    +   *
    
    4120
    +   */
    
    4121
    +
    
    3844 4122
       /**************************************************************************
    
    3845 4123
        *
    
    3846 4124
        * @function:
    
    ... ... @@ -4057,6 +4335,13 @@ FT_BEGIN_HEADER
    4057 4335
                         FT_UInt   *agindex );
    
    4058 4336
     
    
    4059 4337
     
    
    4338
    +  /**************************************************************************
    
    4339
    +   *
    
    4340
    +   * @section:
    
    4341
    +   *   face_creation
    
    4342
    +   *
    
    4343
    +   */
    
    4344
    +
    
    4060 4345
       /**************************************************************************
    
    4061 4346
        *
    
    4062 4347
        * @function:
    
    ... ... @@ -4155,6 +4440,13 @@ FT_BEGIN_HEADER
    4155 4440
                           FT_Parameter*  properties );
    
    4156 4441
     
    
    4157 4442
     
    
    4443
    +  /**************************************************************************
    
    4444
    +   *
    
    4445
    +   * @section:
    
    4446
    +   *   information_retrieval
    
    4447
    +   *
    
    4448
    +   */
    
    4449
    +
    
    4158 4450
       /**************************************************************************
    
    4159 4451
        *
    
    4160 4452
        * @function:
    
    ... ... @@ -4900,32 +5192,10 @@ FT_BEGIN_HEADER
    4900 5192
       /**************************************************************************
    
    4901 5193
        *
    
    4902 5194
        * @section:
    
    4903
    -   *   version
    
    4904
    -   *
    
    4905
    -   * @title:
    
    4906
    -   *   FreeType Version
    
    4907
    -   *
    
    4908
    -   * @abstract:
    
    4909
    -   *   Functions and macros related to FreeType versions.
    
    4910
    -   *
    
    4911
    -   * @description:
    
    4912
    -   *   Note that those functions and macros are of limited use because even a
    
    4913
    -   *   new release of FreeType with only documentation changes increases the
    
    4914
    -   *   version number.
    
    4915
    -   *
    
    4916
    -   * @order:
    
    4917
    -   *   FT_Library_Version
    
    4918
    -   *
    
    4919
    -   *   FREETYPE_MAJOR
    
    4920
    -   *   FREETYPE_MINOR
    
    4921
    -   *   FREETYPE_PATCH
    
    4922
    -   *
    
    4923
    -   *   FT_Face_CheckTrueTypePatents
    
    4924
    -   *   FT_Face_SetUnpatentedHinting
    
    5195
    +   *   library_setup
    
    4925 5196
        *
    
    4926 5197
        */
    
    4927 5198
     
    
    4928
    -
    
    4929 5199
       /**************************************************************************
    
    4930 5200
        *
    
    4931 5201
        * @enum:
    
    ... ... @@ -4992,6 +5262,13 @@ FT_BEGIN_HEADER
    4992 5262
                           FT_Int      *apatch );
    
    4993 5263
     
    
    4994 5264
     
    
    5265
    +  /**************************************************************************
    
    5266
    +   *
    
    5267
    +   * @section:
    
    5268
    +   *   other_api_data
    
    5269
    +   *
    
    5270
    +   */
    
    5271
    +
    
    4995 5272
       /**************************************************************************
    
    4996 5273
        *
    
    4997 5274
        * @function:
    

  • include/freetype/ftchapters.h
    ... ... @@ -31,9 +31,28 @@
    31 31
        *   Core API
    
    32 32
        *
    
    33 33
        * @sections:
    
    34
    -   *   version
    
    35 34
        *   basic_types
    
    36
    -   *   base_interface
    
    35
    +   *   library_setup
    
    36
    +   *   face_creation
    
    37
    +   *   font_testing_macros
    
    38
    +   *   sizing_and_scaling
    
    39
    +   *   glyph_retrieval
    
    40
    +   *   character_mapping
    
    41
    +   *   information_retrieval
    
    42
    +   *   other_api_data
    
    43
    +   *
    
    44
    +   */
    
    45
    +
    
    46
    +
    
    47
    +  /**************************************************************************
    
    48
    +   *
    
    49
    +   * @chapter:
    
    50
    +   *   extended_api
    
    51
    +   *
    
    52
    +   * @title:
    
    53
    +   *   Extended API
    
    54
    +   *
    
    55
    +   * @sections:
    
    37 56
        *   glyph_variants
    
    38 57
        *   color_management
    
    39 58
        *   layer_management
    


  • reply via email to

    [Prev in Thread] Current Thread [Next in Thread]