NAME

create_ellipse_list - Creates a ellipse_list

SYNOPSIS

#include "g2/g2_ellipse.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


Ellipse_list *create_ellipse_list(int num_ellipses);

DESCRIPTION

This routine creates a ellipse_list and returns a pointer to it. If TEST is #defined (unix only) then this routine is #define'd to be debug_create_ellipse_list, which is the version available in the developement library. In developement code memory is tracked so that memory leaks can be found more easily. Furthermore, all memory freed is checked that it was allocated by an L library routine. The routine free_ellipse_list should be used to dispose of the storage once it is no longer needed.

RETURNS

On error, this routine returns NULL, with an error message being set. One success it returns a pointer to the ellipse_list.

ACKNOWLEGEMENT

This routine grew out of one written by Ian Harder. However, it is important to note that this routine is somewhat different than any of Ian's routines.

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER