Woolz Image Processing  Version 1.7.5
AlcArray

Files

file  AlcArray.c
 Provides functions for the allocation of 1, 2 and 3D arrays of types char, short, int, float and double. Extension to other types (including user defined types) should be straight formward through templates defined in AlcTemplates.h.
 

Macros

#define ALC_TEMPLATE_C1D(D, T, M, F)
 A template for functions which allocate 1 dimensional zero'd arrays of any type. More...
 
#define ALC_TEMPLATE_M1D(D, T, M, F)
 A template for functions which allocate 1 dimensional non-zero'd arrays of any type. More...
 
#define ALC_TEMPLATE_C2D(D, T, M, N, F)
 A template for functions which allocate 2 dimensional zero'd arrays of any type. More...
 
#define ALC_TEMPLATE_M2D(D, T, M, N, F)
 A template for functions which allocate 2 dimensional non-zero'd arrays of any type. More...
 
#define ALC_TEMPLATE_SYM_C2D(D, T, N, F)
 A template for functions which allocate 2 dimensional zero'd symetric arrays of any type. Obviously symetric arrays are square, but in this representation only the lower trinagle is stored. More...
 
#define ALC_TEMPLATE_SYM_M2D(D, T, N, F)
 A template for functions which allocate 2 dimensional zero'd symetric arrays of any type. Obviously symetric arrays are square, but in this representation only the lower trinagle is stored. More...
 
#define ALC_TEMPLATE_F2D(D, F)
 A template for functions which free 2 dimensional arrays of any type, actualy no type information is used in freeing the array. More...
 
#define ALC_TEMPLATE_C3D(D, T, M, N, O, F)
 A template for functions which allocate 3 dimensional zero'd arrays of any type. More...
 
#define ALC_TEMPLATE_M3D(D, T, M, N, O, F)
 A template for functions which allocate 3 dimensional non-zero'd arrays of any type. More...
 
#define ALC_TEMPLATE_F3D(D, F)
 A template for functions which free 3 dimensional arrays of any type, actualy no type information is used in freeing the array. More...
 

Functions

AlcErrno AlcBit1Calloc (unsigned char **dest, size_t mElem)
 Allocates a 1 dimensional zero'd bit array. More...
 
AlcErrno AlcPtr1Calloc (void ***dest, size_t mElem)
 Allocates a 1 dimensional zero'd array of pointers to void. More...
 
AlcErrno AlcChar1Calloc (char **dest, size_t mElem)
 Allocates a 1 dimensional zero'd array of chars. More...
 
AlcErrno AlcUnchar1Calloc (unsigned char **dest, size_t mElem)
 Allocates a 1 dimensional zero'd array of unsigned chars. More...
 
AlcErrno AlcShort1Calloc (short **dest, size_t mElem)
 Allocates a 1 dimensional zero'd array of shorts. More...
 
AlcErrno AlcInt1Calloc (int **dest, size_t mElem)
 Allocates a 1 dimensional zero'd array of ints. More...
 
AlcErrno AlcFloat1Calloc (float **dest, size_t mElem)
 Allocates a 1 dimensional zero'd array of floats. More...
 
AlcErrno AlcDouble1Calloc (double **dest, size_t mElem)
 Allocates a 1 dimensional zero'd array of doubles. More...
 
AlcErrno AlcBit1Malloc (unsigned char **dest, size_t mElem)
 Allocates a 1 dimensional non-zero'd bit array. More...
 
AlcErrno AlcPtr1Malloc (void ***dest, size_t mElem)
 Allocates a 1 dimensional non-zero'd array of pointers to void. More...
 
AlcErrno AlcChar1Malloc (char **dest, size_t mElem)
 Allocates a 1 dimensional non-zero'd array of chars. More...
 
AlcErrno AlcUnchar1Malloc (unsigned char **dest, size_t mElem)
 Allocates a 1 dimensional non-zero'd array of unsigned chars. More...
 
AlcErrno AlcShort1Malloc (short **dest, size_t mElem)
 Allocates a 1 dimensional non-zero'd array of shorts. More...
 
AlcErrno AlcInt1Malloc (int **dest, size_t mElem)
 Allocates a 1 dimensional non-zero'd array of ints. More...
 
AlcErrno AlcFloat1Malloc (float **dest, size_t mElem)
 Allocates a 1 dimensional non-zero'd array of floats. More...
 
AlcErrno AlcDouble1Malloc (double **dest, size_t mElem)
 Allocates a 1 dimensional non-zero'd array of doubles. More...
 
AlcErrno AlcBit2Calloc (unsigned char ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional zero'd bit array. More...
 
AlcErrno AlcPtr2Calloc (void ****dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional zero'd array of pointers to void. More...
 
AlcErrno AlcChar2Calloc (char ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional zero'd array of chars. More...
 
AlcErrno AlcUnchar2Calloc (unsigned char ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional zero'd array of unsigned chars. More...
 
AlcErrno AlcShort2Calloc (short ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional zero'd array of shorts. More...
 
AlcErrno AlcInt2Calloc (int ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional zero'd array of ints. More...
 
AlcErrno AlcFloat2Calloc (float ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional zero'd array of floats. More...
 
AlcErrno AlcDouble2Calloc (double ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional zero'd array of doubles. More...
 
AlcErrno AlcBit2Malloc (unsigned char ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional non-zero'd bit array. More...
 
AlcErrno AlcPtr2Malloc (void ****dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional non-zero'd array of pointers to void. More...
 
AlcErrno AlcChar2Malloc (char ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional non-zero'd array of chars. More...
 
AlcErrno AlcUnchar2Malloc (unsigned char ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional non-zero'd array of unsigned chars. More...
 
AlcErrno AlcShort2Malloc (short ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional non-zero'd array of shorts. More...
 
AlcErrno AlcInt2Malloc (int ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional non-zero'd array of ints. More...
 
AlcErrno AlcFloat2Malloc (float ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional non-zero'd array of floats. More...
 
AlcErrno AlcDouble2Malloc (double ***dest, size_t mElem, size_t nElem)
 Allocates a 2 dimensional non-zero'd array of doubles. More...
 
AlcErrno AlcSymChar2Calloc (char ***dest, size_t nElem)
 Allocates a 2 dimensional zero'd symetric array of chars in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymUnchar2Calloc (unsigned char ***dest, size_t nElem)
 Allocates a 2 dimensional zero'd symetric array of unsigned chars in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymShort2Calloc (short ***dest, size_t nElem)
 Allocates a 2 dimensional zero'd symetric array of shorts in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymInt2Calloc (int ***dest, size_t nElem)
 Allocates a 2 dimensional zero'd symetric array of ints in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymFloat2Calloc (float ***dest, size_t nElem)
 Allocates a 2 dimensional zero'd symetric array of floats in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymDouble2Calloc (double ***dest, size_t nElem)
 Allocates a 2 dimensional zero'd symetric array of doubles in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymChar2Malloc (char ***dest, size_t nElem)
 Allocates a 2 dimensional non-zero'd symetric array of chars in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymUnchar2Malloc (unsigned char ***dest, size_t nElem)
 Allocates a 2 dimensional non-zero'd symetric array of unsigned chars in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymShort2Malloc (short ***dest, size_t nElem)
 Allocates a 2 dimensional non-zero'd symetric array of shorts in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymInt2Malloc (int ***dest, size_t nElem)
 Allocates a 2 dimensional non-zero'd symetric array of ints in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymFloat2Malloc (float ***dest, size_t nElem)
 Allocates a 2 dimensional non-zero'd symetric array of floats in which only the lower triangle of elements are stored. More...
 
AlcErrno AlcSymDouble2Malloc (double ***dest, size_t nElem)
 Allocates a 2 dimensional non-zero'd symetric array of doubles in which only the lower triangle of elements are stored. More...
 
AlcErrno Alc2Free (void **dat)
 Free's a 2 dimensional array allocated by one of the 2 dimensional array allocation functions. More...
 
AlcErrno AlcBit3Calloc (unsigned char ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional zero'd bit array. More...
 
AlcErrno AlcPtr3Calloc (void *****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional array of pointers to void. More...
 
AlcErrno AlcChar3Calloc (char ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional array of chars. More...
 
AlcErrno AlcUnchar3Calloc (unsigned char ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional array of unsigned chars. More...
 
AlcErrno AlcShort3Calloc (short ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional array of chars. More...
 
AlcErrno AlcInt3Calloc (int ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional array of chars. More...
 
AlcErrno AlcFloat3Calloc (float ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional array of chars. More...
 
AlcErrno AlcPtr3Malloc (void *****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional non-zero'd array of pointers to void. More...
 
AlcErrno AlcChar3Malloc (char ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional non-zero'd array of chars. More...
 
AlcErrno AlcUnchar3Malloc (unsigned char ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional non-zero'd array of unsigned chars. More...
 
AlcErrno AlcShort3Malloc (short ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional non-zero'd array of shorts. More...
 
AlcErrno AlcInt3Malloc (int ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional non-zero'd array of ints. More...
 
AlcErrno AlcFloat3Malloc (float ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional non-zero'd array of floats. More...
 
AlcErrno AlcDouble3Malloc (double ****dest, size_t mElem, size_t nElem, size_t oElem)
 Allocates a 3 dimensional non-zero'd array of doubles. More...
 
AlcErrno Alc3Free (void ***dest)
 Free's any 3 dimensional array allocated by one of the 3 dimensional array allocation functions. More...
 
AlcErrno AlcDouble1ReadAsci (FILE *fP, double **dstA, size_t *dstNElem)
 Reads a 1D double array from the given numeric ASCI file. Each value should be on a seperate line. More...
 
AlcErrno AlcDouble2ReadAsci (FILE *fP, double ***dstA, size_t *dstMElem, size_t *dstNElem)
 Reads a 2D double array from the given numeric ASCI file. Fields in the file must be white space saperated and records must be on separate lines. The number of fields per record must be the same for all records. More...
 
AlcErrno AlcDouble1WriteAsci (FILE *fP, double *ar, size_t nElem)
 Writes a 1D double array in numeric ASCI format to the given file file. Elements are on separate lines. More...
 
AlcErrno AlcDouble2WriteAsci (FILE *fP, double **ar, size_t mElem, size_t nElem)
 Writes a 2D double array in numeric ASCI format to the given file file. Fields in the file are white space seperated and records are on separate lines. More...
 

Detailed Description

Macro Definition Documentation

#define ALC_TEMPLATE_C1D (   D,
  T,
  M,
 
)
Value:
AlcErrno alcErrno = ALC_ER_NONE; \
\
if((D) == NULL) \
alcErrno = ALC_ER_NULLPTR; \
else if((M) < 1) \
alcErrno = ALC_ER_NUMELEM; \
else if((*(D) = (T*)AlcCalloc((M), sizeof(T))) == NULL) \
alcErrno = ALC_ER_ALLOC; \
if(alcErrno != ALC_ER_NONE) \
{ \
if(D) \
*(D) = NULL; \
} \
return(alcErrno);
Definition: AlcType.h:86
enum _AlcErrno AlcErrno
Definition: AlcType.h:88
Definition: AlcType.h:87
Definition: AlcType.h:85
void * AlcCalloc(size_t elCount, size_t elSz)
Allocates space for the given number of elements with each element set to zero. At it&#39;s most basic th...
Definition: AlcAlloc.c:60

A template for functions which allocate 1 dimensional zero'd arrays of any type.

Parameters
DDestination pointer, of type T *.
TType, eg char, short, int, ....
MNumber of elements in array.
FString with name of function.

Referenced by AlcChar1Calloc(), AlcDouble1Calloc(), AlcFloat1Calloc(), AlcInt1Calloc(), and AlcShort1Calloc().

#define ALC_TEMPLATE_M1D (   D,
  T,
  M,
 
)
Value:
AlcErrno alcErrno = ALC_ER_NONE; \
\
if((D) == NULL) \
alcErrno = ALC_ER_NULLPTR; \
else if((M) < 1) \
alcErrno = ALC_ER_NUMELEM; \
else if((*(D) = (T*)AlcMalloc((M) * sizeof(T))) == NULL) \
alcErrno = ALC_ER_ALLOC; \
if(alcErrno != ALC_ER_NONE) \
{ \
if(D) \
*(D) = NULL; \
} \
return(alcErrno);
Definition: AlcType.h:86
enum _AlcErrno AlcErrno
void * AlcMalloc(size_t byteCount)
Allocates space for the given number of bytes with each each element left an undefined value...
Definition: AlcAlloc.c:78
Definition: AlcType.h:88
Definition: AlcType.h:87
Definition: AlcType.h:85

A template for functions which allocate 1 dimensional non-zero'd arrays of any type.

Parameters
DDestination pointer, of type T *.
TType, eg char, short, int, ....
MNumber of elements in array.
FString with name of function.

Referenced by AlcChar1Malloc(), AlcDouble1Malloc(), AlcFloat1Malloc(), AlcInt1Malloc(), and AlcShort1Malloc().

#define ALC_TEMPLATE_C2D (   D,
  T,
  M,
  N,
 
)

A template for functions which allocate 2 dimensional zero'd arrays of any type.

Parameters
DDestination pointer, of type T **.
TType, eg char, short, int, ....
MNumber of 1D arrays.
NNumber of elements in each 1D array.
FString with name of function.

Referenced by AlcChar2Calloc(), AlcDouble2Calloc(), AlcFloat2Calloc(), AlcInt2Calloc(), and AlcShort2Calloc().

#define ALC_TEMPLATE_M2D (   D,
  T,
  M,
  N,
 
)

A template for functions which allocate 2 dimensional non-zero'd arrays of any type.

Parameters
DDestination pointer, of type T **.
TType, eg char, short, int, ....
MNumber of 1D arrays.
NNumber of elements in each 1D array.
FString with name of function.

Referenced by AlcChar2Malloc(), AlcDouble2Malloc(), AlcFloat2Malloc(), AlcInt2Malloc(), and AlcShort2Malloc().

#define ALC_TEMPLATE_SYM_C2D (   D,
  T,
  N,
 
)

A template for functions which allocate 2 dimensional zero'd symetric arrays of any type. Obviously symetric arrays are square, but in this representation only the lower trinagle is stored.

Parameters
DDestination pointer, of type T **.
TType, eg char, short, int, ....
NNumber of rows or columns.
FString with name of function.

Referenced by AlcSymChar2Calloc(), AlcSymDouble2Calloc(), AlcSymFloat2Calloc(), AlcSymInt2Calloc(), and AlcSymShort2Calloc().

#define ALC_TEMPLATE_SYM_M2D (   D,
  T,
  N,
 
)

A template for functions which allocate 2 dimensional zero'd symetric arrays of any type. Obviously symetric arrays are square, but in this representation only the lower trinagle is stored.

Parameters
DDestination pointer, of type T **.
TType, eg char, short, int, ....
NNumber of rows or columns.
FString with name of function.

Referenced by AlcSymChar2Malloc(), AlcSymDouble2Malloc(), AlcSymFloat2Malloc(), AlcSymInt2Malloc(), and AlcSymShort2Malloc().

#define ALC_TEMPLATE_F2D (   D,
 
)
Value:
AlcErrno alcErrno = ALC_ER_NONE; \
\
if((D == NULL) || (*(D) == NULL)) \
{ \
alcErrno = ALC_ER_NULLPTR; \
} \
else \
{ \
AlcFree(*(D)); \
AlcFree(D); \
} \
return(alcErrno);
enum _AlcErrno AlcErrno
Definition: AlcType.h:87
Definition: AlcType.h:85

A template for functions which free 2 dimensional arrays of any type, actualy no type information is used in freeing the array.

Parameters
DPointer for array to be free'd.
FString with name of function.

Referenced by Alc2Free(), AlcChar2Free(), AlcDouble2Free(), AlcFloat2Free(), AlcInt2Free(), and AlcShort2Free().

#define ALC_TEMPLATE_C3D (   D,
  T,
  M,
  N,
  O,
 
)

A template for functions which allocate 3 dimensional zero'd arrays of any type.

Parameters
DDestination pointer, of type T **.
TType, eg char, short, int, ....
MNumber of 2D arrays.
NNumber of 1D arrays.
ONumber of elements in each 1D array.
FString with name of function.

Referenced by AlcChar3Calloc(), AlcDouble3Calloc(), AlcFloat3Calloc(), AlcInt3Calloc(), and AlcShort3Calloc().

#define ALC_TEMPLATE_M3D (   D,
  T,
  M,
  N,
  O,
 
)

A template for functions which allocate 3 dimensional non-zero'd arrays of any type.

Parameters
DDestination pointer, of type T **.
TType, eg char, short, int, ....
MNumber of 2D arrays.
NNumber of 1D arrays.
ONumber of elements in each 1D array.
FString with name of function.

Referenced by AlcChar3Malloc(), AlcDouble3Malloc(), AlcFloat3Malloc(), AlcInt3Malloc(), and AlcShort3Malloc().

#define ALC_TEMPLATE_F3D (   D,
 
)
Value:
AlcErrno alcErrno = ALC_ER_NONE; \
\
if((D == NULL) || (*(D) == NULL) || (**(D) == NULL)) \
{ \
alcErrno = ALC_ER_NULLPTR; \
} \
else \
{ \
AlcFree(**(D)); \
AlcFree(*(D)); \
AlcFree(D); \
} \
return(alcErrno);
enum _AlcErrno AlcErrno
Definition: AlcType.h:87
Definition: AlcType.h:85

A template for functions which free 3 dimensional arrays of any type, actualy no type information is used in freeing the array.

Parameters
DPointer for array to be free'd.
FString with name of function.

Referenced by Alc3Free(), AlcChar3Free(), AlcDouble3Free(), AlcFloat3Free(), AlcInt3Free(), and AlcShort3Free().

Function Documentation

AlcErrno AlcBit1Calloc ( unsigned char **  dest,
size_t  mElem 
)

Allocates a 1 dimensional zero'd bit array.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References AlcUnchar1Calloc().

Referenced by WlzCMeshToDomObjValues(), WlzCMeshTransformManyObjAsIdx(), and WlzContourFromPoints().

AlcErrno AlcPtr1Calloc ( void ***  dest,
size_t  mElem 
)

Allocates a 1 dimensional zero'd array of pointers to void.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_ER_ALLOC, ALC_ER_NONE, ALC_ER_NULLPTR, ALC_ER_NUMELEM, and AlcCalloc().

AlcErrno AlcChar1Calloc ( char **  dest,
size_t  mElem 
)

Allocates a 1 dimensional zero'd array of chars.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_TEMPLATE_C1D.

Referenced by AlcUnchar1Calloc().

AlcErrno AlcUnchar1Calloc ( unsigned char **  dest,
size_t  mElem 
)

Allocates a 1 dimensional zero'd array of unsigned chars.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References AlcChar1Calloc().

Referenced by AlcBit1Calloc().

AlcErrno AlcShort1Calloc ( short **  dest,
size_t  mElem 
)

Allocates a 1 dimensional zero'd array of shorts.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_TEMPLATE_C1D.

AlcErrno AlcInt1Calloc ( int **  dest,
size_t  mElem 
)

Allocates a 1 dimensional zero'd array of ints.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_TEMPLATE_C1D.

AlcErrno AlcFloat1Calloc ( float **  dest,
size_t  mElem 
)

Allocates a 1 dimensional zero'd array of floats.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_TEMPLATE_C1D.

AlcErrno AlcDouble1Calloc ( double **  dest,
size_t  mElem 
)

Allocates a 1 dimensional zero'd array of doubles.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_TEMPLATE_C1D.

AlcErrno AlcBit1Malloc ( unsigned char **  dest,
size_t  mElem 
)

Allocates a 1 dimensional non-zero'd bit array.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References AlcUnchar1Malloc().

AlcErrno AlcPtr1Malloc ( void ***  dest,
size_t  mElem 
)

Allocates a 1 dimensional non-zero'd array of pointers to void.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_ER_ALLOC, ALC_ER_NONE, ALC_ER_NULLPTR, ALC_ER_NUMELEM, and AlcMalloc().

AlcErrno AlcChar1Malloc ( char **  dest,
size_t  mElem 
)

Allocates a 1 dimensional non-zero'd array of chars.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_TEMPLATE_M1D.

Referenced by AlcUnchar1Malloc().

AlcErrno AlcUnchar1Malloc ( unsigned char **  dest,
size_t  mElem 
)

Allocates a 1 dimensional non-zero'd array of unsigned chars.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References AlcChar1Malloc().

Referenced by AlcBit1Malloc().

AlcErrno AlcShort1Malloc ( short **  dest,
size_t  mElem 
)

Allocates a 1 dimensional non-zero'd array of shorts.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_TEMPLATE_M1D.

AlcErrno AlcInt1Malloc ( int **  dest,
size_t  mElem 
)

Allocates a 1 dimensional non-zero'd array of ints.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_TEMPLATE_M1D.

AlcErrno AlcFloat1Malloc ( float **  dest,
size_t  mElem 
)

Allocates a 1 dimensional non-zero'd array of floats.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_TEMPLATE_M1D.

AlcErrno AlcDouble1Malloc ( double **  dest,
size_t  mElem 
)

Allocates a 1 dimensional non-zero'd array of doubles.

Returns
Error code.
Note
Should be free'd using AlcFree().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of elements in array.

References ALC_TEMPLATE_M1D.

Referenced by Wlz3DViewStructSetupTransformLuts(), WlzAffineTransformLSqRegWlz2D(), and WlzContourFromPoints().

AlcErrno AlcBit2Calloc ( unsigned char ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional zero'd bit array.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References AlcUnchar2Calloc().

Referenced by WlzAffineTransformGMShell(), WlzContourFromPoints(), WlzContourGrdObj2D(), WlzContourRBFBndObj3D(), WlzFromBArray1D(), and WlzRankFilter().

AlcErrno AlcPtr2Calloc ( void ****  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional zero'd array of pointers to void.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_ER_ALLOC, ALC_ER_NONE, ALC_ER_NULLPTR, ALC_ER_NUMELEM, AlcCalloc(), AlcFree(), and AlcMalloc().

AlcErrno AlcChar2Calloc ( char ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional zero'd array of chars.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_TEMPLATE_C2D.

Referenced by AlcUnchar2Calloc().

AlcErrno AlcUnchar2Calloc ( unsigned char ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional zero'd array of unsigned chars.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References AlcChar2Calloc().

Referenced by AlcBit2Calloc(), WlzCMeshCompSurfMap(), WlzContourGrdObj2D(), and WlzProjectObjToPlane().

AlcErrno AlcShort2Calloc ( short ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional zero'd array of shorts.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_TEMPLATE_C2D.

AlcErrno AlcInt2Calloc ( int ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional zero'd array of ints.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_TEMPLATE_C2D.

Referenced by WlzProjectObjToPlane().

AlcErrno AlcFloat2Calloc ( float ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional zero'd array of floats.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_TEMPLATE_C2D.

AlcErrno AlcDouble2Calloc ( double ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional zero'd array of doubles.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_TEMPLATE_C2D.

Referenced by AlgMatrixRectNew(), WlzContourGrdObj2D(), and WlzMakeAffineTransform().

AlcErrno AlcBit2Malloc ( unsigned char ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd bit array.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References AlcUnchar2Malloc().

Referenced by WlzRsvFilterBuffer(), and WlzToArray2D().

AlcErrno AlcPtr2Malloc ( void ****  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd array of pointers to void.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_ER_ALLOC, ALC_ER_NONE, ALC_ER_NULLPTR, ALC_ER_NUMELEM, AlcFree(), and AlcMalloc().

AlcErrno AlcChar2Malloc ( char ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd array of chars.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_TEMPLATE_M2D.

Referenced by AlcUnchar2Malloc().

AlcErrno AlcUnchar2Malloc ( unsigned char ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd array of unsigned chars.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References AlcChar2Malloc().

Referenced by AlcBit2Malloc(), WlzEffReadObjBmpData2D(), WlzEffReadObjPnmData2D(), and WlzRankFilter().

AlcErrno AlcShort2Malloc ( short ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd array of shorts.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_TEMPLATE_M2D.

Referenced by WlzRankFilter().

AlcErrno AlcInt2Malloc ( int ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd array of ints.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_TEMPLATE_M2D.

Referenced by WlzEffReadObjGif(), WlzRankFilter(), WlzSampleObj(), and WlzSampleObjPoint2D().

AlcErrno AlcFloat2Malloc ( float ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd array of floats.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_TEMPLATE_M2D.

Referenced by WlzRankFilter().

AlcErrno AlcDouble2Malloc ( double ***  dest,
size_t  mElem,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd array of doubles.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 1D arrays.
nElemNumber of elements in each 1D array.

References ALC_TEMPLATE_M2D.

Referenced by AlgMixtureMLG(), WlzAffineTransformLSqReg2D(), WlzAffineTransformLSqReg3D(), WlzAffineTransformLSqRegWlz2D(), WlzAutoCor(), WlzContourFromPoints(), WlzContourGrdObj2D(), WlzInit3DViewStructAffineTransform(), WlzRankFilter(), WlzRsvFilterBuffer(), WlzSampleObj(), and WlzSampleObjPoint2D().

AlcErrno AlcSymChar2Calloc ( char ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional zero'd symetric array of chars in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References ALC_TEMPLATE_SYM_C2D.

Referenced by AlcSymUnchar2Calloc().

AlcErrno AlcSymUnchar2Calloc ( unsigned char ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional zero'd symetric array of unsigned chars in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References AlcSymChar2Calloc().

AlcErrno AlcSymShort2Calloc ( short ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional zero'd symetric array of shorts in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References ALC_TEMPLATE_SYM_C2D.

AlcErrno AlcSymInt2Calloc ( int ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional zero'd symetric array of ints in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References ALC_TEMPLATE_SYM_C2D.

AlcErrno AlcSymFloat2Calloc ( float ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional zero'd symetric array of floats in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References ALC_TEMPLATE_SYM_C2D.

AlcErrno AlcSymDouble2Calloc ( double ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional zero'd symetric array of doubles in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References ALC_TEMPLATE_SYM_C2D.

AlcErrno AlcSymChar2Malloc ( char ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd symetric array of chars in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References ALC_TEMPLATE_SYM_M2D.

Referenced by AlcSymUnchar2Malloc().

AlcErrno AlcSymUnchar2Malloc ( unsigned char ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd symetric array of unsigned chars in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References AlcSymChar2Malloc().

AlcErrno AlcSymShort2Malloc ( short ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd symetric array of shorts in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References ALC_TEMPLATE_SYM_M2D.

AlcErrno AlcSymInt2Malloc ( int ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd symetric array of ints in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References ALC_TEMPLATE_SYM_M2D.

AlcErrno AlcSymFloat2Malloc ( float ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd symetric array of floats in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References ALC_TEMPLATE_SYM_M2D.

AlcErrno AlcSymDouble2Malloc ( double ***  dest,
size_t  nElem 
)

Allocates a 2 dimensional non-zero'd symetric array of doubles in which only the lower triangle of elements are stored.

Returns
Error code.
Note
Should be free'd using Alc2Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
nElemNumber of row or column elements in the symetric array.

References ALC_TEMPLATE_SYM_M2D.

AlcErrno Alc2Free ( void **  dat)

Free's a 2 dimensional array allocated by one of the 2 dimensional array allocation functions.

Returns
Error code.
Parameters
datPtr with array to be free'd.

References ALC_TEMPLATE_F2D.

Referenced by WlzAffineTransformGMShell(), WlzAutoCor(), WlzCMeshCompSurfMap(), WlzContourFromPoints(), WlzContourGrdObj2D(), WlzContourRBFBndObj3D(), WlzEffReadObjGif(), WlzEffWriteObjAnl(), WlzEffWriteObjNifti(), WlzEffWriteObjStack(), WlzFourierTransformObj(), WlzImageBlendObjToBufRGBA(), WlzProjectObjToPlane(), WlzRankFilter(), and WlzRsvFilterBuffer().

AlcErrno AlcBit3Calloc ( unsigned char ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional zero'd bit array.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References AlcUnchar3Calloc().

Referenced by WlzRankFilter(), and WlzRasterLineSetItv2D().

AlcErrno AlcPtr3Calloc ( void *****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional array of pointers to void.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_ER_ALLOC, ALC_ER_NONE, ALC_ER_NULLPTR, ALC_ER_NUMELEM, AlcCalloc(), AlcFree(), and AlcMalloc().

AlcErrno AlcChar3Calloc ( char ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional array of chars.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_TEMPLATE_C3D.

Referenced by AlcUnchar3Calloc().

AlcErrno AlcUnchar3Calloc ( unsigned char ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional array of unsigned chars.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References AlcChar3Calloc().

Referenced by AlcBit3Calloc().

AlcErrno AlcShort3Calloc ( short ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional array of chars.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_TEMPLATE_C3D.

AlcErrno AlcInt3Calloc ( int ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional array of chars.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_TEMPLATE_C3D.

AlcErrno AlcFloat3Calloc ( float ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional array of chars.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_TEMPLATE_C3D.

AlcErrno AlcPtr3Malloc ( void *****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional non-zero'd array of pointers to void.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_ER_ALLOC, ALC_ER_NONE, ALC_ER_NULLPTR, ALC_ER_NUMELEM, AlcFree(), and AlcMalloc().

Referenced by WlzGeoModelGridWSpSet3D().

AlcErrno AlcChar3Malloc ( char ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional non-zero'd array of chars.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_TEMPLATE_M3D.

Referenced by AlcUnchar3Malloc(), and WlzEffWriteObjAm().

AlcErrno AlcUnchar3Malloc ( unsigned char ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional non-zero'd array of unsigned chars.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References AlcChar3Malloc().

Referenced by AlcBit3Malloc(), WlzEffReadObjDen(), WlzEffReadObjIcs(), WlzEffReadObjIPL(), WlzEffReadObjPic(), WlzEffReadObjSlc(), WlzEffReadObjVff(), WlzEffWriteObjStack(), and WlzRankFilter().

AlcErrno AlcShort3Malloc ( short ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional non-zero'd array of shorts.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_TEMPLATE_M3D.

Referenced by WlzEffReadObjIcs(), WlzEffReadObjIPL(), WlzEffReadObjPic(), WlzEffReadObjVff(), WlzEffWriteObjAm(), and WlzRankFilter().

AlcErrno AlcInt3Malloc ( int ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional non-zero'd array of ints.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_TEMPLATE_M3D.

Referenced by WlzEffReadObjIcs(), WlzEffReadObjIPL(), WlzEffReadObjVff(), and WlzRankFilter().

AlcErrno AlcFloat3Malloc ( float ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional non-zero'd array of floats.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_TEMPLATE_M3D.

Referenced by WlzEffReadObjIPL(), and WlzRankFilter().

AlcErrno AlcDouble3Malloc ( double ****  dest,
size_t  mElem,
size_t  nElem,
size_t  oElem 
)

Allocates a 3 dimensional non-zero'd array of doubles.

Returns
Error code.
Note
Should be free'd using Alc3Free().
Array size is limited only by address space.
Parameters
destDestination for allocated array pointer.
mElemNumber of 2D arrays.
nElemNumber of 1D arrays.
oElemNumber of elements in each 1D array.

References ALC_TEMPLATE_M3D.

Referenced by WlzRankFilter(), and WlzRsvFilterBuffer().

AlcErrno AlcDouble1ReadAsci ( FILE *  fP,
double **  dstA,
size_t *  dstNElem 
)

Reads a 1D double array from the given numeric ASCI file. Each value should be on a seperate line.

Returns
Error code.
Parameters
fPFile pointer.
dstADestination pointer for the new array.
dstNElemDestination pointer for the number of elements in the 1D array.

References ALC_ER_NONE, AlcVecReadDouble1Asci(), AlcVectorFree(), and AlcVectorToArray1D().

AlcErrno AlcDouble2ReadAsci ( FILE *  fP,
double ***  dstA,
size_t *  dstMElem,
size_t *  dstNElem 
)

Reads a 2D double array from the given numeric ASCI file. Fields in the file must be white space saperated and records must be on separate lines. The number of fields per record must be the same for all records.

Returns
Error code.
Parameters
fPFile pointer.
dstADestination pointer for the new array.
dstMElemDestination pointer for the number of 1D arrays (number of records).
dstNElemDestination pointer for the number of elements in each 1D array (number of fields per record).

References ALC_ER_NONE, AlcVecReadDouble2Asci(), AlcVectorFree(), and AlcVectorToArray2D().

AlcErrno AlcDouble1WriteAsci ( FILE *  fP,
double *  ar,
size_t  nElem 
)

Writes a 1D double array in numeric ASCI format to the given file file. Elements are on separate lines.

Returns
Error code.
Parameters
fPFile pointer.
arGiven array.
nElemNumber of elements in the 1D array.

References ALC_ER_NONE, and ALC_ER_WRITE.

Referenced by WlzBasisFnScalarMOS3DFromCPts(), and WlzCMeshCompSurfMap().

AlcErrno AlcDouble2WriteAsci ( FILE *  fP,
double **  ar,
size_t  mElem,
size_t  nElem 
)

Writes a 2D double array in numeric ASCI format to the given file file. Fields in the file are white space seperated and records are on separate lines.

Returns
Error code.
Parameters
fPFile pointer.
arGiven array.
mElemNumber of 1D arrays (number of records).
nElemNumber of elements in each 1D array (number of fields per record).

References ALC_ER_NONE, and ALC_ER_WRITE.

Referenced by WlzRegICPTreeAndVertices(), and WlzRegICPVerticesWSD2D().