summaryrefslogtreecommitdiffstats
path: root/doc/html/RM_H5Z.html
diff options
context:
space:
mode:
authorFrank Baker <fbaker@hdfgroup.org>2005-07-19 17:28:56 (GMT)
committerFrank Baker <fbaker@hdfgroup.org>2005-07-19 17:28:56 (GMT)
commit794ba0a251af47b8e3c60afa2fe92d267e2a6b55 (patch)
treef24cea3b81ff02fa3f31c0a1c4e80fa10f4393c0 /doc/html/RM_H5Z.html
parentd2e92fd23610c3ccdddbbc55484e54a5a21a9252 (diff)
downloadhdf5-794ba0a251af47b8e3c60afa2fe92d267e2a6b55.zip
hdf5-794ba0a251af47b8e3c60afa2fe92d267e2a6b55.tar.gz
hdf5-794ba0a251af47b8e3c60afa2fe92d267e2a6b55.tar.bz2
[svn-r11084]
Description: All HDF5 user documentation has been moved to a separate hdf5doc/ repository, managed under Subversion. With this 'cvs commit', all files are stripped from hdf5/doc/. THIS CHANGE IS APPLIED ONLY TO THE HDF5 DEVELOPMENT BRANCH, post Release 1.6.x; it is not applied to the release branches.
Diffstat (limited to 'doc/html/RM_H5Z.html')
-rw-r--r--doc/html/RM_H5Z.html655
1 files changed, 0 insertions, 655 deletions
diff --git a/doc/html/RM_H5Z.html b/doc/html/RM_H5Z.html
deleted file mode 100644
index 0d46864..0000000
--- a/doc/html/RM_H5Z.html
+++ /dev/null
@@ -1,655 +0,0 @@
-<html>
-<head>
-<title>
-HDF5/H5Z API Specification
-</title>
-
-<!-- #BeginLibraryItem "/ed_libs/styles_RM.lbi" -->
-
-<!--
- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- * 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://hdf.ncsa.uiuc.edu/HDF5/doc/Copyright.html. If you do not have *
- * access to either file, you may request a copy from hdfhelp@ncsa.uiuc.edu. *
- * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- -->
-
-<link href="ed_styles/RMelect.css" rel="stylesheet" type="text/css">
-<!-- #EndLibraryItem --></head>
-
-<body bgcolor="#FFFFFF">
-<!-- HEADER RIGHT " " -->
-
-
-<!-- #BeginLibraryItem "/ed_libs/NavBar_RM.lbi" --><hr>
-<center>
-<table border=0 width=98%>
-<tr><td valign=top align=left>
-<a href="index.html">HDF5 documents and links</a>&nbsp;<br>
-<a href="H5.intro.html">Introduction to HDF5</a>&nbsp;<br>
-<a href="http://hdf.ncsa.uiuc.edu/HDF5/doc/UG/index.html">HDF5 User Guide</a>&nbsp;<br>
-<!--
-<a href="Glossary.html">Glossary</a><br>
--->
-</td>
-<td valign=top align=right>
-And in this document, the
-<a href="RM_H5Front.html">HDF5 Reference Manual</a>&nbsp;&nbsp;
-<br>
-<a href="http://hdf.ncsa.uiuc.edu/HDF5/hdf5_hl/doc/RM_hdf5im.html">H5IM</a>&nbsp;&nbsp;
-<a href="http://hdf.ncsa.uiuc.edu/HDF5/hdf5_hl/doc/RM_hdf5lt.html">H5LT</a>&nbsp;&nbsp;
-<a href="http://hdf.ncsa.uiuc.edu/HDF5/hdf5_hl/doc/RM_hdf5pt.html">H5PT</a>&nbsp;&nbsp;
-<a href="http://hdf.ncsa.uiuc.edu/HDF5/hdf5_hl/doc/RM_hdf5tb.html">H5TB</a>&nbsp;&nbsp;
-<br>
-<a href="RM_H5.html">H5</a>&nbsp;&nbsp;
-<a href="RM_H5A.html">H5A</a>&nbsp;&nbsp;
-<a href="RM_H5D.html">H5D</a>&nbsp;&nbsp;
-<a href="RM_H5E.html">H5E</a>&nbsp;&nbsp;
-<a href="RM_H5F.html">H5F</a>&nbsp;&nbsp;
-<a href="RM_H5G.html">H5G</a>&nbsp;&nbsp;
-<a href="RM_H5I.html">H5I</a>&nbsp;&nbsp;
-<a href="RM_H5P.html">H5P</a>&nbsp;&nbsp;
-<br>
-<a href="RM_H5R.html">H5R</a>&nbsp;&nbsp;
-<a href="RM_H5S.html">H5S</a>&nbsp;&nbsp;
-<a href="RM_H5T.html">H5T</a>&nbsp;&nbsp;
-<a href="RM_H5Z.html">H5Z</a>&nbsp;&nbsp;
-<a href="Tools.html">Tools</a>&nbsp;&nbsp;
-<a href="PredefDTypes.html">Datatypes</a>&nbsp;&nbsp;
-</td></tr>
-</table>
-</center>
-<hr><!-- #EndLibraryItem --><center>
-<h1>H5Z: Filter and Compression Interface</h1>
-</center>
-
-<h2>Filter and Compression API Functions</h2>
-
-These functions enable the user to configure new filters
-for the local environment.
-
-<table border=0 width=80%>
-<tr><td valign=top width="30%">
-<ul>
- <li><a href="#Compression-FilterAvail">H5Zfilter_avail</a><br>
- <li><a href="#Compression-GetFilterInfo">H5Zget_filter_info</a>
-</ul>
-</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top width="30%">
-<ul>
- <li><a href="#Compression-Register">H5Zregister</a>
-</ul>
-</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top width="30%">
-<ul>
- <li><a href="#Compression-Unregister">H5Zunregister</a>
-</ul>
-</td></tr>
-</table>
-
-<br>
-<strong>The FORTRAN90 Interfaces:</strong>
-<br>
-In general, each FORTRAN90 subroutine performs exactly the same task
-as the corresponding C function.
-<br>
-
-<table border=0 width=80%>
-<tr><td valign=top width="30%">
- <ul>
- <li><a href="#Compression-FilterAvail">h5zfilter_avail_f</a>
- </ul>
-</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top width="30%">
- <ul>
-<!--<li><a href="#Compression-Register">h5zregister_f</a><br> -->
- <li><a href="#Compression-GetFilterInfo">h5zget_filter_info_f</a>
- </ul>
-</td><td>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</td><td valign=top width="30%">
- <ul>
- <li><a href="#Compression-Unregister">h5zunregister_f</a>
- </ul>
-</td></tr>
-</table>
-
-<p>
-HDF5 supports a filter pipeline that provides the capability for standard
-and customized raw data processing during I/O operations.
-HDF5 is distributed with a small set of standard filters such as
-compression (gzip, SZIP, and a shuffling algorithm) and
-error checking (Fletcher32 checksum).
-For further flexibility, the library allows a
-user application to extend the pipeline through the
-creation and registration of customized filters.
-<p>
-The flexibility of the filter pipeline implementation enables the
-definition of additional filters by a user application.
-A filter
- <ul>
- <li>is associated with a dataset when the dataset is created,
- <li>can be used only with chunked data
- <br>(i.e., datasets stored in the <code>H5D_CHUNKED</code>
- storage layout), and
- <li>is applied independently to each chunk of the dataset.
- </ul>
-<p>
-The HDF5 library does not support filters for contiguous datasets
-because of the difficulty of implementing random access for partial I/O.
-Compact dataset filters are not supported because it would not produce
-significant results.
-<p>
-Filter identifiers for the filters distributed with the HDF5 Library
-are as follows:
-<table align=center border=0>
- <tr valign=top align=left>
- <td>
- <code>H5Z_FILTER_DEFLATE</code></td><td>The gzip compression,
- or deflation, filter
- </td></tr><tr><td>
- <code>H5Z_FILTER_SZIP</code></td><td>The SZIP compression filter
- </td></tr><tr><td>
- <code>H5Z_FILTER_SHUFFLE</code></td><td>The shuffle algorithm filter
- </td></tr><tr><td>
- <code>H5Z_FILTER_FLETCHER32&nbsp;&nbsp;</code></td><td>The Fletcher32 checksum,
- or error checking, filter
- </td></tr>
-</table>
-Custom filters that have been registered with the library will have
-additional unique identifiers.
-<p>
-See <a href="Datasets.html"><cite>The Dataset Interface (H5D)</cite></a>
-in the <cite>HDF5 User's Guide</cite> for further information regarding
-data compression.
-
-<!-- NEW PAGE -->
-<!-- HEADER RIGHT " " -->
-<!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Zfilter_avail" -->
-<hr>
-<dl>
- <dt><strong>Name:</strong> <a name="Compression-FilterAvail">H5Zfilter_avail</a>
- <dt><strong>Signature:</strong>
- <dd><em>herr_t</em> <code>H5Zfilter_avail</code>(<em>H5Z_filter_t</em> <code>filter</code>)
- <dt><strong>Purpose:</strong>
- <dd>Determines whether a filter is available.
- <dt><strong>Description:</strong>
- <dd><code>H5Zfilter_avail</code> determines whether the filter
- specified in <code>filter</code> is available to the application.
- <dt><strong>Parameters:</strong>
- <ul><table>
- <tr>
- <td valign="top"><em>H5Z_filter_t</em>&nbsp;<code>filter&nbsp;&nbsp;&nbsp;&nbsp;</code></td>
- <td valign="top">IN: Filter identifier.
- See the introduction to this section of the reference manual
- for a list of valid filter identifiers.</td></tr>
- </table></ul>
- <dt><strong>Returns:</strong>
- <dd>Returns a non-negative value if successful;
- otherwise returns a negative value.
- <dt><strong>Fortran90 Interface:</strong> h5zfilter_avail_f
- <dd>
- <pre>
-SUBROUTINE h5zfilter_avail_f(filter, status, hdferr)
- IMPLICIT NONE
- INTEGER, INTENT(IN) :: filter ! Filter
- ! Valid values are:
- ! H5Z_FILTER_DEFLATE_F
- ! H5Z_FILTER_SHUFFLE_F
- ! H5Z_FILTER_FLETCHER32_F
- ! H5Z_FILTER_SZIP_F
- LOGICAL, INTENT(OUT) :: status ! Flag indicating whether
- ! filter is available:
- ! .TRUE.
- ! .FALSE.
-END SUBROUTINE h5zfilter_avail_f
- </pre>
-
- <!--<dt><strong>Non-C API(s):</strong>
- <dd>
-
- <img src="Graphics/Java.gif">
- <img src="Graphics/C++.gif">
- -->
-</dl>
-
-
-<!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Zget_filter_info" -->
-<hr>
-<dl>
-<dt><strong>Name:</strong> <a name="Compression-GetFilterInfo">H5Zget_filter_info</a>
-<dt><strong>Signature:</strong>
- <dd><em>herr_t</em>
- <code>H5Zget_filter_info</code>(
- <em>H5Z_filter_t</em> <code>filter</code>,
- <em>unsigned int *</em><code>filter_config_flags</code>
- )
-<dt><strong>Purpose:</strong>
- <dd>Retrieves information about a filter.
-<dt><strong>Description:</strong>
- <dd>
- <code>H5Zget_filter_info</code> retrieves information about a filter.
- At present, this means that the function retrieves a
- filter's configuration flags, indicating whether the filter is
- configured to decode data, to encode data, neither, or both.
- <p>
- If <code>filter_config_flags</code> is not set to <small>NULL</small>
- prior to the function call, the returned parameter contains a
- bit field specifying the available filter configuration.
- The configuration flag values can then be determined through
- a series of bitwise <small>AND</small> operations, as described below.
- <p>
- Valid filter configuration flags include the following:
- <table>
- <tr><td><code>&nbsp;&nbsp;&nbsp;&nbsp;</code></td>
- <td><code>H5Z_FILTER_CONFIG_ENCODE_ENABLED</code></td>
- <td>Encoding is enabled for this filter
- </td></tr>
- <tr><td>&nbsp;</td>
- <td><code>H5Z_FILTER_CONFIG_DECODE_ENABLED</code>&nbsp;&nbsp;&nbsp;&nbsp;</td>
- <td>Decoding is enabled for this filter
- </td></tr>
- <tr><td>&nbsp;</td>
- <td colspan="2" align="right"><small>(These flags
- are defined in the HDF5 Library source code file
- <code>H5Zpublic.h</code>.)</small>
- </td></tr>
- </table>
- A bitwise <small>AND</small> of the returned
- <code>filter_config_flags</code> and a valid
- filter configuration flag will reveal whether
- the related configuration option is available.
- For example, if the value of
- <br>
- <code>&nbsp;&nbsp;&nbsp;&nbsp;
- H5Z_FILTER_CONFIG_ENCODE_ENABLED
- &amp;
- filter_config_flags</code>
- <br>
- is true, i.e., greater than <code>0</code> (zero),
- the queried filter is configured to encode data;
- if the value is <code>FALSE</code>,
- i.e., equal to <code>0</code> (zero),
- the filter is not so configured.
- <p>
- If a filter is not encode-enabled, the corresponding
- <code>H5Pset_*</code> function will return an error if the
- filter is added to a dataset creation property list (which is
- required if the filter is to be used to encode that dataset).
- For example, if the <code>H5Z_FILTER_CONFIG_ENCODE_ENABLED</code>
- flag is not returned for the SZIP filter,
- <code>H5Z_FILTER_SZIP</code>, a call to <code>H5Pset_szip</code>
- will fail.
- <p>
- If a filter is not decode-enabled, the application will not be
- able to read an existing file encoded with that filter.
- <p>
- This function should be called, and the returned
- <code>filter_config_flags</code> analyzed, before calling
- any other function, such as <code>H5Pset_szip</code>,
- that might require a particular filter configuration.
-
-<dt><strong>Parameters:</strong>
- <dl>
- <dt><em>H5Z_filter_t</em> <code>filter</code>
- <dd>IN: Identifier of the filter to query.
- See the introduction to this section of the reference manual
- for a list of valid filter identifiers.
- <dt><em>unsigned int *</em><code>filter_config_flags</code>
- <dd>OUT: A bit field encoding the returned filter information
- </dl>
-<dt><strong>Returns:</strong>
- <dd>Returns a non-negative value on success,
- a negative value on failure.
-
-<!-- NEW PAGE -->
-<dt><strong>Fortran90 Interface:</strong>
- <dd>
- <pre>
-SUBROUTINE h5zget_filter_info_f(filter, config_flags, hdferr)
-
- IMPLICIT NONE
- INTEGER, INTENT(IN) :: filter ! Filter, may be one of the
- ! following:
- ! H5Z_FILTER_DEFLATE_F
- ! H5Z_FILTER_SHUFFLE_F
- ! H5Z_FILTER_FLETCHER32_F
- ! H5Z_FILTER_SZIP_F
- INTEGER, INTENT(OUT) :: config_flags ! Bit field indicating whether
- ! a filter's encoder and/or
- ! decoder are available
- INTEGER, INTENT(OUT) :: hdferr ! Error code
-
-END SUBROUTINE h5zfilter_avail_f
- </pre>
- <!--<dt><strong>Non-C API(s):</strong>
- <dd>
-
- <img src="Graphics/Java.gif">
- <img src="Graphics/C++.gif">
- -->
-</dl>
-
-
-<!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Zregister" -->
-<hr>
-<dl>
-<dt><strong>Name:</strong> <a name="Compression-Register">H5Zregister</a>
-<dt><strong>Signature:</strong>
- <dd><em>herr_t</em> <code>H5Zregister</code>(<em>const H5Z_class_t</em> <code>filter_class</code>)
- )
-<dt><strong>Purpose:</strong>
- <dd>Registers new filter.
-<dt><strong>Description:</strong>
- <dd><code>H5Zregister</code> registers a new filter with the
- HDF5 library.
- <p>
- Making a new filter available to an application is a two-step
- process. The first step is to write
- the three filter callback functions described below:
- <code>can_apply_func</code>, <code>set_local_func</code>, and
- <code>filter_func</code>.
- This call to <code>H5Zregister</code>,
- <span class="termEmphasis">registering</span> the filter with the
- library, is the second step.
- The <code>can_apply_func</code> and <code>set_local_func</code>
- fields can be set to <code>NULL</code>
- if they are not required for the filter being registered.
- <p>
- <code>H5Zregister</code> accepts a single parameter,
- the <code>filter_class</code> data structure,
- which is defined as follows:
- <pre>
- &nbsp; typedef struct H5Z_class_t {
- &nbsp; H5Z_filter_t filter_id;
- &nbsp; const char *comment;
- &nbsp; H5Z_can_apply_func_t can_apply_func;
- &nbsp; H5Z_set_local_func_t set_local_func;
- &nbsp; H5Z_func_t filter_func;
- &nbsp; } H5Z_class_t;
- </pre>
-
- <p>
- <code>filter_id</code> is the identifier for the new filter.
- This is a user-defined value between
- <code>H5Z_FILTER_RESERVED</code> and <code>H5Z_FILTER_MAX</code>,
- both of which are defined in the HDF5 source file
- <code>H5Zpublic.h</code>.
- <p>
- <code>comment</code> is used for debugging,
- may contain a descriptive name for the filter,
- and may be the null pointer.
- <p>
- <code>can_apply_func</code>, described in detail below,
- is a user-defined callback function which determines whether
- the combination of the dataset creation property list values,
- the datatype, and the dataspace represent a valid combination
- to apply this filter to.
- <p>
- <code>set_local_func</code>, described in detail below,
- is a user-defined callback function which sets any parameters that
- are specific to this dataset, based on the combination of the
- dataset creation property list values, the datatype, and the
- dataspace.
- <p>
- <code>filter_func</code>, described in detail below,
- is a user-defined callback function which performs the action
- of the filter.
- <p>
- The statistics associated with a filter are not reset
- by this function; they accumulate over the life of the library.
-
- <p>
- <strong>The callback functions</strong>
- <br>
- Before <code>H5Zregister</code> can link a filter into an
- application, three callback functions must be defined
- as described in the HDF5 Library header file <code>H5Zpublic.h</code>.
-
- <p>
- <u>The <i>can apply</i> callback function</u> is defined as follows:<br>
- <dir>
- <em>typedef herr_t</em> (*<code>H5Z_can_apply_func_t</code>)
- (<em>hid_t</em> <code>dcpl_id</code>,
- <em>hid_t</em> <code>type_id</code>,
- <em>hid_t</em> <code>space_id</code>)
- </dir>
- <p>
- Before a dataset is created, the <i>can apply</i> callbacks for
- any filters used in the dataset creation property list are called
- with the dataset's dataset creation property list, <code>dcpl_id</code>,
- the dataset's datatype, <code>type_id</code>, and
- a dataspace describing a chunk, <code>space_id</code>,
- (for chunked dataset storage).
- <p>
- This callback must determine whether the combination of the
- dataset creation property list settings, the datatype, and the
- dataspace represent a valid combination to which to apply this filter.
- For example, an invalid combination may involve
- the filter not operating correctly on certain datatypes,
- on certain datatype sizes, or on certain sizes of the chunk dataspace.
- <p>
- This callback can be the <code>NULL</code> pointer, in which case
- the library will assume that the filter can be applied to a dataset with
- any combination of dataset creation property list values, datatypes,
- and dataspaces.
- <p>
- The <i>can apply</i> callback function must return
- a positive value for a valid combination,
- zero for an invalid combination, and
- a negative value for an error.
-
- <p>
- <u>The <i>set local</i> callback function</u> is defined as follows:<br>
- <dir>
- <em>typedef herr_t</em> (*<code>H5Z_set_local_func_t</code>)
- (<em>hid_t</em> <code>dcpl_id</code>,
- <em>hid_t</em> <code>type_id</code>,
- <em>hid_t</em> <code>space_id</code>)
- </dir>
- <p>
- After the <i>can apply</i> callbacks are checked for a new dataset,
- the <i>set local</i> callback functions for any filters used in the
- dataset creation property list are called.
- These callbacks receive
- <code>dcpl_id</code>, the dataset's private copy of the dataset
- creation property list passed in to <code>H5Dcreate</code>
- (i.e. not the actual property list passed in to <code>H5Dcreate</code>);
- <code>type_id</code>, the datatype identifier passed in to
- <code>H5Dcreate</code>,
- which is not copied and should not be modified; and
- <code>space_id</code>, a dataspace describing the chunk
- (for chunked dataset storage), which should also not be modified.
- <p>
- The <i>set local</i> callback must set any filter parameters that are
- specific to this dataset, based on the combination of the
- dataset creation property list values, the datatype, and the dataspace.
- For example, some filters perform different actions based on
- different datatypes, datatype sizes, numbers of dimensions,
- or dataspace sizes.
- <p>
- The <i>set local</i> callback may be the <code>NULL</code> pointer,
- in which case, the library will assume that there are
- no dataset-specific settings for this filter.
- <p>
- The <i>set local</i> callback function must return
- a non-negative value on success and
- a negative value for an error.
-
- <p>
- <u>The <i>filter operation</i> callback function</u>,
- defining the filter's operation on the data, is defined as follows:
- <dir>
- <em>typedef size_t</em> (*<code>H5Z_func_t</code>)
- (<em>unsigned int</em> <code>flags</code>,
- <em>size_t</em> <code>cd_nelmts</code>,
- <em>const unsigned int</em> <code>cd_values[]</code>,
- <em>size_t</em> <code>nbytes</code>,
- <em>size_t *</em><code>buf_size</code>,
- <em>void **</em><code>buf</code>)
- </dir>
-
- <p>
- The parameters <code>flags</code>, <code>cd_nelmts</code>,
- and <code>cd_values</code> are the same as for the function
- <a href="RM_H5P.html#Property-SetFilter"><code>H5Pset_filter</code></a>.
- The one exception is that an additional flag,
- <code>H5Z_FLAG_REVERSE</code>, is set when
- the filter is called as part of the input pipeline.
- <p>
- The parameter <code>*buf</code> points to the input buffer
- which has a size of <code>*buf_size</code> bytes,
- <code>nbytes</code> of which are valid data.
- <p>
- The filter should perform the transformation in place if
- possible. If the transformation cannot be done in place,
- then the filter should allocate a new buffer with
- <code>malloc()</code> and assign it to <code>*buf</code>,
- assigning the allocated size of that buffer to
- <code>*buf_size</code>.
- The old buffer should be freed by calling <code>free()</code>.
- <p>
- If successful, the <i>filter operation</i> callback function
- returns the number of valid bytes of data contained in <code>*buf</code>.
- In the case of failure, the return value is <code>0</code> (zero)
- and all pointer arguments are left unchanged.
-<dt><strong>Note:</strong>
- <dd>The <code>H5Zregister</code> interface is substantially revised
- from the HDF5 Release 1.4.x series.
- The <code>H5Z_class_t</code> struct and
- the <i>set local</i> and <i>can apply</i> callback functions
- first appeared in HDF5 Release 1.6.
-<dt><strong>Parameters:</strong>
- <ul><table>
- <tr>
- <td valign="top"><em>const&nbsp;H5Z_class_t</em>&nbsp;<code>filter_class&nbsp;&nbsp;&nbsp;&nbsp;</code></td>
- <td valign="top">IN: Struct containing filter-definition information.</td></tr>
- </table></ul>
-<dt><strong>Returns:</strong>
- <dd>Returns a non-negative value if successful;
- otherwise returns a negative value.
-<dt><strong>Fortran90 Interface:</strong>
- <dd>None.
-<!--
- <pre>
-
- </pre>
--->
-
- <!--<dt><strong>Non-C API(s):</strong>
- <dd>
-
- <img src="Graphics/Java.gif">
- <img src="Graphics/C++.gif">
- -->
-</dl>
-
-<!-- NEW PAGE -->
-<!-- HEADER RIGHT "H5Zunregister" -->
-<hr>
-<dl>
- <dt><strong>Name:</strong> <a name="Compression-Unregister">H5Zunregister</a>
- <dt><strong>Signature:</strong>
- <dd><em>herr_t</em> <code>H5Zunregister</code>(<em>H5Z_filter_t</em> <code>filter</code>)
- <dt><strong>Purpose:</strong>
- <dd>Unregisters a filter.
- <dt><strong>Description:</strong>
- <dd><code>H5Zunregister</code> unregisters the filter
- specified in <code>filter</code>.  
- <p>
- After a call to <code>H5Zunregister</code>, the filter
- specified in <code>filter</code> will no longer be
- available to the application.
- <dt><strong>Parameters:</strong>
- <ul><table>
- <tr>
- <td valign="top"><em>H5Z_filter_t</em>&nbsp;<code>filter&nbsp;&nbsp;&nbsp;&nbsp;</code></td>
- <td valign="top">IN: Identifier of the filter to be unregistered.
- See the introduction to this section of the reference manual
- for a list of identifiers for standard filters
- distributed with the HDF5 Library.</td></tr>
- </table></ul>
- <dt><strong>Returns:</strong>
- <dd>Returns a non-negative value if successful;
- otherwise returns a negative value.
- <dt><strong>Fortran90 Interface:</strong> h5zunregister_f
- <dd>
- <pre>
-SUBROUTINE h5zunregister_f(filter, hdferr)
- IMPLICIT NONE
- INTEGER, INTENT(IN) :: filter ! Filter; one of the possible values:
- ! H5Z_FILTER_DEFLATE_F
- ! H5Z_FILTER_SHUFFLE_F
- ! H5Z_FILTER_FLETCHER32_F
- ! H5Z_FILTER_SZIP_F
- INTEGER, INTENT(OUT) :: hdferr ! Error code
- ! 0 on success, and -1 on failure
-END SUBROUTINE h5zunregister_f
- </pre>
-
- <!--<dt><strong>Non-C API(s):</strong>
- <dd>
-
- <img src="Graphics/Java.gif">
- <img src="Graphics/C++.gif">
- -->
-</dl>
-
-<!-- HEADER RIGHT " " -->
-
-<!-- #BeginLibraryItem "/ed_libs/NavBar_RM.lbi" --><hr>
-<center>
-<table border=0 width=98%>
-<tr><td valign=top align=left>
-<a href="index.html">HDF5 documents and links</a>&nbsp;<br>
-<a href="H5.intro.html">Introduction to HDF5</a>&nbsp;<br>
-<a href="http://hdf.ncsa.uiuc.edu/HDF5/doc/UG/index.html">HDF5 User Guide</a>&nbsp;<br>
-<!--
-<a href="Glossary.html">Glossary</a><br>
--->
-</td>
-<td valign=top align=right>
-And in this document, the
-<a href="RM_H5Front.html">HDF5 Reference Manual</a>&nbsp;&nbsp;
-<br>
-<a href="http://hdf.ncsa.uiuc.edu/HDF5/hdf5_hl/doc/RM_hdf5im.html">H5IM</a>&nbsp;&nbsp;
-<a href="http://hdf.ncsa.uiuc.edu/HDF5/hdf5_hl/doc/RM_hdf5lt.html">H5LT</a>&nbsp;&nbsp;
-<a href="http://hdf.ncsa.uiuc.edu/HDF5/hdf5_hl/doc/RM_hdf5pt.html">H5PT</a>&nbsp;&nbsp;
-<a href="http://hdf.ncsa.uiuc.edu/HDF5/hdf5_hl/doc/RM_hdf5tb.html">H5TB</a>&nbsp;&nbsp;
-<br>
-<a href="RM_H5.html">H5</a>&nbsp;&nbsp;
-<a href="RM_H5A.html">H5A</a>&nbsp;&nbsp;
-<a href="RM_H5D.html">H5D</a>&nbsp;&nbsp;
-<a href="RM_H5E.html">H5E</a>&nbsp;&nbsp;
-<a href="RM_H5F.html">H5F</a>&nbsp;&nbsp;
-<a href="RM_H5G.html">H5G</a>&nbsp;&nbsp;
-<a href="RM_H5I.html">H5I</a>&nbsp;&nbsp;
-<a href="RM_H5P.html">H5P</a>&nbsp;&nbsp;
-<br>
-<a href="RM_H5R.html">H5R</a>&nbsp;&nbsp;
-<a href="RM_H5S.html">H5S</a>&nbsp;&nbsp;
-<a href="RM_H5T.html">H5T</a>&nbsp;&nbsp;
-<a href="RM_H5Z.html">H5Z</a>&nbsp;&nbsp;
-<a href="Tools.html">Tools</a>&nbsp;&nbsp;
-<a href="PredefDTypes.html">Datatypes</a>&nbsp;&nbsp;
-</td></tr>
-</table>
-</center>
-<hr><!-- #EndLibraryItem --><!-- #BeginLibraryItem "/ed_libs/Footer.lbi" --><address>
-<a href="mailto:hdfhelp@ncsa.uiuc.edu">HDF Help Desk</a>
-<br>
-Describes HDF5 Release 1.7, the unreleased development branch; working toward HDF5 Release 1.8.0
-</address><!-- #EndLibraryItem --><SCRIPT LANGUAGE="JAVASCRIPT">
-<!--
-document.writeln("Last modified: 2 September 2004");
--->
-</SCRIPT>
-
-</body>
-</html>