ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/rxvtperl.xs
Revision: 1.46
Committed: Mon Jan 9 01:36:56 2006 UTC (18 years, 5 months ago) by root
Branch: MAIN
Changes since 1.45: +1 -1 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 root 1.1 /*----------------------------------------------------------------------*
2     * File: rxvtperl.xs
3     *----------------------------------------------------------------------*
4     *
5     * All portions of code are copyright by their respective author/s.
6 root 1.31 * Copyright (c) 2005-2006 Marc Lehmann <pcg@goof.com>
7 root 1.1 *
8     * This program is free software; you can redistribute it and/or modify
9     * it under the terms of the GNU General Public License as published by
10     * the Free Software Foundation; either version 2 of the License, or
11     * (at your option) any later version.
12     *
13     * This program is distributed in the hope that it will be useful,
14     * but WITHOUT ANY WARRANTY; without even the implied warranty of
15     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16     * GNU General Public License for more details.
17     *
18     * You should have received a copy of the GNU General Public License
19     * along with this program; if not, write to the Free Software
20     * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21     *----------------------------------------------------------------------*/
22    
23     #define line_t perl_line_t
24     #include <EXTERN.h>
25     #include <perl.h>
26     #include <XSUB.h>
27     #undef line_t
28    
29     #include "../config.h"
30    
31 root 1.38 #include <cstddef>
32 root 1.1 #include <cstdarg>
33    
34     #include "rxvt.h"
35     #include "iom.h"
36     #include "rxvtutil.h"
37     #include "rxvtperl.h"
38    
39     #include "perlxsi.c"
40    
41 root 1.41 #if defined(HAVE_SCROLLBARS) || defined(MENUBAR)
42     # define GRAB_CURSOR THIS->leftptr_cursor
43     #else
44     # define GRAB_CURSOR None
45     #endif
46    
47 root 1.8 #undef LINENO
48     #define LINENO(n) MOD (THIS->term_start + int(n), THIS->total_rows)
49     #undef ROW
50     #define ROW(n) THIS->row_buf [LINENO (n)]
51    
52 root 1.1 /////////////////////////////////////////////////////////////////////////////
53    
54 root 1.42 static SV *
55     taint (SV *sv)
56     {
57     SvTAINT (sv);
58     return sv;
59     }
60    
61     static SV *
62     taint_if (SV *sv, SV *src)
63     {
64     if (SvTAINTED (src))
65     SvTAINT (sv);
66    
67     return sv;
68     }
69    
70 root 1.1 static wchar_t *
71     sv2wcs (SV *sv)
72     {
73     STRLEN len;
74     char *str = SvPVutf8 (sv, len);
75     return rxvt_utf8towcs (str, len);
76     }
77    
78     static SV *
79 root 1.25 wcs2sv (wchar_t *wstr, int len = -1)
80     {
81     char *str = rxvt_wcstoutf8 (wstr, len);
82    
83     SV *sv = newSVpv (str, 0);
84     SvUTF8_on (sv);
85     free (str);
86    
87     return sv;
88     }
89    
90     static SV *
91 root 1.1 new_ref (HV *hv, const char *klass)
92     {
93     return sv_bless (newRV ((SV *)hv), gv_stashpv (klass, 1));
94     }
95    
96     //TODO: use magic
97     static SV *
98     newSVptr (void *ptr, const char *klass)
99     {
100     HV *hv = newHV ();
101 root 1.18 sv_magic ((SV *)hv, 0, PERL_MAGIC_ext, (char *)ptr, 0);
102 root 1.1 return sv_bless (newRV_noinc ((SV *)hv), gv_stashpv (klass, 1));
103     }
104    
105 root 1.18 static void
106     clearSVptr (SV *sv)
107     {
108     if (SvROK (sv))
109     sv = SvRV (sv);
110    
111     hv_clear ((HV *)sv);
112     sv_unmagic (sv, PERL_MAGIC_ext);
113     }
114    
115 root 1.1 static long
116     SvPTR (SV *sv, const char *klass)
117     {
118     if (!sv_derived_from (sv, klass))
119     croak ("object of type %s expected", klass);
120    
121 root 1.18 MAGIC *mg = mg_find (SvRV (sv), PERL_MAGIC_ext);
122 root 1.1
123 root 1.18 if (!mg)
124 root 1.1 croak ("perl code used %s object, but C++ object is already destroyed, caught", klass);
125    
126 root 1.18 return (long)mg->mg_ptr;
127 root 1.1 }
128    
129 root 1.36 #define newSVterm(term) SvREFCNT_inc ((SV *)term->perl.self)
130 root 1.1 #define SvTERM(sv) (rxvt_term *)SvPTR (sv, "urxvt::term")
131    
132     /////////////////////////////////////////////////////////////////////////////
133    
134     struct perl_watcher
135     {
136     SV *cbsv;
137     HV *self;
138    
139     perl_watcher ()
140     : cbsv (newSV (0))
141     {
142     }
143    
144     ~perl_watcher ()
145     {
146     SvREFCNT_dec (cbsv);
147     }
148    
149     void cb (SV *cb)
150     {
151     sv_setsv (cbsv, cb);
152     }
153    
154     void invoke (const char *type, SV *self, int arg = -1);
155     };
156    
157     void
158     perl_watcher::invoke (const char *type, SV *self, int arg)
159     {
160     dSP;
161    
162     ENTER;
163     SAVETMPS;
164    
165     PUSHMARK (SP);
166    
167     XPUSHs (sv_2mortal (self));
168    
169     if (arg >= 0)
170     XPUSHs (sv_2mortal (newSViv (arg)));
171    
172     PUTBACK;
173     call_sv (cbsv, G_VOID | G_EVAL | G_DISCARD);
174     SPAGAIN;
175    
176     PUTBACK;
177     FREETMPS;
178     LEAVE;
179    
180     if (SvTRUE (ERRSV))
181     rxvt_warn ("%s callback evaluation error: %s", type, SvPV_nolen (ERRSV));
182     }
183    
184     #define newSVtimer(timer) new_ref (timer->self, "urxvt::timer")
185     #define SvTIMER(sv) (timer *)SvPTR (sv, "urxvt::timer")
186    
187     struct timer : time_watcher, perl_watcher
188     {
189 root 1.13 tstamp interval;
190    
191 root 1.1 timer ()
192     : time_watcher (this, &timer::execute)
193     {
194     }
195    
196     void execute (time_watcher &w)
197     {
198 root 1.13 if (interval)
199     start (at + interval);
200    
201 root 1.1 invoke ("urxvt::timer", newSVtimer (this));
202     }
203     };
204    
205     #define newSViow(iow) new_ref (iow->self, "urxvt::iow")
206     #define SvIOW(sv) (iow *)SvPTR (sv, "urxvt::iow")
207    
208     struct iow : io_watcher, perl_watcher
209     {
210     iow ()
211     : io_watcher (this, &iow::execute)
212     {
213     }
214    
215     void execute (io_watcher &w, short revents)
216     {
217     invoke ("urxvt::iow", newSViow (this), revents);
218     }
219     };
220    
221     /////////////////////////////////////////////////////////////////////////////
222    
223 root 1.13 #define SvOVERLAY(sv) (overlay *)SvPTR (sv, "urxvt::overlay")
224    
225     struct overlay {
226     HV *self;
227     rxvt_term *THIS;
228     int x, y, w, h;
229     int border;
230     text_t **text;
231     rend_t **rend;
232    
233     overlay (rxvt_term *THIS, int x_, int y_, int w_, int h_, rend_t rstyle, int border);
234     ~overlay ();
235    
236 root 1.18 void show ();
237     void hide ();
238    
239 root 1.13 void swap ();
240    
241     void set (int x, int y, SV *str, SV *rend);
242     };
243    
244     overlay::overlay (rxvt_term *THIS, int x_, int y_, int w_, int h_, rend_t rstyle, int border)
245     : THIS(THIS), x(x_), y(y_), w(w_), h(h_), border(border == 2)
246     {
247     if (border == 2)
248     {
249     w += 2;
250     h += 2;
251     }
252    
253     text = new text_t *[h];
254     rend = new rend_t *[h];
255 root 1.24
256 root 1.13 for (int y = 0; y < h; y++)
257 root 1.24 {
258 root 1.13 text_t *tp = text[y] = new text_t[w];
259     rend_t *rp = rend[y] = new rend_t[w];
260 root 1.24
261 root 1.13 text_t t0, t1, t2;
262     rend_t r = rstyle;
263 root 1.24
264 root 1.13 if (border == 2)
265     {
266     if (y == 0)
267     t0 = 0x2554, t1 = 0x2550, t2 = 0x2557;
268     else if (y < h - 1)
269     t0 = 0x2551, t1 = 0x0020, t2 = 0x2551;
270     else
271     t0 = 0x255a, t1 = 0x2550, t2 = 0x255d;
272 root 1.24
273     *tp++ = t0;
274 root 1.13 *rp++ = r;
275 root 1.24
276 root 1.13 for (int x = w - 2; x-- > 0; )
277     {
278     *tp++ = t1;
279     *rp++ = r;
280 root 1.24 }
281 root 1.13
282     *tp = t2;
283 root 1.24 *rp = r;
284 root 1.13 }
285     else
286     for (int x = w; x-- > 0; )
287     {
288     *tp++ = 0x0020;
289     *rp++ = r;
290 root 1.24 }
291     }
292 root 1.13
293 root 1.18 show ();
294 root 1.13 THIS->want_refresh = 1;
295     }
296    
297     overlay::~overlay ()
298     {
299 root 1.18 hide ();
300    
301 root 1.13 for (int y = h; y--; )
302     {
303     delete [] text[y];
304     delete [] rend[y];
305     }
306    
307     delete [] text;
308     delete [] rend;
309    
310     THIS->want_refresh = 1;
311     }
312    
313 root 1.18 void
314     overlay::show ()
315     {
316     char key[33]; sprintf (key, "%32lx", (long)this);
317    
318 root 1.36 HV *hv = (HV *)SvRV (*hv_fetch ((HV *)SvRV ((SV *)THIS->perl.self), "_overlay", 8, 0));
319 root 1.18 hv_store (hv, key, 32, newSViv ((long)this), 0);
320     }
321    
322     void
323     overlay::hide ()
324     {
325 root 1.36 SV **ovs = hv_fetch ((HV *)SvRV ((SV *)THIS->perl.self), "_overlay", 8, 0);
326 root 1.18
327     if (ovs)
328     {
329     char key[33]; sprintf (key, "%32lx", (long)this);
330    
331     HV *hv = (HV *)SvRV (*ovs);
332     hv_delete (hv, key, 32, G_DISCARD);
333     }
334     }
335    
336 root 1.13 void overlay::swap ()
337     {
338     int ov_x = max (0, min (MOD (x, THIS->ncol), THIS->ncol - w));
339     int ov_y = max (0, min (MOD (y, THIS->nrow), THIS->nrow - h));
340    
341     int ov_w = min (w, THIS->ncol - ov_x);
342     int ov_h = min (h, THIS->nrow - ov_y);
343    
344     for (int y = ov_h; y--; )
345     {
346     text_t *t1 = text [y];
347     rend_t *r1 = rend [y];
348 root 1.24
349 root 1.13 text_t *t2 = ROW(y + ov_y - THIS->view_start).t + ov_x;
350     rend_t *r2 = ROW(y + ov_y - THIS->view_start).r + ov_x;
351    
352     for (int x = ov_w; x--; )
353 root 1.24 {
354 root 1.13 text_t t = *t1; *t1++ = *t2; *t2++ = t;
355     rend_t r = *r1; *r1++ = *r2; *r2++ = SET_FONT (r, THIS->fontset [GET_STYLE (r)]->find_font (t));
356     }
357     }
358    
359     }
360    
361 root 1.14 void overlay::set (int x, int y, SV *text, SV *rend)
362 root 1.13 {
363     x += border;
364     y += border;
365    
366     if (!IN_RANGE_EXC (y, 0, h - border))
367     return;
368    
369 root 1.14 wchar_t *wtext = sv2wcs (text);
370 root 1.13
371 root 1.14 for (int col = min (wcslen (wtext), w - x - border); col--; )
372     this->text [y][x + col] = wtext [col];
373 root 1.24
374 root 1.14 free (wtext);
375    
376     if (rend)
377     {
378     if (!SvROK (rend) || SvTYPE (SvRV (rend)) != SVt_PVAV)
379     croak ("rend must be arrayref");
380    
381     AV *av = (AV *)SvRV (rend);
382    
383     for (int col = min (av_len (av) + 1, w - x - border); col--; )
384     this->rend [y][x + col] = SvIV (*av_fetch (av, col, 1));
385     }
386 root 1.13
387     THIS->want_refresh = 1;
388     }
389    
390    
391     /////////////////////////////////////////////////////////////////////////////
392    
393 root 1.1 struct rxvt_perl_interp rxvt_perl;
394    
395     static PerlInterpreter *perl;
396    
397     rxvt_perl_interp::rxvt_perl_interp ()
398     {
399     }
400    
401     rxvt_perl_interp::~rxvt_perl_interp ()
402     {
403     if (perl)
404     {
405     perl_destruct (perl);
406     perl_free (perl);
407     }
408     }
409    
410     void
411 root 1.43 rxvt_perl_interp::init ()
412 root 1.1 {
413     if (!perl)
414     {
415     char *argv[] = {
416     "",
417 root 1.43 "-T",
418 root 1.1 "-edo '" LIBDIR "/urxvt.pm' or ($@ and die $@) or exit 1",
419     };
420    
421     perl = perl_alloc ();
422     perl_construct (perl);
423    
424 root 1.43 if (perl_parse (perl, xs_init, 3, argv, (char **)NULL)
425 root 1.1 || perl_run (perl))
426     {
427     rxvt_warn ("unable to initialize perl-interpreter, continuing without.\n");
428    
429     perl_destruct (perl);
430     perl_free (perl);
431     perl = 0;
432     }
433     }
434     }
435    
436 root 1.45 static void
437     ungrab (rxvt_term *THIS)
438     {
439     if (THIS->perl.grabtime)
440     {
441     XUngrabKeyboard (THIS->display->display, THIS->perl.grabtime);
442     XUngrabPointer (THIS->display->display, THIS->perl.grabtime);
443     THIS->perl.grabtime = 0;
444     }
445     }
446    
447 root 1.1 bool
448     rxvt_perl_interp::invoke (rxvt_term *term, hook_type htype, ...)
449     {
450 root 1.13 if (!perl)
451 root 1.1 return false;
452 root 1.24
453 root 1.1 if (htype == HOOK_INIT) // first hook ever called
454 root 1.13 {
455 root 1.36 term->perl.self = (void *)newSVptr ((void *)term, "urxvt::term");
456     hv_store ((HV *)SvRV ((SV *)term->perl.self), "_overlay", 8, newRV_noinc ((SV *)newHV ()), 0);
457 root 1.13 }
458 root 1.36 else if (!term->perl.self)
459 root 1.17 return false; // perl not initialized for this instance
460 root 1.13 else if (htype == HOOK_DESTROY)
461     {
462     // handled later
463     }
464     else if (htype == HOOK_REFRESH_BEGIN || htype == HOOK_REFRESH_END)
465     {
466 root 1.36 HV *hv = (HV *)SvRV (*hv_fetch ((HV *)SvRV ((SV *)term->perl.self), "_overlay", 8, 0));
467 root 1.13
468     if (HvKEYS (hv))
469     {
470     hv_iterinit (hv);
471    
472     while (HE *he = hv_iternext (hv))
473     ((overlay *)SvIV (hv_iterval (hv, he)))->swap ();
474     }
475     }
476     else if (!should_invoke [htype])
477     return false;
478 root 1.1
479     dSP;
480     va_list ap;
481    
482     va_start (ap, htype);
483    
484     ENTER;
485     SAVETMPS;
486    
487     PUSHMARK (SP);
488    
489     XPUSHs (sv_2mortal (newSVterm (term)));
490     XPUSHs (sv_2mortal (newSViv (htype)));
491    
492     for (;;) {
493     data_type dt = (data_type)va_arg (ap, int);
494    
495     switch (dt)
496     {
497     case DT_INT:
498     XPUSHs (sv_2mortal (newSViv (va_arg (ap, int))));
499     break;
500    
501     case DT_LONG:
502     XPUSHs (sv_2mortal (newSViv (va_arg (ap, long))));
503     break;
504    
505 root 1.32 case DT_STR:
506 root 1.42 XPUSHs (taint (sv_2mortal (newSVpv (va_arg (ap, char *), 0))));
507 root 1.6 break;
508    
509 root 1.32 case DT_STR_LEN:
510 root 1.29 {
511     char *str = va_arg (ap, char *);
512     int len = va_arg (ap, int);
513    
514 root 1.42 XPUSHs (taint (sv_2mortal (newSVpvn (str, len))));
515 root 1.29 }
516     break;
517    
518 root 1.32 case DT_WCS_LEN:
519     {
520     wchar_t *wstr = va_arg (ap, wchar_t *);
521     int wlen = va_arg (ap, int);
522    
523 root 1.42 XPUSHs (taint (sv_2mortal (wcs2sv (wstr, wlen))));
524 root 1.32 }
525 root 1.34 break;
526 root 1.32
527 root 1.29 case DT_XEVENT:
528     {
529     XEvent *xe = va_arg (ap, XEvent *);
530     HV *hv = newHV ();
531    
532     # define set(name, sv) hv_store (hv, # name, sizeof (# name) - 1, sv, 0)
533     # define setiv(name, val) hv_store (hv, # name, sizeof (# name) - 1, newSViv (val), 0)
534     # undef set
535    
536     setiv (type, xe->type);
537     setiv (send_event, xe->xany.send_event);
538     setiv (serial, xe->xany.serial);
539    
540     switch (xe->type)
541     {
542     case KeyPress:
543     case KeyRelease:
544     case ButtonPress:
545     case ButtonRelease:
546     case MotionNotify:
547     setiv (time, xe->xmotion.time);
548     setiv (x, xe->xmotion.x);
549     setiv (y, xe->xmotion.y);
550 root 1.30 setiv (row, xe->xmotion.y / term->fheight);
551     setiv (col, xe->xmotion.x / term->fwidth);
552 root 1.29 setiv (x_root, xe->xmotion.x_root);
553     setiv (y_root, xe->xmotion.y_root);
554     setiv (state, xe->xmotion.state);
555     break;
556     }
557    
558     switch (xe->type)
559     {
560     case KeyPress:
561     case KeyRelease:
562     setiv (keycode, xe->xkey.keycode);
563     break;
564    
565     case ButtonPress:
566     case ButtonRelease:
567     setiv (button, xe->xbutton.button);
568     break;
569    
570     case MotionNotify:
571     setiv (is_hint, xe->xmotion.is_hint);
572     break;
573     }
574    
575     XPUSHs (sv_2mortal (newRV_noinc ((SV *)hv)));
576     }
577     break;
578    
579 root 1.1 case DT_END:
580     {
581     va_end (ap);
582    
583     PUTBACK;
584     int count = call_pv ("urxvt::invoke", G_ARRAY | G_EVAL);
585     SPAGAIN;
586    
587     if (count)
588     {
589     SV *status = POPs;
590     count = SvTRUE (status);
591     }
592    
593     PUTBACK;
594     FREETMPS;
595     LEAVE;
596    
597     if (SvTRUE (ERRSV))
598 root 1.45 {
599     rxvt_warn ("perl hook %d evaluation error: %s", htype, SvPV_nolen (ERRSV));
600     ungrab (term); // better lose the grab than the session
601     }
602 root 1.1
603 root 1.4 if (htype == HOOK_DESTROY)
604     {
605 root 1.36 clearSVptr ((SV *)term->perl.self);
606     SvREFCNT_dec ((SV *)term->perl.self);
607 root 1.4 }
608    
609 root 1.1 return count;
610     }
611    
612     default:
613     rxvt_fatal ("FATAL: unable to pass data type %d\n", dt);
614     }
615     }
616     }
617    
618     /////////////////////////////////////////////////////////////////////////////
619    
620     MODULE = urxvt PACKAGE = urxvt
621    
622     PROTOTYPES: ENABLE
623    
624     BOOT:
625     {
626 root 1.39 sv_setsv (get_sv ("urxvt::LIBDIR", 1), newSVpvn (LIBDIR, sizeof (LIBDIR) - 1));
627 root 1.37
628 root 1.1 AV *hookname = get_av ("urxvt::HOOKNAME", 1);
629 root 1.21 # define def(sym) av_store (hookname, HOOK_ ## sym, newSVpv (# sym, 0));
630     # include "hookinc.h"
631     # undef def
632 root 1.1
633 root 1.39 HV *option = get_hv ("urxvt::OPTION", 1);
634     # define def(name,val) hv_store (option, # name, sizeof (# name) - 1, newSVuv (Opt_ ## name), 0);
635     # define nodef(name)
636     # include "optinc.h"
637     # undef nodef
638     # undef def
639    
640     HV *stash = gv_stashpv ("urxvt", 1);
641     # define export_const_iv(name) newCONSTSUB (stash, # name, newSViv (name));
642 root 1.37 export_const_iv (DEFAULT_RSTYLE);
643     export_const_iv (OVERLAY_RSTYLE);
644     export_const_iv (RS_Bold);
645     export_const_iv (RS_Italic);
646     export_const_iv (RS_Blink);
647     export_const_iv (RS_RVid);
648     export_const_iv (RS_Uline);
649 root 1.38
650 root 1.37 export_const_iv (CurrentTime);
651 root 1.38 export_const_iv (ShiftMask);
652     export_const_iv (LockMask);
653     export_const_iv (ControlMask);
654     export_const_iv (Mod1Mask);
655     export_const_iv (Mod2Mask);
656     export_const_iv (Mod3Mask);
657     export_const_iv (Mod4Mask);
658     export_const_iv (Mod5Mask);
659     export_const_iv (Button1Mask);
660     export_const_iv (Button2Mask);
661     export_const_iv (Button3Mask);
662     export_const_iv (Button4Mask);
663     export_const_iv (Button5Mask);
664     export_const_iv (AnyModifier);
665 root 1.1 }
666    
667 root 1.28 SV *
668     new (...)
669     CODE:
670     {
671     stringvec *argv = new stringvec;
672     bool success;
673    
674     for (int i = 0; i < items ;i++)
675     argv->push_back (strdup (SvPVbyte_nolen (ST (i))));
676    
677     rxvt_term *term = new rxvt_term;
678    
679     term->argv = argv;
680    
681     try
682     {
683     if (!term->init (argv->size (), argv->begin ()))
684     term = 0;
685     }
686     catch (const class rxvt_failure_exception &e)
687     {
688     term->destroy ();
689     croak ("exception caught while initializing new terminal instance");
690     }
691    
692 root 1.36 RETVAL = term && term->perl.self ? newSVterm (term) : &PL_sv_undef;
693 root 1.28 }
694     OUTPUT:
695     RETVAL
696    
697 root 1.1 void
698     set_should_invoke (int htype, int value)
699     CODE:
700     rxvt_perl.should_invoke [htype] = value;
701    
702     void
703     warn (const char *msg)
704     CODE:
705     rxvt_warn ("%s", msg);
706    
707     void
708     fatal (const char *msg)
709     CODE:
710     rxvt_fatal ("%s", msg);
711    
712 root 1.45 SV *
713     untaint (SV *sv)
714     CODE:
715     RETVAL = newSVsv (sv);
716     SvTAINTED_off (RETVAL);
717     OUTPUT:
718     RETVAL
719    
720 root 1.3 NV
721     NOW ()
722     CODE:
723     RETVAL = NOW;
724     OUTPUT:
725     RETVAL
726    
727 root 1.11 int
728     GET_BASEFG (int rend)
729     CODE:
730     RETVAL = GET_BASEFG (rend);
731     OUTPUT:
732     RETVAL
733    
734     int
735     GET_BASEBG (int rend)
736     CODE:
737     RETVAL = GET_BASEBG (rend);
738     OUTPUT:
739     RETVAL
740    
741     int
742 root 1.12 SET_FGCOLOR (int rend, int new_color)
743 root 1.11 CODE:
744 root 1.12 RETVAL = SET_FGCOLOR (rend, new_color);
745 root 1.11 OUTPUT:
746     RETVAL
747    
748     int
749 root 1.12 SET_BGCOLOR (int rend, int new_color)
750 root 1.11 CODE:
751 root 1.12 RETVAL = SET_BGCOLOR (rend, new_color);
752     OUTPUT:
753     RETVAL
754    
755     int
756     GET_CUSTOM (int rend)
757     CODE:
758     RETVAL = (rend && RS_customMask) >> RS_customShift;
759     OUTPUT:
760     RETVAL
761    
762     int
763     SET_CUSTOM (int rend, int new_value)
764     CODE:
765     {
766     if (!IN_RANGE_EXC (new_value, 0, RS_customCount))
767     croak ("custom value out of range, must be 0..%d", RS_customCount - 1);
768    
769     RETVAL = (rend & ~RS_customMask)
770     | ((new_value << RS_customShift) & RS_customMask);
771     }
772 root 1.11 OUTPUT:
773     RETVAL
774    
775 root 1.3 MODULE = urxvt PACKAGE = urxvt::term
776    
777 root 1.28 void
778     rxvt_term::destroy ()
779    
780 root 1.35 void
781 root 1.36 rxvt_term::grab_button (int button, U32 modifiers)
782     CODE:
783     XGrabButton (THIS->display->display, button, modifiers, THIS->vt, 1,
784     ButtonPressMask | ButtonReleaseMask | EnterWindowMask | LeaveWindowMask | PointerMotionMask,
785 root 1.41 GrabModeSync, GrabModeSync, None, GRAB_CURSOR);
786 root 1.36
787     bool
788     rxvt_term::grab (U32 eventtime, int sync = 0)
789 root 1.35 CODE:
790     {
791 root 1.36 int mode = sync ? GrabModeSync : GrabModeAsync;
792    
793     THIS->perl.grabtime = 0;
794    
795     if (!XGrabPointer (THIS->display->display, THIS->vt, 0,
796     ButtonPressMask | ButtonReleaseMask | EnterWindowMask | LeaveWindowMask | PointerMotionMask,
797 root 1.41 mode, mode, None, GRAB_CURSOR, eventtime))
798 root 1.36 if (!XGrabKeyboard (THIS->display->display, THIS->vt, 0, mode, mode, eventtime))
799     THIS->perl.grabtime = eventtime;
800     else
801     XUngrabPointer (THIS->display->display, eventtime);
802    
803     RETVAL = !!THIS->perl.grabtime;
804 root 1.35 }
805 root 1.36 OUTPUT:
806     RETVAL
807    
808     void
809 root 1.44 rxvt_term::allow_events_async ()
810 root 1.36 CODE:
811 root 1.44 XAllowEvents (THIS->display->display, AsyncBoth, THIS->perl.grabtime);
812 root 1.36
813     void
814 root 1.44 rxvt_term::allow_events_sync ()
815 root 1.36 CODE:
816 root 1.44 XAllowEvents (THIS->display->display, SyncBoth, THIS->perl.grabtime);
817 root 1.36
818     void
819 root 1.44 rxvt_term::allow_events_replay ()
820 root 1.36 CODE:
821 root 1.44 XAllowEvents (THIS->display->display, ReplayPointer, THIS->perl.grabtime);
822     XAllowEvents (THIS->display->display, ReplayKeyboard, THIS->perl.grabtime);
823 root 1.36
824     void
825 root 1.44 rxvt_term::ungrab ()
826 root 1.36 CODE:
827 root 1.45 ungrab (THIS);
828 root 1.35
829 root 1.1 int
830 root 1.3 rxvt_term::strwidth (SV *str)
831 root 1.1 CODE:
832     {
833     wchar_t *wstr = sv2wcs (str);
834 root 1.3
835     rxvt_push_locale (THIS->locale);
836 root 1.1 RETVAL = wcswidth (wstr, wcslen (wstr));
837 root 1.3 rxvt_pop_locale ();
838    
839 root 1.1 free (wstr);
840     }
841     OUTPUT:
842     RETVAL
843    
844 root 1.3 SV *
845     rxvt_term::locale_encode (SV *str)
846 root 1.1 CODE:
847 root 1.3 {
848     wchar_t *wstr = sv2wcs (str);
849    
850     rxvt_push_locale (THIS->locale);
851     char *mbstr = rxvt_wcstombs (wstr);
852     rxvt_pop_locale ();
853    
854     free (wstr);
855    
856 root 1.42 RETVAL = taint_if (newSVpv (mbstr, 0), str);
857 root 1.3 free (mbstr);
858     }
859     OUTPUT:
860 root 1.1 RETVAL
861    
862 root 1.3 SV *
863     rxvt_term::locale_decode (SV *octets)
864     CODE:
865     {
866     STRLEN len;
867     char *data = SvPVbyte (octets, len);
868    
869     rxvt_push_locale (THIS->locale);
870     wchar_t *wstr = rxvt_mbstowcs (data, len);
871     rxvt_pop_locale ();
872    
873 root 1.42 RETVAL = taint_if (wcs2sv (wstr), octets);
874 root 1.3 free (wstr);
875     }
876     OUTPUT:
877     RETVAL
878 root 1.1
879 root 1.38 #define TERM_OFFSET(sym) offsetof (TermWin_t, sym)
880 root 1.24
881     #define TERM_OFFSET_width TERM_OFFSET(width)
882     #define TERM_OFFSET_height TERM_OFFSET(height)
883     #define TERM_OFFSET_fwidth TERM_OFFSET(fwidth)
884     #define TERM_OFFSET_fheight TERM_OFFSET(fheight)
885     #define TERM_OFFSET_fbase TERM_OFFSET(fbase)
886     #define TERM_OFFSET_nrow TERM_OFFSET(nrow)
887     #define TERM_OFFSET_ncol TERM_OFFSET(ncol)
888     #define TERM_OFFSET_focus TERM_OFFSET(focus)
889     #define TERM_OFFSET_mapped TERM_OFFSET(mapped)
890     #define TERM_OFFSET_saveLines TERM_OFFSET(saveLines)
891     #define TERM_OFFSET_total_rows TERM_OFFSET(total_rows)
892     #define TERM_OFFSET_nsaved TERM_OFFSET(nsaved)
893    
894     int
895     rxvt_term::width ()
896     ALIAS:
897     width = TERM_OFFSET_width
898     height = TERM_OFFSET_height
899     fwidth = TERM_OFFSET_fwidth
900     fheight = TERM_OFFSET_fheight
901     fbase = TERM_OFFSET_fbase
902     nrow = TERM_OFFSET_nrow
903     ncol = TERM_OFFSET_ncol
904     focus = TERM_OFFSET_focus
905     mapped = TERM_OFFSET_mapped
906     saveLines = TERM_OFFSET_saveLines
907     total_rows = TERM_OFFSET_total_rows
908     nsaved = TERM_OFFSET_nsaved
909     CODE:
910     RETVAL = *(int *)((char *)THIS + ix);
911     OUTPUT:
912     RETVAL
913    
914 root 1.38 unsigned int
915     rxvt_term::ModLevel3Mask ()
916     ALIAS:
917     ModLevel3Mask = 0
918     ModMetaMask = 1
919     ModNumLockMask = 2
920     CODE:
921     switch (ix)
922     {
923     case 0: RETVAL = THIS->ModLevel3Mask; break;
924     case 1: RETVAL = THIS->ModMetaMask; break;
925     case 2: RETVAL = THIS->ModNumLockMask; break;
926     }
927     OUTPUT:
928     RETVAL
929    
930 root 1.24 U32
931 root 1.31 rxvt_term::parent ()
932     CODE:
933     RETVAL = (U32)THIS->parent [0];
934     OUTPUT:
935     RETVAL
936    
937     U32
938 root 1.30 rxvt_term::vt ()
939     CODE:
940 root 1.31 RETVAL = (U32)THIS->vt;
941 root 1.30 OUTPUT:
942     RETVAL
943    
944     U32
945 root 1.25 rxvt_term::rstyle (U32 new_rstyle = THIS->rstyle)
946 root 1.7 CODE:
947 root 1.24 {
948 root 1.25 RETVAL = THIS->rstyle;
949     THIS->rstyle = new_rstyle;
950 root 1.24 }
951 root 1.7 OUTPUT:
952 root 1.24 RETVAL
953 root 1.7
954     int
955     rxvt_term::view_start (int newval = -1)
956     CODE:
957     {
958     RETVAL = THIS->view_start;
959    
960     if (newval >= 0)
961     {
962     THIS->view_start = min (newval, THIS->nsaved);
963     THIS->scr_changeview (RETVAL);
964     }
965     }
966     OUTPUT:
967     RETVAL
968    
969 root 1.8 void
970 root 1.9 rxvt_term::want_refresh ()
971     CODE:
972     THIS->want_refresh = 1;
973    
974     void
975 root 1.27 rxvt_term::ROW_t (int row_number, SV *new_text = 0, int start_col = 0, int start_ofs = 0, int max_len = MAX_COLS)
976 root 1.8 PPCODE:
977     {
978     if (!IN_RANGE_EXC (row_number, -THIS->nsaved, THIS->nrow))
979 root 1.19 XSRETURN_EMPTY;
980 root 1.8
981     line_t &l = ROW(row_number);
982    
983     if (GIMME_V != G_VOID)
984     {
985     wchar_t *wstr = new wchar_t [THIS->ncol];
986    
987 root 1.33 for (int col = 0; col < THIS->ncol; col++)
988 root 1.8 wstr [col] = l.t [col];
989    
990 root 1.42 XPUSHs (taint (sv_2mortal (wcs2sv (wstr, THIS->ncol))));
991 root 1.8
992 root 1.25 delete [] wstr;
993 root 1.8 }
994    
995     if (new_text)
996     {
997 root 1.13 wchar_t *wstr = sv2wcs (new_text);
998 root 1.8
999 root 1.27 int len = min (wcslen (wstr) - start_ofs, max_len);
1000 root 1.8
1001 root 1.10 if (!IN_RANGE_INC (start_col, 0, THIS->ncol - len))
1002 root 1.8 {
1003     free (wstr);
1004 root 1.10 croak ("new_text extends beyond horizontal margins");
1005 root 1.8 }
1006    
1007     for (int col = start_col; col < start_col + len; col++)
1008     {
1009 root 1.27 l.t [col] = wstr [start_ofs + col - start_col];
1010 root 1.8 l.r [col] = SET_FONT (l.r [col], THIS->fontset [GET_STYLE (l.r [col])]->find_font (l.t [col]));
1011     }
1012 root 1.9
1013     free (wstr);
1014 root 1.8 }
1015     }
1016    
1017     void
1018 root 1.27 rxvt_term::ROW_r (int row_number, SV *new_rend = 0, int start_col = 0, int start_ofs = 0, int max_len = MAX_COLS)
1019 root 1.8 PPCODE:
1020     {
1021     if (!IN_RANGE_EXC (row_number, -THIS->nsaved, THIS->nrow))
1022 root 1.19 XSRETURN_EMPTY;
1023 root 1.8
1024     line_t &l = ROW(row_number);
1025    
1026     if (GIMME_V != G_VOID)
1027     {
1028     AV *av = newAV ();
1029    
1030     av_extend (av, THIS->ncol - 1);
1031     for (int col = 0; col < THIS->ncol; col++)
1032     av_store (av, col, newSViv (l.r [col]));
1033    
1034     XPUSHs (sv_2mortal (newRV_noinc ((SV *)av)));
1035     }
1036    
1037     if (new_rend)
1038     {
1039     if (!SvROK (new_rend) || SvTYPE (SvRV (new_rend)) != SVt_PVAV)
1040     croak ("new_rend must be arrayref");
1041    
1042     AV *av = (AV *)SvRV (new_rend);
1043 root 1.27 int len = min (av_len (av) + 1 - start_ofs, max_len);
1044 root 1.8
1045 root 1.10 if (!IN_RANGE_INC (start_col, 0, THIS->ncol - len))
1046     croak ("new_rend array extends beyond horizontal margins");
1047 root 1.8
1048     for (int col = start_col; col < start_col + len; col++)
1049     {
1050 root 1.27 rend_t r = SvIV (*av_fetch (av, start_ofs + col - start_col, 1)) & ~RS_fontMask;
1051 root 1.8
1052     l.r [col] = SET_FONT (r, THIS->fontset [GET_STYLE (r)]->find_font (l.t [col]));
1053     }
1054     }
1055     }
1056    
1057     int
1058 root 1.26 rxvt_term::ROW_l (int row_number, int new_length = -1)
1059 root 1.8 CODE:
1060     {
1061     if (!IN_RANGE_EXC (row_number, -THIS->nsaved, THIS->nrow))
1062 root 1.19 XSRETURN_EMPTY;
1063 root 1.8
1064     line_t &l = ROW(row_number);
1065 root 1.26 RETVAL = l.l;
1066 root 1.8
1067 root 1.26 if (new_length >= 0)
1068 root 1.8 l.l = new_length;
1069     }
1070     OUTPUT:
1071     RETVAL
1072    
1073 root 1.19 bool
1074 root 1.26 rxvt_term::ROW_is_longer (int row_number, int new_is_longer = -1)
1075 root 1.19 CODE:
1076     {
1077     if (!IN_RANGE_EXC (row_number, -THIS->nsaved, THIS->nrow))
1078     XSRETURN_EMPTY;
1079    
1080     line_t &l = ROW(row_number);
1081 root 1.26 RETVAL = l.is_longer ();
1082    
1083     if (new_is_longer >= 0)
1084     l.is_longer (new_is_longer);
1085 root 1.19 }
1086     OUTPUT:
1087     RETVAL
1088    
1089 root 1.8 SV *
1090 root 1.33 rxvt_term::special_encode (SV *string)
1091 root 1.8 CODE:
1092 root 1.33 {
1093     wchar_t *wstr = sv2wcs (string);
1094     int wlen = wcslen (wstr);
1095     wchar_t *rstr = new wchar_t [wlen]; // cannot become longer
1096    
1097     rxvt_push_locale (THIS->locale);
1098    
1099     wchar_t *r = rstr;
1100     for (wchar_t *s = wstr; *s; s++)
1101     if (wcwidth (*s) == 0)
1102     {
1103     if (r == rstr)
1104     croak ("leading combining character unencodable");
1105    
1106     unicode_t n = rxvt_compose (r[-1], *s);
1107     if (n == NOCHAR)
1108     n = rxvt_composite.compose (r[-1], *s);
1109    
1110     r[-1] = n;
1111     }
1112     #if !UNICODE_3
1113     else if (*s >= 0x10000)
1114     *r++ = rxvt_composite.compose (*s);
1115     #endif
1116     else
1117     *r++ = *s;
1118    
1119     rxvt_pop_locale ();
1120    
1121 root 1.42 RETVAL = taint_if (wcs2sv (rstr, r - rstr), string);
1122 root 1.33
1123     delete [] rstr;
1124     }
1125     OUTPUT:
1126     RETVAL
1127 root 1.8
1128     SV *
1129 root 1.33 rxvt_term::special_decode (SV *text)
1130 root 1.8 CODE:
1131 root 1.33 {
1132     wchar_t *wstr = sv2wcs (text);
1133     int wlen = wcslen (wstr);
1134     int dlen = 0;
1135    
1136     // find length
1137     for (wchar_t *s = wstr; *s; s++)
1138     if (*s == NOCHAR)
1139     ;
1140     else if (IS_COMPOSE (*s))
1141     dlen += rxvt_composite.expand (*s, 0);
1142     else
1143     dlen++;
1144    
1145     wchar_t *rstr = new wchar_t [dlen];
1146    
1147     // decode
1148     wchar_t *r = rstr;
1149     for (wchar_t *s = wstr; *s; s++)
1150     if (*s == NOCHAR)
1151     ;
1152     else if (IS_COMPOSE (*s))
1153     r += rxvt_composite.expand (*s, r);
1154     else
1155     *r++ = *s;
1156    
1157 root 1.42 RETVAL = taint_if (wcs2sv (rstr, r - rstr), text);
1158 root 1.33
1159     delete [] rstr;
1160     }
1161     OUTPUT:
1162     RETVAL
1163 root 1.8
1164 root 1.1 void
1165 root 1.2 rxvt_term::_resource (char *name, int index, SV *newval = 0)
1166     PPCODE:
1167     {
1168     struct resval { const char *name; int value; } rslist [] = {
1169 root 1.21 # define def(name) { # name, Rs_ ## name },
1170     # define reserve(name,count)
1171 root 1.2 # include "rsinc.h"
1172 root 1.21 # undef def
1173     # undef reserve
1174 root 1.2 };
1175    
1176     struct resval *rs = rslist + sizeof (rslist) / sizeof (rslist [0]);
1177    
1178     do {
1179     if (rs-- == rslist)
1180     croak ("no such resource '%s', requested", name);
1181     } while (strcmp (name, rs->name));
1182    
1183     index += rs->value;
1184    
1185     if (!IN_RANGE_EXC (index, 0, NUM_RESOURCES))
1186     croak ("requested out-of-bound resource %s+%d,", name, index - rs->value);
1187    
1188     if (GIMME_V != G_VOID)
1189 root 1.42 XPUSHs (THIS->rs [index] ? sv_2mortal (taint (newSVpv (THIS->rs [index], 0))) : &PL_sv_undef);
1190 root 1.2
1191     if (newval)
1192     {
1193     if (SvOK (newval))
1194     {
1195     char *str = strdup (SvPVbyte_nolen (newval));
1196     THIS->rs [index] = str;
1197     THIS->allocated.push_back (str);
1198     }
1199     else
1200     THIS->rs [index] = 0;
1201     }
1202     }
1203    
1204 root 1.40 bool
1205     rxvt_term::option (U32 optval, int set = -1)
1206     CODE:
1207     {
1208     RETVAL = THIS->options & optval;
1209    
1210     if (set >= 0)
1211     {
1212     if (set)
1213     THIS->options |= optval;
1214     else
1215     THIS->options &= ~optval;
1216    
1217     switch (optval)
1218     {
1219     case Opt_skipBuiltinGlyphs:
1220     THIS->set_fonts ();
1221     THIS->scr_remap_chars ();
1222     THIS->scr_touch (true);
1223     THIS->want_refresh = 1;
1224     break;
1225    
1226     case Opt_cursorUnderline:
1227     THIS->want_refresh = 1;
1228     break;
1229    
1230     # case Opt_scrollBar_floating:
1231     # case Opt_scrollBar_right:
1232     # THIS->resize_all_windows (THIS->width, THIS->height, 1);
1233     # break;
1234     }
1235     }
1236     }
1237     OUTPUT:
1238     RETVAL
1239    
1240 root 1.2 void
1241 root 1.46 rxvt_term::screen_cur (...)
1242 root 1.1 PROTOTYPE: $;$$
1243     ALIAS:
1244 root 1.24 screen_cur = 0
1245     selection_beg = 1
1246     selection_end = 2
1247     selection_mark = 3
1248 root 1.1 PPCODE:
1249     {
1250 root 1.24 row_col_t &rc = ix == 0 ? THIS->screen.cur
1251     : ix == 1 ? THIS->selection.beg
1252     : ix == 2 ? THIS->selection.end
1253     : THIS->selection.mark;
1254 root 1.1
1255     if (GIMME_V != G_VOID)
1256     {
1257     EXTEND (SP, 2);
1258 root 1.24 PUSHs (sv_2mortal (newSViv (rc.row)));
1259     PUSHs (sv_2mortal (newSViv (rc.col)));
1260 root 1.1 }
1261    
1262     if (items == 3)
1263     {
1264 root 1.24 rc.row = clamp (SvIV (ST (1)), -THIS->nsaved, THIS->nrow - 1);
1265     rc.col = clamp (SvIV (ST (2)), 0, THIS->ncol - 1);
1266 root 1.1
1267     if (ix)
1268     THIS->want_refresh = 1;
1269     }
1270     }
1271    
1272     int
1273 root 1.36 rxvt_term::selection_grab (U32 eventtime)
1274 root 1.1
1275     void
1276     rxvt_term::selection (SV *newtext = 0)
1277     PPCODE:
1278     {
1279     if (GIMME_V != G_VOID)
1280 root 1.45 XPUSHs (THIS->selection.text
1281     ? taint (sv_2mortal (wcs2sv (THIS->selection.text, THIS->selection.len)))
1282     : &PL_sv_undef);
1283 root 1.1
1284     if (newtext)
1285     {
1286     free (THIS->selection.text);
1287    
1288     THIS->selection.text = sv2wcs (newtext);
1289     THIS->selection.len = wcslen (THIS->selection.text);
1290     }
1291     }
1292 root 1.24
1293 root 1.1 void
1294 root 1.25 rxvt_term::scr_add_lines (SV *string)
1295     CODE:
1296     {
1297     wchar_t *wstr = sv2wcs (string);
1298 root 1.32 THIS->scr_add_lines (wstr, wcslen (wstr));
1299 root 1.25 free (wstr);
1300     }
1301    
1302     void
1303 root 1.13 rxvt_term::tt_write (SV *octets)
1304     INIT:
1305     STRLEN len;
1306     char *str = SvPVbyte (octets, len);
1307     C_ARGS:
1308 root 1.23 str, len
1309 root 1.13
1310 root 1.28 void
1311     rxvt_term::cmd_parse (SV *octets)
1312     CODE:
1313     {
1314     STRLEN len;
1315     char *str = SvPVbyte (octets, len);
1316    
1317     char *old_cmdbuf_ptr = THIS->cmdbuf_ptr;
1318     char *old_cmdbuf_endp = THIS->cmdbuf_endp;
1319    
1320     THIS->cmdbuf_ptr = str;
1321     THIS->cmdbuf_endp = str + len;
1322    
1323 root 1.35 rxvt_push_locale (THIS->locale);
1324 root 1.28 THIS->cmd_parse ();
1325 root 1.35 rxvt_pop_locale ();
1326 root 1.28
1327     THIS->cmdbuf_ptr = old_cmdbuf_ptr;
1328     THIS->cmdbuf_endp = old_cmdbuf_endp;
1329     }
1330    
1331 root 1.13 SV *
1332     rxvt_term::overlay (int x, int y, int w, int h, int rstyle = OVERLAY_RSTYLE, int border = 2)
1333     CODE:
1334     {
1335     overlay *o = new overlay (THIS, x, y, w, h, rstyle, border);
1336     RETVAL = newSVptr ((void *)o, "urxvt::overlay");
1337     o->self = (HV *)SvRV (RETVAL);
1338     }
1339     OUTPUT:
1340     RETVAL
1341    
1342     MODULE = urxvt PACKAGE = urxvt::overlay
1343 root 1.1
1344     void
1345 root 1.13 overlay::set (int x, int y, SV *text, SV *rend = 0)
1346 root 1.1
1347     void
1348 root 1.18 overlay::show ()
1349    
1350     void
1351     overlay::hide ()
1352    
1353     void
1354 root 1.13 overlay::DESTROY ()
1355 root 1.1
1356     MODULE = urxvt PACKAGE = urxvt::timer
1357    
1358     SV *
1359     timer::new ()
1360     CODE:
1361     timer *w = new timer;
1362 root 1.13 w->start (NOW);
1363 root 1.1 RETVAL = newSVptr ((void *)w, "urxvt::timer");
1364     w->self = (HV *)SvRV (RETVAL);
1365     OUTPUT:
1366     RETVAL
1367    
1368     timer *
1369     timer::cb (SV *cb)
1370     CODE:
1371     THIS->cb (cb);
1372     RETVAL = THIS;
1373     OUTPUT:
1374     RETVAL
1375    
1376     NV
1377     timer::at ()
1378     CODE:
1379     RETVAL = THIS->at;
1380     OUTPUT:
1381     RETVAL
1382    
1383     timer *
1384 root 1.13 timer::interval (NV interval)
1385     CODE:
1386     THIS->interval = interval;
1387     RETVAL = THIS;
1388     OUTPUT:
1389     RETVAL
1390    
1391     timer *
1392 root 1.1 timer::set (NV tstamp)
1393     CODE:
1394     THIS->set (tstamp);
1395     RETVAL = THIS;
1396     OUTPUT:
1397     RETVAL
1398    
1399     timer *
1400     timer::start (NV tstamp = THIS->at)
1401     CODE:
1402     THIS->start (tstamp);
1403     RETVAL = THIS;
1404     OUTPUT:
1405     RETVAL
1406    
1407     timer *
1408     timer::stop ()
1409     CODE:
1410     THIS->stop ();
1411     RETVAL = THIS;
1412     OUTPUT:
1413     RETVAL
1414    
1415     void
1416     timer::DESTROY ()
1417    
1418     MODULE = urxvt PACKAGE = urxvt::iow
1419    
1420     SV *
1421     iow::new ()
1422     CODE:
1423     iow *w = new iow;
1424     RETVAL = newSVptr ((void *)w, "urxvt::iow");
1425     w->self = (HV *)SvRV (RETVAL);
1426     OUTPUT:
1427     RETVAL
1428    
1429     iow *
1430     iow::cb (SV *cb)
1431     CODE:
1432     THIS->cb (cb);
1433     RETVAL = THIS;
1434     OUTPUT:
1435     RETVAL
1436    
1437     iow *
1438     iow::fd (int fd)
1439     CODE:
1440     THIS->fd = fd;
1441     RETVAL = THIS;
1442     OUTPUT:
1443     RETVAL
1444    
1445     iow *
1446     iow::events (short events)
1447     CODE:
1448     THIS->events = events;
1449     RETVAL = THIS;
1450     OUTPUT:
1451     RETVAL
1452    
1453     iow *
1454     iow::start ()
1455     CODE:
1456     THIS->start ();
1457     RETVAL = THIS;
1458     OUTPUT:
1459     RETVAL
1460    
1461     iow *
1462     iow::stop ()
1463     CODE:
1464     THIS->stop ();
1465     RETVAL = THIS;
1466     OUTPUT:
1467     RETVAL
1468    
1469     void
1470     iow::DESTROY ()
1471    
1472