group.c File Reference

#include <string.h>
#include <stdlib.h>
#include <grass/imagery.h>

Include dependency graph for group.c:

Go to the source code of this file.

Functions
int	I_get_group (char *group)
int	I_put_group (const char *group)
int	I_get_subgroup (const char *group, char *subgroup)
int	I_put_subgroup (const char *group, const char *subgroup)
int	I_get_group_ref (const char *group, struct Ref *ref)
	read group REF file
int	I_get_group_ref2 (const char *group, const char *mapset, struct Ref *ref)
	read group REF file
int	I_get_subgroup_ref (const char *group, const char *subgroup, struct Ref *ref)
	read subgroup REF file
int	I_get_subgroup_ref2 (const char *group, const char *subgroup, const char *mapset, struct Ref *ref)
	read subgroup REF file
int	I_init_ref_color_nums (struct Ref *ref)
int	I_put_group_ref (const char *group, const struct Ref *ref)
	write group REF file
int	I_put_subgroup_ref (const char *group, const char *subgroup, const struct Ref *ref)
	write subgroup REF file
int	I_add_file_to_group_ref (const char *name, const char *mapset, struct Ref *ref)
	add file name to Ref structure
int	I_transfer_group_ref_file (const struct Ref *ref2, int n, struct Ref *ref1)
	copy Ref lists
int	I_init_group_ref (struct Ref *ref)
	initialize Ref structure
int	I_free_group_ref (struct Ref *ref)
	free Ref structure

Function Documentation

I_add_file_to_group_ref()

int I_add_file_to_group_ref	(	const char *	name,
		const char *	mapset,
		struct Ref *	ref
	)

add file name to Ref structure

This routine adds the file name and mapset to the list contained in the ref structure, if it is not already in the list. The ref structure must have been properly initialized. This routine is used by programs, such as i.maxlik, to add to the group new raster maps created from files already in the group. Returns the index into the file array within the ref structure for the file after insertion; see Imagery_Library_Data_Structures.

Parameters

name
mapset
ref

Returns

int

Definition at line 380 of file group.c.

References G_malloc, G_realloc, Ref_Files::mapset, AMI_STREAM< T >::name(), name, and strcpy.

Referenced by I_transfer_group_ref_file().

I_free_group_ref()

int I_free_group_ref

(

struct Ref *

ref

)

free Ref structure

This routine frees memory allocated to the ref structure.

Parameters

ref

Returns

int

Definition at line 475 of file group.c.

References free().

Referenced by I_iclass_init_group().

I_get_group()

int I_get_group

(

char *

group

)

Definition at line 37 of file group.c.

References G_fopen_old(), G_mapset(), G_suppress_warnings(), GROUPFILE, and NULL.

I_get_group_ref()

int I_get_group_ref	(	const char *	group,
		struct Ref *	ref
	)

read group REF file

Reads the contents of the REF file for the specified group into the ref structure. Returns 1 if successful; 0 otherwise (but no error messages are printed).

Parameters

group
ref

Returns

int

Definition at line 111 of file group.c.

References NULL.

Referenced by I_iclass_init_group().

I_get_group_ref2()

int I_get_group_ref2	(	const char *	group,
		const char *	mapset,
		struct Ref *	ref
	)

read group REF file

Reads the contents of the REF file for the specified group into the ref structure. Returns 1 if successful; 0 otherwise (but no error messages are printed).

Parameters

group
mapset
ref

Returns

int

Definition at line 128 of file group.c.

I_get_subgroup()

int I_get_subgroup	(	const char *	group,
		char *	subgroup
	)

Definition at line 67 of file group.c.

References G_suppress_warnings(), I_find_group(), I_fopen_group_file_old(), NULL, and SUBGROUPFILE.

I_get_subgroup_ref()

int I_get_subgroup_ref	(	const char *	group,
		const char *	subgroup,
		struct Ref *	ref
	)

read subgroup REF file

Reads the contents of the REF file for the specified subgroup of the specified group into the ref structure. Returns 1 if successful; 0 otherwise (but no error messages are printed).

Parameters

group
subgroup
ref

Returns

int

Definition at line 146 of file group.c.

References NULL.

Referenced by I_iclass_init_group().

I_get_subgroup_ref2()

int I_get_subgroup_ref2	(	const char *	group,
		const char *	subgroup,
		const char *	mapset,
		struct Ref *	ref
	)

read subgroup REF file

Reads the contents of the REF file for the specified subgroup of the specified group into the ref structure. Returns 1 if successful; 0 otherwise (but no error messages are printed).

Parameters

group
subgroup
mapset
ref

Returns

int

Definition at line 165 of file group.c.

I_init_group_ref()

int I_init_group_ref

(

struct Ref *

ref

)

initialize Ref structure

This routine initializes the ref structure for other library calls which require a Ref structure. This routine must be called before any use of the structure can be made. Note. The routines I_get_group_ref and I_get_subgroup_ref call this routine automatically.

Parameters

ref

Returns

int

Definition at line 458 of file group.c.

References NULL.

Referenced by I_iclass_init_group().

I_init_ref_color_nums()

int I_init_ref_color_nums

(

struct Ref *

ref

)

Definition at line 250 of file group.c.

References NULL.

I_put_group()

int I_put_group

(

const char *

group

)

Definition at line 54 of file group.c.

References G_fopen_new(), GROUPFILE, and NULL.

I_put_group_ref()

int I_put_group_ref	(	const char *	group,
		const struct Ref *	ref
	)

write group REF file

Writes the contents of the ref structure to the REF file for the specified group. Returns 1 if successful; 0 otherwise (and prints a diagnostic error). Note. This routine will create the group, if it does not already exist.

Parameters

group
ref

Returns

int

Definition at line 306 of file group.c.

I_put_subgroup()

int I_put_subgroup	(	const char *	group,
		const char *	subgroup
	)

Definition at line 86 of file group.c.

References I_find_group(), I_fopen_group_file_new(), NULL, and SUBGROUPFILE.

I_put_subgroup_ref()

int I_put_subgroup_ref	(	const char *	group,
		const char *	subgroup,
		const struct Ref *	ref
	)

write subgroup REF file

Writes the contents of the ref structure into the REF file for the specified subgroup of the specified group. Returns 1 if successful; 0 otherwise (and prints a diagnostic error). Note. This routine will create the subgroup, if it does not already exist.

Parameters

group
subgroup
ref

Returns

int

Definition at line 326 of file group.c.

I_transfer_group_ref_file()

int I_transfer_group_ref_file	(	const struct Ref *	ref2,
		int	n,
		struct Ref *	ref1
	)

copy Ref lists

This routine is used to copy file names from one Ref structure to another. The name and mapset for file n from the src structure are copied into the dst structure (which must be properly initialized). For example, the following code copies one Ref structure to another:

struct Ref src,dst;
int n;
// some code to get information into <b>src</b>
...
I_init_group_ref (&dst);
for (n = 0; n < src.nfiles; n++)
I_transfer_group_ref_file (&src, n, &dst);

This routine is used by g.gui.gcp to create the REF file for a subgroup.

Parameters

ref2	Source
n
ref1	Destination

Returns

int 0

Definition at line 427 of file group.c.

References I_add_file_to_group_ref(), and AMI_STREAM< T >::name().