NAME
get_target_ellipse_list - Gets target 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
int get_target_ellipse_list
(
Ellipse_list **target_list_ptr_ptr,
int num_ellipses
);
DESCRIPTION
This routine implements the creation/over-writing semantics used in the KJB
library in the case of ellipse_lists. If *target_list_ptr_ptr is NULL, then
this routine creates the ellipse_list. If it is not null, and it is the
right size, then this routine does nothing. If it is the wrong size, then it
is resized.
In order to be memory efficient, we free before resizing. If the resizing
fails, then the original contents of the *target_list_ptr_ptr will be lost.
However, (*target_list_ptr_ptr)->ellipses will be set to NULL, so
(*target_list_ptr_ptr) can be safely sent to free_ellipse_list().
DISCLAIMER
This software is not adequatedly tested. It is recomended that
results are checked independantly where appropriate.
AUTHOR
Kobus Barnard
DOCUMENTER
Kobus Barnard
SEE ALSO
create_ellipse_list
,
free_ellipse_list