Banked functions Table at 003F : 6800 (ROM V1.004)

This table contains 390 functions. Click on a link in the discription area for more detailed information when calling a function.

Index	Bank 3F address	Function Address	Discription
0000	6800	3A:5B54	Read App Preference
0003	6803	3A:587A	Save App Preference
0006	6806	3A:5C7F	Delete App Preference
0009	6809	3A:74E3	Get program ID
000C	680C	2F:4270	Memory error message box
000F	680F	28:4000	Get system format
0012	6812	2F:5845	-
0015	6815	3B:50BF
0018	6818	25:5520
001B	681B	3D:53FE
001E	681E	3D:4EF2
0021	6821	3D:41A8
0024	6824	3D:560D
0027	6827	3D:57F6	'Warning language data missed' message box
002A	682A	3D:57CE	Enter Synchronizing Mode (same as wake-up)
002D	682D	3D:504F
0030	6830	1E:6EE6	Rotate resource
0033	6833	29:7049
0036	6836	3D:58A5	sqrt
0039	6839	3D:5D39
003C	683C	3D:5AC9	atod
003F	683F	29:7654	Get Avigo Version
0042	6842	29:76C2
0045	6845	08:4000	Avigo diagnostic Menu
0048	6848	32:66C5
004B	684B	32:6712
004E	684E	32:675A
0051	6851	32:67DA
0054	6854	32:6867
0057	6857	32:68E3
005A	685A	32:6956
005D	685D	32:69B4
0060	6860	32:6A8D
0063	6863	32:6F85
0066	6866	32:7252
0069	6869	32:7301
006C	686C	32:73C8
006F	686F	32:776A
0072	6872	32:77D5
0075	6875	32:788B
0078	6878	2D:7362
007B	687B	2D:7392
007E	687E	2D:73BE
0081	6881	32:7911
0084	6884	32:797D
0087	6887	2A:5E8F
008A	688A	32:7A44
008D	688D	02:6F2B	'Error 1002: upgrade canceled' message box
0090	6890	1E:4000	Set State (view)
0093	6893	1E:4067	Draw (view)
0096	6896	1E:4074	Handle Event (view)
0099	6899	1E:41A2	Set group state
009C	689C	1E:4228	Draw group
009F	689F	1E:42D8	Handle group event
00A2	68A2	1E:4414	Execute group
00A5	68A5	1E:458D	Redraw group
00A8	68A8	1E:45D9	Preview group
00AB	68AB	1E:4670	Set current group
00AE	68AE	1E:47B0	Insert group
00B1	68B1	1E:5603	Draw deskbox (see also 6941 )
00B4	68B4	1E:5A0F	Handle deskbox event
00B7	68B7	1E:56EA	Draw deskbox title
00BA	68BA	1E:65C2	Redraw deskbox
00BD	68BD	1D:4507	Draw button
00C0	68C0	1D:45CB	Handle button event
00C3	68C3	1D:42DC	Draw button status
00C6	68C6	1F:4000	Draw page arrow
00C9	68C9	1F:4273	Handle page arrow event
00CC	68CC	1F:496E
00CF	68CF	1F:50E4
00D2	68D2	1B:66A4	Draw Lister
00D5	68D5	1B:6AC3	Handle Lister event
00D8	68D8	1B:6F06	Write Lister item
00DB	68DB	1B:6F27	Lister Pen Down Act
00DE	68DE	19:58C6
00E1	68E1	19:5CB1
00E4	68E4	19:6836
00E7	68E7	19:6940
00EA	68EA	1F:5CAE	Draw Menufield
00ED	68ED	1F:5E68	Handle Menufield event
00F0	68F0	1F:63AC	Set numberset State
00F3	68F3	1F:6419	Draw Numberset
00F6	68F6	1F:66D2	Draw Numberset number
00F9	68F9	1F:67CA
00FC	68FC	1F:698A	Handle numberset event
00FF	68FF	1F:70E8	Draw stacked list
0102	6902	1F:73BD	Handle stacked list event
0105	6905	1F:73B0	Draw stacked list example
0108	6908	18:52F7	Set Squarefield state
010B	690B	18:5404
010E	690E	18:54BB
0111	6911	18:56CA
0114	6914	18:5C9D
0117	6917	18:5D5D
011A	691A	18:5EAB
011D	691D	18:6475	Draw Boolfield (Checkbox)
0120	6920	18:658E	Handle Boolfield event (checkbox)
0123	6923	18:6C67	Draw date field
0126	6926	18:6D35	Handle date field event
0129	6929	18:68AF	Draw timefield
012C	692C	18:697D	Handle timefield event
012F	692F	18:705B	Draw starttime-endtimefield
0132	6932	18:716C	Handle starttime-endtimefield event
0135	6935	18:741E	Draw Numberfield
0138	6938	18:7624	Handle Numberfield event
013B	693B	1E:6666	Create deskbox
013E	693E	1E:69F1	Change Command Menu
0141	6941	1E:498C	Draw Deskbox (direct)
0144	6944	1D:4B29	Create button
0147	6947	1D:4E0B	Change button
014A	694A	1D:4F5A	Insert button
014D	694D	1D:4000	Draw Button direct
0150	6950	1F:470C	Create Page arrow
0153	6953	1F:48AC	Insert (page arrow)
0156	6956	1F:55B5	Create Control Menu
0159	6959	1B:6F48	Create Lister
015C	695C	19:6D6A
015F	695F	1F:6229	Create Menufield
0162	6962	1F:6E57	Create NumberSet
0165	6965	1F:7629	Create Stacked List
0168	6968	18:5AE8
016B	696B	18:628F
016E	696E	18:6E55	Create datefield
0171	6971	18:6A9D	Create timefield
0174	6974	18:6732	Create boolfield (Checkbox)
0177	6977	18:7724	Create Numberfield
017A	697A	18:538E	Draw field box
017D	697D	1E:6AF1	Destroy resource block(same as free resource 01F2)
0180	6980	1E:6B0A	Execute View
0183	6983	1E:6C5C	Delete resource
0186	6986	1E:6D89	Send Message
0189	6989	1E:6E3A	Disable menu command
018C	698C	1E:6E90	Enable menu command
018F	698F	1A:448B	Message box
0192	6992	31:5A1F
0195	6995	31:5AB3
0198	6998	31:5377	Numberfield picker
019B	699B	31:4000
019E	699E	31:4038
01A1	69A1	32:4393
01A4	69A4	32:6230
01A7	69A7	32:413D
01AA	69AA	32:42A0
01AD	69AD	1C:635F
01B0	69B0	1C:5FB3
01B3	69B3	1C:4000	Get Weekday
01B6	69B6	1C:414C
01B9	69B9	1C:4541
01BC	69BC	1C:46A6	Write Date
01BF	69BF	1C:46E3	Write Time
01C2	69C2	1C:43E7
01C5	69C5	1C:49ED
01C8	69C8	1C:4A43
01CB	69CB	1C:4EA7	Add Date
01CE	69CE	1C:5245
01D1	69D1	1C:55B8	Get Date difference
01D4	69D4	1C:57F9	Get Day (of the month)
01D7	69D7	1C:5C19
01DA	69DA	1C:5C6E
01DD	69DD	1C:6F72
01E0	69E0	1C:7058	Press at Range
01E3	69E3	1C:7099	Press at button
01E6	69E6	1C:71CA	Press at button invert
01E9	69E9	1C:7385
01EC	69EC	1A:4000
01EF	69EF	1C:756C	Allocate block
01F2	69F2	1C:7721	Free resource block
01F5	69F5	1C:7800	*Get resource ID list
01F8	69F8	18:4000	Get event
01FB	69FB	18:42DA	Put event
01FE	69FE	18:42FE	Test put event
0201	6A01	18:434D	Clear event
0204	6A04	18:42BD	Set event mask
0207	6A07	18:42D3	Get event mask
020A	6A0A	18:436E
020D	6A0D	18:43C1
0210	6A10	18:43C8
0213	6A13	18:4406
0216	6A16	18:46BC
0219	6A19	18:4705
021C	6A1C	3A:404F
021F	6A1F	3A:4000
0222	6A22	3A:40AF
0225	6A25	3A:4145
0228	6A28	3A:4224
022B	6A2B	3A:471C
022E	6A2E	3A:4780
0231	6A31	3A:4D15
0234	6A34	3A:4E72	Load Index Table
0237	6A37	3A:52F9	Save Index Table
023A	6A3A	3A:5604	Get Record Quantity
023D	6A3D	3A:5844	Get Record Size
0240	6A40	3D:6D50
0243	6A43	3A:5D72	Read Record
0246	6A46	3A:5DF5	Insert Record
0249	6A49	3A:6160	Create Record
024C	6A4C	3A:64A8	Delete Record
024F	6A4F	3A:64E7	Modify Record
0252	6A52	3A:6669	Change Record
0255	6A55	3A:676E
0258	6A58	3A:6AFB	Get password
025B	6A5B	3A:6B80	Set password
025E	6A5E	3A:6C05
0261	6A61	3A:6C46
0264	6A64	3A:7666
0267	6A67	3A:76C1
026A	6A6A	3A:77A8
026D	6A6D	3A:7861
0270	6A70	3A:6CC4
0273	6A73	3A:6D37
0276	6A76	3A:6DEC
0279	6A79	3A:6E6A
027C	6A7C	3A:6F3B
027F	6A7F	3A:711F
0282	6A82	3A:71CD
0285	6A85	3A:7248
0288	6A88	3A:7392
028B	6A8B	3A:73DB
028E	6A8E	3A:7420
0291	6A91	3A:7495
0294	6A94	3A:755C
0297	6A97	3A:75B0
029A	6A9A	3A:7605
029D	6A9D	3C:5BC4
02A0	6AA0	3C:66D5
02A3	6AA3	3C:6709
02A6	6AA6	3C:67AD
02A9	6AA9	3C:6548
02AC	6AAC	3B:4000
02AF	6AAF	3B:43BE
02B2	6AB2	3B:447A
02B5	6AB5	3B:46E7
02B8	6AB8	3B:4714
02BB	6ABB	3B:473C	Read List Name
02BE	6ABE	3B:483D	Read List Info
02C1	6AC1	3B:48FE	Save List Info
02C4	6AC4	3B:493D
02C7	6AC7	3B:4A7D
02CA	6ACA	3B:49DE
02CD	6ACD	3B:4AB3
02D0	6AD0	3B:4B63	Read Category Info
02D3	6AD3	3B:4C1F	Save Category Info
02D6	6AD6	3B:4C5E
02D9	6AD9	3B:4CFF
02DC	6ADC	3B:4D24
02DF	6ADF	3B:4D47	Read Field Item
02E2	6AE2	3B:4F8E
02E5	6AE5	3B:4DC0	Read Field Info
02E8	6AE8	3B:501F	Save Field Info
02EB	6AEB	3B:5099
02EE	6AEE	3B:5102
02F1	6AF1	3B:51FB	Get Record Status
02F4	6AF4	3B:525F
02F7	6AF7	3B:52A7
02FA	6AFA	3B:541A
02FD	6AFD	3B:55A1
0300	6B00	3B:5753
0303	6B03	3C:4000
0306	6B06	3C:4040
0309	6B09	3C:4086
030C	6B0C	3C:408D
030F	6B0F	3C:4240
0312	6B12	3C:5217
0315	6B15	3C:5814
0318	6B18	0F:48F1	Convert Numeric to String
031B	6B1B	0F:4D6E	Convert String to Numeric
031E	6B1E	0F:4D92
0321	6B21	3B:6378
0324	6B24	3B:6656
0327	6B27	0F:59AD
032A	6B2A	19:6FD9
032D	6B2D	19:6FE6
0330	6B30	19:6FF9
0333	6B33	19:7179
0336	6B36	1A:4295
0339	6B39	1A:43C0
033C	6B3C	1F:58B3
033F	6B3F	19:704D
0342	6B42	1E:6AB5	Clear datefield date
0345	6B45	1E:6AD3	Clear timefield time
0348	6B48	19:7A23
034B	6B4B	1B:49DD
034E	6B4E	1B:54A4
0351	6B51	32:43B1
0354	6B54	32:4D21
0357	6B57	1C:4312
035A	6B5A	1C:4750
035D	6B5D	1C:58B2
0360	6B60	1C:5B65
0363	6B63	19:4000
0366	6B66	19:4052
0369	6B69	19:464C	Get Data Size
036C	6B6C	19:4733
036F	6B6F	19:4C0C
0372	6B72	19:538B
0375	6B75	19:5535
0378	6B78	19:7564
037B	6B7B	19:7700
037E	6B7E	1E:6F41
0381	6B81	2F:42C7
0384	6B84	3D:44F0
0387	6B87	3A:47DE
038A	6B8A	3A:4AC1
038D	6B8D	3A:4CD1	Allocate PIM Record Space
0390	6B90	3A:5A56	Get App Preference Length
0393	6B93	3D:6D14
0396	6B96	3A:6197
0399	6B99	3C:64CF
039C	6B9C	3A:78D6
039F	6B9F	3B:4618
03A2	6BA2	3B:49A1
03A5	6BA5	3B:4E6C
03A8	6BA8	17:4000	Create textfield
03AB	6BAB	17:41BD
03AE	6BAE	17:4329	Draw Textfield
03B1	6BB1	17:4869	Handle Textfield event
03B4	6BB4	17:505B
03B7	6BB7	17:566C
03BA	6BBA	17:4BD5
03BD	6BBD	17:4E21
03C0	6BC0	17:4F03
03C3	6BC3	1B:6154
03C6	6BC6	1B:627E
03C9	6BC9	1B:52AD
03CC	6BCC	1B:56B5
03CF	6BCF	0B:5B34
03D2	6BD2	1B:645C
03D5	6BD5	18:7263	Create starttime-endtimefield
03D8	6BD8	1B:4000
03DB	6BDB	17:5CB8
03DE	6BDE	17:5D67
03E1	6BE1	17:69EF
03E4	6BE4	17:59EB
03E7	6BE7	16:4204
03EA	6BEA	16:437E
03ED	6BED	16:5D91
03F0	6BF0	16:40C3
03F3	6BF3	17:7181
03F6	6BF6	16:4000
03F9	6BF9	16:749A
03FC	6BFC	16:7888
03FF	6BFF	16:5E50
0402	6C02	16:4D6E
0405	6C05	16:458A
0408	6C08	16:5A73
040B	6C0B	16:5BC7
040E	6C0E	16:70DB
0411	6C11	16:6980
0414	6C14	16:6CE8
0417	6C17	16:60F7
041A	6C1A	16:5113
041D	6C1D	17:7AB2
0420	6C20	16:58E3
0423	6C23	16:589C
0426	6C26	16:5271
0429	6C29	16:7C13
042C	6C2C	1A:67EA
042F	6C2F	1A:6922
0432	6C32	1A:712F
0435	6C35	1A:7323
0438	6C38	1A:6F25
043B	6C3B	1A:6CC5
043E	6C3E	1A:74A0
0441	6C41	1A:4D09
0444	6C44	1A:60CF
0447	6C47	1A:572D
044A	6C4A	0F:75B1
044D	6C4D	0F:5E1A
0450	6C50	0F:63AA
0453	6C53	0F:6439
0456	6C56	0F:709C
0459	6C59	0F:72A6
045C	6C5C	0F:78ED
045F	6C5F	10:4391
0462	6C62	10:45C7
0465	6C65	10:45D9
0468	6C68	10:4935
046B	6C6B	10:4F9B
046E	6C6E	10:50FC
0471	6C71	10:5495
0474	6C74	0E:7860
0477	6C77	0E:72E6
047A	6C7A	0E:75CA
047D	6C7D	0E:40A1
0480	6C80	26:66BC	Get system data address
0483	6C83	01:61DE
0486	6C86	3A:5660	Is Over Filled
0489	6C89	3A:56F0
048C	6C8C	3A:5757	Is Alive Record
048F	6C8F	3A:57A7	Get Full Record Quantity
			Following functions are obselete for ROM versions v1.00 and v1.004 Using these function will cause Avigo to reset.
0492	6C92	0:0	Read table name
0495	6C95	0:0	Save table name
0498	6C98	0:0	Get private state
049B	6C9B	0:0	Set private state
049E	6C9E	0:0	Get table count
04A1	6CA1	0:0	Read Field info
04A4	6CA4	0:0	Save field info
04A7	6CA7	0:0	Get Free Table ID

Calling banked functions.

There are two possible methods to call a banked function.

CALL $3000 ;Call by absolute table address
CALL $3003 ;Call indexed table address

For a CALL $3000. The BC register must hold the absolute address of the banked function table entry.
When a CALL $3003 is used. The BC register holds the index offset to the banked function entry.

Example:

LD	BC,$018F	;Draw message box
CALL	$3003		;function by index

Is the same as:

LD	BC,$698F	;Draw message box
CALL	$3000		;function by index

0009 Get program ID

Get ID number for application at bank HL. This ID number is required for preference functions. On return of this function the A register holds the ID number.

Remark:
It is possible for a application to have multiple IDs if that application greater than 16K. For each 16K bank you can claim a ID (Usefull if 256 bytes for preferences is not enough).

Example:

	CALL	$000F		;Get ROM bank (Expecting this code in ROM)
	LD	BC,$0009
	CALL	$3003
	LD	H,0		;HL=A (most functions requiring the ID expect it in HL)
	LD	L,A
	LD	(PROG_ID),HL	;store ID

0390 Get preference length

Get preference lenght of application with ID HL. Returns with preference lenght in HL register.
A zero lenght indicates that there are no preferences for that application.

Example:

	LD	HL,(PROG_ID)	;Program ID
	LD	BC,$0390	;Get prefs lenght
	CALL	$3003
	LD	A,H
	OR	L
	JP	Z,NO_PREFS	;HL=Lenght, HL=0 No Prefs

0003 Save preference

Save prefereces of application with ID HL. DE register points to the preferences to be saved and (SP+2) = lenght.
On return HL = $FFFF if an error occured or HL = 0 for no error.

NOTE:
DE must point somewhere in RAM (above $7FFF). If just one byte of the preferences is changed. All preferences must be resaved.

Example:

	LD	HL,LENGHT	;Max lenght = 256
	LD	DE,$8000	;location of the new preferences
	PUSH	HL
	LD	HL,(PROG_ID)	;Program ID
	LD	BC,$0003	;Save preferences
	CALL	$3003
	POP	BC
	LD	A,H		;test for error
	OR	L
	JP	NZ,ERROR

0000 Read preference

Read preferences of application with ID HL. (SP+4) = Length and (SP+2) = RAM address to copy to. DE is offset to first preference byte to copy.
On return HL = $FFFF if a error occured or HL=0 for no error.

NOTE:
Normaly DE = 0 and lenght = length of preferences.
It is also possible to read the preferences partially. Reading the 10th byte. Requires DE = 10 and length = 1.

Example:

	LD	HL,LENGHT	;Preference length or bytes to read
	PUSH	HL
	LD	HL,$8000	;RAM address to copy prefs to.
	PUSH	HL
	LD	DE,0		;copy from 1st pref byte
	LD	HL,(PROG_ID)	;application ID
	LD	BC,$0000	;Read preferences
	CALL	$3003
	POP	BC
	POP	BC
	LD	A,H		;HL=FFFF ERROR
	OR	L		;HL=0  OK
	JP	NZ,ERROR

0006 Delete preference

Delete preferences for application with ID HL.
On return HL = $FFFF if a error occured or HL=0 for no error.

Example:

	LD	HL,(PROG_ID)	;Program ID
	LD	BC,$0006		;Delete Preferences
	CALL	$3003
	LD	A,H		;HL=FFFF ERROR
	OR	L		;HL=0  OK
	JP	NZ,ERROR

Get and Set private state.

These functions are no longer supported for ROMs V1.00 and higher. To Get and set the private state the system variable holding the private state must be accessed directly.
System variable at $F153 is the private state. A direct read or write to this system variable gets or sets the private state.
Valid values : 0 = HIDE PRIVATE, 1 = SHOW PRIVATE

Example:

XOR	A		;A = 0
LD	($F153),A	;Set private state to hide private

0258 Get password

When calling this function HL must point to a 9 byte space to which the password is copied.

025B Set password

When calling this function HL must point to the 9 byte string (in RAM) of the new password. Note that the password can be max 8 characters in length followed with a 0 byte as a terminator.
Valid characters are SPACE,'0'-'9','A'-'Z'(No lowercase!) and the symbols '.',',','-','/'

01EF Allocate block

Allocates a block in resource memory for a object (buttons,deskbox, etc.). On entry E reg is ID number, HL = required size for object (SP+2) Allocation method. On exit HL = 0 if block couldn't be created or HL points to the created block.
Note. Create Button, deskbox etc. call this function. It is not required to call this function if you create a deskbox or so.

Example (as used by create deskbox):

LD		L,1			;=1: create new entry, =0: recycle deleted entry
PUSH	HL
LD		E,'D'		;Deskbox ID
LD		HL,$42		;Size of deskbox object
LD		BC,$01EF	;Allocate Resource
CALL	$3003
POP     BC
LD		A,H			;Test for error
OR		L
JP		Z,out_of_memory