diff options
Diffstat (limited to 'libraries/openjpeg-libsl/libopenjpeg/pi.h')
-rw-r--r-- | libraries/openjpeg-libsl/libopenjpeg/pi.h | 152 |
1 files changed, 152 insertions, 0 deletions
diff --git a/libraries/openjpeg-libsl/libopenjpeg/pi.h b/libraries/openjpeg-libsl/libopenjpeg/pi.h new file mode 100644 index 0000000..fc99329 --- /dev/null +++ b/libraries/openjpeg-libsl/libopenjpeg/pi.h | |||
@@ -0,0 +1,152 @@ | |||
1 | /* | ||
2 | * Copyright (c) 2002-2007, Communications and Remote Sensing Laboratory, Universite catholique de Louvain (UCL), Belgium | ||
3 | * Copyright (c) 2002-2007, Professor Benoit Macq | ||
4 | * Copyright (c) 2001-2003, David Janssens | ||
5 | * Copyright (c) 2002-2003, Yannick Verschueren | ||
6 | * Copyright (c) 2003-2007, Francois-Olivier Devaux and Antonin Descampe | ||
7 | * Copyright (c) 2005, Herve Drolon, FreeImage Team | ||
8 | * All rights reserved. | ||
9 | * | ||
10 | * Redistribution and use in source and binary forms, with or without | ||
11 | * modification, are permitted provided that the following conditions | ||
12 | * are met: | ||
13 | * 1. Redistributions of source code must retain the above copyright | ||
14 | * notice, this list of conditions and the following disclaimer. | ||
15 | * 2. Redistributions in binary form must reproduce the above copyright | ||
16 | * notice, this list of conditions and the following disclaimer in the | ||
17 | * documentation and/or other materials provided with the distribution. | ||
18 | * | ||
19 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS' | ||
20 | * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | ||
21 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | ||
22 | * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE | ||
23 | * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | ||
24 | * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | ||
25 | * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | ||
26 | * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | ||
27 | * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | ||
28 | * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | ||
29 | * POSSIBILITY OF SUCH DAMAGE. | ||
30 | */ | ||
31 | |||
32 | #ifndef __PI_H | ||
33 | #define __PI_H | ||
34 | /** | ||
35 | @file pi.h | ||
36 | @brief Implementation of a packet iterator (PI) | ||
37 | |||
38 | The functions in PI.C have for goal to realize a packet iterator that permits to get the next | ||
39 | packet following the progression order and change of it. The functions in PI.C are used | ||
40 | by some function in T2.C. | ||
41 | */ | ||
42 | |||
43 | /** @defgroup PI PI - Implementation of a packet iterator */ | ||
44 | /*@{*/ | ||
45 | |||
46 | /** | ||
47 | FIXME: documentation | ||
48 | */ | ||
49 | typedef struct opj_pi_resolution { | ||
50 | int pdx, pdy; | ||
51 | int pw, ph; | ||
52 | } opj_pi_resolution_t; | ||
53 | |||
54 | /** | ||
55 | FIXME: documentation | ||
56 | */ | ||
57 | typedef struct opj_pi_comp { | ||
58 | int dx, dy; | ||
59 | /** number of resolution levels */ | ||
60 | int numresolutions; | ||
61 | opj_pi_resolution_t *resolutions; | ||
62 | } opj_pi_comp_t; | ||
63 | |||
64 | /** | ||
65 | Packet iterator | ||
66 | */ | ||
67 | typedef struct opj_pi_iterator { | ||
68 | /** Enabling Tile part generation*/ | ||
69 | char tp_on; | ||
70 | /** precise if the packet has been already used (usefull for progression order change) */ | ||
71 | short int *include; | ||
72 | /** layer step used to localize the packet in the include vector */ | ||
73 | int step_l; | ||
74 | /** resolution step used to localize the packet in the include vector */ | ||
75 | int step_r; | ||
76 | /** component step used to localize the packet in the include vector */ | ||
77 | int step_c; | ||
78 | /** precinct step used to localize the packet in the include vector */ | ||
79 | int step_p; | ||
80 | /** component that identify the packet */ | ||
81 | int compno; | ||
82 | /** resolution that identify the packet */ | ||
83 | int resno; | ||
84 | /** precinct that identify the packet */ | ||
85 | int precno; | ||
86 | /** layer that identify the packet */ | ||
87 | int layno; | ||
88 | /** 0 if the first packet */ | ||
89 | int first; | ||
90 | /** progression order change information */ | ||
91 | opj_poc_t poc; | ||
92 | /** number of components in the image */ | ||
93 | int numcomps; | ||
94 | /** Components*/ | ||
95 | opj_pi_comp_t *comps; | ||
96 | int tx0, ty0, tx1, ty1; | ||
97 | int x, y, dx, dy; | ||
98 | } opj_pi_iterator_t; | ||
99 | |||
100 | /** @name Exported functions */ | ||
101 | /*@{*/ | ||
102 | /* ----------------------------------------------------------------------- */ | ||
103 | /** | ||
104 | Create a packet iterator for Encoder | ||
105 | @param image Raw image for which the packets will be listed | ||
106 | @param cp Coding parameters | ||
107 | @param tileno Number that identifies the tile for which to list the packets | ||
108 | @param t2_mode If == 0 In Threshold calculation ,If == 1 Final pass | ||
109 | @return Returns a packet iterator that points to the first packet of the tile | ||
110 | @see pi_destroy | ||
111 | */ | ||
112 | opj_pi_iterator_t *pi_initialise_encode(opj_image_t *image, opj_cp_t *cp, int tileno,J2K_T2_MODE t2_mode); | ||
113 | /** | ||
114 | Modify the packet iterator for enabling tile part generation | ||
115 | @param pi Handle to the packet iterator generated in pi_initialise_encode | ||
116 | @param cp Coding parameters | ||
117 | @param tileno Number that identifies the tile for which to list the packets | ||
118 | @param tpnum Tile part number of the current tile | ||
119 | @param tppos The position of the tile part flag in the progression order | ||
120 | */ | ||
121 | void pi_create_encode( opj_pi_iterator_t *pi, opj_cp_t *cp,int tileno, int pino,int tpnum, int tppos); | ||
122 | /** | ||
123 | Create a packet iterator for Decoder | ||
124 | @param image Raw image for which the packets will be listed | ||
125 | @param cp Coding parameters | ||
126 | @param tileno Number that identifies the tile for which to list the packets | ||
127 | @return Returns a packet iterator that points to the first packet of the tile | ||
128 | @see pi_destroy | ||
129 | */ | ||
130 | opj_pi_iterator_t *pi_create_decode(opj_image_t * image, opj_cp_t * cp, int tileno); | ||
131 | |||
132 | /** | ||
133 | Destroy a packet iterator | ||
134 | @param pi Previously created packet iterator | ||
135 | @param cp Coding parameters | ||
136 | @param tileno Number that identifies the tile for which the packets were listed | ||
137 | @see pi_create | ||
138 | */ | ||
139 | void pi_destroy(opj_pi_iterator_t *pi, opj_cp_t *cp, int tileno); | ||
140 | |||
141 | /** | ||
142 | Modify the packet iterator to point to the next packet | ||
143 | @param pi Packet iterator to modify | ||
144 | @return Returns false if pi pointed to the last packet or else returns true | ||
145 | */ | ||
146 | bool pi_next(opj_pi_iterator_t * pi); | ||
147 | /* ----------------------------------------------------------------------- */ | ||
148 | /*@}*/ | ||
149 | |||
150 | /*@}*/ | ||
151 | |||
152 | #endif /* __PI_H */ | ||