Geneva Programming Documentation


© Dan Wilga of Gribnif Software   Copyright © 1997, Gribnif Software. All Rights Reserved.

Why am I here?

A long time ago, in a galaxy far, far away John Whalley and I exchanged e-mails. He was having doubts about putting up on his site the Magic German programming documentation so it could be translated into english. I told him I thought it was a great idea, and to push on. With encouragement from others also, he did so, and the Magic docs were translated from german to english.
That got me thinking. English writing programmers could now write programs for Magic, but German writing programmers had no such aid if they wanted to write programs for that other great multitasking system, Geneva.
Let it be known that I am not ignoring MiNT by any means! But it seems to have no problem with english/german documentation

I have been using Geneva almost since its inception, and find it to be a most stable and easily configurable multitasking system. I thought that if the documentation was available in german, then German programmers may like to write, or adapt already written programs, to run under Geneva.
I discussed this with Dan Wilga, the U.S.programmer of Geneva among other great programs. see Gribnif Software. and he agreed to having this programming documentation put on the web so that those multi-talented, wonderful people who are capable of translating from English to German and vice-versa would have an opportunity to exercise their gifts, and help out the worldwide Atari community at the same time!!

So here it is folks, the
English to German Geneva programming documentation Project!
Perhaps someone actually living in Geneva could help! :-)

Download docs in RTF format, ASCII format, Atari Works(STW) format, or HTML formator PAPyrus8 format

Have something translated? Mail me! ASCII is OK.


Table of Contents

  1. Proramming with Geneva
    1. Detecting Geneva
    2. Detecting Multitasking mode
    3. New Features
      1. Object Trees
        1. New Object Types
        2. New ob_state Attributes
        3. Round buttons
        4. Keyboard equivalents
    4. Changes to Existing Functions
      1. appl_search()
        1. New Modes
      2. appl_write()
      3. evnt_multi(), evnt_messag()
      4. form_alert()
      5. form_dial()
      6. form_error()
      7. graf_mouse()
      8. graf_slidebox()
      9. rsrc_load()
      10. shel_write()
      11. wind_get(), wind_set()
    5. New Data Types
    6. New Functions
      1. ay_return=appl_yield(void)
      2. xaf_return=x+appl_flags(int getset, int index, APPFLAGS *flags)
      3. xpf_return = x_appl_font( int getset, int zero, XFONTINFO *info )
      4. xas_return = x_appl_sleep( int id, int sleep )
      5. xat_return = x_appl_term( int apid, int retrn, int set_me )
      6. xfc_return = x_form_center( OBJECT *tree, int *cx, int *cy, int *cw, int *ch )
      7. xfe_return = x_form_error( char *fmt, int errnum )
      8. xff_return = x_form_filename( OBJECT *tree, int obj, int to_from, char *string )
      9. xfm_return = x_form_mouse( OBJECT *tree, int mouse_x, int mouse_y, int clicks, int *edit_obj, int *next_obj, int *edit_idx )
      10. xfs_return = x_fsel_input( char *inpath, int pathlen, char *files, int sels, int *exbutton, char *label )
      11. xgb_return = x_graf_blit( GRECT *source, GRECT *dest )
      12. xgr_return = x_graf_rubberbox(GRECT *area, GRECT *outer, int minwidth, int minheight, int maxwidth, int maxheight, int snap, int lag )
      13. xoe_return = x_objc_edit( OBJECT *tree, int edit_obj, int key_press, int shift_state, int *edit_idx, int mode )
      14. xwd_return = x_wdial_draw( int handle, int start, int depth )
      15. xwc_return = x_wdial_change( int handle, int object, int newstate )
      16. xwcr_return = x_wind_create( int kind, int xkind, int wx, int wy, int ww, int wh )
      17. xwca_return = x_wind_calc( int type, int kind, int xkind, int inx, int iny, int inw, int inh, int *outx, int *outy, int *outw, int *outh )
      18. xwt_return = x_wind_tree( int mode, WIND_TREE *wtree )
        1. Mode 0, X_WT_GETCNT (get count & flags)
        2. Mode 1, X_WT_READ (Read the current tree into the program's memory)
        3. Mode 2, X_WT_SET (Set count, flags, and tree address)
      19. xs_return = x_settings„¤int getset, int length, SETTINGS *user )
        1. "getset" mode:
      20. xsg_return = x_shel_get( int mode, int length, char *buf )
      21. xsp_return = x_shel_put( int mode, char *buf )
      22. void x_sprintf( char *buf, char *fmt, ... )
      23. void x_sscanf( char *buf, char *fmt, ... )
      24. xhe_return = x_help( char *topic, char *helpfile, int sensitive )
    7. The GENEVA.CNF File
    8. Miscellaneous Programming Information

      Geneva documentation from Programming Read.me file
      Make Help file
      Geneva Read.me file
      Programming documentation from Geneva Read.me file

    This page last updated: 09-Nov-2002