jassub 1.7.13 → 1.7.14

package/dist/libraries/include/freetype2/freetype/ftincrem.h

@@ -1,348 +0,0 @@
-/****************************************************************************
- *
- * ftincrem.h
- *
- *   FreeType incremental loading (specification).
- *
- * Copyright (C) 2002-2021 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
- * this file you indicate that you have read the license and
- * understand and accept it fully.
- *
- */
-
-
-#ifndef FTINCREM_H_
-#define FTINCREM_H_
-
-#include <freetype/freetype.h>
-#include <freetype/ftparams.h>
-
-#ifdef FREETYPE_H
-#error "freetype.h of FreeType 1 has been loaded!"
-#error "Please fix the directory search order for header files"
-#error "so that freetype.h of FreeType 2 is found first."
-#endif
-
-
-FT_BEGIN_HEADER
-
-  /**************************************************************************
-   *
-   * @section:
-   *    incremental
-   *
-   * @title:
-   *    Incremental Loading
-   *
-   * @abstract:
-   *    Custom Glyph Loading.
-   *
-   * @description:
-   *   This section contains various functions used to perform so-called
-   *   'incremental' glyph loading.  This is a mode where all glyphs loaded
-   *   from a given @FT_Face are provided by the client application.
-   *
-   *   Apart from that, all other tables are loaded normally from the font
-   *   file.  This mode is useful when FreeType is used within another
-   *   engine, e.g., a PostScript Imaging Processor.
-   *
-   *   To enable this mode, you must use @FT_Open_Face, passing an
-   *   @FT_Parameter with the @FT_PARAM_TAG_INCREMENTAL tag and an
-   *   @FT_Incremental_Interface value.  See the comments for
-   *   @FT_Incremental_InterfaceRec for an example.
-   *
-   */
-
-
-  /**************************************************************************
-   *
-   * @type:
-   *   FT_Incremental
-   *
-   * @description:
-   *   An opaque type describing a user-provided object used to implement
-   *   'incremental' glyph loading within FreeType.  This is used to support
-   *   embedded fonts in certain environments (e.g., PostScript
-   *   interpreters), where the glyph data isn't in the font file, or must be
-   *   overridden by different values.
-   *
-   * @note:
-   *   It is up to client applications to create and implement
-   *   @FT_Incremental objects, as long as they provide implementations for
-   *   the methods @FT_Incremental_GetGlyphDataFunc,
-   *   @FT_Incremental_FreeGlyphDataFunc and
-   *   @FT_Incremental_GetGlyphMetricsFunc.
-   *
-   *   See the description of @FT_Incremental_InterfaceRec to understand how
-   *   to use incremental objects with FreeType.
-   *
-   */
-  typedef struct FT_IncrementalRec_*  FT_Incremental;
-
-
-  /**************************************************************************
-   *
-   * @struct:
-   *   FT_Incremental_MetricsRec
-   *
-   * @description:
-   *   A small structure used to contain the basic glyph metrics returned by
-   *   the @FT_Incremental_GetGlyphMetricsFunc method.
-   *
-   * @fields:
-   *   bearing_x ::
-   *     Left bearing, in font units.
-   *
-   *   bearing_y ::
-   *     Top bearing, in font units.
-   *
-   *   advance ::
-   *     Horizontal component of glyph advance, in font units.
-   *
-   *   advance_v ::
-   *     Vertical component of glyph advance, in font units.
-   *
-   * @note:
-   *   These correspond to horizontal or vertical metrics depending on the
-   *   value of the `vertical` argument to the function
-   *   @FT_Incremental_GetGlyphMetricsFunc.
-   *
-   */
-  typedef struct  FT_Incremental_MetricsRec_
-  {
-    FT_Long  bearing_x;
-    FT_Long  bearing_y;
-    FT_Long  advance;
-    FT_Long  advance_v;     /* since 2.3.12 */
-
-  } FT_Incremental_MetricsRec;
-
-
-  /**************************************************************************
-   *
-   * @struct:
-   *   FT_Incremental_Metrics
-   *
-   * @description:
-   *   A handle to an @FT_Incremental_MetricsRec structure.
-   *
-   */
-   typedef struct FT_Incremental_MetricsRec_*  FT_Incremental_Metrics;
-
-
-  /**************************************************************************
-   *
-   * @type:
-   *   FT_Incremental_GetGlyphDataFunc
-   *
-   * @description:
-   *   A function called by FreeType to access a given glyph's data bytes
-   *   during @FT_Load_Glyph or @FT_Load_Char if incremental loading is
-   *   enabled.
-   *
-   *   Note that the format of the glyph's data bytes depends on the font
-   *   file format.  For TrueType, it must correspond to the raw bytes within
-   *   the 'glyf' table.  For PostScript formats, it must correspond to the
-   *   **unencrypted** charstring bytes, without any `lenIV` header.  It is
-   *   undefined for any other format.
-   *
-   * @input:
-   *   incremental ::
-   *     Handle to an opaque @FT_Incremental handle provided by the client
-   *     application.
-   *
-   *   glyph_index ::
-   *     Index of relevant glyph.
-   *
-   * @output:
-   *   adata ::
-   *     A structure describing the returned glyph data bytes (which will be
-   *     accessed as a read-only byte block).
-   *
-   * @return:
-   *   FreeType error code.  0~means success.
-   *
-   * @note:
-   *   If this function returns successfully the method
-   *   @FT_Incremental_FreeGlyphDataFunc will be called later to release the
-   *   data bytes.
-   *
-   *   Nested calls to @FT_Incremental_GetGlyphDataFunc can happen for
-   *   compound glyphs.
-   *
-   */
-  typedef FT_Error
-  (*FT_Incremental_GetGlyphDataFunc)( FT_Incremental  incremental,
-                                      FT_UInt         glyph_index,
-                                      FT_Data*        adata );
-
-
-  /**************************************************************************
-   *
-   * @type:
-   *   FT_Incremental_FreeGlyphDataFunc
-   *
-   * @description:
-   *   A function used to release the glyph data bytes returned by a
-   *   successful call to @FT_Incremental_GetGlyphDataFunc.
-   *
-   * @input:
-   *   incremental ::
-   *     A handle to an opaque @FT_Incremental handle provided by the client
-   *     application.
-   *
-   *   data ::
-   *     A structure describing the glyph data bytes (which will be accessed
-   *     as a read-only byte block).
-   *
-   */
-  typedef void
-  (*FT_Incremental_FreeGlyphDataFunc)( FT_Incremental  incremental,
-                                       FT_Data*        data );
-
-
-  /**************************************************************************
-   *
-   * @type:
-   *   FT_Incremental_GetGlyphMetricsFunc
-   *
-   * @description:
-   *   A function used to retrieve the basic metrics of a given glyph index
-   *   before accessing its data.  This allows for handling font types such
-   *   as PCL~XL Format~1, Class~2 downloaded TrueType fonts, where the glyph
-   *   metrics (`hmtx` and `vmtx` tables) are permitted to be omitted from
-   *   the font, and the relevant metrics included in the header of the glyph
-   *   outline data.  Importantly, this is not intended to allow custom glyph
-   *   metrics (for example, Postscript Metrics dictionaries), because that
-   *   conflicts with the requirements of outline hinting.  Such custom
-   *   metrics must be handled separately, by the calling application.
-   *
-   * @input:
-   *   incremental ::
-   *     A handle to an opaque @FT_Incremental handle provided by the client
-   *     application.
-   *
-   *   glyph_index ::
-   *     Index of relevant glyph.
-   *
-   *   vertical ::
-   *     If true, return vertical metrics.
-   *
-   *   ametrics ::
-   *     This parameter is used for both input and output.  The original
-   *     glyph metrics, if any, in font units.  If metrics are not available
-   *     all the values must be set to zero.
-   *
-   * @output:
-   *   ametrics ::
-   *     The glyph metrics in font units.
-   *
-   */
-  typedef FT_Error
-  (*FT_Incremental_GetGlyphMetricsFunc)
-                      ( FT_Incremental              incremental,
-                        FT_UInt                     glyph_index,
-                        FT_Bool                     vertical,
-                        FT_Incremental_MetricsRec  *ametrics );
-
-
-  /**************************************************************************
-   *
-   * @struct:
-   *   FT_Incremental_FuncsRec
-   *
-   * @description:
-   *   A table of functions for accessing fonts that load data incrementally.
-   *   Used in @FT_Incremental_InterfaceRec.
-   *
-   * @fields:
-   *   get_glyph_data ::
-   *     The function to get glyph data.  Must not be null.
-   *
-   *   free_glyph_data ::
-   *     The function to release glyph data.  Must not be null.
-   *
-   *   get_glyph_metrics ::
-   *     The function to get glyph metrics.  May be null if the font does not
-   *     require it.
-   *
-   */
-  typedef struct  FT_Incremental_FuncsRec_
-  {
-    FT_Incremental_GetGlyphDataFunc     get_glyph_data;
-    FT_Incremental_FreeGlyphDataFunc    free_glyph_data;
-    FT_Incremental_GetGlyphMetricsFunc  get_glyph_metrics;
-
-  } FT_Incremental_FuncsRec;
-
-
-  /**************************************************************************
-   *
-   * @struct:
-   *   FT_Incremental_InterfaceRec
-   *
-   * @description:
-   *   A structure to be used with @FT_Open_Face to indicate that the user
-   *   wants to support incremental glyph loading.  You should use it with
-   *   @FT_PARAM_TAG_INCREMENTAL as in the following example:
-   *
-   *   ```
-   *     FT_Incremental_InterfaceRec  inc_int;
-   *     FT_Parameter                 parameter;
-   *     FT_Open_Args                 open_args;
-   *
-   *
-   *     // set up incremental descriptor
-   *     inc_int.funcs  = my_funcs;
-   *     inc_int.object = my_object;
-   *
-   *     // set up optional parameter
-   *     parameter.tag  = FT_PARAM_TAG_INCREMENTAL;
-   *     parameter.data = &inc_int;
-   *
-   *     // set up FT_Open_Args structure
-   *     open_args.flags      = FT_OPEN_PATHNAME | FT_OPEN_PARAMS;
-   *     open_args.pathname   = my_font_pathname;
-   *     open_args.num_params = 1;
-   *     open_args.params     = &parameter; // we use one optional argument
-   *
-   *     // open the font
-   *     error = FT_Open_Face( library, &open_args, index, &face );
-   *     ...
-   *   ```
-   *
-   */
-  typedef struct  FT_Incremental_InterfaceRec_
-  {
-    const FT_Incremental_FuncsRec*  funcs;
-    FT_Incremental                  object;
-
-  } FT_Incremental_InterfaceRec;
-
-
-  /**************************************************************************
-   *
-   * @type:
-   *   FT_Incremental_Interface
-   *
-   * @description:
-   *   A pointer to an @FT_Incremental_InterfaceRec structure.
-   *
-   */
-  typedef FT_Incremental_InterfaceRec*   FT_Incremental_Interface;
-
-
-  /* */
-
-
-FT_END_HEADER
-
-#endif /* FTINCREM_H_ */
-
-
-/* END */

package/dist/libraries/include/freetype2/freetype/ftlcdfil.h

@@ -1,323 +0,0 @@
-/****************************************************************************
- *
- * ftlcdfil.h
- *
- *   FreeType API for color filtering of subpixel bitmap glyphs
- *   (specification).
- *
- * Copyright (C) 2006-2021 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
- * this file you indicate that you have read the license and
- * understand and accept it fully.
- *
- */
-
-
-#ifndef FTLCDFIL_H_
-#define FTLCDFIL_H_
-
-#include <freetype/freetype.h>
-#include <freetype/ftparams.h>
-
-#ifdef FREETYPE_H
-#error "freetype.h of FreeType 1 has been loaded!"
-#error "Please fix the directory search order for header files"
-#error "so that freetype.h of FreeType 2 is found first."
-#endif
-
-
-FT_BEGIN_HEADER
-
-  /**************************************************************************
-   *
-   * @section:
-   *   lcd_rendering
-   *
-   * @title:
-   *   Subpixel Rendering
-   *
-   * @abstract:
-   *   API to control subpixel rendering.
-   *
-   * @description:
-   *   FreeType provides two alternative subpixel rendering technologies. 
-   *   Should you define `FT_CONFIG_OPTION_SUBPIXEL_RENDERING` in your
-   *   `ftoption.h` file, this enables ClearType-style rendering.
-   *   Otherwise, Harmony LCD rendering is enabled.  These technologies are
-   *   controlled differently and API described below, although always
-   *   available, performs its function when appropriate method is enabled
-   *   and does nothing otherwise.
-   *
-   *   ClearType-style LCD rendering exploits the color-striped structure of
-   *   LCD pixels, increasing the available resolution in the direction of
-   *   the stripe (usually horizontal RGB) by a factor of~3.  Using the
-   *   subpixel coverages unfiltered can create severe color fringes
-   *   especially when rendering thin features.  Indeed, to produce
-   *   black-on-white text, the nearby color subpixels must be dimmed
-   *   evenly.  Therefore, an equalizing 5-tap FIR filter should be applied
-   *   to subpixel coverages regardless of pixel boundaries and should have
-   *   these properties:
-   *
-   *   1. It should be symmetrical, like {~a, b, c, b, a~}, to avoid
-   *      any shifts in appearance.
-   *
-   *   2. It should be color-balanced, meaning a~+ b~=~c, to reduce color
-   *      fringes by distributing the computed coverage for one subpixel to
-   *      all subpixels equally.
-   *
-   *   3. It should be normalized, meaning 2a~+ 2b~+ c~=~1.0 to maintain
-   *      overall brightness.
-   *
-   *   Boxy 3-tap filter {0, 1/3, 1/3, 1/3, 0} is sharper but is less
-   *   forgiving of non-ideal gamma curves of a screen (and viewing angles),
-   *   beveled filters are fuzzier but more tolerant.
-   *
-   *   Use the @FT_Library_SetLcdFilter or @FT_Library_SetLcdFilterWeights
-   *   API to specify a low-pass filter, which is then applied to
-   *   subpixel-rendered bitmaps generated through @FT_Render_Glyph.
-   *
-   *   Harmony LCD rendering is suitable to panels with any regular subpixel
-   *   structure, not just monitors with 3 color striped subpixels, as long
-   *   as the color subpixels have fixed positions relative to the pixel
-   *   center.  In this case, each color channel can be rendered separately
-   *   after shifting the outline opposite to the subpixel shift so that the
-   *   coverage maps are aligned.  This method is immune to color fringes
-   *   because the shifts do not change integral coverage.
-   *
-   *   The subpixel geometry must be specified by xy-coordinates for each
-   *   subpixel. By convention they may come in the RGB order: {{-1/3, 0},
-   *   {0, 0}, {1/3, 0}} for standard RGB striped panel or {{-1/6, 1/4},
-   *   {-1/6, -1/4}, {1/3, 0}} for a certain PenTile panel.
-   *
-   *   Use the @FT_Library_SetLcdGeometry API to specify subpixel positions.
-   *   If one follows the RGB order convention, the same order applies to the
-   *   resulting @FT_PIXEL_MODE_LCD and @FT_PIXEL_MODE_LCD_V bitmaps.  Note,
-   *   however, that the coordinate frame for the latter must be rotated
-   *   clockwise.  Harmony with default LCD geometry is equivalent to
-   *   ClearType with light filter.
-   *
-   *   As a result of ClearType filtering or Harmony shifts, the resulting
-   *   dimensions of LCD bitmaps can be slightly wider or taller than the
-   *   dimensions the original outline with regard to the pixel grid.
-   *   For example, for @FT_RENDER_MODE_LCD, the filter adds 2~subpixels to
-   *   the left, and 2~subpixels to the right.  The bitmap offset values are
-   *   adjusted accordingly, so clients shouldn't need to modify their layout
-   *   and glyph positioning code when enabling the filter.
-   *
-   *   The ClearType and Harmony rendering is applicable to glyph bitmaps
-   *   rendered through @FT_Render_Glyph, @FT_Load_Glyph, @FT_Load_Char, and
-   *   @FT_Glyph_To_Bitmap, when @FT_RENDER_MODE_LCD or @FT_RENDER_MODE_LCD_V
-   *   is specified.  This API does not control @FT_Outline_Render and
-   *   @FT_Outline_Get_Bitmap.
-   *
-   *   The described algorithms can completely remove color artefacts when
-   *   combined with gamma-corrected alpha blending in linear space.  Each of
-   *   the 3~alpha values (subpixels) must by independently used to blend one
-   *   color channel.  That is, red alpha blends the red channel of the text
-   *   color with the red channel of the background pixel.
-   */
-
-
-  /**************************************************************************
-   *
-   * @enum:
-   *   FT_LcdFilter
-   *
-   * @description:
-   *   A list of values to identify various types of LCD filters.
-   *
-   * @values:
-   *   FT_LCD_FILTER_NONE ::
-   *     Do not perform filtering.  When used with subpixel rendering, this
-   *     results in sometimes severe color fringes.
-   *
-   *   FT_LCD_FILTER_DEFAULT ::
-   *     This is a beveled, normalized, and color-balanced five-tap filter
-   *     with weights of [0x08 0x4D 0x56 0x4D 0x08] in 1/256th units.
-   *
-   *   FT_LCD_FILTER_LIGHT ::
-   *     this is a boxy, normalized, and color-balanced three-tap filter with
-   *     weights of [0x00 0x55 0x56 0x55 0x00] in 1/256th units.
-   *
-   *   FT_LCD_FILTER_LEGACY ::
-   *   FT_LCD_FILTER_LEGACY1 ::
-   *     This filter corresponds to the original libXft color filter.  It
-   *     provides high contrast output but can exhibit really bad color
-   *     fringes if glyphs are not extremely well hinted to the pixel grid.
-   *     This filter is only provided for comparison purposes, and might be
-   *     disabled or stay unsupported in the future. The second value is
-   *     provided for compatibility with FontConfig, which historically used
-   *     different enumeration, sometimes incorrectly forwarded to FreeType.
-   *
-   * @since:
-   *   2.3.0 (`FT_LCD_FILTER_LEGACY1` since 2.6.2)
-   */
-  typedef enum  FT_LcdFilter_
-  {
-    FT_LCD_FILTER_NONE    = 0,
-    FT_LCD_FILTER_DEFAULT = 1,
-    FT_LCD_FILTER_LIGHT   = 2,
-    FT_LCD_FILTER_LEGACY1 = 3,
-    FT_LCD_FILTER_LEGACY  = 16,
-
-    FT_LCD_FILTER_MAX   /* do not remove */
-
-  } FT_LcdFilter;
-
-
-  /**************************************************************************
-   *
-   * @function:
-   *   FT_Library_SetLcdFilter
-   *
-   * @description:
-   *   This function is used to change filter applied to LCD decimated
-   *   bitmaps, like the ones used when calling @FT_Render_Glyph with
-   *   @FT_RENDER_MODE_LCD or @FT_RENDER_MODE_LCD_V.
-   *
-   * @input:
-   *   library ::
-   *     A handle to the target library instance.
-   *
-   *   filter ::
-   *     The filter type.
-   *
-   *     You can use @FT_LCD_FILTER_NONE here to disable this feature, or
-   *     @FT_LCD_FILTER_DEFAULT to use a default filter that should work well
-   *     on most LCD screens.
-   *
-   * @return:
-   *   FreeType error code.  0~means success.
-   *
-   * @note:
-   *   Since 2.10.3 the LCD filtering is enabled with @FT_LCD_FILTER_DEFAULT.
-   *   It is no longer necessary to call this function explicitly except
-   *   to choose a different filter or disable filtering altogether with
-   *   @FT_LCD_FILTER_NONE.
-   *
-   *   This function does nothing but returns `FT_Err_Unimplemented_Feature`
-   *   if the configuration macro `FT_CONFIG_OPTION_SUBPIXEL_RENDERING` is
-   *   not defined in your build of the library.
-   *
-   * @since:
-   *   2.3.0
-   */
-  FT_EXPORT( FT_Error )
-  FT_Library_SetLcdFilter( FT_Library    library,
-                           FT_LcdFilter  filter );
-
-
-  /**************************************************************************
-   *
-   * @function:
-   *   FT_Library_SetLcdFilterWeights
-   *
-   * @description:
-   *   This function can be used to enable LCD filter with custom weights,
-   *   instead of using presets in @FT_Library_SetLcdFilter.
-   *
-   * @input:
-   *   library ::
-   *     A handle to the target library instance.
-   *
-   *   weights ::
-   *     A pointer to an array; the function copies the first five bytes and
-   *     uses them to specify the filter weights in 1/256th units.
-   *
-   * @return:
-   *   FreeType error code.  0~means success.
-   *
-   * @note:
-   *   This function does nothing but returns `FT_Err_Unimplemented_Feature`
-   *   if the configuration macro `FT_CONFIG_OPTION_SUBPIXEL_RENDERING` is
-   *   not defined in your build of the library.
-   *
-   *   LCD filter weights can also be set per face using @FT_Face_Properties
-   *   with @FT_PARAM_TAG_LCD_FILTER_WEIGHTS.
-   *
-   * @since:
-   *   2.4.0
-   */
-  FT_EXPORT( FT_Error )
-  FT_Library_SetLcdFilterWeights( FT_Library      library,
-                                  unsigned char  *weights );
-
-
-  /**************************************************************************
-   *
-   * @type:
-   *   FT_LcdFiveTapFilter
-   *
-   * @description:
-   *   A typedef for passing the five LCD filter weights to
-   *   @FT_Face_Properties within an @FT_Parameter structure.
-   *
-   * @since:
-   *   2.8
-   *
-   */
-#define FT_LCD_FILTER_FIVE_TAPS  5
-
-  typedef FT_Byte  FT_LcdFiveTapFilter[FT_LCD_FILTER_FIVE_TAPS];
-
-
-  /**************************************************************************
-   *
-   * @function:
-   *   FT_Library_SetLcdGeometry
-   *
-   * @description:
-   *   This function can be used to modify default positions of color
-   *   subpixels, which controls Harmony LCD rendering.
-   *
-   * @input:
-   *   library ::
-   *     A handle to the target library instance.
-   *
-   *   sub ::
-   *     A pointer to an array of 3 vectors in 26.6 fractional pixel format;
-   *     the function modifies the default values, see the note below.
-   *
-   * @return:
-   *   FreeType error code.  0~means success.
-   *
-   * @note:
-   *   Subpixel geometry examples:
-   *
-   *   - {{-21, 0}, {0, 0}, {21, 0}} is the default, corresponding to 3 color
-   *   stripes shifted by a third of a pixel. This could be an RGB panel.
-   *
-   *   - {{21, 0}, {0, 0}, {-21, 0}} looks the same as the default but can
-   *   specify a BGR panel instead, while keeping the bitmap in the same
-   *   RGB888 format.
-   *
-   *   - {{0, 21}, {0, 0}, {0, -21}} is the vertical RGB, but the bitmap
-   *   stays RGB888 as a result.
-   *
-   *   - {{-11, 16}, {-11, -16}, {22, 0}} is a certain PenTile arrangement.
-   *
-   *   This function does nothing and returns `FT_Err_Unimplemented_Feature`
-   *   in the context of ClearType-style subpixel rendering when
-   *   `FT_CONFIG_OPTION_SUBPIXEL_RENDERING` is defined in your build of the
-   *   library.
-   *
-   * @since:
-   *   2.10.0
-   */
-  FT_EXPORT( FT_Error )
-  FT_Library_SetLcdGeometry( FT_Library  library,
-                             FT_Vector   sub[3] );
-
-  /* */
-
-
-FT_END_HEADER
-
-#endif /* FTLCDFIL_H_ */
-
-
-/* END */