 |
vlmopen_vox
NAME
vlmopen_vox - Opens a ParVox voxel data file.
SYNOPSIS
#include <vlmeta.h>
int vlmopen_vox(char *name, int dtype, int mode);
DESCRIPTION
Vlmopen_vox opens a ParVox voxel data file and
returns a handle that can be used by
vlmget_vdim4d,
vlmget_slice4d, and
vlmget_voxel4d. The name
parameter can be either the basename of the voxel data file, or the
complete name, including the .vox.nc extension. For example, to
open the file ocean.vox.nc, vlmopen_vox can be called via
vlmopen_env("ocean", ...) or
vlmopen("ocean.vox.nc", ...). The dtype parameter
can take either VL_RAW or VL_NETCDF, indicating the data
file is in either the raw binary format or the NetCDF format, respectively.
The mode parameter is the NetCDF
file mode, either NC_WRITE or NC_NOWRITE.
NOTES
The raw binary format isn't fully supported in the
current version of the VLMeta library.
SEE ALSO
vlmget_vdim4d,
vlmget_slice4d,
vlmget_voxel4d,
vlmclose,
ParVox Tutorial: Input
Data Format
DIAGNOSTICS
Upon successful completion, the file handle for the
file is returned. Otherwise, a value of -1 is returned.
|
 |