83Plus:BCALLs:404B - Revision history

219.83.17.14: /* Example */

2006-02-23T06:08:30Z

‎Example

AndyJ: /* Registers Destroyed */ ==> Destroys

2005-04-24T17:43:46Z

‎Registers Destroyed: ==> Destroys

Dan Englender: /* Example */ Added rest of monitor vectors

2005-04-21T18:34:26Z

‎Example: Added rest of monitor vectors

FloppusMaximus: cat: monitor

2005-04-16T06:57:26Z

cat: monitor

FloppusMaximus: /* Synopsis */ links+caps

2005-04-16T06:56:21Z

‎Synopsis: links+caps

Woozle: /* Comments */

2005-04-16T05:57:58Z

‎Comments

Woozle: /* Comments */

2005-04-16T05:57:00Z

‎Comments

Woozle: /* Example */

2005-04-16T05:56:30Z

‎Example

Woozle at 05:55, 16 April 2005

2005-04-16T05:55:24Z

New page

[[Category:83Plus:BCALLs:By Name:Utility|AppInit]] [[Category:83Plus:BCALLs:By Name|AppInit]] [[Category:83Plus:BCALLs:By Address|404B - AppInit]]
== Synopsis ==
'''Official Name:''' AppInit

'''BCALL Address:''' 404B

Sets the context vector table so an application can receive various notifications from the OS.

=== Inputs ===
* HL=address of custom vector table to copy

=== Outputs ===
* [[83Plus:RAM:858D|CxMain]] and the 6 vectors that follow
* [[83Plus:RAM:8599|CxPage]] is set to the current page of the app
* (iy+appFlags) is set to the 15th byte of the table

=== Registers Destroyed ===
* HL, A, DE

=== Comments ===
Typically this routine is called at the start of an application so that the application can receive events and react appropriately. If this routine is used, it is also important to call [[83Plus:BCALLs:4C36|ReloadAppEntryVecs]] before exiting the app. Failing to do so will likely result in a crash.
This copies 14 bytes from the address indicated in HL to [[83Plus:RAM:858D|CxMain]], an additional byte to (iy+appFlags), then stores the page number obtained from Port 6 into [[83Plus:RAM:8599|CxPage]]. When starting an app normally, the default is usually a dummy return. The OS sends key presses to this routine for proper handling.

== Example ==

ld hl,vectorTable
B_CALL appInit
;....

vectorTable:
;NOTE: you must define the following routines yourself. If you have no need for such routines, then simply point these vectors to a dummy return.
dw cxMainHandler ;usually handles keys
dw cxPPutAwayHandler ;Partial put away, this should be used to clean when exiting edit buffers
dw cxPutAwayHandler ;Put away, this should be used to clean up just before exiting an app. Usually in response to OFF or 2nd+quit.
dw cxRedispHandler ;?
dw cxErrorEPHandler ;This can be used to process errors before error handlers set up by AppOnErr
dw cxSizeWindHandler ;?
dw 0 ;value to be copied to (iy+appFlags)

@@ Line 39: / Line 39: @@
   dw cxErrorEPHandler  ;This can be used to process errors before error handlers set up by AppOnErr
   dw cxSizeWindHandler ;Window size change notification.  For example, rcl has been activated.
-  dw 0                 ;value to be copied to (iy+appFlags)
+  db 0                 ;value to be copied to (iy+appFlags)

@@ Line 15: / Line 15: @@
 * [[83Plus:Flags:0D|(iy+appFlags)]] is set to the 15th byte of the table
-=== Registers Destroyed ===
+=== Destroys ===
 * HL, A, DE

@@ Line 36: / Line 36: @@
   dw cxPutAwayHandler  ;Put away, this should be used to clean up just before exiting an app.
                        ;Usually in response to OFF or 2nd+quit.
-  dw cxRedispHandler   ;?
+  dw cxRedispHandler   ;Redisplay the application's screen.
   dw cxErrorEPHandler  ;This can be used to process errors before error handlers set up by AppOnErr
-  dw cxSizeWindHandler ;?
+  dw cxSizeWindHandler ;Window size change notification.  For example, rcl has been activated.
   dw 0                 ;value to be copied to (iy+appFlags)

@@ Line 1: / Line 1: @@
-[[Category:83Plus:BCALLs:By Name:Utility|AppInit]] [[Category:83Plus:BCALLs:By Name|AppInit]] [[Category:83Plus:BCALLs:By Address|404B - AppInit]]
+[[Category:83Plus:BCALLs:By Name:Monitor|AppInit]] [[Category:83Plus:BCALLs:By Name:Utility|AppInit]] [[Category:83Plus:BCALLs:By Name|AppInit]] [[Category:83Plus:BCALLs:By Address|404B - AppInit]]
 == Synopsis ==
 '''Official Name:''' AppInit

@@ Line 11: / Line 11: @@
 === Outputs ===
-* [[83Plus:RAM:858D|CxMain]] and the 6 vectors that follow
+* [[83Plus:RAM:858D|cxMain]] and the 6 vectors that follow
-* [[83Plus:RAM:8599|CxPage]] is set to the current page of the app
+* [[83Plus:RAM:8599|cxPage]] is set to the current page of the app
-* (iy+appFlags) is set to the 15th byte of the table
+* [[83Plus:Flags:0D|(iy+appFlags)]] is set to the 15th byte of the table
 === Registers Destroyed ===
@@ Line 21: / Line 21: @@
 Typically this routine is called at the start of an application so that the application can receive events and react appropriately.  If this routine is used, it is also important to call [[83Plus:BCALLs:4C36|ReloadAppEntryVecs]] before exiting the app.  Failing to do so will likely result in a crash.
-This copies 14 bytes from the address indicated in HL to [[83Plus:RAM:858D|CxMain]], an additional byte to (iy+appFlags), then stores the page number obtained from Port 6 into [[83Plus:RAM:8599|CxPage]].
+This copies 14 bytes from the address indicated in HL to [[83Plus:RAM:858D|cxMain]], an additional byte to [[83Plus:Flags:0D|(iy+appFlags)]], then stores the page number obtained from Port 6 into [[83Plus:RAM:8599|cxPage]].
 == Example ==