Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.8.1.37  v_page_size                                              TOS

 Name:         »Set page size«

 Opcode:       5 (Escape 37)

 Syntax:       int16_t v_page_size ( int16_t handle, int16_t page_id 
               );

 Description:  The call v_page_size enables one to set the page format 
               for an output device. The following apply:

                Parameter  Meaning

                handle     Workstation identifier
                page_id    Desired paper format:
                            0 =   Default setting
                            1 =   DIN A3
                            2 =   DIN A4
                            3 =   DIN A5
                            4 =   DIN B5
                            16 =  Letter size
                            17 =  Half size
                            18 =  Legal size
                            19 =  Double size
                            20 =  Broadsheet size

               Note: If the requested size does not exist, the default 
               setting will be used.

 Return value: The function returns the set paper format. For a return 
               value of -1 the workstation has to be closed, as 
               insufficient free memory is available.

 Availability: The function is only present of contrl[4] contains a 
               non-zero value.

 Group:        Special graphic functions

 See Also:     Binding   v_opnwk   vq_extnd