Grid serializer/unserializer. More...

#include <openvdb/io/Archive.h>

Inherited by File, and Stream.

Public Types
using	Ptr = SharedPtr< Archive >

using	ConstPtr = SharedPtr< const Archive >

Public Member Functions
	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...

Static Public Member Functions
static bool	hasBloscCompression ()
	Return `true` if the OpenVDB library includes support for the Blosc compressor. More...

static bool	hasZLibCompression ()
	Return `true` if the OpenVDB library includes support for the ZLib compressor. More...

static bool	isDelayedLoadingEnabled ()
	Return `true` if delayed loading is enabled. More...

Static Public Attributes
static const uint32_t	DEFAULT_COMPRESSION_FLAGS

Protected Types
using	NamedGridMap = std::map< Name, GridBase::Ptr >

Protected Member Functions
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 Protected Member Functions
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...

Friends
class	::TestFile

Detailed Description

Grid serializer/unserializer.

Member Typedef Documentation

using ConstPtr = SharedPtr<const Archive>

using NamedGridMap = std::map<Name , GridBase::Ptr>

protected

using Ptr = SharedPtr<Archive>

Constructor & Destructor Documentation

Archive ( )

Archive ( const Archive & )

default

virtual ~Archive ( )

virtual

Member Function Documentation

uint32_t compression ( ) const

inline

Return a bit mask specifying compression options for the data stream.

void connectInstance	(	const GridDescriptor &	,
		const NamedGridMap &
	)		const

protected

If the grid represented by the given grid descriptor is an instance, connect it with its instance parent.

virtual Ptr copy ( ) const

virtual

Return a copy of this archive.

Reimplemented in File, and Stream.

uint32_t fileVersion ( ) const

inline

Return the file format version number of the input stream.

std::string getUniqueTag ( ) const

Return the UUID that was most recently written (or read, if no UUID has been written yet).

static bool hasBloscCompression ( )

static

Return true if the OpenVDB library includes support for the Blosc compressor.

static bool hasZLibCompression ( )

static

Return true if the OpenVDB library includes support for the ZLib compressor.

bool inputHasGridOffsets ( ) const

inlineprotected

Return true if the input stream contains grid offsets that allow for random access or partial reading.

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.

bool isGridStatsMetadataEnabled ( ) const

inline

Return true if grid statistics (active voxel count and bounding box, etc.) are computed and written as grid metadata.

bool isIdentical ( const std::string & uuidStr ) const

Return true if the given UUID matches this archive's UUID.

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.

VersionId libraryVersion ( ) const

inline

Return the (major, minor) version number of the library that was used to write the input stream.

Archive& operator= ( const Archive & )

default

static void readGrid	(	GridBase::Ptr	,
		const GridDescriptor &	,
		std::istream &
	)

staticprotected

Populate the given grid from the input stream.

static void readGrid	(	GridBase::Ptr	,
		const GridDescriptor &	,
		std::istream &	,
		const BBoxd &
	)

staticprotected

Populate the given grid from the input stream, but only where it intersects the given world-space bounding box.

static void readGrid	(	GridBase::Ptr	,
		const GridDescriptor &	,
		std::istream &	,
		const CoordBBox &
	)

staticprotected

Populate the given grid from the input stream, but only where it intersects the given index-space bounding box.

static void readGridCompression ( std::istream & )

staticprotected

Read in the compression flags for a grid and tag the given input stream with those flags.

static int32_t readGridCount ( std::istream & )

staticprotected

Read in and return the number of grids on the input stream.

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.

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.

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.

void setFormatVersion ( std::istream & )

protected

Tag the given input stream with the input file format version number.

The tag can be retrieved with getFormatVersion().

See also: getFormatVersion()

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.

void setGridStatsMetadataEnabled ( bool b )

inline

Specify whether grid statistics (active voxel count and bounding box, etc.) should be computed and written as grid metadata.

void setInputHasGridOffsets ( bool b )

inlineprotected

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.

void setLibraryVersion ( std::istream & )

protected

Tag the given input stream with the version number of the library with which the input stream was created.

The tag can be retrieved with getLibraryVersion().

See also: getLibraryVersion()

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.

virtual void write	(	const GridCPtrVec &	,
		const MetaMap &	= `MetaMap()`
	)		const

inlinevirtual

Write the grids in the given container to this archive's output stream.

Reimplemented in File, and Stream.

void write	(	std::ostream &	,
		const GridPtrVec &	,
		bool	seekable,
		const MetaMap &	= `MetaMap()`
	)		const

protected

Write the given grids to an output stream.

void write	(	std::ostream &	,
		const GridCPtrVec &	,
		bool	seekable,
		const MetaMap &	= `MetaMap()`
	)		const

protected

Write the given grids to an output stream.

void writeGrid	(	GridDescriptor &	,
		GridBase::ConstPtr	,
		std::ostream &	,
		bool	seekable
	)		const

protected

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

void writeGridInstance	(	GridDescriptor &	,
		GridBase::ConstPtr	,
		std::ostream &	,
		bool	seekable
	)		const

protected

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

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

Friends And Related Function Documentation

friend class ::TestFile

friend

Member Data Documentation

const uint32_t DEFAULT_COMPRESSION_FLAGS

static

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Types

Protected Member Functions

Static Protected Member Functions

Friends

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation