List of Changes

VERSION 2.5 (Proposed Changes)

• Multiple selection listboxes:

    listbox newmultilist(char * string_list[], rect r, scrollfn fn);
    int     isselected(listbox b, int index);
  

• New drop-down lists and editable field lists:

    listbox newdroplist(char * string_list[], rect r, scrollfn fn);
    listbox newdropfield(char * string_list[], rect r, scrollfn fn);
  

• New dialogs:

    char * askpassword(char *question, char *default_answer);
  

• gettext should work on all list types too, but not multilists.
• Will have to produce new graphapp.h header file.

VERSION 2.4

• New text boxes:

    textbox newtextarea(char *text, rect r);
    field   newpassword(char *text, rect r);
  

• New image display controls:

    control  newpicture(image img, rect r);
    button   newimagebutton(image img, rect r, actionfn fn);
    checkbox newimagecheckbox(image img, rect r, actionfn fn);
    void     setimage(button b, image img);
  

• New image functions:

    bitmap imagetobitmap(image img);
    image  scaleimage(image src, rect dr, rect sr);
    void   drawimage(image img, rect dr, rect sr);
    void   drawmonochrome(image img, rect dr, rect sr);
    void   drawgreyscale(image img, rect dr, rect sr);
    void   drawgrayscale(image img, rect dr, rect sr);
    void   drawdarker(image img, rect dr, rect sr);
    void   drawbrighter(image img, rect dr, rect sr);
  

• Notes on new image functions:

  • The scaleimage function can perform cropping and scaling.
  • Note sr and dr refer to rectangles in the source, and destination, respectively.
  • drawimage has been modifed to allow cropping and scaling.
  • drawimage is now much faster (uses imagetobitmap).
  • drawdarkened has been replaced by drawdarker.
  • drawdisabled has been replaced by drawgreyscale.
  • drawgrayscale is the same function as drawgreyscale (just American spelling versus English spelling).

• Timer function modified:

    typedef void (*timerfn)(void *data);
    void	  settimerfn(timerfn timeout, void *data);
  

  This allows timers to receive a data pointer.

• Changed the dialogs to use these constants (defined in graphapp.h):

    #define YES     1
    #define NO     -1	// note the swap
    #define CANCEL  0	// note the swap
  

  This allows all functions to return CANCEL if they have been cancelled (including those which return strings). Check all instances of the following functions: askokcancel, askyesno and askyesnocancel. In particular the expression

    if (askyesno("?")) ...

  always evaluates to true! So check carefully...

• Changed createcursor to be called newcursor (the old newcursor becomes createcursor)

• Added a new font function:

    rect  strrect(font f, char *str);
  

  This replaces strsize because it is more logical.

• Bug-fixes:

  • Fixed copyrect, scrollrect and texturerect to use current drawing destination and mode correctly (previously they used bitblt with a mode of S).
  • Palette functions for 16-bit and 24-bit colour selections are now Blindingly Fast (tm)
  • File dialogs now rescan the directory when shown.
  • From version 2.41, loadbitmap can load GIFs and the resultant bitmap has transparency information built-in. Note: this is better than using loadimage and then drawimage, because it avoids recreating the bitmap.
  • From v2.41, getrect (actually objrect) has been fixed so that the x and y coordinates returned will always be zero.
  • From v2.41, setimage no longer uses the data pointer of an imagebutton, imagecheckbox or picture. Instead there is a special image pointer stored with those objects. Also, drawing of those objects has been optimised.
  • Version 2.42 of the Athena GraphApp has a bug-fix for the geometry manager which sometimes placed controls in odd places. Also, there is a new listbox widget.
  • Version 2.42 of the Windows GraphApp has some minor bugfixes for the askstring function and a bit of code in init.c
  • Version 2.46 of all GraphApp versions have a bug fix in drawtext.c for an infinite loop problem.
  • Version 2.47 of the Windows GraphApp fixes a problem with the CallWindowProc function having a parameter type mismatch.
  • Version 2.47 of the all GraphApp versions of the file array.c now use the C standard functions memset and memmove for faster memory access.
  • Version 2.48 of the Windows GraphApp fixes a problem with the pattern alignments on 256-colour machines using Win32, Win95 or Win98.

• There is a new graphapp.h header file.

VERSION 2.3

• Added byte type (a byte is an unsigned char)
• An rgb is now an unsigned long.
• Added functions: getaplha, getred, getgreen, getblue which work on rgb values.
• New spellings: AlignCenter, AlignCentre, Center, Centre, Centered are all equivalent.
• Added image type:

    typedef struct imagedata {
      int     depth;
      int     width;
      int     height;
      int     cmapsize;
      rgb *   cmap;
      byte *  pixels;
    } * image;
  

• Added image button object:

    button  newimagebutton(image img, rect r);
    void    setbuttonimage(button b, image img);
  

• Added loading and saving of GIF images via loadimage.
• Improved cursors:

    cursor  loadcursor(char *filename);	// can now load image files
    void    createcursor(point, image);	// create from image
  

• New font functions: getwidth, getheight, getascent, getdescent
• del can now delete images as well as other objects
• Added getwidth, getheight, getrect, getdepth functions which work on images, fonts and other objects
• Internal changes:
  • New memory functions: free becomes discard, malloc becomes create
  • ~string calls del_string (str.h)
  • del_string calls discard
  • fixrect removed for controls, buttons etc.
  • Added flags and xtext fields to internal objects.
  • Updated internal.h
  • Changed LIBRARY_PRIVATE to PROTECTED
• Bug-fixes:
  • The Athena version now has a proper file selection dialog.
  • The Motif version now uses the same file selection code.
    (The old Motif file dialog always returned the wrong path).
• Produced new graphapp.h header file.

VERSION 2.2

• Added newradiogroup function.
• General bug-fixing.
• Produced new graphapp.h header file.

VERSION 2.1

• Added text editing functions for textbox, field objects.
• General bug-fixing.
• Internal changes:
  • Added LIBRARY_PRIVATE functions to optimise symbol table.
• Produced new graphapp.h header file.

VERSION 2.0

• First public release.
• Added support for multiple windows.

VERSION 1.0

• Private demonstration version.
• Just has drawing operations.