FreeType-2.1.10 API Reference
LZW Streams
Synopsis
#FT_Stream_OpenLZW
FT_Stream_OpenLZW
This section contains the declaration of LZW-specific functions.
FT_Stream_OpenLZW
FT_EXPORT(
ft2-basic_types.html#FT_Error
FT_Error
)
FT_Stream_OpenLZW
(
ft2-system_interface.html#FT_Stream
FT_Stream
stream,
ft2-system_interface.html#FT_Stream
FT_Stream
source );
Open a new stream to parse LZW-compressed font files. This is mainly used to support the compressed *.pcf.Z fonts that come with XFree86.
input
stream
The target embedding stream.
source
The source stream.
return
FreeType error code. 0 means success.
note
The source stream must be opened
before
calling this function.
Calling the internal function FT_Stream_Close on the new stream will
not
call FT_Stream_Close on the source stream. None of the stream objects will be released to the heap.
The stream implementation is very basic and resets the decompression process each time seeking backwards is needed within the stream
In certain builds of the library, LZW compression recognition is automatically handled when calling
ft2-base_interface.html#FT_New_Face
FT_New_Face
or
ft2-base_interface.html#FT_Open_Face
FT_Open_Face
. This means that if no font driver is capable of handling the raw compressed file, the library will try to open a LZW stream from it and re-open the face with it.
This function may return "FT_Err_Unimplemented" if your build of FreeType was not compiled with LZW support.
