2 * $Id: placeholder_manager.h 44 2011-02-15 12:32:29Z kaori $
4 * Copyright (c) 2002-2011, Communications and Remote Sensing Laboratory, Universite catholique de Louvain (UCL), Belgium
5 * Copyright (c) 2002-2011, Professor Benoit Macq
6 * Copyright (c) 2010-2011, Kaori Hagihara
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in the
16 * documentation and/or other materials provided with the distribution.
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS `AS IS'
19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
22 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28 * POSSIBILITY OF SUCH DAMAGE.
31 #ifndef PLACEHOLDER_MANAGER_H_
32 # define PLACEHOLDER_MANAGER_H_
34 #include "byte_manager.h"
35 #include "box_manager.h"
37 //! A.3.6.3 Placeholder box format
38 //! placeholder box parameters
39 typedef struct placeholder_param{
44 Byte_t *OrigBH; //!< dynamic memory pointer
45 Byte_t OrigBHlen; //!< length of OrigBH
48 Byte_t *EquivBH; //!< dynamic memory pointer
49 Byte_t EquivBHlen; //!< length of EquivBH
53 struct placeholder_param *next; //!< pointer to the next placeholder
54 } placeholder_param_t;
57 //! placeholder box list parameters
58 typedef struct placeholderlist_param{
59 placeholder_param_t *first; //!< first placeholder pointer of the list
60 placeholder_param_t *last; //!< last placeholder pointer of the list
61 } placeholderlist_param_t;
65 * generate a placeholder list
67 * @return pointer to the generated placeholder list
69 placeholderlist_param_t * gene_placeholderlist();
73 * delete placeholder list
75 * @param[in,out] list address of the placeholder list pointer
77 void delete_placeholderlist( placeholderlist_param_t **list);
81 * generate a placeholder of a box
83 * @param[in] box box pointer
84 * @param[in] origID metadata-bin ID of the bin containing the contents of the original box
85 * @return pointer to the generated placeholder
87 placeholder_param_t * gene_placeholder( box_param_t *box, int origID);
91 * delete a placeholder
93 * @param[in,out] placeholder address of the placeholder pointer
95 void delete_placeholder( placeholder_param_t **placeholder);
97 void insert_placeholder_into_list( placeholder_param_t *phld, placeholderlist_param_t *phldlist);
101 * print placeholder parameters
103 * @param[in] phld placeholder pointer
105 void print_placeholder( placeholder_param_t *phld);
109 * print all placeholder parameters
111 * @param[in] list placeholder list pointer
113 void print_allplaceholder( placeholderlist_param_t *list);
115 #endif /* !PLACEHOLDER_MANAGER_H_ */