| 4759 |
right-hear |
1 |
/***************************************************************************/ |
|
|
2 |
/* */ |
|
|
3 |
/* ftgzip.h */ |
|
|
4 |
/* */ |
|
|
5 |
/* Gzip-compressed stream support. */ |
|
|
6 |
/* */ |
|
|
7 |
/* Copyright 2002, 2003, 2004, 2006 by */ |
|
|
8 |
/* David Turner, Robert Wilhelm, and Werner Lemberg. */ |
|
|
9 |
/* */ |
|
|
10 |
/* This file is part of the FreeType project, and may only be used, */ |
|
|
11 |
/* modified, and distributed under the terms of the FreeType project */ |
|
|
12 |
/* license, LICENSE.TXT. By continuing to use, modify, or distribute */ |
|
|
13 |
/* this file you indicate that you have read the license and */ |
|
|
14 |
/* understand and accept it fully. */ |
|
|
15 |
/* */ |
|
|
16 |
/***************************************************************************/ |
|
|
17 |
|
|
|
18 |
|
|
|
19 |
#ifndef __FTGZIP_H__ |
|
|
20 |
#define __FTGZIP_H__ |
|
|
21 |
|
|
|
22 |
#include |
|
|
23 |
#include FT_FREETYPE_H |
|
|
24 |
|
|
|
25 |
#ifdef FREETYPE_H |
|
|
26 |
#error "freetype.h of FreeType 1 has been loaded!" |
|
|
27 |
#error "Please fix the directory search order for header files" |
|
|
28 |
#error "so that freetype.h of FreeType 2 is found first." |
|
|
29 |
#endif |
|
|
30 |
|
|
|
31 |
|
|
|
32 |
FT_BEGIN_HEADER |
|
|
33 |
|
|
|
34 |
/*************************************************************************/ |
|
|
35 |
/* */ |
|
|
36 |
/* |
|
|
37 |
/* gzip */ |
|
|
38 |
/* */ |
|
|
39 |
/* */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l40">40</a></td>
<td class="code"><pre> /* GZIP Streams */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l41">41</a></td>
<td class="code"><pre> /* */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l42">42</a></td>
<td class="code"><pre> /* <Abstract> */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l43">43</a></td>
<td class="code"><pre> /* Using gzip-compressed font files. */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l44">44</a></td>
<td class="code"><pre> /* */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l45">45</a></td>
<td class="code"><pre> /* <Description> */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l46">46</a></td>
<td class="code"><pre> /* This section contains the declaration of Gzip-specific functions. */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l47">47</a></td>
<td class="code"><pre> /* */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l48">48</a></td>
<td class="code"><pre> /*************************************************************************/</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l49">49</a></td>
<td class="code"><pre> </pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l50">50</a></td>
<td class="code"><pre> </pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l51">51</a></td>
<td class="code"><pre> /************************************************************************</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l52">52</a></td>
<td class="code"><pre> *</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l53">53</a></td>
<td class="code"><pre> * @function:</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l54">54</a></td>
<td class="code"><pre> * FT_Stream_OpenGzip</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l55">55</a></td>
<td class="code"><pre> *</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l56">56</a></td>
<td class="code"><pre> * @description:</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l57">57</a></td>
<td class="code"><pre> * Open a new stream to parse gzip-compressed font files. This is</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l58">58</a></td>
<td class="code"><pre> * mainly used to support the compressed `*.pcf.gz' fonts that come</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l59">59</a></td>
<td class="code"><pre> * with XFree86.</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l60">60</a></td>
<td class="code"><pre> *</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l61">61</a></td>
<td class="code"><pre> * @input:</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l62">62</a></td>
<td class="code"><pre> * stream ::</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l63">63</a></td>
<td class="code"><pre> * The target embedding stream.</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l64">64</a></td>
<td class="code"><pre> *</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l65">65</a></td>
<td class="code"><pre> * source ::</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l66">66</a></td>
<td class="code"><pre> * The source stream.</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l67">67</a></td>
<td class="code"><pre> *</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l68">68</a></td>
<td class="code"><pre> * @return:</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l69">69</a></td>
<td class="code"><pre> * FreeType error code. 0~means success.</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l70">70</a></td>
<td class="code"><pre> *</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l71">71</a></td>
<td class="code"><pre> * @note:</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l72">72</a></td>
<td class="code"><pre> * The source stream must be opened _before_ calling this function.</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l73">73</a></td>
<td class="code"><pre> *</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l74">74</a></td>
<td class="code"><pre> * Calling the internal function `FT_Stream_Close' on the new stream will</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l75">75</a></td>
<td class="code"><pre> * *not* call `FT_Stream_Close' on the source stream. None of the stream</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l76">76</a></td>
<td class="code"><pre> * objects will be released to the heap.</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l77">77</a></td>
<td class="code"><pre> *</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l78">78</a></td>
<td class="code"><pre> * The stream implementation is very basic and resets the decompression</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l79">79</a></td>
<td class="code"><pre> * process each time seeking backwards is needed within the stream.</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l80">80</a></td>
<td class="code"><pre> *</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l81">81</a></td>
<td class="code"><pre> * In certain builds of the library, gzip compression recognition is</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l82">82</a></td>
<td class="code"><pre> * automatically handled when calling @FT_New_Face or @FT_Open_Face.</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l83">83</a></td>
<td class="code"><pre> * This means that if no font driver is capable of handling the raw</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l84">84</a></td>
<td class="code"><pre> * compressed file, the library will try to open a gzipped stream from</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l85">85</a></td>
<td class="code"><pre> * it and re-open the face with it.</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l86">86</a></td>
<td class="code"><pre> *</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l87">87</a></td>
<td class="code"><pre> * This function may return `FT_Err_Unimplemented_Feature' if your build</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l88">88</a></td>
<td class="code"><pre> * of FreeType was not compiled with zlib support.</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l89">89</a></td>
<td class="code"><pre> */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l90">90</a></td>
<td class="code"><pre> FT_EXPORT( FT_Error )</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l91">91</a></td>
<td class="code"><pre> FT_Stream_OpenGzip( FT_Stream stream,</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l92">92</a></td>
<td class="code"><pre> FT_Stream source );</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l93">93</a></td>
<td class="code"><pre> </pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l94">94</a></td>
<td class="code"><pre> /* */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l95">95</a></td>
<td class="code"><pre> </pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l96">96</a></td>
<td class="code"><pre> </pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l97">97</a></td>
<td class="code"><pre>FT_END_HEADER</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l98">98</a></td>
<td class="code"><pre> </pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l99">99</a></td>
<td class="code"><pre>#endif /* __FTGZIP_H__ */</pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l100">100</a></td>
<td class="code"><pre> </pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l101">101</a></td>
<td class="code"><pre> </pre></td>
</tr>
<tr valign="middle">
<td></td>
<td></td>
<td><a name="l102">102</a></td>
<td class="code"><pre>/* END */</Description></Abstract> |