Changes to bank

In earlier Starbase releases, when using a CRX graphics device without X Windows, or using a depth 8 window on a CRX/GRX, CRX-24, or CRX-24Z graphics device, double-buffering could be implemented with either double_buffer() or bank_switch().

Beginning with the HP-UX 9.05 release, bank_switch() no longer sets the graphics bank used for output primitives. This results in the following changes:

Applications that use bank_switch() in depth 8 windows to do double-buffering will encounter a problem when moving from earlier versions of Starbase to subsequent releases. Modify these applications to use double_buffer() and dbuffer_switch().
A bank_switch() call is only used to specify a bank of planes used in raster operations:
- the destination bank for block_write()
- the source bank for block_read()
- the source/destination bank for block_move()
- the definition bank for define_raster_echo().
The dbank parameter of bank_switch() will be ignored.
The wbank parameter of bank_switch() will function as described below.

Specifying wbank

On 8-plane devices, the wbank parameter of bank_switch() selects a hardware bank that is dependent on the use of Starbase double-buffering. This is shown in Table 1-6 “wbank Selection on 8-Plane Devices ”.

Table 1-6 wbank Selection on 8-Plane Devices

Device Type	Depth of Window	Value of wbank	wbank parameter selects this hardware bank
Device Type	Depth of Window	Value of wbank	if write buffer ^[1] is 0	if write buffer ^[1]
Integrated Graphics ^[2] , Internal Color ^[3], CRX, GRX, Dual CRX, CRX-24, CRX-24Z, CRX-48Z, HCRX-8, HCRX-8Z, HCRX-24, HCRX-24Z	8	0	0	1
	8	1	1	0
^[1]This is the value of the buffer parameter in the most recent call to `dbuffer_switch()`. ^[2]Integrated graphics devices with 8-plane VM (virtual memory) double-buffering (e.g., HP 710) and Internal Color graphics devices with VM double-buffering enabled (e.g., HP 715/64). ^[3]Integrated graphics devices with 8-plane VM (virtual memory) double-buffering (e.g., HP 710) and Internal Color graphics devices with VM double-buffering enabled (e.g., HP 715/64).

On 24-plane devices, the wbank parameter of bank_switch() selects a hardware bank independent of the use of Starbase double-buffering. This is shown in Table 1-7 “wbank Selection on 24-Plane Devices ”.

Table 1-7 wbank Selection on 24-Plane Devices

Device Type

Depth of Window

Value of wbank

wbank parameter selects this hardware bank

CRX-24, CRX-24Z, HCRX-24, HCRX-24Z

12 or 24

On devices with 48 planes, the wbank parameter of bank_switch() selects a hardware bank that is dependent on the use of Starbase double-buffering. This is shown in Table 1-8 “wbank Selection on Devices with 48 Planes”.

Table 1-8 wbank Selection on Devices with 48 Planes

Device Type	Depth of Window	Value of wbank	wbank parameter selects this hardware bank
Device Type	Depth of Window	Value of wbank	if write buffer ^[1] is 0	if write buffer ^[1]
CRX-48Z	24	0	0	3
		1	1	4
		2	2	5
		3	3	0
		4	4	1
		5	5	2
^[1]This is the value of the buffer parameter in the most recent call to `dbuffer_switch()`.

Changes to bank_switch()

Technical documentation

» Table of Contents

» Index

Specifying wbank