[XForms] Genuine API changes to forms.h, glcanvas.h since XForms 0.89

[Angus Leeming]

Jean-Marc, all,

I think that below are all the genuine API changes to forms.h since 
XForms 0.89. AFAICS, there is only one genuine regression and that it 
probably trivial. Nonetheless, I guess we should
#define fl_set_error_logfp fl_set_err_logfp.

I don't see any implications in passing 'unsigned long' to functions 
that used to receive 'unsigned' vars. Are there any implications when 
using shared objects?

I don't see any implications at all to returning an 'int' from 
functions that were previously declared as 'void'.

I have no feeling whatsoever about the implications of functions 
previously receiving 'char *' that now receive 'char []'.

Once these points have been nailed down, it'll be trivial to document 
these changes.

Angus



New static constants:
    FL_ARGUMENT   = -3,
    FL_ALLOC      = -4,
    FL_BAD_OBJECT = -5

New FL_EVENTS:
    FL_MOVEORIGIN,		/* dragging the form across the screen
				   changes its absolute x,y coords. Objects
				   that themselves contain forms should
				   ensure that they are up to date. */
    FL_RESIZED			/* The object has been resized by scale_form
				   Tell it that this has happened so that
				   it can resize any FL_FORMs that it
				   contains. */

-FL_EXPORT unsigned long fl_msleep(unsigned);
+FL_EXPORT unsigned long fl_msleep(unsigned long);

-FL_EXPORT FL_RAW_CALLBACK 
 fl_register_raw_callback(FL_FORM *, unsigned, FL_RAW_CALLBACK);
+FL_EXPORT FL_RAW_CALLBACK 
 fl_register_raw_callback(FL_FORM *, unsigned long, FL_RAW_CALLBACK);

-FL_EXPORT void fl_set_error_logfp(FILE *);
+FL_EXPORT void fl_set_err_logfp(FILE *);

-#define FL_CHART_MAX 512
+#define FL_CHART_MAX 2048
 
-FL_EXPORT void fl_set_chart_maxnumb(FL_OBJECT *, int);
+FL_EXPORT int fl_set_chart_maxnumb(FL_OBJECT *, int);

+FL_EXPORT void fl_set_chart_baseline(FL_OBJECT *, int);

+enum
+{
+ FL_TRIANGLE_UPBOX1,
+ FL_TRIANGLE_UPBOX2,
+ FL_TRIANGLE_UPBOX3,
+ FL_TRIANGLE_UPBOX4,
+ FL_TRIANGLE_UPBOX6,
+ FL_TRIANGLE_UPBOX7,
+ FL_TRIANGLE_UPBOX8,
+ FL_TRIANGLE_UPBOX9,
+ FL_TRIANGLE_DOWNBOX1,
+ FL_TRIANGLE_DOWNBOX2,
+ FL_TRIANGLE_DOWNBOX3,
+ FL_TRIANGLE_DOWNBOX4,
+ FL_TRIANGLE_DOWNBOX6,
+ FL_TRIANGLE_DOWNBOX7,
+ FL_TRIANGLE_DOWNBOX8,
+ FL_TRIANGLE_DOWNBOX9
+};


+typedef void (*FL_ERROR_FUNC)( const char *, const char *,... );
+typedef const char *(*FL_VAL_FILTER) (FL_OBJECT *, double, int);

+/** Functions to set and get the timeout value used by the
+ * counter code to control modification of the counter value.
+ */
+FL_EXPORT int fl_get_counter_repeat(FL_OBJECT *);
+FL_EXPORT void fl_set_counter_repeat(FL_OBJECT *, int);
 
-FL_EXPORT char *fl_fix_dirname(char *);
+FL_EXPORT char *fl_fix_dirname(char dir[]);

+FL_EXPORT int fl_goodies_atclose(FL_FORM *, void *);

+/** Functions to set and get the timeout value used by the
+ slider code to increment the position of the knob.
+ */
+FL_EXPORT int fl_get_slider_repeat(FL_OBJECT *);
+FL_EXPORT void fl_set_slider_repeat(FL_OBJECT *, int);

-FL_EXPORT void fl_set_xyplot_data(FL_OBJECT *, float *, float *, int, 
const char *, const char *, const char *);
+FL_EXPORT int fl_set_xyplot_data(FL_OBJECT *, float *, float *, int, 
const char *, const char *, const char *);

+FL_EXPORT int fl_set_xyplot_data_double(FL_OBJECT *, double *, double 
*, int, const char *, const char *, const char *);

+/* Replace the value of a particular point in dataset setID, 
+ * where setID=0 is the first data set.
+ * This routine is an extension of fl_replace_xyplot_point
+ * which acts on the first dataset only.
+ */
+FL_EXPORT void fl_replace_xyplot_point_in_overlay(FL_OBJECT *, int, 
int, double, double);


-FL_EXPORT void fl_get_glcanvas_defaults(int *);
+FL_EXPORT void fl_get_glcanvas_defaults(int[]);