ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/rxvtperl.xs
Revision: 1.47
Committed: Mon Jan 9 02:06:43 2006 UTC (18 years, 5 months ago) by root
Branch: MAIN
Changes since 1.46: +7 -0 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.47 bool
721     safe ()
722     CODE:
723     RETVAL = !rxvt_tainted ();
724     OUTPUT:
725     RETVAL
726    
727 root 1.3 NV
728     NOW ()
729     CODE:
730     RETVAL = NOW;
731     OUTPUT:
732     RETVAL
733    
734 root 1.11 int
735     GET_BASEFG (int rend)
736     CODE:
737     RETVAL = GET_BASEFG (rend);
738     OUTPUT:
739     RETVAL
740    
741     int
742     GET_BASEBG (int rend)
743     CODE:
744     RETVAL = GET_BASEBG (rend);
745     OUTPUT:
746     RETVAL
747    
748     int
749 root 1.12 SET_FGCOLOR (int rend, int new_color)
750 root 1.11 CODE:
751 root 1.12 RETVAL = SET_FGCOLOR (rend, new_color);
752 root 1.11 OUTPUT:
753     RETVAL
754    
755     int
756 root 1.12 SET_BGCOLOR (int rend, int new_color)
757 root 1.11 CODE:
758 root 1.12 RETVAL = SET_BGCOLOR (rend, new_color);
759     OUTPUT:
760     RETVAL
761    
762     int
763     GET_CUSTOM (int rend)
764     CODE:
765     RETVAL = (rend && RS_customMask) >> RS_customShift;
766     OUTPUT:
767     RETVAL
768    
769     int
770     SET_CUSTOM (int rend, int new_value)
771     CODE:
772     {
773     if (!IN_RANGE_EXC (new_value, 0, RS_customCount))
774     croak ("custom value out of range, must be 0..%d", RS_customCount - 1);
775    
776     RETVAL = (rend & ~RS_customMask)
777     | ((new_value << RS_customShift) & RS_customMask);
778     }
779 root 1.11 OUTPUT:
780     RETVAL
781    
782 root 1.3 MODULE = urxvt PACKAGE = urxvt::term
783    
784 root 1.28 void
785     rxvt_term::destroy ()
786    
787 root 1.35 void
788 root 1.36 rxvt_term::grab_button (int button, U32 modifiers)
789     CODE:
790     XGrabButton (THIS->display->display, button, modifiers, THIS->vt, 1,
791     ButtonPressMask | ButtonReleaseMask | EnterWindowMask | LeaveWindowMask | PointerMotionMask,
792 root 1.41 GrabModeSync, GrabModeSync, None, GRAB_CURSOR);
793 root 1.36
794     bool
795     rxvt_term::grab (U32 eventtime, int sync = 0)
796 root 1.35 CODE:
797     {
798 root 1.36 int mode = sync ? GrabModeSync : GrabModeAsync;
799    
800     THIS->perl.grabtime = 0;
801    
802     if (!XGrabPointer (THIS->display->display, THIS->vt, 0,
803     ButtonPressMask | ButtonReleaseMask | EnterWindowMask | LeaveWindowMask | PointerMotionMask,
804 root 1.41 mode, mode, None, GRAB_CURSOR, eventtime))
805 root 1.36 if (!XGrabKeyboard (THIS->display->display, THIS->vt, 0, mode, mode, eventtime))
806     THIS->perl.grabtime = eventtime;
807     else
808     XUngrabPointer (THIS->display->display, eventtime);
809    
810     RETVAL = !!THIS->perl.grabtime;
811 root 1.35 }
812 root 1.36 OUTPUT:
813     RETVAL
814    
815     void
816 root 1.44 rxvt_term::allow_events_async ()
817 root 1.36 CODE:
818 root 1.44 XAllowEvents (THIS->display->display, AsyncBoth, THIS->perl.grabtime);
819 root 1.36
820     void
821 root 1.44 rxvt_term::allow_events_sync ()
822 root 1.36 CODE:
823 root 1.44 XAllowEvents (THIS->display->display, SyncBoth, THIS->perl.grabtime);
824 root 1.36
825     void
826 root 1.44 rxvt_term::allow_events_replay ()
827 root 1.36 CODE:
828 root 1.44 XAllowEvents (THIS->display->display, ReplayPointer, THIS->perl.grabtime);
829     XAllowEvents (THIS->display->display, ReplayKeyboard, THIS->perl.grabtime);
830 root 1.36
831     void
832 root 1.44 rxvt_term::ungrab ()
833 root 1.36 CODE:
834 root 1.45 ungrab (THIS);
835 root 1.35
836 root 1.1 int
837 root 1.3 rxvt_term::strwidth (SV *str)
838 root 1.1 CODE:
839     {
840     wchar_t *wstr = sv2wcs (str);
841 root 1.3
842     rxvt_push_locale (THIS->locale);
843 root 1.1 RETVAL = wcswidth (wstr, wcslen (wstr));
844 root 1.3 rxvt_pop_locale ();
845    
846 root 1.1 free (wstr);
847     }
848     OUTPUT:
849     RETVAL
850    
851 root 1.3 SV *
852     rxvt_term::locale_encode (SV *str)
853 root 1.1 CODE:
854 root 1.3 {
855     wchar_t *wstr = sv2wcs (str);
856    
857     rxvt_push_locale (THIS->locale);
858     char *mbstr = rxvt_wcstombs (wstr);
859     rxvt_pop_locale ();
860    
861     free (wstr);
862    
863 root 1.42 RETVAL = taint_if (newSVpv (mbstr, 0), str);
864 root 1.3 free (mbstr);
865     }
866     OUTPUT:
867 root 1.1 RETVAL
868    
869 root 1.3 SV *
870     rxvt_term::locale_decode (SV *octets)
871     CODE:
872     {
873     STRLEN len;
874     char *data = SvPVbyte (octets, len);
875    
876     rxvt_push_locale (THIS->locale);
877     wchar_t *wstr = rxvt_mbstowcs (data, len);
878     rxvt_pop_locale ();
879    
880 root 1.42 RETVAL = taint_if (wcs2sv (wstr), octets);
881 root 1.3 free (wstr);
882     }
883     OUTPUT:
884     RETVAL
885 root 1.1
886 root 1.38 #define TERM_OFFSET(sym) offsetof (TermWin_t, sym)
887 root 1.24
888     #define TERM_OFFSET_width TERM_OFFSET(width)
889     #define TERM_OFFSET_height TERM_OFFSET(height)
890     #define TERM_OFFSET_fwidth TERM_OFFSET(fwidth)
891     #define TERM_OFFSET_fheight TERM_OFFSET(fheight)
892     #define TERM_OFFSET_fbase TERM_OFFSET(fbase)
893     #define TERM_OFFSET_nrow TERM_OFFSET(nrow)
894     #define TERM_OFFSET_ncol TERM_OFFSET(ncol)
895     #define TERM_OFFSET_focus TERM_OFFSET(focus)
896     #define TERM_OFFSET_mapped TERM_OFFSET(mapped)
897     #define TERM_OFFSET_saveLines TERM_OFFSET(saveLines)
898     #define TERM_OFFSET_total_rows TERM_OFFSET(total_rows)
899     #define TERM_OFFSET_nsaved TERM_OFFSET(nsaved)
900    
901     int
902     rxvt_term::width ()
903     ALIAS:
904     width = TERM_OFFSET_width
905     height = TERM_OFFSET_height
906     fwidth = TERM_OFFSET_fwidth
907     fheight = TERM_OFFSET_fheight
908     fbase = TERM_OFFSET_fbase
909     nrow = TERM_OFFSET_nrow
910     ncol = TERM_OFFSET_ncol
911     focus = TERM_OFFSET_focus
912     mapped = TERM_OFFSET_mapped
913     saveLines = TERM_OFFSET_saveLines
914     total_rows = TERM_OFFSET_total_rows
915     nsaved = TERM_OFFSET_nsaved
916     CODE:
917     RETVAL = *(int *)((char *)THIS + ix);
918     OUTPUT:
919     RETVAL
920    
921 root 1.38 unsigned int
922     rxvt_term::ModLevel3Mask ()
923     ALIAS:
924     ModLevel3Mask = 0
925     ModMetaMask = 1
926     ModNumLockMask = 2
927     CODE:
928     switch (ix)
929     {
930     case 0: RETVAL = THIS->ModLevel3Mask; break;
931     case 1: RETVAL = THIS->ModMetaMask; break;
932     case 2: RETVAL = THIS->ModNumLockMask; break;
933     }
934     OUTPUT:
935     RETVAL
936    
937 root 1.24 U32
938 root 1.31 rxvt_term::parent ()
939     CODE:
940     RETVAL = (U32)THIS->parent [0];
941     OUTPUT:
942     RETVAL
943    
944     U32
945 root 1.30 rxvt_term::vt ()
946     CODE:
947 root 1.31 RETVAL = (U32)THIS->vt;
948 root 1.30 OUTPUT:
949     RETVAL
950    
951     U32
952 root 1.25 rxvt_term::rstyle (U32 new_rstyle = THIS->rstyle)
953 root 1.7 CODE:
954 root 1.24 {
955 root 1.25 RETVAL = THIS->rstyle;
956     THIS->rstyle = new_rstyle;
957 root 1.24 }
958 root 1.7 OUTPUT:
959 root 1.24 RETVAL
960 root 1.7
961     int
962     rxvt_term::view_start (int newval = -1)
963     CODE:
964     {
965     RETVAL = THIS->view_start;
966    
967     if (newval >= 0)
968     {
969     THIS->view_start = min (newval, THIS->nsaved);
970     THIS->scr_changeview (RETVAL);
971     }
972     }
973     OUTPUT:
974     RETVAL
975    
976 root 1.8 void
977 root 1.9 rxvt_term::want_refresh ()
978     CODE:
979     THIS->want_refresh = 1;
980    
981     void
982 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)
983 root 1.8 PPCODE:
984     {
985     if (!IN_RANGE_EXC (row_number, -THIS->nsaved, THIS->nrow))
986 root 1.19 XSRETURN_EMPTY;
987 root 1.8
988     line_t &l = ROW(row_number);
989    
990     if (GIMME_V != G_VOID)
991     {
992     wchar_t *wstr = new wchar_t [THIS->ncol];
993    
994 root 1.33 for (int col = 0; col < THIS->ncol; col++)
995 root 1.8 wstr [col] = l.t [col];
996    
997 root 1.42 XPUSHs (taint (sv_2mortal (wcs2sv (wstr, THIS->ncol))));
998 root 1.8
999 root 1.25 delete [] wstr;
1000 root 1.8 }
1001    
1002     if (new_text)
1003     {
1004 root 1.13 wchar_t *wstr = sv2wcs (new_text);
1005 root 1.8
1006 root 1.27 int len = min (wcslen (wstr) - start_ofs, max_len);
1007 root 1.8
1008 root 1.10 if (!IN_RANGE_INC (start_col, 0, THIS->ncol - len))
1009 root 1.8 {
1010     free (wstr);
1011 root 1.10 croak ("new_text extends beyond horizontal margins");
1012 root 1.8 }
1013    
1014     for (int col = start_col; col < start_col + len; col++)
1015     {
1016 root 1.27 l.t [col] = wstr [start_ofs + col - start_col];
1017 root 1.8 l.r [col] = SET_FONT (l.r [col], THIS->fontset [GET_STYLE (l.r [col])]->find_font (l.t [col]));
1018     }
1019 root 1.9
1020     free (wstr);
1021 root 1.8 }
1022     }
1023    
1024     void
1025 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)
1026 root 1.8 PPCODE:
1027     {
1028     if (!IN_RANGE_EXC (row_number, -THIS->nsaved, THIS->nrow))
1029 root 1.19 XSRETURN_EMPTY;
1030 root 1.8
1031     line_t &l = ROW(row_number);
1032    
1033     if (GIMME_V != G_VOID)
1034     {
1035     AV *av = newAV ();
1036    
1037     av_extend (av, THIS->ncol - 1);
1038     for (int col = 0; col < THIS->ncol; col++)
1039     av_store (av, col, newSViv (l.r [col]));
1040    
1041     XPUSHs (sv_2mortal (newRV_noinc ((SV *)av)));
1042     }
1043    
1044     if (new_rend)
1045     {
1046     if (!SvROK (new_rend) || SvTYPE (SvRV (new_rend)) != SVt_PVAV)
1047     croak ("new_rend must be arrayref");
1048    
1049     AV *av = (AV *)SvRV (new_rend);
1050 root 1.27 int len = min (av_len (av) + 1 - start_ofs, max_len);
1051 root 1.8
1052 root 1.10 if (!IN_RANGE_INC (start_col, 0, THIS->ncol - len))
1053     croak ("new_rend array extends beyond horizontal margins");
1054 root 1.8
1055     for (int col = start_col; col < start_col + len; col++)
1056     {
1057 root 1.27 rend_t r = SvIV (*av_fetch (av, start_ofs + col - start_col, 1)) & ~RS_fontMask;
1058 root 1.8
1059     l.r [col] = SET_FONT (r, THIS->fontset [GET_STYLE (r)]->find_font (l.t [col]));
1060     }
1061     }
1062     }
1063    
1064     int
1065 root 1.26 rxvt_term::ROW_l (int row_number, int new_length = -1)
1066 root 1.8 CODE:
1067     {
1068     if (!IN_RANGE_EXC (row_number, -THIS->nsaved, THIS->nrow))
1069 root 1.19 XSRETURN_EMPTY;
1070 root 1.8
1071     line_t &l = ROW(row_number);
1072 root 1.26 RETVAL = l.l;
1073 root 1.8
1074 root 1.26 if (new_length >= 0)
1075 root 1.8 l.l = new_length;
1076     }
1077     OUTPUT:
1078     RETVAL
1079    
1080 root 1.19 bool
1081 root 1.26 rxvt_term::ROW_is_longer (int row_number, int new_is_longer = -1)
1082 root 1.19 CODE:
1083     {
1084     if (!IN_RANGE_EXC (row_number, -THIS->nsaved, THIS->nrow))
1085     XSRETURN_EMPTY;
1086    
1087     line_t &l = ROW(row_number);
1088 root 1.26 RETVAL = l.is_longer ();
1089    
1090     if (new_is_longer >= 0)
1091     l.is_longer (new_is_longer);
1092 root 1.19 }
1093     OUTPUT:
1094     RETVAL
1095    
1096 root 1.8 SV *
1097 root 1.33 rxvt_term::special_encode (SV *string)
1098 root 1.8 CODE:
1099 root 1.33 {
1100     wchar_t *wstr = sv2wcs (string);
1101     int wlen = wcslen (wstr);
1102     wchar_t *rstr = new wchar_t [wlen]; // cannot become longer
1103    
1104     rxvt_push_locale (THIS->locale);
1105    
1106     wchar_t *r = rstr;
1107     for (wchar_t *s = wstr; *s; s++)
1108     if (wcwidth (*s) == 0)
1109     {
1110     if (r == rstr)
1111     croak ("leading combining character unencodable");
1112    
1113     unicode_t n = rxvt_compose (r[-1], *s);
1114     if (n == NOCHAR)
1115     n = rxvt_composite.compose (r[-1], *s);
1116    
1117     r[-1] = n;
1118     }
1119     #if !UNICODE_3
1120     else if (*s >= 0x10000)
1121     *r++ = rxvt_composite.compose (*s);
1122     #endif
1123     else
1124     *r++ = *s;
1125    
1126     rxvt_pop_locale ();
1127    
1128 root 1.42 RETVAL = taint_if (wcs2sv (rstr, r - rstr), string);
1129 root 1.33
1130     delete [] rstr;
1131     }
1132     OUTPUT:
1133     RETVAL
1134 root 1.8
1135     SV *
1136 root 1.33 rxvt_term::special_decode (SV *text)
1137 root 1.8 CODE:
1138 root 1.33 {
1139     wchar_t *wstr = sv2wcs (text);
1140     int wlen = wcslen (wstr);
1141     int dlen = 0;
1142    
1143     // find length
1144     for (wchar_t *s = wstr; *s; s++)
1145     if (*s == NOCHAR)
1146     ;
1147     else if (IS_COMPOSE (*s))
1148     dlen += rxvt_composite.expand (*s, 0);
1149     else
1150     dlen++;
1151    
1152     wchar_t *rstr = new wchar_t [dlen];
1153    
1154     // decode
1155     wchar_t *r = rstr;
1156     for (wchar_t *s = wstr; *s; s++)
1157     if (*s == NOCHAR)
1158     ;
1159     else if (IS_COMPOSE (*s))
1160     r += rxvt_composite.expand (*s, r);
1161     else
1162     *r++ = *s;
1163    
1164 root 1.42 RETVAL = taint_if (wcs2sv (rstr, r - rstr), text);
1165 root 1.33
1166     delete [] rstr;
1167     }
1168     OUTPUT:
1169     RETVAL
1170 root 1.8
1171 root 1.1 void
1172 root 1.2 rxvt_term::_resource (char *name, int index, SV *newval = 0)
1173     PPCODE:
1174     {
1175     struct resval { const char *name; int value; } rslist [] = {
1176 root 1.21 # define def(name) { # name, Rs_ ## name },
1177     # define reserve(name,count)
1178 root 1.2 # include "rsinc.h"
1179 root 1.21 # undef def
1180     # undef reserve
1181 root 1.2 };
1182    
1183     struct resval *rs = rslist + sizeof (rslist) / sizeof (rslist [0]);
1184    
1185     do {
1186     if (rs-- == rslist)
1187     croak ("no such resource '%s', requested", name);
1188     } while (strcmp (name, rs->name));
1189    
1190     index += rs->value;
1191    
1192     if (!IN_RANGE_EXC (index, 0, NUM_RESOURCES))
1193     croak ("requested out-of-bound resource %s+%d,", name, index - rs->value);
1194    
1195     if (GIMME_V != G_VOID)
1196 root 1.42 XPUSHs (THIS->rs [index] ? sv_2mortal (taint (newSVpv (THIS->rs [index], 0))) : &PL_sv_undef);
1197 root 1.2
1198     if (newval)
1199     {
1200     if (SvOK (newval))
1201     {
1202     char *str = strdup (SvPVbyte_nolen (newval));
1203     THIS->rs [index] = str;
1204     THIS->allocated.push_back (str);
1205     }
1206     else
1207     THIS->rs [index] = 0;
1208     }
1209     }
1210    
1211 root 1.40 bool
1212     rxvt_term::option (U32 optval, int set = -1)
1213     CODE:
1214     {
1215     RETVAL = THIS->options & optval;
1216    
1217     if (set >= 0)
1218     {
1219     if (set)
1220     THIS->options |= optval;
1221     else
1222     THIS->options &= ~optval;
1223    
1224     switch (optval)
1225     {
1226     case Opt_skipBuiltinGlyphs:
1227     THIS->set_fonts ();
1228     THIS->scr_remap_chars ();
1229     THIS->scr_touch (true);
1230     THIS->want_refresh = 1;
1231     break;
1232    
1233     case Opt_cursorUnderline:
1234     THIS->want_refresh = 1;
1235     break;
1236    
1237     # case Opt_scrollBar_floating:
1238     # case Opt_scrollBar_right:
1239     # THIS->resize_all_windows (THIS->width, THIS->height, 1);
1240     # break;
1241     }
1242     }
1243     }
1244     OUTPUT:
1245     RETVAL
1246    
1247 root 1.2 void
1248 root 1.46 rxvt_term::screen_cur (...)
1249 root 1.1 PROTOTYPE: $;$$
1250     ALIAS:
1251 root 1.24 screen_cur = 0
1252     selection_beg = 1
1253     selection_end = 2
1254     selection_mark = 3
1255 root 1.1 PPCODE:
1256     {
1257 root 1.24 row_col_t &rc = ix == 0 ? THIS->screen.cur
1258     : ix == 1 ? THIS->selection.beg
1259     : ix == 2 ? THIS->selection.end
1260     : THIS->selection.mark;
1261 root 1.1
1262     if (GIMME_V != G_VOID)
1263     {
1264     EXTEND (SP, 2);
1265 root 1.24 PUSHs (sv_2mortal (newSViv (rc.row)));
1266     PUSHs (sv_2mortal (newSViv (rc.col)));
1267 root 1.1 }
1268    
1269     if (items == 3)
1270     {
1271 root 1.24 rc.row = clamp (SvIV (ST (1)), -THIS->nsaved, THIS->nrow - 1);
1272     rc.col = clamp (SvIV (ST (2)), 0, THIS->ncol - 1);
1273 root 1.1
1274     if (ix)
1275     THIS->want_refresh = 1;
1276     }
1277     }
1278    
1279     int
1280 root 1.36 rxvt_term::selection_grab (U32 eventtime)
1281 root 1.1
1282     void
1283     rxvt_term::selection (SV *newtext = 0)
1284     PPCODE:
1285     {
1286     if (GIMME_V != G_VOID)
1287 root 1.45 XPUSHs (THIS->selection.text
1288     ? taint (sv_2mortal (wcs2sv (THIS->selection.text, THIS->selection.len)))
1289     : &PL_sv_undef);
1290 root 1.1
1291     if (newtext)
1292     {
1293     free (THIS->selection.text);
1294    
1295     THIS->selection.text = sv2wcs (newtext);
1296     THIS->selection.len = wcslen (THIS->selection.text);
1297     }
1298     }
1299 root 1.24
1300 root 1.1 void
1301 root 1.25 rxvt_term::scr_add_lines (SV *string)
1302     CODE:
1303     {
1304     wchar_t *wstr = sv2wcs (string);
1305 root 1.32 THIS->scr_add_lines (wstr, wcslen (wstr));
1306 root 1.25 free (wstr);
1307     }
1308    
1309     void
1310 root 1.13 rxvt_term::tt_write (SV *octets)
1311     INIT:
1312     STRLEN len;
1313     char *str = SvPVbyte (octets, len);
1314     C_ARGS:
1315 root 1.23 str, len
1316 root 1.13
1317 root 1.28 void
1318     rxvt_term::cmd_parse (SV *octets)
1319     CODE:
1320     {
1321     STRLEN len;
1322     char *str = SvPVbyte (octets, len);
1323    
1324     char *old_cmdbuf_ptr = THIS->cmdbuf_ptr;
1325     char *old_cmdbuf_endp = THIS->cmdbuf_endp;
1326    
1327     THIS->cmdbuf_ptr = str;
1328     THIS->cmdbuf_endp = str + len;
1329    
1330 root 1.35 rxvt_push_locale (THIS->locale);
1331 root 1.28 THIS->cmd_parse ();
1332 root 1.35 rxvt_pop_locale ();
1333 root 1.28
1334     THIS->cmdbuf_ptr = old_cmdbuf_ptr;
1335     THIS->cmdbuf_endp = old_cmdbuf_endp;
1336     }
1337    
1338 root 1.13 SV *
1339     rxvt_term::overlay (int x, int y, int w, int h, int rstyle = OVERLAY_RSTYLE, int border = 2)
1340     CODE:
1341     {
1342     overlay *o = new overlay (THIS, x, y, w, h, rstyle, border);
1343     RETVAL = newSVptr ((void *)o, "urxvt::overlay");
1344     o->self = (HV *)SvRV (RETVAL);
1345     }
1346     OUTPUT:
1347     RETVAL
1348    
1349     MODULE = urxvt PACKAGE = urxvt::overlay
1350 root 1.1
1351     void
1352 root 1.13 overlay::set (int x, int y, SV *text, SV *rend = 0)
1353 root 1.1
1354     void
1355 root 1.18 overlay::show ()
1356    
1357     void
1358     overlay::hide ()
1359    
1360     void
1361 root 1.13 overlay::DESTROY ()
1362 root 1.1
1363     MODULE = urxvt PACKAGE = urxvt::timer
1364    
1365     SV *
1366     timer::new ()
1367     CODE:
1368     timer *w = new timer;
1369 root 1.13 w->start (NOW);
1370 root 1.1 RETVAL = newSVptr ((void *)w, "urxvt::timer");
1371     w->self = (HV *)SvRV (RETVAL);
1372     OUTPUT:
1373     RETVAL
1374    
1375     timer *
1376     timer::cb (SV *cb)
1377     CODE:
1378     THIS->cb (cb);
1379     RETVAL = THIS;
1380     OUTPUT:
1381     RETVAL
1382    
1383     NV
1384     timer::at ()
1385     CODE:
1386     RETVAL = THIS->at;
1387     OUTPUT:
1388     RETVAL
1389    
1390     timer *
1391 root 1.13 timer::interval (NV interval)
1392     CODE:
1393     THIS->interval = interval;
1394     RETVAL = THIS;
1395     OUTPUT:
1396     RETVAL
1397    
1398     timer *
1399 root 1.1 timer::set (NV tstamp)
1400     CODE:
1401     THIS->set (tstamp);
1402     RETVAL = THIS;
1403     OUTPUT:
1404     RETVAL
1405    
1406     timer *
1407     timer::start (NV tstamp = THIS->at)
1408     CODE:
1409     THIS->start (tstamp);
1410     RETVAL = THIS;
1411     OUTPUT:
1412     RETVAL
1413    
1414     timer *
1415     timer::stop ()
1416     CODE:
1417     THIS->stop ();
1418     RETVAL = THIS;
1419     OUTPUT:
1420     RETVAL
1421    
1422     void
1423     timer::DESTROY ()
1424    
1425     MODULE = urxvt PACKAGE = urxvt::iow
1426    
1427     SV *
1428     iow::new ()
1429     CODE:
1430     iow *w = new iow;
1431     RETVAL = newSVptr ((void *)w, "urxvt::iow");
1432     w->self = (HV *)SvRV (RETVAL);
1433     OUTPUT:
1434     RETVAL
1435    
1436     iow *
1437     iow::cb (SV *cb)
1438     CODE:
1439     THIS->cb (cb);
1440     RETVAL = THIS;
1441     OUTPUT:
1442     RETVAL
1443    
1444     iow *
1445     iow::fd (int fd)
1446     CODE:
1447     THIS->fd = fd;
1448     RETVAL = THIS;
1449     OUTPUT:
1450     RETVAL
1451    
1452     iow *
1453     iow::events (short events)
1454     CODE:
1455     THIS->events = events;
1456     RETVAL = THIS;
1457     OUTPUT:
1458     RETVAL
1459    
1460     iow *
1461     iow::start ()
1462     CODE:
1463     THIS->start ();
1464     RETVAL = THIS;
1465     OUTPUT:
1466     RETVAL
1467    
1468     iow *
1469     iow::stop ()
1470     CODE:
1471     THIS->stop ();
1472     RETVAL = THIS;
1473     OUTPUT:
1474     RETVAL
1475    
1476     void
1477     iow::DESTROY ()
1478    
1479