OpenJPH
Open-source implementation of JPEG2000 Part-15
ojph_params.h
Go to the documentation of this file.
1//***************************************************************************/
2// This software is released under the 2-Clause BSD license, included
3// below.
4//
5// Copyright (c) 2019, Aous Naman
6// Copyright (c) 2019, Kakadu Software Pty Ltd, Australia
7// Copyright (c) 2019, The University of New South Wales, Australia
8//
9// Redistribution and use in source and binary forms, with or without
10// modification, are permitted provided that the following conditions are
11// met:
12//
13// 1. Redistributions of source code must retain the above copyright
14// notice, this list of conditions and the following disclaimer.
15//
16// 2. Redistributions in binary form must reproduce the above copyright
17// notice, this list of conditions and the following disclaimer in the
18// documentation and/or other materials provided with the distribution.
19//
20// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
21// IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22// TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
23// PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
24// HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
25// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
26// TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
27// PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
28// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
29// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
30// SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31//***************************************************************************/
32// This file is part of the OpenJPH software implementation.
33// File: ojph_params.h
34// Author: Aous Naman
35// Date: 28 August 2019
36//***************************************************************************/
37
38
39#ifndef OJPH_PARAMS_H
40#define OJPH_PARAMS_H
41
42#include "ojph_arch.h"
43#include "ojph_base.h"
44
45namespace ojph {
46
47 /***************************************************************************/
48 // defined here
49 class param_siz;
50 class param_cod;
51 class param_coc;
52 class param_qcd;
53 class param_cap;
54 class param_nlt;
55 class codestream;
56
57 /***************************************************************************/
58 // prototyping from local
59 namespace local {
60 struct param_siz;
61 struct param_cod;
62 struct param_coc;
63 struct param_qcd;
64 struct param_cap;
65 struct param_nlt;
66 class codestream;
67 }
68
69 /***************************************************************************/
71 {
72 public:
73 param_siz(local::param_siz *p) : state(p) {}
74
75 //setters
76 void set_image_extent(point extent);
77 void set_tile_size(size s);
78 void set_image_offset(point offset);
79 void set_tile_offset(point offset);
80 void set_num_components(ui32 num_comps);
81 void set_component(ui32 comp_num, const point& downsampling,
82 ui32 bit_depth, bool is_signed);
83
84 //getters
85 point get_image_extent() const;
86 point get_image_offset() const;
87 size get_tile_size() const;
88 point get_tile_offset() const;
89 ui32 get_num_components() const;
90 ui32 get_bit_depth(ui32 comp_num) const;
91 bool is_signed(ui32 comp_num) const;
92 point get_downsampling(ui32 comp_num) const;
93
94 //deeper getters
95 ui32 get_recon_width(ui32 comp_num) const;
96 ui32 get_recon_height(ui32 comp_num) const;
97
98 private:
100 };
101
102 /***************************************************************************/
104 {
105 public:
106 param_cod(local::param_cod* p) : state(p) {}
107
108 void set_num_decomposition(ui32 num_decompositions);
109 void set_block_dims(ui32 width, ui32 height);
110 void set_precinct_size(int num_levels, size* precinct_size);
111 void set_progression_order(const char *name);
112 void set_color_transform(bool color_transform);
113 void set_reversible(bool reversible);
114 param_coc get_coc(ui32 component_idx);
115
116 ui32 get_num_decompositions() const;
117 size get_block_dims() const;
118 size get_log_block_dims() const;
119 bool is_reversible() const;
120 size get_precinct_size(ui32 level_num) const;
121 size get_log_precinct_size(ui32 level_num) const;
122 int get_progression_order() const;
123 const char* get_progression_order_as_string() const;
124 int get_num_layers() const;
125 bool is_using_color_transform() const;
126 bool packets_may_use_sop() const;
127 bool packets_use_eph() const;
128 bool get_block_vertical_causality() const;
129
130 private:
132 };
133
134 /***************************************************************************/
136 {
137 public:
138 param_coc(local::param_cod* p) : state(p) {}
139
140 void set_num_decomposition(ui32 num_decompositions);
141 void set_block_dims(ui32 width, ui32 height);
142 void set_precinct_size(int num_levels, size* precinct_size);
143 void set_reversible(bool reversible);
144
145 ui32 get_num_decompositions() const;
146 size get_block_dims() const;
147 size get_log_block_dims() const;
148 bool is_reversible() const;
149 size get_precinct_size(ui32 level_num) const;
150 size get_log_precinct_size(ui32 level_num) const;
151 bool get_block_vertical_causality() const;
152
153 private:
155 };
156
157 /***************************************************************************/
163 {
164 public:
165 param_qcd(local::param_qcd* p) : state(p) {}
166
175 void set_irrev_quant(float delta);
176
188 void set_irrev_quant(ui32 comp_idx, float delta);
189
190 private:
192 };
193
194 /*************************************************************************/
245 {
246 public:
247 enum special_comp_num : ui16 { ALL_COMPS = 65535 };
249 OJPH_NLT_NO_NLT = 0, // supported
250 OJPH_NLT_GAMMA_STYLE_NLT = 1, // not supported
251 OJPH_NLT_LUT_STYLE_NLT = 2, // not supported
252 OJPH_NLT_BINARY_COMPLEMENT_NLT = 3, // supported
253 OJPH_NLT_UNDEFINED = 255 // This is used internally and is
254 // not part of the standard
255 };
256 public:
257 param_nlt(local::param_nlt* p) : state(p) {}
258
270 void set_nonlinear_transform(ui32 comp_num, ui8 nl_type);
271
282 bool get_nonlinear_transform(ui32 comp_num, ui8& bit_depth,
283 bool& is_signed, ui8& nl_type) const;
284
285 private:
287 };
288
289 /***************************************************************************/
291 {
292 friend class local::codestream;
293 public:
294 comment_exchange() : data(NULL), len(0), Rcom(0) {}
295 void set_string(const char* str);
296 void set_data(const char* data, ui16 len);
297
298 private:
299 const char* data;
302 };
303
304}
305
306#endif // !OJPH_PARAMS_H
param_coc(local::param_cod *p)
Definition: ojph_params.h:138
local::param_cod * state
Definition: ojph_params.h:154
local::param_cod * state
Definition: ojph_params.h:131
param_cod(local::param_cod *p)
Definition: ojph_params.h:106
non-linearity point transformation object (implements NLT marker segment)
Definition: ojph_params.h:245
param_nlt(local::param_nlt *p)
Definition: ojph_params.h:257
local::param_nlt * state
Definition: ojph_params.h:286
Quantization parameters object.
Definition: ojph_params.h:163
local::param_qcd * state
Definition: ojph_params.h:191
param_qcd(local::param_qcd *p)
Definition: ojph_params.h:165
local::param_siz * state
Definition: ojph_params.h:99
param_siz(local::param_siz *p)
Definition: ojph_params.h:73
uint16_t ui16
Definition: ojph_defs.h:52
uint32_t ui32
Definition: ojph_defs.h:54
uint8_t ui8
Definition: ojph_defs.h:50
#define OJPH_EXPORT
Definition: ojph_arch.h:119