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.25  v_copies                                                 TOS

 Name:         »Set number of copies« - Set number of copies of page 
               to be printed.

 Opcode:       5 (Escape 28)

 Syntax:       int16_t v_copies ( int16_t handle, int16_t count );

 Description:  The call v_copies determines the number of copies of 
               the page to be printed. The following apply:

                Parameter  Meaning

                handle     Workstation identifier
                count      Number of copies (1 = normal), or -1 to 
                           obtain the number of copies set

               Note: All pages up to the closing or the output device 
               will be printed in the specified quantity.

 Return value: The function returns the number of copies set.

 Availability: GEM/3 Release 3.1, and otherwise only if contrl[4] 
               contains a non-zero value.

 Group:        Special graphic functions

 See Also:     Binding   v_orient   v_tray