GRASS GIS 8 Programmer's Manual
8.5.0dev(2024)-498676c526
|
OGSF library - loading and manipulating volumes (lower level functions) More...
#include <string.h>
#include <stdlib.h>
#include <grass/gis.h>
#include <grass/ogsf.h>
#include <grass/raster3d.h>
#include <grass/glocale.h>
Go to the source code of this file.
Macros | |
#define | LUCKY 33 |
#define | MODE_DIRECT 0 |
#define | MODE_SLICE 1 |
#define | MODE_FULL 2 |
#define | MODE_PRELOAD 3 |
#define | MODE_DEFAULT 0 |
#define | STATUS_READY 0 |
#define | STATUS_BUSY 1 |
Functions | |
void * | open_g3d_file (const char *filename, IFLAG *type, double *min, double *max) |
Open 3d raster file. More... | |
int | close_g3d_file (void *map) |
Close g3d file. More... | |
geovol_file * | gvl_file_get_volfile (int id) |
Get geovol_file structure for given handle. More... | |
int | find_datah (const char *name, IFLAG type, int begin) |
Find file with name and type in geovol_file array an return handle. More... | |
char * | gvl_file_get_name (int id) |
Get file name for given handle. More... | |
int | gvl_file_get_file_type (geovol_file *vf) |
Get file type for given handle. More... | |
int | gvl_file_get_data_type (geovol_file *vf) |
Get data type for given handle. More... | |
void | gvl_file_get_min_max (geovol_file *vf, double *min, double *max) |
Get minimum and maximum value in volume file. More... | |
void * | open_volfile (const char *name, IFLAG file_type, IFLAG *data_type, double *min, double *max) |
Open 3d raster file. More... | |
int | close_volfile (void *map, IFLAG type) |
Close volume file. More... | |
int | gvl_file_newh (const char *name, IFLAG file_type) |
Get handle for given file name and type. More... | |
int | free_volfile_buffs (geovol_file *vf) |
Free allocated buffers. More... | |
int | gvl_file_free_datah (int id) |
Free geovol_file structure for given handle. More... | |
int | read_g3d_value (IFLAG type, void *map, int x, int y, int z, void *value) |
Eead value from g3d file. More... | |
int | read_g3d_slice (IFLAG type, void *map, int level, void *data) |
Read slice of values at level from g3d file. More... | |
int | read_g3d_vol (IFLAG type, void *map, void *data) |
Read all values from g3d file. More... | |
int | is_null_g3d_value (IFLAG type, void *value) |
Check for null value. More... | |
int | get_buff_value (IFLAG type, void *data, int offset, void *value) |
Get value from buffer. More... | |
int | get_direct_value (geovol_file *vf, int x, int y, int z, void *value) |
Read value direct from volume file. More... | |
int | alloc_vol_buff (geovol_file *vf) |
Allocate buffer memory for full mode reading. More... | |
int | free_vol_buff (geovol_file *vf) |
Free memory buffer memory. More... | |
int | read_vol (geovol_file *vf) |
Read all values from volume file. More... | |
int | get_vol_value (geovol_file *vf, int x, int y, int z, void *value) |
Get value from volume buffer. More... | |
int | alloc_slice_buff (geovol_file *vf) |
Allocate buffer for slice mode reading. More... | |
int | free_slice_buff (geovol_file *vf) |
Free buffer for slice mode reading. More... | |
int | read_slice (geovol_file *vf, int s, int l) |
Read slice of values at level from volume file. More... | |
void | shift_slices (geovol_file *vf) |
Read new slice into buffer. More... | |
int | get_slice_value (geovol_file *vf, int x, int y, int z, void *value) |
Get value from slice buffer. More... | |
int | gvl_file_start_read (geovol_file *vf) |
Start read - allocate memory buffer a read first data into buffer. More... | |
int | gvl_file_end_read (geovol_file *vf) |
End read - free buffer memory. More... | |
int | gvl_file_get_value (geovol_file *vf, int x, int y, int z, void *value) |
Get value for volume file at x, y, z. More... | |
int | gvl_file_is_null_value (geovol_file *vf, void *value) |
Check for null value. More... | |
int | gvl_file_set_mode (geovol_file *vf, IFLAG mode) |
Set read mode. More... | |
int | gvl_file_set_slices_param (geovol_file *vf, int n, int b) |
Set parameters for slice reading. More... | |
OGSF library - loading and manipulating volumes (lower level functions)
GRASS OpenGL gsurf OGSF Library
(C) 1999-2008 by the GRASS Development Team
This program is free software under the GNU General Public License (>=v2). Read the file COPYING that comes with GRASS for details.
Definition in file gvl_file.c.
#define LUCKY 33 |
Definition at line 28 of file gvl_file.c.
#define MODE_DEFAULT 0 |
Definition at line 35 of file gvl_file.c.
#define MODE_DIRECT 0 |
Definition at line 30 of file gvl_file.c.
#define MODE_FULL 2 |
Definition at line 32 of file gvl_file.c.
#define MODE_PRELOAD 3 |
Definition at line 33 of file gvl_file.c.
#define MODE_SLICE 1 |
Definition at line 31 of file gvl_file.c.
#define STATUS_BUSY 1 |
Definition at line 38 of file gvl_file.c.
#define STATUS_READY 0 |
Definition at line 37 of file gvl_file.c.
int alloc_slice_buff | ( | geovol_file * | vf | ) |
Allocate buffer for slice mode reading.
vf | pointer to geovol_file struct |
Definition at line 809 of file gvl_file.c.
References geovol_file::buff, Cols, geovol_file::data_type, G_malloc, NULL, Rows, VOL_DTYPE_DOUBLE, and VOL_DTYPE_FLOAT.
Referenced by gvl_file_start_read().
int alloc_vol_buff | ( | geovol_file * | vf | ) |
Allocate buffer memory for full mode reading.
vf | pointer to geovol_file |
Definition at line 716 of file gvl_file.c.
References geovol_file::buff, Cols, geovol_file::data_type, Depths, G_malloc, NULL, Rows, VOL_DTYPE_DOUBLE, and VOL_DTYPE_FLOAT.
Referenced by gvl_file_start_read().
int close_g3d_file | ( | void * | map | ) |
Close g3d file.
map | 3d raster map |
Definition at line 465 of file gvl_file.c.
References _, G_warning(), and Rast3d_close().
int close_volfile | ( | void * | map, |
IFLAG | type | ||
) |
Close volume file.
map | volume filename |
type | file type |
Definition at line 251 of file gvl_file.c.
int find_datah | ( | const char * | name, |
IFLAG | type, | ||
int | begin | ||
) |
Find file with name and type in geovol_file array an return handle.
name | file name |
begin | |
data | id |
-1 | not found |
Definition at line 139 of file gvl_file.c.
int free_slice_buff | ( | geovol_file * | vf | ) |
Free buffer for slice mode reading.
vf | pointer to geovol_file struct |
Definition at line 848 of file gvl_file.c.
References geovol_file::buff, and G_free().
Referenced by gvl_file_end_read().
int free_vol_buff | ( | geovol_file * | vf | ) |
Free memory buffer memory.
vf | pointer to geovol_file struct |
Definition at line 748 of file gvl_file.c.
References geovol_file::buff, and G_free().
Referenced by gvl_file_end_read().
int free_volfile_buffs | ( | geovol_file * | vf | ) |
Free allocated buffers.
vf | pointer to geovol_file struct |
Definition at line 342 of file gvl_file.c.
References geovol_file::buff, G_free(), geovol_file::mode, MODE_PRELOAD, MODE_SLICE, and NULL.
int get_buff_value | ( | IFLAG | type, |
void * | data, | ||
int | offset, | ||
void * | value | ||
) |
Get value from buffer.
type | data type |
data | data buffer |
offset | |
value |
Definition at line 651 of file gvl_file.c.
Referenced by get_slice_value(), and get_vol_value().
int get_direct_value | ( | geovol_file * | vf, |
int | x, | ||
int | y, | ||
int | z, | ||
void * | value | ||
) |
Read value direct from volume file.
vf | pointer to geovol_file struct | |
x,y,z | real point | |
[out] | value | data value |
Definition at line 687 of file gvl_file.c.
References geovol_file::data_type, geovol_file::file_type, geovol_file::map, read_g3d_value(), VOL_FTYPE_RASTER3D, and x.
Referenced by gvl_file_get_value().
int get_slice_value | ( | geovol_file * | vf, |
int | x, | ||
int | y, | ||
int | z, | ||
void * | value | ||
) |
Get value from slice buffer.
vf | pointer to geovol_file struct | |
x,y,z | real point | |
[out] | value | data value |
Definition at line 925 of file gvl_file.c.
References geovol_file::buff, Cols, geovol_file::data_type, get_buff_value(), if(), shift_slices(), and x.
Referenced by gvl_file_get_value().
int get_vol_value | ( | geovol_file * | vf, |
int | x, | ||
int | y, | ||
int | z, | ||
void * | value | ||
) |
Get value from volume buffer.
vf | pointer to geovol_file struct | |
x,y,z | real point | |
[out] | value | data value |
Definition at line 788 of file gvl_file.c.
References geovol_file::buff, Cols, geovol_file::data_type, get_buff_value(), Rows, and x.
Referenced by gvl_file_get_value().
int gvl_file_end_read | ( | geovol_file * | vf | ) |
End read - free buffer memory.
vf | pointer to geovol_file struct |
Definition at line 1016 of file gvl_file.c.
References free_slice_buff(), free_vol_buff(), geovol_file::mode, MODE_FULL, MODE_SLICE, geovol_file::status, and STATUS_READY.
int gvl_file_free_datah | ( | int | id | ) |
Free geovol_file structure for given handle.
id |
Definition at line 364 of file gvl_file.c.
References G_debug().
Referenced by gvl_free_volmem().
int gvl_file_get_data_type | ( | geovol_file * | vf | ) |
Get data type for given handle.
vf | pointer to geovol_file struct |
Definition at line 202 of file gvl_file.c.
References geovol_file::data_type.
int gvl_file_get_file_type | ( | geovol_file * | vf | ) |
Get file type for given handle.
vf | pointer to geovol_file struct |
Definition at line 190 of file gvl_file.c.
References geovol_file::file_type.
void gvl_file_get_min_max | ( | geovol_file * | vf, |
double * | min, | ||
double * | max | ||
) |
Get minimum and maximum value in volume file.
vf | pointer to geovol_file struct | |
[out] | min | min value |
[out] | max | max value |
Definition at line 214 of file gvl_file.c.
References geovol_file::max, max, geovol_file::min, and min.
Referenced by iso_get_range().
char* gvl_file_get_name | ( | int | id | ) |
Get file name for given handle.
id | handle id |
Definition at line 165 of file gvl_file.c.
References GPATH_MAX.
int gvl_file_get_value | ( | geovol_file * | vf, |
int | x, | ||
int | y, | ||
int | z, | ||
void * | value | ||
) |
Get value for volume file at x, y, z.
vf | pointer to geovol_file struct |
Definition at line 1048 of file gvl_file.c.
References get_direct_value(), get_slice_value(), get_vol_value(), geovol_file::mode, MODE_DIRECT, MODE_FULL, MODE_PRELOAD, MODE_SLICE, geovol_file::status, STATUS_BUSY, and x.
geovol_file* gvl_file_get_volfile | ( | int | id | ) |
Get geovol_file structure for given handle.
id |
Definition at line 117 of file gvl_file.c.
Referenced by iso_get_range().
int gvl_file_is_null_value | ( | geovol_file * | vf, |
void * | value | ||
) |
Check for null value.
vf | pointer to geovol_file struct |
value | data value |
Definition at line 1085 of file gvl_file.c.
References geovol_file::file_type, is_null_g3d_value(), and VOL_FTYPE_RASTER3D.
int gvl_file_newh | ( | const char * | name, |
IFLAG | file_type | ||
) |
Get handle for given file name and type.
name | volume filename |
file_type | file type |
Definition at line 269 of file gvl_file.c.
int gvl_file_set_mode | ( | geovol_file * | vf, |
IFLAG | mode | ||
) |
Set read mode.
vf | pointer to geovol_file struct |
mode | read mode |
Definition at line 1114 of file gvl_file.c.
int gvl_file_set_slices_param | ( | geovol_file * | vf, |
int | n, | ||
int | b | ||
) |
Set parameters for slice reading.
vf | pointer to geovol_file struct |
n | |
b |
Definition at line 1164 of file gvl_file.c.
References b, geovol_file::buff, geovol_file::mode, MODE_SLICE, return(), geovol_file::status, and STATUS_BUSY.
int gvl_file_start_read | ( | geovol_file * | vf | ) |
Start read - allocate memory buffer a read first data into buffer.
vf | pointer to geovol_file struct |
Definition at line 965 of file gvl_file.c.
References alloc_slice_buff(), alloc_vol_buff(), geovol_file::buff, geovol_file::mode, MODE_FULL, MODE_SLICE, read_slice(), read_vol(), geovol_file::status, and STATUS_BUSY.
int is_null_g3d_value | ( | IFLAG | type, |
void * | value | ||
) |
Check for null value.
type | data type |
value |
Definition at line 614 of file gvl_file.c.
Referenced by gvl_file_is_null_value().
void * open_g3d_file | ( | const char * | filename, |
IFLAG * | type, | ||
double * | min, | ||
double * | max | ||
) |
Open 3d raster file.
filename | file name | |
type | data type | |
[out] | min | min value |
[out] | max | max value |
Definition at line 417 of file gvl_file.c.
Referenced by open_volfile().
void* open_volfile | ( | const char * | name, |
IFLAG | file_type, | ||
IFLAG * | data_type, | ||
double * | min, | ||
double * | max | ||
) |
Open 3d raster file.
name | file name | |
file_type | file type | |
data_type | data type | |
[out] | min | min value |
[out] | max | max value |
Definition at line 232 of file gvl_file.c.
References max, min, name, NULL, open_g3d_file(), and VOL_FTYPE_RASTER3D.
int read_g3d_slice | ( | IFLAG | type, |
void * | map, | ||
int | level, | ||
void * | data | ||
) |
Read slice of values at level from g3d file.
type | data type | |
map | 3D raster map | |
level | ||
[out] | data |
Definition at line 520 of file gvl_file.c.
int read_g3d_value | ( | IFLAG | type, |
void * | map, | ||
int | x, | ||
int | y, | ||
int | z, | ||
void * | value | ||
) |
Eead value from g3d file.
type | data type | |
map | 3D raster map | |
x,y,z | real coordinates | |
[out] | value | data value |
Definition at line 488 of file gvl_file.c.
Referenced by get_direct_value().
int read_g3d_vol | ( | IFLAG | type, |
void * | map, | ||
void * | data | ||
) |
Read all values from g3d file.
type | data type | |
map | 3D raster map | |
[out] | data | data buffer |
Definition at line 565 of file gvl_file.c.
Referenced by read_vol().
int read_slice | ( | geovol_file * | vf, |
int | s, | ||
int | l | ||
) |
Read slice of values at level from volume file.
vf | pointer to geovol_file struct |
s | |
l |
Definition at line 870 of file gvl_file.c.
Referenced by gvl_file_start_read().
int read_vol | ( | geovol_file * | vf | ) |
Read all values from volume file.
vf | pointer to geovol_file struct |
Definition at line 763 of file gvl_file.c.
References geovol_file::buff, geovol_file::data_type, geovol_file::file_type, geovol_file::map, read_g3d_vol(), and VOL_FTYPE_RASTER3D.
Referenced by gvl_file_start_read().
void shift_slices | ( | geovol_file * | vf | ) |
Read new slice into buffer.
vf | pointer to geovol_file struct |
Definition at line 894 of file gvl_file.c.
Referenced by get_slice_value().