| • Oscanis | Returns OverScan's version number. |
| • Oscanpatch | Obtains patch block of OverScan. |
| • Oscanphy | Switches the Physbase emulator. |
| • Oscanscr | Switches the Setscreen calls. |
| • Oscanswitch | Switches or obtains current mode. |
| • Oscantab | Gets pointer to data structure of a screen resolution. |
| • Oscanvb | Switches the VB edge-test routine, as well as some tests in the IKBD interrupt. |
Note:
These functions are only available under OverScan; they
are not routines of the operating system.
| Name: | »Oscanis« - Return OverScan's version number. |
| Opcode: | 4200 |
| Syntax: | int16_t Oscanis( void ); |
| Description: | The function returns the (hexadecimal) version number of
OverScan. A value of 0x300 corresponds here to Version 3.0. As this function is based on an undocumented feature, it is better to make use of the OVER cookie if possible. |
| Return value: | The function (normally) returns the value 4200 when OverScan is not installed, otherwise its version number. |
| Availability: | These functions are only available under OverScan; they are not routines of the operating system. |
| Group: | OverScan XBIOS functions |
| See also: | Binding Oscanpatch Oscanphy Oscanscr Oscanswitch Oscantab Oscanvb |
| C: | int16_t Oscanis( void ); |
| Assembler: | move.w #4200,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #2,sp ; Stack korrigieren |
| Name: | »Oscanpatch« - Obtain patch block of OverScan |
| Opcode: | 4205 |
| Syntax: | OVERPATCH *Oscanpatch( void ); |
| Description: | The function returns a pointer to the patch block of OverScan. |
| Return value: | The function returns a pointer to the OverScan patch block. |
| Availability: | These functions are only available under OverScan; they are not routines of the operating system. |
| Group: | OverScan XBIOS functions |
| See also: | Binding Oscanis Oscanphy Oscanscr Oscanswitch Oscantab Oscanvb |
| C: | OVERPATCH *Oscanpatch( void ); |
| Assembler: | move.w #4205,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #2,sp ; Stack korrigieren |
| Name: | »Oscanphy« - Switch the Physbase emulator. | |||||||||||||
| Opcode: | 4202 | |||||||||||||
| Syntax: | int16_t Oscanphy( int16_t mode ); | |||||||||||||
| Description: | The function permits the switching of the Physbase emulator.
The following apply:
When the emulator is switched on, then a call of Physbase returns the value of Logbase. Before terminating the program it is imperative that the Physbase emulator is switched on again. | |||||||||||||
| Return value: | For mode -1, the function returns the current status of the emulator. | |||||||||||||
| Availability: | These functions are only available under OverScan; they are not routines of the operating system. | |||||||||||||
| Group: | OverScan XBIOS functions | |||||||||||||
| See also: | Binding Oscanis Oscanpatch Oscanscr Oscanswitch Oscantab Oscanvb |
| C: | int16_t Oscanphy( int16_t mode ); |
| Assembler: | move.w mode,-(sp) ; Offset 2 move.w #4202,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #4,sp ; Stack korrigieren |
| Name: | »Oscanscr« - Switch the Setscreen calls. | |||||||||||||
| Opcode: | 4203 | |||||||||||||
| Syntax: | int16_t Oscanscr( int16_t mode ); | |||||||||||||
| Description: | The function permits switching of the Setscreen call. The
following apply:
Normally under OverScan the relocation of the screen or a change of resolution is not possible. If one wants to relocate the screen memory with Setscreen, it is important that the offset between Logbase and Physbase is not destroyed. Important: Before terminating the program, the Setscreen call must be locked once more. | |||||||||||||
| Return value: | The function returns the current setting. | |||||||||||||
| Availability: | These functions are only available under OverScan; they are not routines of the operating system. | |||||||||||||
| Group: | OverScan XBIOS functions | |||||||||||||
| See also: | Binding Oscanis Oscanpatch Oscanphy Oscanswitch Oscantab Oscanvb |
| C: | int16_t Oscanscr( int16_t mode ); |
| Assembler: | move.w mode,-(sp) ; Offset 2 move.w #4203,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #4,sp ; Stack korrigieren |
| Name: | »Oscanswitch« -Switch or obtains current mode. | |||||||||||||
| Opcode: | 4206 | |||||||||||||
| Syntax: | int16_t Oscanswitch( int16_t mode ); | |||||||||||||
| Description: | The function switches between the normal mode and the OverScan
mode. The following apply:
The function not only switches over the hardware, but also all internal GEM variables are patched and the screen is copied over. | |||||||||||||
| Return value: | The function returns the current setting in each case. | |||||||||||||
| Availability: | These functions are only available under OverScan; they are not routines of the operating system. | |||||||||||||
| Group: | OverScan XBIOS functions | |||||||||||||
| See also: | Binding Oscanis Oscanpatch Oscanphy Oscanscr Oscantab Oscanvb |
| C: | int16_t Oscanswitch( int16_t mode ); |
| Assembler: | move.w mode,-(sp) ; Offset 2 move.w #4206,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #4,sp ; Stack korrigieren |
| Name: | »Oscantab« - Get pointer to data structure of a screen resolution. | ||||||||||||||||
| Opcode: | 4201 | ||||||||||||||||
| Syntax: | SCREEN *Oscantab( int16_t res ); | ||||||||||||||||
| Description: | The function returns a pointer to a structure for a description
of the screen. The following apply:
The data structure of the current setting is updated at each call of the function. | ||||||||||||||||
| Return value: | The function returns a pointer to the corresponding structure for the description of the screen. | ||||||||||||||||
| Availability: | These functions are only available under OverScan; they are not routines of the operating system. | ||||||||||||||||
| Group: | OverScan XBIOS functions | ||||||||||||||||
| See also: | Binding Oscanis Oscanpatch Oscanphy Oscanscr Oscanswitch Oscanvb |
| C: | SCREEN *Oscantab( int16_t res ); |
| Assembler: | move.w res,-(sp) ; Offset 2 move.w #4201,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #4,sp ; Stack korrigieren |
| Name: | »Oscanvb« - witch the VB edge-test routine, as well as some tests in the IKBD interrupt. | |||||||||||||
| Opcode: | 4204 | |||||||||||||
| Syntax: | int16_t Oscanvb( int16_t mode ); | |||||||||||||
| Description: | The function permits switching off the VB edge-test routine as
well as the test for Shift/Shift/Clear in the IKBD interrupt. The
following apply:
Though the tests require only some 1-2% CPU time, for time-critical animations and MIDI routines this could be just too much. Important: Before termination of the program it is imperative that the tests are switched on again. | |||||||||||||
| Return value: | The function returns the current setting in each case. | |||||||||||||
| Availability: | These functions are only available under OverScan; they are not routines of the operating system. | |||||||||||||
| Group: | OverScan XBIOS functions | |||||||||||||
| See also: | Binding Oscanis Oscanpatch Oscanphy Oscanscr Oscanswitch Oscantab |
| C: | int16_t Oscanvb( int16_t mode ); |
| Assembler: | move.w mode,-(sp) ; Offset 2 move.w #4204,-(sp) ; Offset 0 trap #14 ; XBIOS aufrufen addq.l #4,sp ; Stack korrigieren |