]> git.saurik.com Git - wxWidgets.git/blob - wxPython/src/gdi.i
Added xh_frame.obj to the list of target objects
[wxWidgets.git] / wxPython / src / gdi.i
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: gdi.i
3 // Purpose: SWIG interface file for wxDC, wxBrush, wxPen, wxFont, etc.
4 //
5 // Author: Robin Dunn
6 //
7 // Created: 7/7/97
8 // RCS-ID: $Id$
9 // Copyright: (c) 1998 by Total Control Software
10 // Licence: wxWindows license
11 /////////////////////////////////////////////////////////////////////////////
12
13
14 %module gdi
15
16 %{
17 #include "helpers.h"
18 #include <wx/metafile.h>
19 #include <wx/imaglist.h>
20 #ifndef __WXMSW__
21 #include <wx/dcps.h>
22 #endif
23 %}
24
25 //----------------------------------------------------------------------
26
27 %include typemaps.i
28 %include my_typemaps.i
29
30 // Import some definitions of other classes, etc.
31 %import _defs.i
32 %import misc.i
33
34
35 %{
36 static wxString wxPyEmptyStr("");
37 %}
38
39 //---------------------------------------------------------------------------
40
41 // class wxGDIImage {
42 // public:
43 // long GetHandle();
44 // void SetHandle(long handle);
45 // bool Ok();
46 // int GetWidth();
47 // int GetHeight();
48 // int GetDepth();
49 // void SetWidth(int w);
50 // void SetHeight(int h);
51 // void SetDepth(int d);
52 // void SetSize(const wxSize& size);
53 // };
54
55 //---------------------------------------------------------------------------
56
57 class wxBitmap
58 //: public wxGDIImage
59 {
60 public:
61 wxBitmap(const wxString& name, long type);
62 ~wxBitmap();
63
64 wxPalette* GetPalette();
65 wxMask* GetMask();
66 bool LoadFile(const wxString& name, long flags);
67 bool SaveFile(const wxString& name, int type, wxPalette* palette = NULL);
68 void SetMask(wxMask* mask);
69 #ifdef __WXMSW__
70 void SetPalette(wxPalette& palette);
71 #endif
72
73 // wxGDIImage methods
74 #ifdef __WXMSW__
75 long GetHandle();
76 void SetHandle(long handle);
77 #endif
78 bool Ok();
79 int GetWidth();
80 int GetHeight();
81 int GetDepth();
82 void SetWidth(int w);
83 void SetHeight(int h);
84 void SetDepth(int d);
85 #ifdef __WXMSW__
86 void SetSize(const wxSize& size);
87 #endif
88
89 wxBitmap GetSubBitmap( const wxRect& rect );
90 #ifdef __WXMSW__
91 bool CopyFromIcon(const wxIcon& icon);
92 bool CopyFromCursor(const wxCursor& cursor);
93 int GetQuality();
94 void SetQuality(int q);
95 #endif
96
97 %pragma(python) addtoclass = "
98 def __del__(self,gdic=gdic):
99 try:
100 if self.thisown == 1 :
101 gdic.delete_wxBitmap(self)
102 except:
103 pass
104 "
105 };
106
107
108 %new wxBitmap* wxEmptyBitmap(int width, int height, int depth=-1);
109
110 #ifdef __WXMSW__
111 %new wxBitmap* wxBitmapFromData(PyObject* data, long type,
112 int width, int height, int depth = 1);
113 #endif
114
115 %{ // Alternate 'constructor'
116 wxBitmap* wxEmptyBitmap(int width, int height, int depth=-1) {
117 return new wxBitmap(width, height, depth);
118 }
119
120 #ifdef __WXMSW__
121 wxBitmap* wxBitmapFromData(PyObject* data, long type,
122 int width, int height, int depth = 1) {
123 if (! PyString_Check(data)) {
124 PyErr_SetString(PyExc_TypeError, "Expected string object");
125 return NULL;
126 }
127
128 return new wxBitmap((void*)PyString_AsString(data), type, width, height, depth);
129 }
130 #endif
131 %}
132
133 //---------------------------------------------------------------------------
134
135 class wxMask {
136 public:
137 wxMask(const wxBitmap& bitmap);
138 //~wxMask();
139 };
140
141 %new wxMask* wxMaskColour(const wxBitmap& bitmap, const wxColour& colour);
142 %{
143 wxMask* wxMaskColour(const wxBitmap& bitmap, const wxColour& colour) {
144 return new wxMask(bitmap, colour);
145 }
146 %}
147
148
149 //---------------------------------------------------------------------------
150
151
152 class wxIcon
153 //: public wxGDIImage
154 {
155 public:
156 wxIcon(const wxString& name, long flags,
157 int desiredWidth = -1, int desiredHeight = -1);
158 ~wxIcon();
159
160 bool LoadFile(const wxString& name, long flags);
161
162 // wxGDIImage methods
163 #ifdef __WXMSW__
164 long GetHandle();
165 void SetHandle(long handle);
166 #endif
167 bool Ok();
168 int GetWidth();
169 int GetHeight();
170 int GetDepth();
171 void SetWidth(int w);
172 void SetHeight(int h);
173 void SetDepth(int d);
174 #ifdef __WXMSW__
175 void SetSize(const wxSize& size);
176 #endif
177 %pragma(python) addtoclass = "
178 def __del__(self,gdic=gdic):
179 try:
180 if self.thisown == 1 :
181 gdic.delete_wxIcon(self)
182 except:
183 pass
184 "
185
186 };
187
188
189 //---------------------------------------------------------------------------
190
191 class wxCursor
192 //: public wxGDIImage
193 {
194 public:
195 #ifdef __WXMSW__
196 wxCursor(const wxString& cursorName, long flags, int hotSpotX=0, int hotSpotY=0);
197 #endif
198 ~wxCursor();
199
200 // wxGDIImage methods
201 #ifdef __WXMSW__
202 long GetHandle();
203 void SetHandle(long handle);
204 #endif
205 bool Ok();
206 #ifdef __WXMSW__
207 int GetWidth();
208 int GetHeight();
209 int GetDepth();
210 void SetWidth(int w);
211 void SetHeight(int h);
212 void SetDepth(int d);
213 void SetSize(const wxSize& size);
214 #endif
215 };
216
217 %name(wxStockCursor) %new wxCursor* wxPyStockCursor(int id);
218 %{ // Alternate 'constructor'
219 wxCursor* wxPyStockCursor(int id) {
220 return new wxCursor(id);
221 }
222 %}
223
224 //----------------------------------------------------------------------
225
226
227 enum wxFontEncoding
228 {
229 wxFONTENCODING_SYSTEM = -1, // system default
230 wxFONTENCODING_DEFAULT, // current default encoding
231
232 // ISO8859 standard defines a number of single-byte charsets
233 wxFONTENCODING_ISO8859_1, // West European (Latin1)
234 wxFONTENCODING_ISO8859_2, // Central and East European (Latin2)
235 wxFONTENCODING_ISO8859_3, // Esperanto (Latin3)
236 wxFONTENCODING_ISO8859_4, // Baltic languages (Estonian) (Latin4)
237 wxFONTENCODING_ISO8859_5, // Cyrillic
238 wxFONTENCODING_ISO8859_6, // Arabic
239 wxFONTENCODING_ISO8859_7, // Greek
240 wxFONTENCODING_ISO8859_8, // Hebrew
241 wxFONTENCODING_ISO8859_9, // Turkish (Latin5)
242 wxFONTENCODING_ISO8859_10, // Variation of Latin4 (Latin6)
243 wxFONTENCODING_ISO8859_11, // Thai
244 wxFONTENCODING_ISO8859_12, // doesn't exist currently, but put it
245 // here anyhow to make all ISO8859
246 // consecutive numbers
247 wxFONTENCODING_ISO8859_13, // Latin7
248 wxFONTENCODING_ISO8859_14, // Latin8
249 wxFONTENCODING_ISO8859_15, // Latin9 (a.k.a. Latin0, includes euro)
250
251 // Cyrillic charset soup (see http://czyborra.com/charsets/cyrillic.html)
252 wxFONTENCODING_KOI8, // we don't support any of KOI8 variants
253 wxFONTENCODING_ALTERNATIVE, // same as MS-DOS CP866
254 wxFONTENCODING_BULGARIAN, // used under Linux in Bulgaria
255
256 // what would we do without Microsoft? They have their own encodings
257 // for DOS
258 wxFONTENCODING_CP437, // original MS-DOS codepage
259 wxFONTENCODING_CP850, // CP437 merged with Latin1
260 wxFONTENCODING_CP852, // CP437 merged with Latin2
261 wxFONTENCODING_CP855, // another cyrillic encoding
262 wxFONTENCODING_CP866, // and another one
263 // and for Windows
264 wxFONTENCODING_CP1250, // WinLatin2
265 wxFONTENCODING_CP1251, // WinCyrillic
266 wxFONTENCODING_CP1252, // WinLatin1
267
268 wxFONTENCODING_MAX
269 };
270
271 class wxFont {
272 public:
273 // I'll do it this way to use long-lived objects and not have to
274 // worry about when python may delete the object.
275 %addmethods {
276 wxFont( int pointSize, int family, int style, int weight,
277 int underline=FALSE, char* faceName = "",
278 wxFontEncoding encoding=wxFONTENCODING_DEFAULT) {
279
280 return wxTheFontList->FindOrCreateFont(pointSize, family, style, weight,
281 underline, faceName, encoding);
282 }
283 // NO Destructor.
284 }
285
286 bool Ok();
287
288 wxString GetFaceName();
289 int GetFamily();
290 #ifdef __WXMSW__
291 int GetFontId();
292 #endif
293 int GetPointSize();
294 int GetStyle();
295 bool GetUnderlined();
296 int GetWeight();
297 wxFontEncoding GetEncoding();
298 void SetFaceName(const wxString& faceName);
299 void SetFamily(int family);
300 void SetPointSize(int pointSize);
301 void SetStyle(int style);
302 void SetUnderlined(bool underlined);
303 void SetWeight(int weight);
304 void SetEncoding(wxFontEncoding encoding);
305 wxString GetFamilyString();
306 wxString GetStyleString();
307 wxString GetWeightString();
308 };
309
310 %inline %{
311 wxFontEncoding wxFont_GetDefaultEncoding() {
312 return wxFont::GetDefaultEncoding();
313 }
314
315 void wxFont_SetDefaultEncoding(wxFontEncoding encoding) {
316 wxFont::SetDefaultEncoding(encoding);
317 }
318 %}
319
320 //----------------------------------------------------------------------
321
322 class wxColour {
323 public:
324 wxColour(unsigned char red=0, unsigned char green=0, unsigned char blue=0);
325 ~wxColour();
326 unsigned char Red();
327 unsigned char Green();
328 unsigned char Blue();
329 bool Ok();
330 void Set(unsigned char red, unsigned char green, unsigned char blue);
331 %addmethods {
332 PyObject* Get() {
333 PyObject* rv = PyTuple_New(3);
334 PyTuple_SetItem(rv, 0, PyInt_FromLong(self->Red()));
335 PyTuple_SetItem(rv, 1, PyInt_FromLong(self->Green()));
336 PyTuple_SetItem(rv, 2, PyInt_FromLong(self->Blue()));
337 return rv;
338 }
339 }
340 %pragma(python) addtoclass = "asTuple = Get"
341 %pragma(python) addtoclass = "def __str__(self): return str(self.asTuple())"
342 %pragma(python) addtoclass = "def __repr__(self): return str(self.asTuple())"
343
344 };
345
346 %new wxColour* wxNamedColour(const wxString& colorName);
347
348 %{ // Alternate 'constructor'
349 wxColour* wxNamedColour(const wxString& colorName) {
350 return new wxColour(colorName);
351 }
352 %}
353
354
355 //----------------------------------------------------------------------
356
357
358 class wxPen {
359 public:
360 // I'll do it this way to use long-lived objects and not have to
361 // worry about when python may delete the object.
362 %addmethods {
363 wxPen(wxColour* colour, int width=1, int style=wxSOLID) {
364 return wxThePenList->FindOrCreatePen(*colour, width, style);
365 }
366 // NO Destructor.
367 }
368
369 int GetCap();
370 wxColour& GetColour();
371
372 int GetJoin();
373 int GetStyle();
374 int GetWidth();
375 bool Ok();
376 void SetCap(int cap_style);
377 void SetColour(wxColour& colour);
378 void SetJoin(int join_style);
379 void SetStyle(int style);
380 void SetWidth(int width);
381
382 // **** This one needs to return a list of ints (wxDash)
383 int GetDashes(wxDash **dashes);
384 void SetDashes(int LCOUNT, wxDash* choices);
385
386 #ifdef __WXMSW__
387 wxBitmap* GetStipple();
388 void SetStipple(wxBitmap& stipple);
389 #endif
390 };
391
392 //----------------------------------------------------------------------
393
394 class wxBrush {
395 public:
396 // I'll do it this way to use long-lived objects and not have to
397 // worry about when python may delete the object.
398 %addmethods {
399 wxBrush(const wxColour* colour, int style=wxSOLID) {
400 return wxTheBrushList->FindOrCreateBrush(*colour, style);
401 }
402 // NO Destructor.
403 }
404
405 // wxBrush(const wxColour& colour, int style=wxSOLID);
406
407 wxColour& GetColour();
408 wxBitmap * GetStipple();
409 int GetStyle();
410 bool Ok();
411 void SetColour(wxColour &colour);
412 void SetStipple(wxBitmap& bitmap);
413 void SetStyle(int style);
414 };
415
416 //----------------------------------------------------------------------
417
418
419
420 class wxDC {
421 public:
422 // wxDC(); **** abstract base class, can't instantiate.
423 ~wxDC();
424
425 void BeginDrawing();
426 // %name(BlitXY)
427 bool Blit(long xdest, long ydest,
428 long width, long height,
429 wxDC *source, long xsrc, long ysrc,
430 int logicalFunc = wxCOPY, int useMask = FALSE);
431 // bool Blit(const wxPoint& destPt, const wxSize& sz,
432 // wxDC *source, const wxPoint& srcPt,
433 // int logicalFunc = wxCOPY, int useMask = FALSE);
434
435 void Clear();
436 void CrossHair(long x, long y);
437 void DestroyClippingRegion();
438 long DeviceToLogicalX(long x);
439 long DeviceToLogicalXRel(long x);
440 long DeviceToLogicalY(long y);
441 long DeviceToLogicalYRel(long y);
442 void DrawArc(long x1, long y1, long x2, long y2, long xc, long yc);
443 void DrawCircle(long x, long y, long radius);
444 void DrawEllipse(long x, long y, long width, long height);
445 void DrawEllipticArc(long x, long y, long width, long height, long start, long end);
446 void DrawIcon(const wxIcon& icon, long x, long y);
447 void DrawLine(long x1, long y1, long x2, long y2);
448 void DrawLines(int PCOUNT, wxPoint* points, long xoffset=0, long yoffset=0);
449 void DrawPolygon(int PCOUNT, wxPoint* points, long xoffset=0, long yoffset=0,
450 int fill_style=wxODDEVEN_RULE);
451 void DrawPoint(long x, long y);
452 void DrawRectangle(long x, long y, long width, long height);
453 void DrawRotatedText(const wxString& text, wxCoord x, wxCoord y, double angle);
454 void DrawRoundedRectangle(long x, long y, long width, long height, long radius=20);
455 void DrawSpline(int PCOUNT, wxPoint* points);
456 void DrawText(const wxString& text, long x, long y);
457 void EndDoc();
458 void EndDrawing();
459 void EndPage();
460 void FloodFill(long x, long y, const wxColour& colour, int style=wxFLOOD_SURFACE);
461 wxBrush& GetBackground();
462 wxBrush& GetBrush();
463 long GetCharHeight();
464 long GetCharWidth();
465 void GetClippingBox(long *OUTPUT, long *OUTPUT,
466 long *OUTPUT, long *OUTPUT);
467 wxFont& GetFont();
468 int GetLogicalFunction();
469 void GetLogicalScale(double *OUTPUT, double *OUTPUT);
470 int GetMapMode();
471 bool GetOptimization();
472 wxPen& GetPen();
473 %addmethods {
474 %new wxColour* GetPixel(long x, long y) {
475 wxColour* wc = new wxColour();
476 self->GetPixel(x, y, wc);
477 return wc;
478 }
479 }
480 %name(GetSizeTuple)void GetSize(int* OUTPUT, int* OUTPUT);
481 wxSize GetSize();
482 wxSize GetSizeMM();
483 wxColour& GetTextBackground();
484 void GetTextExtent(const wxString& string, long *OUTPUT, long *OUTPUT);
485 %name(GetFullTextExtent)void GetTextExtent(const wxString& string,
486 long *OUTPUT, long *OUTPUT, long *OUTPUT, long* OUTPUT,
487 const wxFont* font = NULL);
488 wxColour& GetTextForeground();
489 void GetUserScale(double *OUTPUT, double *OUTPUT);
490 long LogicalToDeviceX(long x);
491 long LogicalToDeviceXRel(long x);
492 long LogicalToDeviceY(long y);
493 long LogicalToDeviceYRel(long y);
494 long MaxX();
495 long MaxY();
496 long MinX();
497 long MinY();
498 bool Ok();
499 void SetDeviceOrigin(long x, long y);
500 void SetBackground(const wxBrush& brush);
501 void SetBackgroundMode(int mode);
502 void SetClippingRegion(long x, long y, long width, long height);
503 void SetPalette(const wxPalette& colourMap);
504 void SetBrush(const wxBrush& brush);
505 void SetFont(const wxFont& font);
506 void SetLogicalFunction(int function);
507 void SetLogicalScale(double x, double y);
508 void SetMapMode(int mode);
509 void SetOptimization(bool optimize);
510 void SetPen(const wxPen& pen);
511 void SetTextBackground(const wxColour& colour);
512 void SetTextForeground(const wxColour& colour);
513 void SetUserScale(double x_scale, double y_scale);
514 bool StartDoc(const wxString& message);
515 void StartPage();
516
517
518
519 void DrawBitmap(const wxBitmap& bitmap, long x, long y,
520 int useMask = FALSE);
521
522 bool CanDrawBitmap();
523 bool CanGetTextExtent();
524 int GetDepth();
525 wxSize GetPPI();
526
527 void GetLogicalOrigin(int *OUTPUT, int *OUTPUT);
528 void SetLogicalOrigin(int x, int y);
529 void GetDeviceOrigin(int *OUTPUT, int *OUTPUT);
530 void SetAxisOrientation(bool xLeftRight, bool yBottomUp);
531
532 void CalcBoundingBox(int x, int y);
533 void ResetBoundingBox();
534 };
535
536
537 //----------------------------------------------------------------------
538
539 class wxMemoryDC : public wxDC {
540 public:
541 wxMemoryDC();
542
543 void SelectObject(const wxBitmap& bitmap);
544 }
545
546 %new wxMemoryDC* wxMemoryDCFromDC(wxDC* oldDC);
547 %{ // Alternate 'constructor'
548 wxMemoryDC* wxMemoryDCFromDC(wxDC* oldDC) {
549 return new wxMemoryDC(oldDC);
550 }
551 %}
552
553
554 //---------------------------------------------------------------------------
555
556 class wxScreenDC : public wxDC {
557 public:
558 wxScreenDC();
559
560 %name(StartDrawingOnTopWin) bool StartDrawingOnTop(wxWindow* window);
561 bool StartDrawingOnTop(wxRect* rect = NULL);
562 bool EndDrawingOnTop();
563 };
564
565 //---------------------------------------------------------------------------
566
567 class wxClientDC : public wxDC {
568 public:
569 wxClientDC(wxWindow* win);
570 };
571
572 //---------------------------------------------------------------------------
573
574 class wxPaintDC : public wxDC {
575 public:
576 wxPaintDC(wxWindow* win);
577 };
578
579 //---------------------------------------------------------------------------
580
581 class wxWindowDC : public wxDC {
582 public:
583 wxWindowDC(wxWindow* win);
584 };
585
586 //---------------------------------------------------------------------------
587
588 #ifndef __WXMSW__
589 class wxPostScriptDC : public wxDC {
590 public:
591 wxPostScriptDC(const wxString& output, bool interactive = TRUE, wxWindow* win = NULL);
592 };
593 #endif
594
595 //---------------------------------------------------------------------------
596
597
598 #ifdef __WXMSW__
599 class wxMetaFileDC : public wxDC {
600 public:
601 wxMetaFileDC(const wxString& filename = wxPyEmptyStr);
602 wxMetaFile* Close();
603 };
604 #endif
605
606 //---------------------------------------------------------------------------
607 //---------------------------------------------------------------------------
608
609
610 %readonly
611 %{
612 #if 0
613 %}
614 extern wxFont *wxNORMAL_FONT;
615 extern wxFont *wxSMALL_FONT;
616 extern wxFont *wxITALIC_FONT;
617 extern wxFont *wxSWISS_FONT;
618
619 extern wxPen *wxRED_PEN;
620 extern wxPen *wxCYAN_PEN;
621 extern wxPen *wxGREEN_PEN;
622 extern wxPen *wxBLACK_PEN;
623 extern wxPen *wxWHITE_PEN;
624 extern wxPen *wxTRANSPARENT_PEN;
625 extern wxPen *wxBLACK_DASHED_PEN;
626 extern wxPen *wxGREY_PEN;
627 extern wxPen *wxMEDIUM_GREY_PEN;
628 extern wxPen *wxLIGHT_GREY_PEN;
629
630 extern wxBrush *wxBLUE_BRUSH;
631 extern wxBrush *wxGREEN_BRUSH;
632 extern wxBrush *wxWHITE_BRUSH;
633 extern wxBrush *wxBLACK_BRUSH;
634 extern wxBrush *wxTRANSPARENT_BRUSH;
635 extern wxBrush *wxCYAN_BRUSH;
636 extern wxBrush *wxRED_BRUSH;
637 extern wxBrush *wxGREY_BRUSH;
638 extern wxBrush *wxMEDIUM_GREY_BRUSH;
639 extern wxBrush *wxLIGHT_GREY_BRUSH;
640
641 extern wxColour *wxBLACK;
642 extern wxColour *wxWHITE;
643 extern wxColour *wxRED;
644 extern wxColour *wxBLUE;
645 extern wxColour *wxGREEN;
646 extern wxColour *wxCYAN;
647 extern wxColour *wxLIGHT_GREY;
648
649 extern wxCursor *wxSTANDARD_CURSOR;
650 extern wxCursor *wxHOURGLASS_CURSOR;
651 extern wxCursor *wxCROSS_CURSOR;
652
653 extern wxBitmap wxNullBitmap;
654 extern wxIcon wxNullIcon;
655 extern wxCursor wxNullCursor;
656 extern wxPen wxNullPen;
657 extern wxBrush wxNullBrush;
658 extern wxPalette wxNullPalette;
659 extern wxFont wxNullFont;
660 extern wxColour wxNullColour;
661
662 %readwrite
663 %{
664 #endif
665 %}
666
667 //---------------------------------------------------------------------------
668
669 class wxPalette {
670 public:
671 wxPalette(int LCOUNT, byte* choices, byte* choices, byte* choices);
672 ~wxPalette();
673
674 int GetPixel(byte red, byte green, byte blue);
675 bool GetRGB(int pixel, byte* OUTPUT, byte* OUTPUT, byte* OUTPUT);
676 bool Ok();
677 };
678
679 //---------------------------------------------------------------------------
680
681 enum {
682 wxIMAGELIST_DRAW_NORMAL ,
683 wxIMAGELIST_DRAW_TRANSPARENT,
684 wxIMAGELIST_DRAW_SELECTED,
685 wxIMAGELIST_DRAW_FOCUSED,
686 wxIMAGE_LIST_NORMAL,
687 wxIMAGE_LIST_SMALL,
688 wxIMAGE_LIST_STATE
689 };
690
691 class wxImageList {
692 public:
693 wxImageList(int width, int height, int mask=TRUE, int initialCount=1);
694 ~wxImageList();
695
696 int Add(const wxBitmap& bitmap, const wxBitmap& mask = wxNullBitmap);
697 %name(AddWithColourMask)int Add(const wxBitmap& bitmap, const wxColour& maskColour);
698 %name(AddIcon)int Add(const wxIcon& icon);
699 #ifdef __WXMSW__
700 bool Replace(int index, const wxBitmap& bitmap, const wxBitmap& mask = wxNullBitmap);
701 #else
702 // %name(ReplaceIcon)bool Replace(int index, const wxIcon& icon);
703 // int Add(const wxBitmap& bitmap);
704 bool Replace(int index, const wxBitmap& bitmap);
705 #endif
706
707 bool Draw(int index, wxDC& dc, int x, int x, int flags = wxIMAGELIST_DRAW_NORMAL,
708 const bool solidBackground = FALSE);
709
710 int GetImageCount();
711 bool Remove(int index);
712 bool RemoveAll();
713 void GetSize(int index, int& OUTPUT, int& OUTPUT);
714 };
715
716
717 //---------------------------------------------------------------------------
718