Atari ST series Technical Reference Manual page 204

Setscreen()
T h e S e t s c r e e n ( ) f u n c t i o n a l l o w s t h e p r o g r a m m e r to c h a n g e t h e p h y s i c a l
s c r e e n a d d r e s s , t h e lo g ic a l s c r e e n a d d r e s s , a n d / o r t h e d i s p l a y r e s o l u t i o n
m o d e . T h e r e a r e s o m e c o n s t r a i n t s o n t h e s e c h a n g e s , h o w e v e r . B o t h th e
p h y s i c a l a n d lo g ic a l s c r e e n a d d r e s s e s m u s t b e g i n o n a n e v e n p a g e ( 2 5 6 -
b y t e ) b o u n d a r y . C h a n g i n g t h e r e s o l u t i o n m o d e o n l y w o r k s if th e p r o g r a m
is r u n n i n g o n a c o l o r m o n i t o r , s i n c e T O S w o n ' t le t y o u s e l e c t a c o l o r m o d e
o n a m o n o c h r o m e s c r e e n , o r v i c e v e r s a . A n d o n c o l o r m o n i t o r s , r e s o l u t i o n
s w i t c h i n g w i t h S e t s c r e e n ( ) o n l y w o r k s f o r T O S p r o g r a m s , s i n c e t h e r e is n o
w a y o f te l lin g G E M t o a d j u s t to a n e w s c r e e n m o d e , o t h e r t h a n b y u s i n g
th e S e t P r e f e r e n c e s m e n u o p t i o n o f t h e D e s k t o p . N o t e t h a t w h e n y o u
c h a n g e r e s o l u t i o n m o d e s , t h e s c r e e n is c l e a r e d a n d c e r t a i n o t h e r s c r e e n p a ­
r a m e t e r s a r e r e in i tia li z e d .
C macro format
i n t r e z ;
l o n g l o g a d d r , p h y s a d d r ;
S e t s c r e e n ( l o g a d d r , p h y s a d d r , r e z ) ;
Machine language format
m o v e .l # r e s , - ( s p )
m o v e .l p h y s a d d r , - ( s p )
m o v e .l l o g a d d r , - (s p )
m o v e . w # 5 , - ( s p )
t r a p # 1 4
a d d q .l # 1 2 , s p
Inputs
r e z w o r d
p h y s a d d r
l o n g
l o g a d d r
l o n g
Results
N o n e
See also
P h y s b a s e ( ) , L o g b a s e ( ) , G e t r e z ( )
196
Setscreen
Set Screen Parameters
T h e n e w d i s p l a y r e s o l u t i o n m o d e
A n y n e g a t i v e n u m b e r m e a n s k e e p c u r ­
r e n t d i s p l a y r e s o l u t i o n
T h e n e w s t a r t i n g a d d r e s s f o r t h e p h y s i c a l
s c r e e n . A n y n e g a t i v e n u m b e r m e a n s k e e p
c u r r e n t p h y s i c a l s c r e e n ,
T h e n e w s t a r t i n g a d d r e s s f o r t h e lo g ic a l
s c r e e n . A n y n e g a t i v e n u m b e r m e a n s k e e p
c u r r e n t lo g ic a l s c r e e n .
0 = L o w r e s o l u t i o n
1 = M e d i u m r e s o l u t i o n
2 = H i g h r e s o l u t i o n
Opcode = 5