src/java.desktop/share/native/libfreetype/include/freetype/ftcolor.h

*** 2,12 ****
   *
   * ftcolor.h
   *
   *   FreeType's glyph color management (specification).
   *
!  * Copyright (C) 2018-2019 by
   * David Turner, Robert Wilhelm, and Werner Lemberg.
   *
   * This file is part of the FreeType project, and may only be used,
   * modified, and distributed under the terms of the FreeType project
   * license, LICENSE.TXT.  By continuing to use, modify, or distribute
--- 2,12 ----
   *
   * ftcolor.h
   *
   *   FreeType's glyph color management (specification).
   *
!  * Copyright (C) 2018-2020 by
   * David Turner, Robert Wilhelm, and Werner Lemberg.
   *
   * This file is part of the FreeType project, and may only be used,
   * modified, and distributed under the terms of the FreeType project
   * license, LICENSE.TXT.  By continuing to use, modify, or distribute
*** 123,155 ****
     * @fields:
     *   num_palettes ::
     *     The number of palettes.
     *
     *   palette_name_ids ::
!    *     A read-only array of palette name IDs with `num_palettes` elements,
!    *     corresponding to entries like 'dark' or 'light' in the font's 'name'
!    *     table.
     *
     *     An empty name ID in the 'CPAL' table gets represented as value
     *     0xFFFF.
     *
     *     `NULL` if the font's 'CPAL' table doesn't contain appropriate data.
     *
     *   palette_flags ::
!    *     A read-only array of palette flags with `num_palettes` elements.
!    *     Possible values are an ORed combination of
     *     @FT_PALETTE_FOR_LIGHT_BACKGROUND and
     *     @FT_PALETTE_FOR_DARK_BACKGROUND.
     *
     *     `NULL` if the font's 'CPAL' table doesn't contain appropriate data.
     *
     *   num_palette_entries ::
     *     The number of entries in a single palette.  All palettes have the
     *     same size.
     *
     *   palette_entry_name_ids ::
!    *     A read-only array of palette entry name IDs with
     *     `num_palette_entries`.  In each palette, entries with the same index
     *     have the same function.  For example, index~0 might correspond to
     *     string 'outline' in the font's 'name' table to indicate that this
     *     palette entry is used for outlines, index~1 might correspond to
     *     'fill' to indicate the filling color palette entry, etc.
--- 123,155 ----
     * @fields:
     *   num_palettes ::
     *     The number of palettes.
     *
     *   palette_name_ids ::
!    *     An optional read-only array of palette name IDs with `num_palettes`
!    *     elements, corresponding to entries like 'dark' or 'light' in the
!    *     font's 'name' table.
     *
     *     An empty name ID in the 'CPAL' table gets represented as value
     *     0xFFFF.
     *
     *     `NULL` if the font's 'CPAL' table doesn't contain appropriate data.
     *
     *   palette_flags ::
!    *     An optional read-only array of palette flags with `num_palettes`
!    *     elements.  Possible values are an ORed combination of
     *     @FT_PALETTE_FOR_LIGHT_BACKGROUND and
     *     @FT_PALETTE_FOR_DARK_BACKGROUND.
     *
     *     `NULL` if the font's 'CPAL' table doesn't contain appropriate data.
     *
     *   num_palette_entries ::
     *     The number of entries in a single palette.  All palettes have the
     *     same size.
     *
     *   palette_entry_name_ids ::
!    *     An optional read-only array of palette entry name IDs with
     *     `num_palette_entries`.  In each palette, entries with the same index
     *     have the same function.  For example, index~0 might correspond to
     *     string 'outline' in the font's 'name' table to indicate that this
     *     palette entry is used for outlines, index~1 might correspond to
     *     'fill' to indicate the filling color palette entry, etc.
*** 161,170 ****
--- 161,173 ----
     *
     * @note:
     *   Use function @FT_Get_Sfnt_Name to map name IDs and entry name IDs to
     *   name strings.
     *
+    *   Use function @FT_Palette_Select to get the colors associated with a
+    *   palette entry.
+    *
     * @since:
     *   2.10
     */
    typedef struct  FT_Palette_Data_ {
      FT_UShort         num_palettes;