1a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/***************************************************************************/
2a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*                                                                         */
3a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  cf2arrst.h                                                             */
4a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*                                                                         */
5a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*    Adobe's code for Array Stacks (specification).                       */
6a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*                                                                         */
7a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  Copyright 2007-2013 Adobe Systems Incorporated.                        */
8a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*                                                                         */
9a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  This software, and all works of authorship, whether in source or       */
10a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  object code form as indicated by the copyright notice(s) included      */
11a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  herein (collectively, the "Work") is made available, and may only be   */
12a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  used, modified, and distributed under the FreeType Project License,    */
13a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  LICENSE.TXT.  Additionally, subject to the terms and conditions of the */
14a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  FreeType Project License, each contributor to the Work hereby grants   */
15a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  to any individual or legal entity exercising permissions granted by    */
16a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  the FreeType Project License and this section (hereafter, "You" or     */
17a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  "Your") a perpetual, worldwide, non-exclusive, no-charge,              */
18a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  royalty-free, irrevocable (except as stated in this section) patent    */
19a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  license to make, have made, use, offer to sell, sell, import, and      */
20a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  otherwise transfer the Work, where such license applies only to those  */
21a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  patent claims licensable by such contributor that are necessarily      */
22a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  infringed by their contribution(s) alone or by combination of their    */
23a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  contribution(s) with the Work to which such contribution(s) was        */
24a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  submitted.  If You institute patent litigation against any entity      */
25a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  (including a cross-claim or counterclaim in a lawsuit) alleging that   */
26a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  the Work or a contribution incorporated within the Work constitutes    */
27a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  direct or contributory patent infringement, then any patent licenses   */
28a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  granted to You under this License for that Work shall terminate as of  */
29a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  the date such litigation is filed.                                     */
30a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*                                                                         */
31a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  By using, modifying, or distributing the Work you indicate that you    */
32a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  have read and understood the terms and conditions of the               */
33a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  FreeType Project License as well as those provided in this section,    */
34a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*  and you accept them fully.                                             */
35a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/*                                                                         */
36a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/***************************************************************************/
37a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
38a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
39a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#ifndef __CF2ARRST_H__
40a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#define __CF2ARRST_H__
41a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
42a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
43a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#include "cf2error.h"
44a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
45a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
46a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu WangFT_BEGIN_HEADER
47a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
48a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
49a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  /* need to define the struct here (not opaque) so it can be allocated by */
50a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  /* clients                                                               */
51a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  typedef struct  CF2_ArrStackRec_
52a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  {
53a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang    FT_Memory  memory;
54a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang    FT_Error*  error;
55a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
56a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang    size_t  sizeItem;       /* bytes per element             */
57a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang    size_t  allocated;      /* items allocated               */
58a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang    size_t  chunk;          /* allocation increment in items */
59a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang    size_t  count;          /* number of elements allocated  */
60a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang    size_t  totalSize;      /* total bytes allocated         */
61a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
62a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang    void*  ptr;             /* ptr to data                   */
63a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
64a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  } CF2_ArrStackRec, *CF2_ArrStack;
65a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
66a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
67a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  FT_LOCAL( void )
68a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  cf2_arrstack_init( CF2_ArrStack  arrstack,
69a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang                     FT_Memory     memory,
70a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang                     FT_Error*     error,
71a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang                     size_t        sizeItem );
72a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  FT_LOCAL( void )
73a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  cf2_arrstack_finalize( CF2_ArrStack  arrstack );
74a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
75a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  FT_LOCAL( void )
76a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  cf2_arrstack_setCount( CF2_ArrStack  arrstack,
77a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang                         size_t        numElements );
78a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  FT_LOCAL( void )
79a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  cf2_arrstack_clear( CF2_ArrStack  arrstack );
80a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  FT_LOCAL( size_t )
81a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  cf2_arrstack_size( const CF2_ArrStack  arrstack );
82a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
83a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  FT_LOCAL( void* )
84a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  cf2_arrstack_getBuffer( const CF2_ArrStack  arrstack );
85a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  FT_LOCAL( void* )
86a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  cf2_arrstack_getPointer( const CF2_ArrStack  arrstack,
87a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang                           size_t              idx );
88a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
89a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  FT_LOCAL( void )
90a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang  cf2_arrstack_push( CF2_ArrStack  arrstack,
91a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang                     const void*   ptr );
92a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
93a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
94a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu WangFT_END_HEADER
95a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
96a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
97a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang#endif /* __CF2ARRST_H__ */
98a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
99a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang
100a2b9955b49034a51dfbc8bf9f4e9d312149cecacXianzhu Wang/* END */
101