272 lines
14 KiB
C
272 lines
14 KiB
C
|
/*******************************************************************
|
||
|
|
*
|
||
|
|
* t1driver.c
|
||
|
|
*
|
||
|
|
* High-level Type1 driver interface for FreeType 2.0
|
||
|
|
*
|
||
|
|
* Copyright 1996-1998 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.
|
||
|
|
*
|
||
|
|
******************************************************************/
|
||
|
|
|
||
|
|
#include <t1driver.h>
|
||
|
|
#include <t1gload.h>
|
||
|
|
|
||
|
|
#include <ftdebug.h>
|
||
|
|
#include <ftstream.h>
|
||
|
|
|
||
|
|
#undef FT_COMPONENT
|
||
|
|
#define FT_COMPONENT trace_t1driver
|
||
|
|
|
||
|
|
/*************************************************************************/
|
||
|
|
/* */
|
||
|
|
/* <Function> */
|
||
|
|
/* Get_Interface */
|
||
|
|
/* */
|
||
|
|
/* <Description> */
|
||
|
|
/* Each driver can provide one or more extensions to the base */
|
||
|
|
/* FreeType API. These can be used to access format specific */
|
||
|
|
/* features (e.g., all TrueType/OpenType resources share a common */
|
||
|
|
/* file structure and common tables which can be accessed through the */
|
||
|
|
/* `sfnt' interface), or more simply generic ones (e.g., the */
|
||
|
|
/* `postscript names' interface which can be used to retrieve the */
|
||
|
|
/* PostScript name of a given glyph index). */
|
||
|
|
/* */
|
||
|
|
/* <InOut> */
|
||
|
|
/* driver :: A handle to a driver object. */
|
||
|
|
/* */
|
||
|
|
/* <Input> */
|
||
|
|
/* interface :: A string designing the interface. Examples are */
|
||
|
|
/* `sfnt', `post_names', `charmaps', etc. */
|
||
|
|
/* */
|
||
|
|
/* <Return> */
|
||
|
|
/* A typeless pointer to the extension's interface (normally a table */
|
||
|
|
/* of function pointers). Returns NULL if the requested extension */
|
||
|
|
/* isn't available (i.e., wasn't compiled in the driver at build */
|
||
|
|
/* time). */
|
||
|
|
/* */
|
||
|
|
static
|
||
|
|
void* Get_Interface( FT_Driver* driver,
|
||
|
|
const FT_String* interface )
|
||
|
|
{
|
||
|
|
UNUSED(driver);
|
||
|
|
UNUSED(interface);
|
||
|
|
return 0;
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/******************************************************************/
|
||
|
|
/* */
|
||
|
|
/* <Function> Set_Char_Sizes */
|
||
|
|
/* */
|
||
|
|
/* <Description> */
|
||
|
|
/* A driver method used to reset a size's character sizes */
|
||
|
|
/* (horizontal and vertical) expressed in fractional points. */
|
||
|
|
/* */
|
||
|
|
/* <Input> */
|
||
|
|
/* size :: handle to target size object */
|
||
|
|
/* char_width :: character width expressed in 26.6 points */
|
||
|
|
/* char_height :: character height expressed in 26.6 points */
|
||
|
|
/* */
|
||
|
|
/* <Return> */
|
||
|
|
/* FreeType error code. 0 means success */
|
||
|
|
/* */
|
||
|
|
static
|
||
|
|
T1_Error Set_Char_Sizes( T1_Size size,
|
||
|
|
T1_F26Dot6 char_width,
|
||
|
|
T1_F26Dot6 char_height,
|
||
|
|
T1_UInt horz_resolution,
|
||
|
|
T1_UInt vert_resolution )
|
||
|
|
{
|
||
|
|
UNUSED(char_width);
|
||
|
|
UNUSED(horz_resolution);
|
||
|
|
UNUSED(vert_resolution);
|
||
|
|
|
||
|
|
size->valid = FALSE;
|
||
|
|
return T1_Reset_Size( size );
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/******************************************************************/
|
||
|
|
/* */
|
||
|
|
/* <Function> Set_Pixel_Sizes */
|
||
|
|
/* */
|
||
|
|
/* <Description> */
|
||
|
|
/* A driver method used to reset a size's character sizes */
|
||
|
|
/* (horizontal and vertical) expressed in integer pixels. */
|
||
|
|
/* */
|
||
|
|
/* <Input> */
|
||
|
|
/* size :: handle to target size object */
|
||
|
|
/* */
|
||
|
|
/* pixel_width :: character width expressed in 26.6 points */
|
||
|
|
/* */
|
||
|
|
/* pixel_height :: character height expressed in 26.6 points */
|
||
|
|
/* */
|
||
|
|
/* char_size :: the corresponding character size in points */
|
||
|
|
/* This value is only sent to the TrueType */
|
||
|
|
/* bytecode interpreter, even though 99% of */
|
||
|
|
/* glyph programs will simply ignore it. A */
|
||
|
|
/* safe value there is the maximum of the */
|
||
|
|
/* pixel width and height (multiplied by */
|
||
|
|
/* 64 to make it a 26.6 fixed float !) */
|
||
|
|
/* <Return> */
|
||
|
|
/* FreeType error code. 0 means success */
|
||
|
|
/* */
|
||
|
|
static
|
||
|
|
T1_Error Set_Pixel_Sizes( T1_Size size,
|
||
|
|
T1_Int pixel_width,
|
||
|
|
T1_Int pixel_height )
|
||
|
|
{
|
||
|
|
UNUSED(pixel_width);
|
||
|
|
UNUSED(pixel_height);
|
||
|
|
|
||
|
|
size->valid = FALSE;
|
||
|
|
return T1_Reset_Size(size);
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
/******************************************************************/
|
||
|
|
/* */
|
||
|
|
/* <Struct> FT_DriverInterface */
|
||
|
|
/* */
|
||
|
|
/* <Description> */
|
||
|
|
/* A structure used to hold a font driver's basic interface */
|
||
|
|
/* used by the high-level parts of FreeType (or other apps) */
|
||
|
|
/* */
|
||
|
|
/* Most scalable drivers provide a specialized interface to */
|
||
|
|
/* access format-specific features. It can be retrieved with */
|
||
|
|
/* a call to the "get_format_interface", and should be defined */
|
||
|
|
/* in each font driver header (e.g. ttdriver.h, t1driver.h,..) */
|
||
|
|
/* */
|
||
|
|
/* All fields are function pointers .. */
|
||
|
|
/* */
|
||
|
|
/* */
|
||
|
|
/* <Fields> */
|
||
|
|
/* */
|
||
|
|
/* new_engine :: */
|
||
|
|
/* used to create and initialise a new driver object */
|
||
|
|
/* */
|
||
|
|
/* done_engine :: */
|
||
|
|
/* used to finalise and destroy a given driver object */
|
||
|
|
/* */
|
||
|
|
/* get_format_interface :: */
|
||
|
|
/* return a typeless pointer to the format-specific */
|
||
|
|
/* driver interface. */
|
||
|
|
/* */
|
||
|
|
/* new_face :: */
|
||
|
|
/* create a new face object from a resource */
|
||
|
|
/* */
|
||
|
|
/* done_face :: */
|
||
|
|
/* discards a face object, as well as all child objects */
|
||
|
|
/* ( sizes, charmaps, glyph slots ) */
|
||
|
|
/* */
|
||
|
|
/* get_face_properties :: */
|
||
|
|
/* return generic face properties */
|
||
|
|
/* */
|
||
|
|
/* get_kerning :: */
|
||
|
|
/* return the kerning vector corresponding to a pair */
|
||
|
|
/* of glyphs, expressed in unscaled font units. */
|
||
|
|
/* */
|
||
|
|
/* new_size :: */
|
||
|
|
/* create and initialise a new scalable size object. */
|
||
|
|
/* */
|
||
|
|
/* new_fixed_size :: */
|
||
|
|
/* create and initialise a new fixed-size object. */
|
||
|
|
/* */
|
||
|
|
/* done_size :: */
|
||
|
|
/* finalize a given face size object. */
|
||
|
|
/* */
|
||
|
|
/* set_size_resolutions :: */
|
||
|
|
/* reset a scalable size object's output resolutions */
|
||
|
|
/* */
|
||
|
|
/* set_size_char_sizes :: */
|
||
|
|
/* reset a scalable size object's character size */
|
||
|
|
/* */
|
||
|
|
/* set_pixel_sizes :: */
|
||
|
|
/* reset a face size object's pixel dimensions. Applies */
|
||
|
|
/* to both scalable and fixed faces. */
|
||
|
|
/* */
|
||
|
|
/* new_glyph_slot :: */
|
||
|
|
/* create and initialise a new glyph slot */
|
||
|
|
/* */
|
||
|
|
/* done_glyph_slot :: */
|
||
|
|
/* discard a given glyph slot */
|
||
|
|
/* */
|
||
|
|
/* load_glyph :: */
|
||
|
|
/* load a given glyph into a given slot */
|
||
|
|
/* */
|
||
|
|
/* get_glyph_metrics :: */
|
||
|
|
/* return a loaded glyph's metrics. */
|
||
|
|
/* */
|
||
|
|
|
||
|
|
EXPORT_FUNC
|
||
|
|
const FT_DriverInterface t1_driver_interface =
|
||
|
|
{
|
||
|
|
sizeof( FT_DriverRec ),
|
||
|
|
sizeof( T1_FaceRec ),
|
||
|
|
sizeof( T1_SizeRec ),
|
||
|
|
sizeof( T1_GlyphSlotRec ),
|
||
|
|
|
||
|
|
"type1",
|
||
|
|
100, /* driver version == 1.0 */
|
||
|
|
200, /* requires FreeType 2.0 or above */
|
||
|
|
|
||
|
|
0, /* format interface */
|
||
|
|
|
||
|
|
(FTDriver_initDriver) T1_Init_Driver,
|
||
|
|
(FTDriver_doneDriver) T1_Done_Driver,
|
||
|
|
(FTDriver_getInterface) Get_Interface,
|
||
|
|
|
||
|
|
(FTDriver_initFace) T1_Init_Face,
|
||
|
|
(FTDriver_doneFace) T1_Done_Face,
|
||
|
|
(FTDriver_getKerning) 0,
|
||
|
|
|
||
|
|
(FTDriver_initSize) T1_Init_Size,
|
||
|
|
(FTDriver_doneSize) T1_Done_Size,
|
||
|
|
(FTDriver_setCharSizes) Set_Char_Sizes,
|
||
|
|
(FTDriver_setPixelSizes) Set_Pixel_Sizes,
|
||
|
|
|
||
|
|
(FTDriver_initGlyphSlot) T1_Init_GlyphSlot,
|
||
|
|
(FTDriver_doneGlyphSlot) T1_Done_GlyphSlot,
|
||
|
|
(FTDriver_loadGlyph) T1_Load_Glyph,
|
||
|
|
|
||
|
|
(FTDriver_getCharIndex) 0,
|
||
|
|
};
|
||
|
|
|
||
|
|
/*************************************************************************/
|
||
|
|
/* */
|
||
|
|
/* <Function> */
|
||
|
|
/* getDriverInterface */
|
||
|
|
/* */
|
||
|
|
/* <Description> */
|
||
|
|
/* This function is used when compiling the font driver as a */
|
||
|
|
/* shared library (`.DLL' or `.so'). It will be used by the */
|
||
|
|
/* high-level library of FreeType to retrieve the address of the */
|
||
|
|
/* driver's generic interface. */
|
||
|
|
/* */
|
||
|
|
/* It shouldn't be implemented in a static build, as each driver must */
|
||
|
|
/* have the same function as an exported entry point. */
|
||
|
|
/* */
|
||
|
|
/* <Return> */
|
||
|
|
/* The address of the TrueType's driver generic interface. The */
|
||
|
|
/* format-specific interface can then be retrieved through the method */
|
||
|
|
/* interface->get_format_interface. */
|
||
|
|
/* */
|
||
|
|
#ifdef FT_CONFIG_OPTION_DYNAMIC_DRIVERS
|
||
|
|
|
||
|
|
EXPORT_FUNC
|
||
|
|
FT_DriverInterface* getDriverInterface( void )
|
||
|
|
{
|
||
|
|
return &t1_driver_interface;
|
||
|
|
}
|
||
|
|
|
||
|
|
#endif /* CONFIG_OPTION_DYNAMIC_DRIVERS */
|
||
|
|
|
||
|
|
|