/******************************************************************* * * 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 #include #include #include #undef FT_COMPONENT #define FT_COMPONENT trace_t1driver /*************************************************************************/ /* */ /* */ /* Get_Interface */ /* */ /* */ /* 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). */ /* */ /* */ /* driver :: A handle to a driver object. */ /* */ /* */ /* interface :: A string designing the interface. Examples are */ /* `sfnt', `post_names', `charmaps', etc. */ /* */ /* */ /* 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; } /******************************************************************/ /* */ /* Set_Char_Sizes */ /* */ /* */ /* A driver method used to reset a size's character sizes */ /* (horizontal and vertical) expressed in fractional points. */ /* */ /* */ /* size :: handle to target size object */ /* char_width :: character width expressed in 26.6 points */ /* char_height :: character height expressed in 26.6 points */ /* */ /* */ /* 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 ); } /******************************************************************/ /* */ /* Set_Pixel_Sizes */ /* */ /* */ /* A driver method used to reset a size's character sizes */ /* (horizontal and vertical) expressed in integer pixels. */ /* */ /* */ /* 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 !) */ /* */ /* 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); } /******************************************************************/ /* */ /* FT_DriverInterface */ /* */ /* */ /* 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 .. */ /* */ /* */ /* */ /* */ /* 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, }; /*************************************************************************/ /* */ /* */ /* getDriverInterface */ /* */ /* */ /* 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. */ /* */ /* */ /* 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 */