< prev index next >
src/java.desktop/share/native/libfreetype/include/freetype/ftbdf.h
Print this page
*** 1,21 ****
! /***************************************************************************/
! /* */
! /* ftbdf.h */
! /* */
! /* FreeType API for accessing BDF-specific strings (specification). */
! /* */
! /* Copyright 2002-2018 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 FTBDF_H_
#define FTBDF_H_
--- 1,21 ----
! /****************************************************************************
! *
! * ftbdf.h
! *
! * FreeType API for accessing BDF-specific strings (specification).
! *
! * Copyright (C) 2002-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
! * this file you indicate that you have read the license and
! * understand and accept it fully.
! *
! */
#ifndef FTBDF_H_
#define FTBDF_H_
*** 30,58 ****
FT_BEGIN_HEADER
! /*************************************************************************/
! /* */
! /* <Section> */
! /* bdf_fonts */
! /* */
! /* <Title> */
! /* BDF and PCF Files */
! /* */
! /* <Abstract> */
! /* BDF and PCF specific API. */
! /* */
! /* <Description> */
! /* This section contains the declaration of functions specific to BDF */
! /* and PCF fonts. */
! /* */
! /*************************************************************************/
! /**********************************************************************
*
* @enum:
* BDF_PropertyType
*
* @description:
--- 30,58 ----
FT_BEGIN_HEADER
! /**************************************************************************
! *
! * @section:
! * bdf_fonts
! *
! * @title:
! * BDF and PCF Files
! *
! * @abstract:
! * BDF and PCF specific API.
! *
! * @description:
! * This section contains the declaration of functions specific to BDF and
! * PCF fonts.
! *
! */
! /**************************************************************************
*
* @enum:
* BDF_PropertyType
*
* @description:
*** 79,101 ****
BDF_PROPERTY_TYPE_CARDINAL = 3
} BDF_PropertyType;
! /**********************************************************************
*
* @type:
* BDF_Property
*
* @description:
! * A handle to a @BDF_PropertyRec structure to model a given
! * BDF/PCF property.
*/
typedef struct BDF_PropertyRec_* BDF_Property;
! /**********************************************************************
*
* @struct:
* BDF_PropertyRec
*
* @description:
--- 79,101 ----
BDF_PROPERTY_TYPE_CARDINAL = 3
} BDF_PropertyType;
! /**************************************************************************
*
* @type:
* BDF_Property
*
* @description:
! * A handle to a @BDF_PropertyRec structure to model a given BDF/PCF
! * property.
*/
typedef struct BDF_PropertyRec_* BDF_Property;
! /**************************************************************************
*
* @struct:
* BDF_PropertyRec
*
* @description:
*** 105,115 ****
* type ::
* The property type.
*
* u.atom ::
* The atom string, if type is @BDF_PROPERTY_TYPE_ATOM. May be
! * NULL, indicating an empty string.
*
* u.integer ::
* A signed integer, if type is @BDF_PROPERTY_TYPE_INTEGER.
*
* u.cardinal ::
--- 105,115 ----
* type ::
* The property type.
*
* u.atom ::
* The atom string, if type is @BDF_PROPERTY_TYPE_ATOM. May be
! * `NULL`, indicating an empty string.
*
* u.integer ::
* A signed integer, if type is @BDF_PROPERTY_TYPE_INTEGER.
*
* u.cardinal ::
*** 126,143 ****
} u;
} BDF_PropertyRec;
! /**********************************************************************
*
* @function:
* FT_Get_BDF_Charset_ID
*
* @description:
! * Retrieve a BDF font character set identity, according to
! * the BDF specification.
*
* @input:
* face ::
* A handle to the input face.
*
--- 126,143 ----
} u;
} BDF_PropertyRec;
! /**************************************************************************
*
* @function:
* FT_Get_BDF_Charset_ID
*
* @description:
! * Retrieve a BDF font character set identity, according to the BDF
! * specification.
*
* @input:
* face ::
* A handle to the input face.
*
*** 158,200 ****
FT_Get_BDF_Charset_ID( FT_Face face,
const char* *acharset_encoding,
const char* *acharset_registry );
! /**********************************************************************
*
* @function:
* FT_Get_BDF_Property
*
* @description:
* Retrieve a BDF property from a BDF or PCF font file.
*
* @input:
! * face :: A handle to the input face.
*
! * name :: The property name.
*
* @output:
! * aproperty :: The property.
*
* @return:
* FreeType error code. 0~means success.
*
* @note:
* This function works with BDF _and_ PCF fonts. It returns an error
* otherwise. It also returns an error if the property is not in the
* font.
*
! * A `property' is a either key-value pair within the STARTPROPERTIES
* ... ENDPROPERTIES block of a BDF font or a key-value pair from the
! * `info->props' array within a `FontRec' structure of a PCF font.
*
! * Integer properties are always stored as `signed' within PCF fonts;
* consequently, @BDF_PROPERTY_TYPE_CARDINAL is a possible return value
* for BDF fonts only.
*
! * In case of error, `aproperty->type' is always set to
* @BDF_PROPERTY_TYPE_NONE.
*/
FT_EXPORT( FT_Error )
FT_Get_BDF_Property( FT_Face face,
const char* prop_name,
--- 158,203 ----
FT_Get_BDF_Charset_ID( FT_Face face,
const char* *acharset_encoding,
const char* *acharset_registry );
! /**************************************************************************
*
* @function:
* FT_Get_BDF_Property
*
* @description:
* Retrieve a BDF property from a BDF or PCF font file.
*
* @input:
! * face ::
! * A handle to the input face.
*
! * name ::
! * The property name.
*
* @output:
! * aproperty ::
! * The property.
*
* @return:
* FreeType error code. 0~means success.
*
* @note:
* This function works with BDF _and_ PCF fonts. It returns an error
* otherwise. It also returns an error if the property is not in the
* font.
*
! * A 'property' is a either key-value pair within the STARTPROPERTIES
* ... ENDPROPERTIES block of a BDF font or a key-value pair from the
! * `info->props` array within a `FontRec` structure of a PCF font.
*
! * Integer properties are always stored as 'signed' within PCF fonts;
* consequently, @BDF_PROPERTY_TYPE_CARDINAL is a possible return value
* for BDF fonts only.
*
! * In case of error, `aproperty->type` is always set to
* @BDF_PROPERTY_TYPE_NONE.
*/
FT_EXPORT( FT_Error )
FT_Get_BDF_Property( FT_Face face,
const char* prop_name,
< prev index next >