summaryrefslogtreecommitdiffstats
path: root/c++/src/H5DcreatProp.h
blob: f0475eb398390104642727a9e60347511def479a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
// C++ informative line for the emacs editor: -*- C++ -*-
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 * Copyright by The HDF Group.                                               *
 * Copyright by the Board of Trustees of the University of Illinois.         *
 * All rights reserved.                                                      *
 *                                                                           *
 * This file is part of HDF5.  The full HDF5 copyright notice, including     *
 * terms governing use, modification, and redistribution, is contained in    *
 * the files COPYING and Copyright.html.  COPYING can be found at the root   *
 * of the source code distribution tree; Copyright.html can be found at the  *
 * root level of an installed copy of the electronic HDF5 document set and   *
 * is linked from the top-level documents page.  It can also be found at     *
 * http://hdfgroup.org/HDF5/doc/Copyright.html.  If you do not have          *
 * access to either file, you may request a copy from help@hdfgroup.org.     *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

#ifndef __H5DSCreatPropList_H
#define __H5DSCreatPropList_H

namespace H5 {

class DataType;
class DataSpace;

/*! \class DSetCreatPropList
    \brief Class DSetCreatPropList inherits from ObjCreatPropList and provides
    wrappers for the HDF5 dataset creation property functions.

    Inheritance: ObjCreatPropList -> PropList -> IdComponent
*/
class H5_DLLCPP DSetCreatPropList : public ObjCreatPropList {
   public:
        ///\brief Default dataset creation property list.
        static const DSetCreatPropList& DEFAULT;

        // Creates a dataset creation property list.
        DSetCreatPropList();

        // Queries whether all the filters set in this property list are
        // available currently.
        bool allFiltersAvail() const;

        // Get space allocation time for this property.
        H5D_alloc_time_t getAllocTime() const;

        // Set space allocation time for dataset during creation.
        void setAllocTime(H5D_alloc_time_t alloc_time) const;

        // Retrieves the size of the chunks used to store a chunked layout dataset.
        int getChunk(int max_ndims, hsize_t* dim) const;

        // Sets the size of the chunks used to store a chunked layout dataset.
        void setChunk(int ndims, const hsize_t* dim) const;

        // Returns information about an external file.
        void getExternal(unsigned idx, size_t name_size, char* name, off_t& offset, hsize_t& size) const;

        // Returns the number of external files for a dataset.
        int getExternalCount() const;

        // Gets fill value writing time.
        H5D_fill_time_t getFillTime() const;

        // Sets fill value writing time for dataset.
        void setFillTime(H5D_fill_time_t fill_time) const;

        // Retrieves a dataset fill value.
        void getFillValue(const DataType& fvalue_type, void* value) const;

        // Sets a dataset fill value.
        void setFillValue(const DataType& fvalue_type, const void* value) const;

        // Returns information about a filter in a pipeline.
        H5Z_filter_t getFilter(int filter_number, unsigned int& flags, size_t& cd_nelmts, unsigned int* cd_values, size_t namelen, char name[], unsigned int &filter_config) const;

        // Returns information about a filter in a pipeline given the filter id.
        void getFilterById(H5Z_filter_t filter_id, unsigned int &flags, size_t &cd_nelmts, unsigned int* cd_values, size_t namelen, char name[], unsigned int &filter_config) const;

        // Gets the layout of the raw data storage of the data that uses this
        // property list.
        H5D_layout_t getLayout() const;

        // Sets the type of storage used to store the raw data for the
        // dataset that uses this property list.
        void setLayout(H5D_layout_t layout) const;

        // Returns the number of filters in the pipeline.
        int getNfilters() const;

        // Checks if fill value has been defined for this property.
        H5D_fill_value_t isFillValueDefined() const;

        // Modifies the specified filter.
        void modifyFilter(H5Z_filter_t filter_id, unsigned int flags, size_t cd_nelmts, const unsigned int cd_values[]) const;

        // Remove one or all filters from the filter pipeline.
        void removeFilter(H5Z_filter_t filter_id) const;

        // Sets compression method and compression level.
        void setDeflate(int level) const;

        // Adds an external file to the list of external files.
        void setExternal(const char* name, off_t offset, hsize_t size) const;

        // Adds a filter to the filter pipeline.
        void setFilter(H5Z_filter_t filter, unsigned int flags = 0, size_t cd_nelmts = 0, const unsigned int cd_values[] = NULL) const;

        // Sets Fletcher32 checksum of EDC for this property list.
        void setFletcher32() const;

        // Sets method of the shuffle filter.
        void setShuffle() const;

        // Sets SZIP compression method.
        void setSzip(unsigned int options_mask, unsigned int pixels_per_block) const;

        // Sets N-bit compression method.
        void setNbit() const;

        // Maps elements of a virtual dataset to elements of the source dataset.
        void setVirtual(const DataSpace& vspace, const char *src_fname, const char *src_dsname, const DataSpace& sspace) const;
        void setVirtual(const DataSpace& vspace, const H5std_string src_fname, const H5std_string src_dsname, const DataSpace& sspace) const;

        ///\brief Returns this class name.
        virtual H5std_string fromClass () const { return("DSetCreatPropList"); }

        // Copy constructor: creates a copy of a DSetCreatPropList object.
        DSetCreatPropList(const DSetCreatPropList& orig);

        // Creates a copy of an existing dataset creation property list
        // using the property list id.
        DSetCreatPropList(const hid_t plist_id);

        // Noop destructor.
        virtual ~DSetCreatPropList();

#ifndef DOXYGEN_SHOULD_SKIP_THIS

        // Deletes the global constant, should only be used by the library
        static void deleteConstants();

    private:
        static DSetCreatPropList* DEFAULT_;

        // Creates the global constant, should only be used by the library
        static DSetCreatPropList* getConstant();

#endif // DOXYGEN_SHOULD_SKIP_THIS

}; // end of DSetCreatPropList
} // namespace H5

#endif // __H5DSCreatPropList_H