103 lines
2.7 KiB
C
103 lines
2.7 KiB
C
/****************************************************************************
|
|
*
|
|
* ftbzip2.h
|
|
*
|
|
* Bzip2-compressed stream support.
|
|
*
|
|
* Copyright (C) 2010-2024 by
|
|
* Joel Klinghed.
|
|
*
|
|
* 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 FTBZIP2_H_
|
|
#define FTBZIP2_H_
|
|
|
|
#include <freetype/freetype.h>
|
|
|
|
#ifdef FREETYPE_H
|
|
#error "freetype.h of FreeType 1 has been loaded!"
|
|
#error "Please fix the directory search order for header files"
|
|
#error "so that freetype.h of FreeType 2 is found first."
|
|
#endif
|
|
|
|
|
|
FT_BEGIN_HEADER
|
|
|
|
/**************************************************************************
|
|
*
|
|
* @section:
|
|
* bzip2
|
|
*
|
|
* @title:
|
|
* BZIP2 Streams
|
|
*
|
|
* @abstract:
|
|
* Using bzip2-compressed font files.
|
|
*
|
|
* @description:
|
|
* In certain builds of the library, bzip2 compression recognition is
|
|
* automatically handled when calling @FT_New_Face or @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 bzip2 compressed
|
|
* stream from it and re-open the face with it.
|
|
*
|
|
* The stream implementation is very basic and resets the decompression
|
|
* process each time seeking backwards is needed within the stream,
|
|
* which significantly undermines the performance.
|
|
*
|
|
* This section contains the declaration of Bzip2-specific functions.
|
|
*
|
|
*/
|
|
|
|
|
|
/**************************************************************************
|
|
*
|
|
* @function:
|
|
* FT_Stream_OpenBzip2
|
|
*
|
|
* @description:
|
|
* Open a new stream to parse bzip2-compressed font files. This is
|
|
* mainly used to support the compressed `*.pcf.bz2` 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.
|
|
*
|
|
* This function may return `FT_Err_Unimplemented_Feature` if your build
|
|
* of FreeType was not compiled with bzip2 support.
|
|
*/
|
|
FT_EXPORT( FT_Error )
|
|
FT_Stream_OpenBzip2( FT_Stream stream,
|
|
FT_Stream source );
|
|
|
|
/* */
|
|
|
|
|
|
FT_END_HEADER
|
|
|
|
#endif /* FTBZIP2_H_ */
|
|
|
|
|
|
/* END */
|