kc3-lang/freetype/src/sdf/ftsdf.h

• Show log

  Commit

• Hash : cd6ff28a
  Author :
  Date : 2020-08-16T17:09:22
  

  [sdf] Add files for new 'sdf' module. Here is a breakdown of what the files will contain. * src/sdf/ftsdfrend.c, src/sdf/ftsdfrend.h: The 'sdf' and 'bsdf' renderers. * src/sdf/ftsdf.c, src/sdf/ftsdf.h: The rasterizer for the 'sdf' renderer. * src/sdf/ftbsdf.c, src/sdf/ftbsdf.h: The rasterizer for the 'bsdf' renderer. * src/sdf/ftsdfcommon.h: Commmon properties and functions for both rasterizers. * src/sdf/ftsdferrs.h: Common error defines. * src/sdf/sdf.c: For building a single object of the entire module.

Download

• src/sdf/ftsdf.h

• 
  #ifndef FTSDF_H_
  #define FTSDF_H_
  
  #include <ft2build.h>
  #include FT_CONFIG_CONFIG_H
  #include <freetype/ftimage.h>
  
  /* common properties and function */
  #include "ftsdfcommon.h"
  
  FT_BEGIN_HEADER
  
    /**************************************************************************
     *
     * @struct:
     *   SDF_Raster_Params
     *
     * @description:
     *   This struct must be passed to the raster render function
     *   @FT_Raster_RenderFunc instead of @FT_Raster_Params because the
     *   rasterizer requires some additional information to render properly. 
     *
     * @fields:
     *   root ::
     *     The native raster parameters structure.
     *
     *   spread ::
     *     This is an essential parameter/property required by the renderer. 
     *     `spread` defines the maximum unsigned value that is present in the
     *     final SDF output.  For the default value check file
     *     `ftsdfcommon.h`.
     *
     *   flip_sign ::
     *     By default positive values indicate positions inside of contours,
     *     i.e., filled by a contour.  If this property is true then that
     *     output will be the opposite of the default, i.e., negative values
     *     indicate positions inside of contours.
     *
     *   flip_y ::
     *     Setting this parameter to true maked the output image flipped
     *     along the y-axis.
     *
     *   overlaps ::
     *     Set this to true to generate SDF for glyphs having overlapping
     *     contours.  The overlapping support is limited to glyphs that do not
     *     have self-intersecting contours.  Also, removing overlaps require a
     *     considerable amount of extra memory; additionally, it will not work
     *     if generating SDF from bitmap.
     *
     * @note:
     *   All properties are valid for both the 'sdf' and 'bsdf' renderers; the
     *   exception is `overlaps`, which gets ignored by the 'bsdf' renderer.
     *
     */
    typedef struct  SDF_Raster_Params_
    {
      FT_Raster_Params  root;
      FT_UInt           spread;
      FT_Bool           flip_sign;
      FT_Bool           flip_y;
      FT_Bool           overlaps;
  
    } SDF_Raster_Params;
  
  FT_END_HEADER
  
  #endif /* FTSDF_H_ */
  
  /* END */
  

Download