SS.PScrn_Set_Status

Converts a screen to a different type.

Entry Conditions

A
path number

B
SS.PScrn ($8E)

X
new screen type

 
0 = 640 x 192 x 2 colors (16K)

 
1 = 320 x 192 x 4 colors (16K)

 
2 = 160 x 192 x 16 colors (16K)

 
3 = 640 x 192 x 4 colors (32K)

 
4 = 320 x 192 x 16 colors (32K)

Y
screen number

Error Output

CC
carry set on error

B
error code

Additional Information

• SS.PScrn changes a screen allocated by SS.AScrn to a new screen type. You can change a 32K screen to either a 32K screen, or a 16K screen. You can change a 16K screen only to another 16K screen type. SS.PScrn updates the current display screen at the next clock interrupt.
• However, if you change a 32K screen to a 16K screen, OS-9 does not reclaim the extra 16K of memory. This means that you can later change the 16K screen back to a 32K screen.
• The support module for this call is VDGInt.