chiark / gitweb /
rationalise borders, comments, etc
[chiark-tcl-applet.git] / applet.tcl
index ce2550775804b36abfa61624c0705e1191bac127..66d1a81251e26ae700dc02f056bacd57d5fe2b93 100644 (file)
@@ -17,34 +17,71 @@ package require tktray
 #
 #  tk::tktray widget is called .i
 #
-# Inner window subprocess:
+# Tooltip:
 #
-#  Caller that needs access to inner window should define
-#     proc innerwindow {} { ... }
-#  and run
-#     innerwindow
-#  This will create
-#     .i.i.b      frame to contain container
-#     .i.i.b.c    actual container
+#   Caller may call
+#      applet::setup-tooltip ON-VISIBLE ON-INVISIBLE
+#   to make applet have a tooltip.
+#
+#   ON-VISIBLE and ON-INVISIBLE will be globally eval'd
+#   when the tooltip becomes visible and invisible.
+#
+#   Caller should call
+#      applet::tooltip-set TEXT-MAYBE-MULTILINE
+#   whenever they like.
 # 
-#  Button presses
+# Button presses
 #
 #    Caller may bind .i.i <ButtonPress-$b>
 #
 #    Alternatively caller may call  applet::setup-button-menu $b
 #    which will generate a menu .m$b which the user can configure
 #    and which will automatically be posted and unposted etc.
+#    In this case the caller should arrange that all of their
+#    menus, when an item is selected, call
+#      applet::msel
+#
+# Icon:
+#
+#  Caller should call:
+#      applet::setimage IMAGE
+#  as necessary.
+#
+# Alternatively of icon, it may provide other arrangements for
+# using the provided subwindow.  Such a caller should call
+#      applet::setup-subwindow WIDTH BORDER-COLOUR BORDER-WIDTH \
+#                ON-DESTROYING ON-READY
+#  Then the main code will call ON-DESTROYING just before
+#  destroying the inner window and recreating it, and ON-READY
+#  just after.  The inner window to use is called .i.i.b.
+#
+#  The user of the subwindow machinery may call
+#      applet::subwindow-need-recreate
+#  if for any reason the inner window should be destroyed and recreated.
+#
+# Alternatively, it may request that a subprocess be spawned
+# repeatedly with the xid of a suitable window.
+#      applet::setup-subproc WIDTH BORDER-COLOUR BORDER-WIDTH \
+#                GET-CMDLINE
+#  Then the main code will call [concat GET_CMDLINE [list XID]]
+#  to get the command line to run.
 
 wm withdraw .
 
 tktray::icon .i -class example
 .i configure -docked 1
 
+fconfigure stdout -buffering line
+
 
 namespace eval applet {
 
+
+# used by both menus and tooltips
 variable posted 0
 
+#----- menus -----
+
 proc setup-button-menu {b} {
     bind .i.i <ButtonPress> { applet::menubuttonpressed %b %X %Y }
     menu .m$b -tearoff 0
@@ -73,60 +110,10 @@ proc msel {} {
     set posted 0
 }
 
-}
-
-proc innerwindow-resetup-required {why} {
-    variable innerwindow_after
-puts "IW-EVENT $why"
-    if {[info exists innerwindow_after]} return
-    set innerwindow_after [after idle innerwindow-resetup]
-}
-
-proc innerwindow-resetup {} {
-    variable innerwindow_after
-    unset innerwindow_after
-
-puts RESETUP
-
-    innerwindow-destroying
-
-    catch { destroy .i.i.c }
-    if {![winfo exists .i.i]} return
-    destroy [frame .i.i.make-exist]
-    catch { destroy .i.i.b.c }
-    catch { destroy .i.i.b }
-    frame .i.i.b
-    pack .i.i.b -fill both -side left -expand 1
-    frame .i.i.b.c -container 1 -background orange
-    pack .i.i.b.c -fill both -side left -expand 1
-#
-    global inner_lastw inner_lasth
-    #set w [winfo width .i.i]
-#    set w [winfo width .i.i]
-#    set h [winfo height .i.i]
-
-#    if {$w != $inner_lastw || $h != $inner_lasth} {
-#      set inner_lastw $w
-#      set inner_lasth $h
-#      innerwindow-ph-dummy configure -width $w -height 2
-       innerwindow-ready
-#    }
-}
-
-proc setupinnerwindow {w} {
-    global inner_lastw inner_lasth
-    set inner_lastw -2
-    set inner_lasth -2
-
-    image create photo innerwindow-ph-dummy -width $w -height 2
-    .i configure -image innerwindow-ph-dummy
-
-    destroy [frame .i.make-exist]
-    destroy [frame .i.i.make-exist]
-    bind .i <<IconConfigure>> { innerwindow-resetup-required IconConfigure }
-}
+#----- tooltips -----
 
-namespace eval applet {
+variable tooltip_on_vis {}
+variable tooltip_on_invis {}
 
 proc tooltip-starttimer {state x y} {
     variable tooltip_after
@@ -139,9 +126,11 @@ proc tooltip-starttimer {state x y} {
 
 proc tooltip-cancel {} {
     variable tooltip_after
+    variable tooltip_on_invis
     catch { after cancel $tooltip_after }
     catch { unset $tooltip_after }
     wm withdraw .tt
+    uplevel #0 $tooltip_on_invis
 }
 
 set tooltip_inwindow 0
@@ -158,7 +147,10 @@ proc tooltip-leave {} {
     tooltip-cancel
 }
 
-proc setup-tooltip {} {
+proc setup-tooltip {on_vis on_invis} {
+    foreach v {vis invis} {
+       variable tooltip_on_$v [set on_$v]
+    }
     bind .i <Enter> { applet::tooltip-enter %s %X %Y }
     bind .i <Leave> { applet::tooltip-leave }
     bind .i <ButtonRelease> { 
@@ -179,54 +171,169 @@ proc tooltip-set {s} {
 }
 
 proc tooltip-show {x y} {
+    variable tooltip_on_vis
     incr x 9
     incr y 9
     wm geometry .tt +$x+$y
     wm deiconify .tt
+    uplevel #0 $tooltip_on_vis
 }
 
-}
+#----- simple images -----
 
 proc setimage {image} {
     .i configure -image $image
 }
 
-proc fork-then {ondeath inchild} {
-    global children errorCode errorInfo
-    foreach f {stdout stderr} {
-       if {[catch { flush $f } emsg]} {
-           catch { bgerror $emsg }
-       }
+#----- subwindow -----
+
+variable subwindow_on_destroying
+variable subwindow_on_ready
+
+proc subwindow-need-recreate {} {
+    variable innerwindow_after
+puts "IW-EVENT"
+    if {[info exists innerwindow_after]} return
+    set innerwindow_after [after idle applet::innerwindow-resetup]
+}
+
+proc innerwindow-resetup {} {
+    variable innerwindow_after
+    variable subwindow_on_destroying
+    variable subwindow_on_ready
+    variable subwindow_border_colour
+    variable subwindow_border_width
+    unset innerwindow_after
+
+puts RESETUP
+
+
+    if {![winfo exists .i.i]} return
+    destroy [frame .i.i.make-exist]
+
+    uplevel #0 $subwindow_on_destroying
+    catch { destroy .i.i.b }
+
+    frame .i.i.b -background darkblue -bd 1
+    pack .i.i.b -fill both -side left -expand 1
+#
+    global inner_lastw inner_lasth
+    #set w [winfo width .i.i]
+#    set w [winfo width .i.i]
+#    set h [winfo height .i.i]
+
+#    if {$w != $inner_lastw || $h != $inner_lasth} {
+#      set inner_lastw $w
+#      set inner_lasth $h
+#      innerwindow-ph-dummy configure -width $w -height 2
+
+    uplevel #0 $subwindow_on_ready
+#    }
+}
+
+proc setup-subwindow {w border_colour border_width on_destroying on_ready} {
+    foreach v {border_width border_colour on_destroying on_ready} {
+       variable subwindow_$v [set $v]
     }
-    set pid [fork]
-    if {!$pid} { 
-       if {[catch { 
-           uplevel 1 $inchild
-       } emsg]} {
-           puts stderr "CHILD ERROR $emsg\n$errorCode\n$errorInfo\n"
+
+    global inner_lastw inner_lasth
+    set inner_lastw -2
+    set inner_lasth -2
+
+    image create photo applet::innerwindow-ph-dummy -width $w -height 2
+    .i configure -image applet::innerwindow-ph-dummy
+
+    destroy [frame .i.make-exist]
+    destroy [frame .i.i.make-exist]
+    bind .i <<IconConfigure>> { 
+       applet::subwindow-need-recreate
+    }
+}
+
+#----- subprocess -----
+
+variable subproc none
+variable ratelimit {}
+
+proc setup-subproc {w border_colour border_width get_cmdline} {
+    variable subproc_get_cmdline $get_cmdline
+    setup-subwindow $w $border_colour $border_width \
+       applet::subproc-destroying applet::subproc-ready
+}
+
+proc subproc-destroying {} {
+    variable subproc
+    puts "DESTROYING $subproc"
+
+    catch { destroy .i.i.b.c }
+
+    switch -exact $subproc {
+       none { }
+       old { }
+       default { kill $subproc; set subproc old }
+    }
+}
+
+proc subproc-ready {} {
+    variable subproc
+    puts "READY $subproc"
+
+    frame .i.i.b.c -container 1 -background orange
+    pack .i.i.b.c -fill both -side left -expand 1
+
+    switch -exact $subproc {
+       none {
+           run-child
+       }
+       old {
+           # wait for it to die
        }
-       kill KILL [id process]
+       default {
+           error "unexpected state $subproc"
+       }
+    }
+    puts "READY-done $subproc"
+}
+
+proc run-child {} {
+    variable subproc
+    variable ratelimit
+    variable subproc_get_cmdline
+
+    set id [winfo id .i.i.b.c]
+    set cmd [uplevel #0 [concat [list $subproc_get_cmdline] $id]]
+
+    puts "RUN-CHILD $subproc"
+    set now [clock seconds]
+    lappend ratelimit $now
+    while {[lindex $ratelimit 0] < {$now - 10}} {
+       set ratelimit [lrange $ratelimit 1 end]
     }
-    set children($pid) $ondeath
-    return $pid
-}
-
-proc chld-handler {} {
-    global children
-    while 1 {
-       if {[catch { set got [wait -nohang] }]} break
-       if {![llength $got]} break
-       manyset $got pid how how2
-       if {[info exists children($pid)]} {
-           set l $children($pid)
-           unset children($pid)
-           if {[catch {
-               uplevel #0 [concat [list $l] $how $how2]
-           } emsg]} {
-               catch { bgerror $emsg }
-           }
+    if {[llength $ratelimit] > 10} {
+       puts stderr "crashing repeatedly, quitting $ratelimit"
+       exit 127
+    }
+
+    set subproc none
+    set subproc [subproc::fork applet::child-died {
+       execl [lindex $cmd 0] [lrange $cmd 1 end]
+    }]
+    puts "FORKED $subproc"
+}
+
+proc child-died {how how2} {
+    puts "DIED $how $how2"
+    variable subproc
+    switch -exact $subproc {
+       old {
+           set subproc none
+           run-child
        }
-    }  
+       default {
+           set subproc none
+           subwindow-need-recreate
+       }
+    }
 }
 
-signal -restart trap CHLD { after idle chld-handler }
+}