How To USE & Library Functions
Installing A.G.E.
Just copy the file "LIBS/AGE.lib"
into your own LIBS folder
I want to make it very clear that
this is NOT an AMOS extension, but more a collection
of custom procedures. These procedures act as gateways and pass control from
Amos to the custom AGE library. If you examine the procedures
yourself, you'll see the variables that need to be passed, for BETTER
results, you can set a routines values and then just CALL the function from the
library. This is not recommended for beginners, but advanced programmers
should have no problems with it.
So there is really no installing AGE into
AMOS, all you need to do it load the AGE procedures, and then start calling
them. Since this is NOT a final release of AGE, more a dump of it in it's
current state, you should expect to find routines that are not fully
implemented, or working as expected...
Procedure Listing AGE V1.01
- _OPEN_AGE_LIBRARY
-
_AGE_OPEN_RESOURCES[SCRNS,COPS,BLKDATAS,USERBANKS,FONTS,FILECACHE,DCACHE]
-
_AGE_TAKE_SYSTEM[COPADDR]
- _AGE_RESTORE_SYSTEM
- _AGE_CLOSE_RESOURCES
-
_AGE_VERTICAL_SYNC[SCANLINE]
-
_AGE_WAIT_BLITTER
-
_AGE_OWN_BLITTER
-
_AGE_DisOWN_BLITTER
-
_AGE_FORBID_TASKING
-
_AGE_PERMIT_TASKING
BLOCK MAP FUNCTIONS
-
_AGE_OPEN_BLKDATA_BANK[BLKFILENAME$,BANK,W,H,D,BLKS,BLKFORMAT]
-
_AGE_REMOVE_BLKDATA_BANK[BANK]
BANK FUNCTIONS
-
_AGE_OPEN_USERBANK[BANK,SIZE]
_AGE_REMOVE_USERBANK[BANK]
Memory Bank Control
-
_AGE_LOAD_USERBANK[FILENAME$,BANK]
-
_AGE_USERBANK_GETADR[BANK]
-
_AGE_USERBANK_GETSIZE[BANK]
FONT functions
-
_AGE_OPEN_FONT[FILENAME$,BANK]
- _AGE_REMOVE_FONT[BANK]
- _AGE_SET_FONT_PLANEMASK[BANK,MASK]
- _AGE_READ_FONT_PLANEMASK[BANK]
- _AGE_READ_FONT_HEIGHT[BANK]
- _AGE_PRINT[T$,X,Y,C,FONT]
DISPLAY Hardware
- _AGE_FLUSH_DISPLAY_HARDWARE
- _AGE_CLOSE_COPPER[NUMB]
- _AGE_OPENSTANDARD_COPPER[COP,SCRN,BURST,DISPLAYMOD]
- _AGE_OPENSTANDARD_COPPER_SPR[COP,SCRN,SPRSLIST,BURST,DISPLAYMOD]
- _AGE_SHOW_COPPER[NUMB]
- _AGE_SET_COPPER[NUMB]
- _AGE_SET_VIEWHW_REGION[XLEFT,WIDTH,YTOP,HEIGHT]
SCREENS
- _AGE_OPENSCREEN[SCRN,WIDTH,HEIGHT,DEPTH,TYPE]
-
_AGE_CLOSESCREEN[SCRN]
- _AGE_LOAD_IFF_TO_SCREEN[FILENAME$,SCRN]
-
_AGE_SAVE_IFF[FILENAME$,SCRN]
- _AGE_EXAMINE_IFF[FILENAME$]
-
_AGE_SET_SCREEN[SCRN]
- _AGE_READ_SCREEN
-
_AGE_SCREEN_SET_CLIP_REGION[X1,Y1,X2,Y2]
- _AGE_SCREEN_RESTORE_CLIP_REGION
-
_AGE_SCREEN_READ_CLIP_REGION
- _AGE_GET_BITPLANE_ADDR[SCRN,BP]
- _AGE_GET_SCREEN_WIDTH[SCRN]
-
_AGE_GET_SCREEN_HEIGHT[SCRN]
-
_AGE_GET_SCREEN_DEPTH[SCRN]
-
_AGE_GET_SCREEN_TYPE[SCRN]
-
_AGE_SCREEN_SET_PALETTE_COLOUR[SCRN,NUMB,C]
-
_AGE_SCREEN_READ_PALETTE_COLOUR[SCRN,NUMB]
-
_AGE_SCREEN_READ_PALETTE_12BITHIGH_COLOUR[SCRN,NUMB]
-
_AGE_SCREEN_READ_PALETTE_12BITLOW_COLOUR[SCRN,NUMB]
-
_AGE_SCREEN_COPY_PALETTE[SRC_SCRN,DEST_SCRN]
lower Level SCREEN reading
- _AGE_WRITEBYTE_TO_SCRN[X,Y,P,B]
- _AGE_WRITEBYTE_TO_SCRN_NOCLIP[X,Y,P,B]
- _AGE_READBYTE_FROM_SCRN[X,Y,P]
- _AGE_READBYTE_FROM_SCRN_NOCLIP[X,Y,P]
- _AGE_WRITEWORD_TO_SCRN[X,Y,P,B]
- _AGE_WRITEWORD_TO_SCRN_NOCLIP[X,Y,P,B]
-
_AGE_READWORD_FROM_SCRN[X,Y,P]
- _AGE_READWORD_FROM_SCRN_NOCLIP[X,Y,P]
- _AGE_WRITELONGWORD_TO_SCRN[X,Y,P,B]
- _AGE_WRITELONGWORD_TO_SCRN_NOCLIP[X,Y,P,B]
- _AGE_READLONGWORD_FROM_SCRN[X,Y,P]
- _AGE_READLONGWORD_FROM_SCRN_NOCLIP[X,Y,P]
- _AGE_COPYBYTES_TO_SCRN[SRCADR,X,Y,P,L]
- _AGE_COPYBYTES_TO_SCRN_NOCLIP[SRCADR,X,Y,P,L]
- _AGE_COPYWORDS_TO_SCRN[SRCADR,X,Y,P,L]
- _AGE_COPYWORDS_TO_SCRN_NOCLIP[SRCADR,X,Y,P,L]
- _AGE_READBYTES_FROM_SCRN[SRCADR,X,Y,P,L]
- _AGE_READBYTES_FROM_SCRN_NOCLIP[SRCADR,X,Y,P,L]
- _AGE_READWORDS_FROM_SCRN[SRCADR,X,Y,P,L]
- _AGE_READWORDS_FROM_SCRN_NOCLIP[SRCADR,X,Y,P,L]
Graphics Rendering
-
_AGE_PLOT_PIXEL[X,Y,P]
- _AGE_PLOT_PIXEL_NO_CLIP[X,Y,P]
- _AGE_PLOT_PIXEL_QUE[TA,P]
- _AGE_READ_PIXEL[X,Y]
- _AGE_DRAW_HORI_STRIP[X1,X2,Y,PCOL]
- _AGE_DRAW_HORI_STRIP2[X1,X2,Y,PCOL]
- _AGE_DRAW_FILLED_STRIP[X1,X2,Y]
- _AGE_DRAW_CLEARED_STRIP[X1,X2,Y]
- _AGE_DRAW_GOURAUD_STRIP[X1,X2,C1,C2,Y]
- _AGE_SCALE_STRIP[SRC,DEST,X1,X2,DX1,DX2,SY,DY]
- _AGE_TMAP_STRIP[SRC,DEST,X1,X2,SX1,SX2,SY1,SY2,DY]
- _AGE_C2P_STRIP_FROM_MEMORY[STRIPADR,X1,X2,Y]
- _AGE_P2C_STRIP_TO_MEMORY[STRIPADR,X1,X2,Y]
- _AGE_C2P_SCRN[SRC,DEST]
- _AGE_C2P_SCRN_CLS[SRC,DEST]
-
_AGE_DRAW_COLOURED_BOX[X1,X2,Y1,Y2,PCOL]
- _AGE_DRAW_FILLED_BOX[X1,X2,Y1,Y2,PLANEMASK]
- _AGE_DRAW_CLEARED_BOX[X1,X2,Y1,Y2,PLANEMASK]
- _AGE_DRAW_GOURAUD_BOX[X1,X2,Y1,Y2,C1,C2,C3,C4]
- _AGE_SCALE_BOX[SRC,DEST,X1,Y1,X2,Y2,X3,Y3,X4,Y4]
- _AGE_CLEAR_SCREEN_CPU[SCRN,BITPAT]
- _AGE_COPY_IMAGE_CPU[SCRN1,SCRN2,X1,Y1,X2,Y2,DESTX1,DESTY1]
- _AGE_SCROLLRIGHT_IMAGE_CPU[SCRN,X1,Y1,X2,Y2,SCRVAL]
- _AGE_SCROLLLEFT_IMAGE_CPU[SCRN,X1,Y1,X2,Y2,SCRVAL]
- _AGE_SCROLLUP_IMAGE_CPU[SCRN,X1,Y1,X2,Y2,SCRVAL]
- _AGE_SCROLLDOWN_IMAGE_CPU[SCRN,X1,Y1,X2,Y2,SCRVAL]
- _AGE_DRAWCIRCLE_COLOUR_BLIT[X1,Y1,RAD,C]
- _AGE_DRAWPOLY_COLOUR[X1,Y1,X2,Y2,X3,Y3,C]
- _AGE_DRAWPOLY_GOURAUD[X1,Y1,C1,X2,Y2,C2,X3,Y3,C3]
- _AGE_DRAWPOLY_TMAP[SRC,DEST,X1,Y1,U1,V1,X2,Y2,U2,V2,X3,Y3,U3,V3]
-
_AGE_DRAWLINE_COLOUR_BLIT[X1,Y1,X2,Y2,C]
-
_AGE_DRAWLINE_COLOUR_BLIT_NOCLIP[X1,Y1,X2,Y2,C]
' BOB & POB image routines
-
_AGE_DRAW_POB[SCRN,X1,Y1]
-
_AGE_DRAW_BLOCK_ARRAY_CPU[BANK,X1,Y1,X2,Y2,MAPX,MAPY]
Age3D Graphics Sub-System
- _AGE3D_OPENBUFFER[DEPTH,WIDTH,POLYS]
- _AGE3D_CLOSEBUFFER
_AGE3D_READFREQBUFFER_STATUS
- _AGE3D_ADPOLY_FILLED[X1,Y1,X2,Y2,X3,Y3,C,Z]
- _AGE3D_ADPOLY_FILLEDCIRCLE[X,Y,R,C,Z]
- _AGE3D_ADPOLY_DOT[X,Y,Z,C]
- _AGE3D_ADPOLY_BOX[X1,Y1,X2,Y2,Z,C]
- _AGE3D_RENDER_SCENE
Home | Welcome
| Credit |
Copyrights
(c) copyright 2000, Kevin Picone, Underware
Design