Grid serializer/unserializer.
More...
#include <Archive.h>
Inherited by File, and Stream.
|
| | Archive () |
| |
| | Archive (const Archive &)=default |
| |
| Archive & | operator= (const Archive &)=default |
| |
| virtual | ~Archive () |
| |
| virtual Ptr | copy () const |
| | Return a copy of this archive. More...
|
| |
| std::string | getUniqueTag () const |
| | Return the UUID that was most recently written (or read, if no UUID has been written yet). More...
|
| |
| bool | isIdentical (const std::string &uuidStr) const |
| | Return true if the given UUID matches this archive's UUID. More...
|
| |
| uint32_t | fileVersion () const |
| | Return the file format version number of the input stream. More...
|
| |
| VersionId | libraryVersion () const |
| | Return the (major, minor) version number of the library that was used to write the input stream. More...
|
| |
| std::string | version () const |
| | Return a string of the form "<major>.<minor>/<format>", giving the library and file format version numbers associated with the input stream. More...
|
| |
| bool | isInstancingEnabled () const |
| | Return true if trees shared by multiple grids are written out only once, false if they are written out once per grid. More...
|
| |
| void | setInstancingEnabled (bool b) |
| | Specify whether trees shared by multiple grids should be written out only once (true) or once per grid (false). More...
|
| |
| uint32_t | compression () const |
| | Return a bit mask specifying compression options for the data stream. More...
|
| |
| void | setCompression (uint32_t c) |
| | Specify whether and how the data stream should be compressed. More...
|
| |
| bool | isGridStatsMetadataEnabled () const |
| | Return true if grid statistics (active voxel count and bounding box, etc.) are computed and written as grid metadata. More...
|
| |
| void | setGridStatsMetadataEnabled (bool b) |
| | Specify whether grid statistics (active voxel count and bounding box, etc.) should be computed and written as grid metadata. More...
|
| |
| virtual void | write (const GridCPtrVec &, const MetaMap &=MetaMap()) const |
| | Write the grids in the given container to this archive's output stream. More...
|
| |
|
| bool | inputHasGridOffsets () const |
| | Return true if the input stream contains grid offsets that allow for random access or partial reading. More...
|
| |
| void | setInputHasGridOffsets (bool b) |
| |
| void | setFormatVersion (std::istream &) |
| | Tag the given input stream with the input file format version number. More...
|
| |
| void | setLibraryVersion (std::istream &) |
| | Tag the given input stream with the version number of the library with which the input stream was created. More...
|
| |
| void | setDataCompression (std::istream &) |
| | Tag the given input stream with flags indicating whether the input stream contains compressed data and how it is compressed. More...
|
| |
| void | setGridCompression (std::ostream &, const GridBase &) const |
| | Tag an output stream with flags specifying only those compression options that are applicable to the given grid. More...
|
| |
| void | connectInstance (const GridDescriptor &, const NamedGridMap &) const |
| | If the grid represented by the given grid descriptor is an instance, connect it with its instance parent. More...
|
| |
| void | writeGrid (GridDescriptor &, GridBase::ConstPtr, std::ostream &, bool seekable) const |
| |
| void | writeGridInstance (GridDescriptor &, GridBase::ConstPtr, std::ostream &, bool seekable) const |
| |
| bool | readHeader (std::istream &) |
| | Read the magic number, version numbers, UUID, etc. from the given input stream. More...
|
| |
| void | writeHeader (std::ostream &, bool seekable) const |
| | Write the magic number, version numbers, UUID, etc. to the given output stream. More...
|
| |
|
| void | write (std::ostream &, const GridPtrVec &, bool seekable, const MetaMap &=MetaMap()) const |
| | Write the given grids to an output stream. More...
|
| |
| void | write (std::ostream &, const GridCPtrVec &, bool seekable, const MetaMap &=MetaMap()) const |
| | Write the given grids to an output stream. More...
|
| |
|
| static void | readGridCompression (std::istream &) |
| | Read in the compression flags for a grid and tag the given input stream with those flags. More...
|
| |
| static int32_t | readGridCount (std::istream &) |
| | Read in and return the number of grids on the input stream. More...
|
| |
| static void | readGrid (GridBase::Ptr, const GridDescriptor &, std::istream &) |
| | Populate the given grid from the input stream. More...
|
| |
| static void | readGrid (GridBase::Ptr, const GridDescriptor &, std::istream &, const BBoxd &) |
| | Populate the given grid from the input stream, but only where it intersects the given world-space bounding box. More...
|
| |
| static void | readGrid (GridBase::Ptr, const GridDescriptor &, std::istream &, const CoordBBox &) |
| | Populate the given grid from the input stream, but only where it intersects the given index-space bounding box. More...
|
| |
Grid serializer/unserializer.
◆ ConstPtr
◆ NamedGridMap
◆ Ptr
◆ Archive() [1/2]
◆ Archive() [2/2]
◆ ~Archive()
◆ compression()
| uint32_t compression |
( |
| ) |
const |
|
inline |
Return a bit mask specifying compression options for the data stream.
◆ connectInstance()
If the grid represented by the given grid descriptor is an instance, connect it with its instance parent.
◆ copy()
| virtual Ptr copy |
( |
| ) |
const |
|
virtual |
Return a copy of this archive.
Reimplemented in File, and Stream.
◆ fileVersion()
| uint32_t fileVersion |
( |
| ) |
const |
|
inline |
Return the file format version number of the input stream.
◆ getUniqueTag()
| std::string getUniqueTag |
( |
| ) |
const |
Return the UUID that was most recently written (or read, if no UUID has been written yet).
◆ hasBloscCompression()
| static bool hasBloscCompression |
( |
| ) |
|
|
static |
Return true if the OpenVDB library includes support for the Blosc compressor.
◆ inputHasGridOffsets()
| bool inputHasGridOffsets |
( |
| ) |
const |
|
inlineprotected |
Return true if the input stream contains grid offsets that allow for random access or partial reading.
◆ isDelayedLoadingEnabled()
| static bool isDelayedLoadingEnabled |
( |
| ) |
|
|
static |
Return true if delayed loading is enabled.
If enabled, delayed loading can be disabled for individual files, but not vice-versa.
- Note
- Define the environment variable
OPENVDB_DISABLE_DELAYED_LOAD to disable delayed loading unconditionally.
◆ isGridStatsMetadataEnabled()
| bool isGridStatsMetadataEnabled |
( |
| ) |
const |
|
inline |
Return true if grid statistics (active voxel count and bounding box, etc.) are computed and written as grid metadata.
◆ isIdentical()
| bool isIdentical |
( |
const std::string & |
uuidStr | ) |
const |
Return true if the given UUID matches this archive's UUID.
◆ isInstancingEnabled()
| bool isInstancingEnabled |
( |
| ) |
const |
|
inline |
Return true if trees shared by multiple grids are written out only once, false if they are written out once per grid.
◆ libraryVersion()
Return the (major, minor) version number of the library that was used to write the input stream.
◆ operator=()
◆ readGrid() [1/3]
Populate the given grid from the input stream.
◆ readGrid() [2/3]
Populate the given grid from the input stream, but only where it intersects the given world-space bounding box.
◆ readGrid() [3/3]
Populate the given grid from the input stream, but only where it intersects the given index-space bounding box.
◆ readGridCompression()
| static void readGridCompression |
( |
std::istream & |
| ) |
|
|
staticprotected |
Read in the compression flags for a grid and tag the given input stream with those flags.
◆ readGridCount()
| static int32_t readGridCount |
( |
std::istream & |
| ) |
|
|
staticprotected |
Read in and return the number of grids on the input stream.
◆ readHeader()
| bool readHeader |
( |
std::istream & |
| ) |
|
|
protected |
Read the magic number, version numbers, UUID, etc. from the given input stream.
- Returns
true if the input UUID differs from the previously-read UUID.
◆ setCompression()
| void setCompression |
( |
uint32_t |
c | ) |
|
|
inline |
Specify whether and how the data stream should be compressed.
- Parameters
-
| c | bitwise OR (e.g., COMPRESS_ZIP | COMPRESS_ACTIVE_MASK) of compression option flags (see Compression.h for the available flags) |
- Note
- Not all combinations of compression options are supported.
◆ setDataCompression()
| void setDataCompression |
( |
std::istream & |
| ) |
|
|
protected |
Tag the given input stream with flags indicating whether the input stream contains compressed data and how it is compressed.
◆ setFormatVersion()
| void setFormatVersion |
( |
std::istream & |
| ) |
|
|
protected |
◆ setGridCompression()
| void setGridCompression |
( |
std::ostream & |
, |
|
|
const GridBase & |
|
|
) |
| const |
|
protected |
Tag an output stream with flags specifying only those compression options that are applicable to the given grid.
◆ setGridStatsMetadataEnabled()
| void setGridStatsMetadataEnabled |
( |
bool |
b | ) |
|
|
inline |
Specify whether grid statistics (active voxel count and bounding box, etc.) should be computed and written as grid metadata.
◆ setInputHasGridOffsets()
| void setInputHasGridOffsets |
( |
bool |
b | ) |
|
|
inlineprotected |
◆ setInstancingEnabled()
| void setInstancingEnabled |
( |
bool |
b | ) |
|
|
inline |
Specify whether trees shared by multiple grids should be written out only once (true) or once per grid (false).
- Note
- Instancing is enabled by default.
◆ setLibraryVersion()
| void setLibraryVersion |
( |
std::istream & |
| ) |
|
|
protected |
◆ version()
| std::string version |
( |
| ) |
const |
Return a string of the form "<major>.<minor>/<format>", giving the library and file format version numbers associated with the input stream.
◆ write() [1/3]
Write the grids in the given container to this archive's output stream.
Reimplemented in File, and Stream.
◆ write() [2/3]
Write the given grids to an output stream.
◆ write() [3/3]
Write the given grids to an output stream.
◆ writeGrid()
Write the given grid descriptor and grid to an output stream and update the GridDescriptor offsets.
- Parameters
-
| seekable | if true, the output stream supports seek operations |
◆ writeGridInstance()
Write the given grid descriptor and grid metadata to an output stream and update the GridDescriptor offsets, but don't write the grid's tree, since it is shared with another grid.
- Parameters
-
| seekable | if true, the output stream supports seek operations |
◆ writeHeader()
| void writeHeader |
( |
std::ostream & |
, |
|
|
bool |
seekable |
|
) |
| const |
|
protected |
Write the magic number, version numbers, UUID, etc. to the given output stream.
- Parameters
-
| seekable | if true, the output stream supports seek operations |
◆ ::TestFile
◆ DEFAULT_COMPRESSION_FLAGS
| const uint32_t DEFAULT_COMPRESSION_FLAGS |
|
static |
The documentation for this class was generated from the following file: