Changeset 1039
- Timestamp:
- 06/04/07 14:34:34 (2 years ago)
- Files:
-
- 1 modified
-
MOAB/trunk/mhdf/include/mhdf.h (modified) (36 diffs)
Legend:
- Unmodified
- Added
- Removed
-
MOAB/trunk/mhdf/include/mhdf.h
r990 r1039 4 4 * 5 5 * Copyright 2004 Sandia Corporation. Under the terms of Contract 6 * DE-AC04-94AL85000 with Sandia Cor oporation, the U.S. Government6 * DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government 7 7 * retains certain rights in this software. 8 8 * … … 144 144 * should be used. If a constant does not exist for 145 145 * the type, a similar naming pattern should be used 146 * (accepted name for type, first chara ster uppercase,146 * (accepted name for type, first character uppercase, 147 147 * subsequent characters lowercase.) The element type 148 148 * index passed to \ref mhdf_addElement is then an 149 149 * index into this list. The array may contain 150 * null ent ires to allow the caller some control over150 * null entries to allow the caller some control over 151 151 * the assigned indices without creating dummy types 152 152 * which may confuse readers. … … 168 168 * 169 169 * \param filename The path and name of the file to open 170 * \param writ eable If non-zero, open read-write. Otherwise readonly.170 * \param writable If non-zero, open read-write. Otherwise read-only. 171 171 * \param status Passed back status of API call. 172 172 * \param max_id Used to pass back the maximum global ID used in the … … 178 178 mhdf_FileHandle 179 179 mhdf_openFile( const char* filename, 180 int writ eable,180 int writable, 181 181 unsigned long* max_id, 182 182 mhdf_Status* status ); … … 193 193 * 194 194 * \param filename The path and name of the file to open 195 * \param writ eable If non-zero, open read-write. Otherwise readonly.195 * \param writable If non-zero, open read-write. Otherwise read-only. 196 196 * \param status Passed back status of API call. 197 197 * \param max_id Used to pass back the maximum global ID used in the … … 200 200 * may be passed. 201 201 * \param options The HDF5 access property list to use when opening 202 * the file. See the HDF5 documen ation for H5Fopen.202 * the file. See the HDF5 documentation for H5Fopen. 203 203 * \return An opaque handle to the file. 204 204 */ 205 205 mhdf_FileHandle 206 206 mhdf_openFileWithOpt( const char* filename, 207 int writ eable,207 int writable, 208 208 unsigned long* max_id, 209 209 hid_t options, … … 213 213 * Fails if buffer is not of sufficient size. 214 214 * \param file_handle The file. 215 * \param type_index The type index. Corresponds to indic ies into215 * \param type_index The type index. Corresponds to indices into 216 216 * the element type list passed to \ref mhdf_createFile. 217 217 * \param buffer The buffer into which to copy the name. … … 236 236 * 237 237 * Close an hid_t-type handle returned from any of the following 238 * functions. Any hid_t passed-back or return d must be closed via239 * this function to avoid resou ce loss.238 * functions. Any hid_t passed-back or returned must be closed via 239 * this function to avoid resource loss. 240 240 * 241 241 * \param file The file the object pointed to by the passed data … … 297 297 * \param num_nodes The number of nodes the table will contain. 298 298 * \param first_node_id_out Nodes are assigned IDs sequentially in the 299 * order they occur in the table, where the ID of the fi srt299 * order they occur in the table, where the ID of the first 300 300 * node in the table is this passed-back value. 301 301 * \param status Passed back status of API call. … … 315 315 * \param num_nodes_out The number of nodes the table contains. 316 316 * \param first_node_id_out Nodes are assigned IDs sequentially in the 317 * order they occur in the table, where the ID of the fi srt317 * order they occur in the table, where the ID of the first 318 318 * node in the table is this passed-back value. 319 319 * \param status Passed back status of API call. … … 427 427 * \param file_handle File in which to create the element type. 428 428 * \param elem_handle The name to use for the element data. This 429 * name is used as an identif er to reference the429 * name is used as an identifier to reference the 430 430 * data for this element type later. The selected 431 431 * name also appears explicitly in the file and … … 488 488 /** \brief Check if an element group contains polygon or polyhedron 489 489 * 490 * Check if an element group contains general poly hon or polyhedrons490 * Check if an element group contains general polygon or polyhedrons 491 491 * rather than typically fixed-connectivity elements. 492 492 * … … 633 633 * \param num_poly The total number number of polygons or polyhedra to 634 634 * be written in the table. 635 * \param data_list_length The to lal number of values to be written to the635 * \param data_list_length The total number of values to be written to the 636 636 * table (the number of polys plus the sum of the number 637 637 * of entities in each poly's connectivity data.) … … 673 673 * \param num_poly_out The total number number of polygons or polyhedra to 674 674 * be written in the table. 675 * \param data_list_length_out The to lal number of values to be written to the675 * \param data_list_length_out The total number of values to be written to the 676 676 * table (the number of polys plus the sum of the number 677 677 * of entities in each poly's connectivity data.) … … 711 711 * This function writes the index list. 712 712 * 713 * \param poly_handle The handle return ded from713 * \param poly_handle The handle returned from 714 714 * <code>mhdf_createPolyConnectivity</code> or 715 715 * <code>mhdf_openPolyConnectivity</code>. 716 716 * \param offset The offset in the table at which to write. The 717 * offset is in terms of the integer valu s in the table,717 * offset is in terms of the integer values in the table, 718 718 * not the count of polys. 719 719 * \param count The size of the integer list to write. … … 746 746 * This function writes the connectivity/ID list. 747 747 * 748 * \param poly_handle The handle return ded from748 * \param poly_handle The handle returned from 749 749 * <code>mhdf_createPolyConnectivity</code> or 750 750 * <code>mhdf_openPolyConnectivity</code>. 751 751 * \param offset The offset in the table at which to write. The 752 * offset is in terms of the integer valu s in the table,752 * offset is in terms of the integer values in the table, 753 753 * not the count of polys. 754 754 * \param count The size of the integer list to write. … … 780 780 * elements.) 781 781 * 782 * \param poly_handle The handle return ded from782 * \param poly_handle The handle returned from 783 783 * <code>mhdf_createPolyConnectivity</code> or 784 784 * <code>mhdf_openPolyConnectivity</code>. 785 785 * \param offset The offset in the table at which to read. The 786 * offset is in terms of the integer valu s in the table,786 * offset is in terms of the integer values in the table, 787 787 * not the count of polys. 788 788 * \param count The size of the integer list to read. … … 813 813 * elements.) 814 814 * 815 * \param poly_handle The handle return ded from815 * \param poly_handle The handle returned from 816 816 * <code>mhdf_createPolyConnectivity</code> or 817 817 * <code>mhdf_openPolyConnectivity</code>. 818 818 * \param offset The offset in the table at which to read. The 819 * offset is in terms of the integer valu s in the table,819 * offset is in terms of the integer values in the table, 820 820 * not the count of polys. 821 821 * \param count The size of the integer list to read. … … 1020 1020 #define mhdf_SET_OWNER_BIT 0x1 1021 1021 /** \brief Set cannot contain duplicates */ 1022 #define mhdf_SET_UNIQ E_BIT 0x21022 #define mhdf_SET_UNIQUE_BIT 0x2 1023 1023 /** \brief Set order is preserved */ 1024 1024 #define mhdf_SET_ORDER_BIT 0x4 … … 1047 1047 * bit in the flags specifies the format of the contents list for each set. 1048 1048 * See a description of the \ref mhdf_SET_RANGE_BIT flag for a description 1049 * of the two poss bile data formats. The index values in the first two columns1049 * of the two possible data formats. The index values in the first two columns 1050 1050 * of the table are the index of the <em>last</em> value for the set in the corresponding 1051 1051 * contents and children lists. The first index is always one greater than the last index 1052 1052 * for the previous set in the table. The first index of the first set in the table is 1053 * implicitly zero. A special value of -1 in the appropr aite column should be used to1053 * implicitly zero. A special value of -1 in the appropriate column should be used to 1054 1054 * indicate that the first set contains no contents or has no children. For any other set, 1055 1055 * if the last index for the set is the same as that of the previous set, it has no data … … 1062 1062 * will be assigned sequential global IDs. 1063 1063 * \param status Passed back status of API call. 1064 *\return The handle to the set meta data table.1064 *\return The handle to the set meta-data table. 1065 1065 */ 1066 1066 hid_t … … 1100 1100 * have sequential global IDs. 1101 1101 * \param status Passed back status of API call. 1102 *\return The handle to the set meta data table.1102 *\return The handle to the set meta-data table. 1103 1103 */ 1104 1104 hid_t … … 1136 1136 * Read flags for each set from the set description table. 1137 1137 * See \ref mhdf_createSetMeta for a description of this data. 1138 *\param data_handle The handle return d from mdhf_createSetMeta or mhdf_openSetMeta1138 *\param data_handle The handle returned from mdhf_createSetMeta or mhdf_openSetMeta 1139 1139 *\param offset The offset (set index) at which to begin reading. 1140 1140 *\param count The number of values (number of sets) to read. … … 1160 1160 * first in the list will have an end index of -1. 1161 1161 * 1162 *\param data_handle The handle return d from mdhf_createSetMeta or mhdf_openSetMeta1162 *\param data_handle The handle returned from mdhf_createSetMeta or mhdf_openSetMeta 1163 1163 *\param offset The offset (set index) at which to begin reading. 1164 1164 *\param count The number of values (number of sets) to read. … … 1183 1183 * first in the list will have an end index of -1. 1184 1184 * 1185 *\param data_handle The handle return d from mdhf_createSetMeta or mhdf_openSetMeta1185 *\param data_handle The handle returned from mdhf_createSetMeta or mhdf_openSetMeta 1186 1186 *\param offset The offset (set index) at which to begin reading. 1187 1187 *\param count The number of values (number of sets) to read. … … 1206 1206 * first in the list will have an end index of -1. 1207 1207 * 1208 *\param data_handle The handle return d from mdhf_createSetMeta or mhdf_openSetMeta1208 *\param data_handle The handle returned from mdhf_createSetMeta or mhdf_openSetMeta 1209 1209 *\param offset The offset (set index) at which to begin reading. 1210 1210 *\param count The number of values (number of sets) to read. … … 1251 1251 * The format of this data is a vector of integer values which is the 1252 1252 * concatenation of the contents list for all the meshsets. The length 1253 * and format of the data for each set is stored in the set meta table.1253 * and format of the data for each set is stored in the set meta table. 1254 1254 * See \ref mhdf_createSetMeta and \ref mhdf_SET_RANGE_BIT for a 1255 1255 * description of that data. … … 1271 1271 * The format of this data is a vector of integer values which is the 1272 1272 * concatenation of the contents list for all the meshsets. The length 1273 * and format of the data for each set is stored in the set meta table.1273 * and format of the data for each set is stored in the set meta table. 1274 1274 * See \ref mhdf_createSetMeta and \ref mhdf_SET_RANGE_BIT for a 1275 1275 * description of that data. … … 1290 1290 * The format of this data is a vector of integer values which is the 1291 1291 * concatenation of the contents list for all the meshsets. The length 1292 * and format of the data for each set is stored in the set meta table.1292 * and format of the data for each set is stored in the set meta table. 1293 1293 * See \ref mhdf_createSetMeta and \ref mhdf_SET_RANGE_BIT for a 1294 1294 * description of that data. … … 1318 1318 * The format of this data is a vector of integer values which is the 1319 1319 * concatenation of the contents list for all the meshsets. The length 1320 * and format of the data for each set is stored in the set meta table.1320 * and format of the data for each set is stored in the set meta table. 1321 1321 * See \ref mhdf_createSetMeta and \ref mhdf_SET_RANGE_BIT for a 1322 1322 * description of that data. … … 1346 1346 * The format of this data is the concatenation of the lists of 1347 1347 * global IDs of child sets for each set. The order of the sets and 1348 * the number of children for each set is contained in the set meta table.1348 * the number of children for each set is contained in the set meta table. 1349 1349 * (See \ref mhdf_createSetMeta ). 1350 1350 * … … 1379 1379 /** \brief Create file object for storing the set parent list 1380 1380 * 1381 * Create a data group for the list of set p rents.1381 * Create a data group for the list of set parents. 1382 1382 * The format of this data is the concatenation of the lists of 1383 1383 * global IDs of parent sets for each set. The order of the sets and 1384 * the number of parents for each set is contained in the set meta table.1384 * the number of parents for each set is contained in the set meta table. 1385 1385 * (See \ref mhdf_createSetMeta ). 1386 1386 * … … 1480 1480 * 1481 1481 * Sparse tag data is stored as a global table pair for each tag type. The first 1482 * if the pair of tables is a list of Global IDs. The second is the correspo ding1482 * if the pair of tables is a list of Global IDs. The second is the corresponding 1483 1483 * tag value for each entity in the ID list. 1484 1484 */ … … 1508 1508 * size. 1509 1509 * 1510 * This function is provid ied to allow converting the stored tag1510 * This function is provided to allow converting the stored tag 1511 1511 * type in a file to the preferred type for it's representation 1512 1512 * in memory when reading tag values. … … 1589 1589 * 1590 1590 *\param file_handle The file. 1591 *\param tag_name The name of the tag to retr eive the data for.1591 *\param tag_name The name of the tag to retrieve the data for. 1592 1592 *\param class_out The TSTT class of the tag data. 1593 1593 *\param size_out Depends on value of class_out: 1594 1594 * - mhdf_OPAQUE - size of opaque data in bytes 1595 1595 * - mhdf_BITFIELD - number of bits 1596 * - for everything else, if the tag dat sis an1597 * array, the length of the array. 1 otherwi ze.1598 *\param tstt_storage_out The value of the TSTT enum for storage (dense, spa se, etc.)1596 * - for everything else, if the tag data is an 1597 * array, the length of the array. 1 otherwise. 1598 *\param tstt_storage_out The value of the TSTT enum for storage (dense, sparse, etc.) 1599 1599 *\param have_default_out Non-zero if file contains a default value for the tag. 1600 1600 *\param have_global_out Non-zero if the file contains a global/mesh value for the tag. … … 1637 1637 /** \brief Check if the file contains dense tag data for the specified tag and element group. 1638 1638 * 1639 * Check if there is dense tag data for a given element type for the spec fiied1639 * Check if there is dense tag data for a given element type for the specified 1640 1640 * tag. 1641 1641 *
![(please configure the [header_logo] section in trac.ini)](/projects/ITAPS/chrome/common/trac_banner.png)