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(void);
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, Byte8_t 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_ */