source: branches/1.3/gui/scripts/vtkheightmapviewer.tcl @ 4436

Last change on this file since 4436 was 4436, checked in by ldelgass, 10 years ago

Fix isolines setting

File size: 87.9 KB
Line 
1# -*- mode: tcl; indent-tabs-mode: nil -*-
2# ----------------------------------------------------------------------
3#  COMPONENT: vtkheightmapviewer - Vtk heightmap viewer
4#
5#  It connects to the Vtk server running on a rendering farm,
6#  transmits data, and displays the results.
7# ======================================================================
8#  AUTHOR:  Michael McLennan, Purdue University
9#  Copyright (c) 2004-2012  HUBzero Foundation, LLC
10#
11#  See the file "license.terms" for information on usage and
12#  redistribution of this file, and for a DISCLAIMER OF ALL WARRANTIES.
13# ======================================================================
14package require Itk
15package require BLT
16#package require Img
17
18option add *VtkHeightmapViewer.width 4i widgetDefault
19option add *VtkHeightmapViewer*cursor crosshair widgetDefault
20option add *VtkHeightmapViewer.height 4i widgetDefault
21option add *VtkHeightmapViewer.foreground black widgetDefault
22option add *VtkHeightmapViewer.controlBackground gray widgetDefault
23option add *VtkHeightmapViewer.controlDarkBackground #999999 widgetDefault
24option add *VtkHeightmapViewer.plotBackground black widgetDefault
25option add *VtkHeightmapViewer.plotForeground white widgetDefault
26option add *VtkHeightmapViewer.font \
27    -*-helvetica-medium-r-normal-*-12-* widgetDefault
28
29# must use this name -- plugs into Rappture::resources::load
30proc VtkHeightmapViewer_init_resources {} {
31    Rappture::resources::register \
32        vtkvis_server Rappture::VtkHeightmapViewer::SetServerList
33}
34
35itcl::class Rappture::VtkHeightmapViewer {
36    inherit Rappture::VisViewer
37
38    itk_option define -plotforeground plotForeground Foreground ""
39    itk_option define -plotbackground plotBackground Background ""
40    itk_option define -mode mode Mode "contour"
41
42    constructor { hostlist args } {
43        Rappture::VisViewer::constructor $hostlist
44    } {
45        # defined below
46    }
47    destructor {
48        # defined below
49    }
50    public proc SetServerList { namelist } {
51        Rappture::VisViewer::SetServerList "vtkvis" $namelist
52    }
53    public method add {dataobj {settings ""}}
54    public method camera {option args}
55    public method delete {args}
56    public method disconnect {}
57    public method download {option args}
58    public method get {args}
59    public method isconnected {}
60    public method limits3 { dataobj }
61    public method parameters {title args} {
62        # do nothing
63    }
64    public method scale {args}
65
66    protected method CameraReset {}
67    protected method Connect {}
68    protected method CurrentDatasets {args}
69    protected method Disconnect {}
70    protected method DoResize {}
71    protected method DoRotate {}
72    protected method AdjustSetting {what {value ""}}
73    protected method AdjustMode {}
74    protected method InitSettings { args  }
75    protected method Pan {option x y}
76    protected method Pick {x y}
77    protected method Rebuild {}
78    protected method ReceiveDataset { args }
79    protected method ReceiveImage { args }
80    protected method ReceiveLegend { colormap title min max size }
81    protected method Rotate {option x y}
82    protected method Zoom {option}
83
84    # The following methods are only used by this class.
85    private method BuildAxisTab {}
86    private method BuildCameraTab {}
87    private method BuildColormap { name }
88    private method BuildContourTab {}
89    private method BuildDownloadPopup { widget command }
90    private method Combo { option }
91    private method DrawLegend {}
92    private method EnterLegend { x y }
93    private method EventuallyRequestLegend {}
94    private method EventuallyResize { w h }
95    private method EventuallyRotate { q }
96    private method GetImage { args }
97    private method GetVtkData { args }
98    private method IsValidObject { dataobj }
99    private method LeaveLegend {}
100    private method MotionLegend { x y }
101    private method PanCamera {}
102    private method RequestLegend {}
103    private method SetCurrentColormap { color }
104    private method SetLegendTip { x y }
105    private method SetObjectStyle { dataobj comp }
106    private method GetHeightmapScale {}
107    private method ResetAxes {}
108    private method SetOrientation { side }
109    private method UpdateContourList {}
110
111    private variable _arcball ""
112    private variable _dlist ""     ;    # list of data objects
113    private variable _obj2datasets
114    private variable _obj2ovride   ;    # maps dataobj => style override
115    private variable _comp2scale;       # maps dataset to the heightmap scale.
116    private variable _datasets     ;    # contains all the dataobj-component
117                                   ;    # datasets in the server
118    private variable _colormaps    ;    # contains all the colormaps
119                                   ;    # in the server.
120
121    # The name of the current colormap used.  The colormap is global to all
122    # heightmaps displayed.
123    private variable _currentColormap ""
124    private variable _currentNumIsolines -1
125
126    private variable _maxScale 100;     # This is the # of times the x-axis
127                                        # and y-axis ranges can differ before
128                                        # automatically turning on
129                                        # -stretchtofit
130
131    private variable _click        ;    # info used for rotate operations
132    private variable _limits       ;    # Holds overall limits for all dataobjs
133                                        # using the viewer.
134    private variable _view         ;    # view params for 3D view
135    private variable _settings
136    private variable _changed
137    private variable _initialStyle "";  # First found style in dataobjects.
138    private variable _reset 1;          # Indicates if camera needs to be reset
139                                        # to starting position.
140    private variable _beforeConnect 1;  # Indicates if camera needs to be reset
141                                        # to starting position.
142
143    private variable _first ""     ;    # This is the topmost dataset.
144    private variable _start 0
145    private variable _isolines
146    private variable _contourList ""
147
148    common _downloadPopup;              # download options from popup
149    private common _hardcopy
150    private variable _width 0
151    private variable _height 0
152    private variable _legendWidth 0
153    private variable _legendHeight 0
154    private variable _resizePending 0
155    private variable _rotatePending 0
156    private variable _legendPending 0
157    private variable _fieldNames {}
158    private variable _fields
159    private variable _curFldName ""
160    private variable _curFldLabel ""
161    private variable _colorMode "scalar";#  Mode of colormap (vmag or scalar)
162}
163
164itk::usual VtkHeightmapViewer {
165    keep -background -foreground -cursor -font
166    keep -plotbackground -plotforeground -mode
167}
168
169# ----------------------------------------------------------------------
170# CONSTRUCTOR
171# ----------------------------------------------------------------------
172itcl::body Rappture::VtkHeightmapViewer::constructor {hostlist args} {
173    set _serverType "vtkvis"
174
175    EnableWaitDialog 900
176    # Rebuild event
177    $_dispatcher register !rebuild
178    $_dispatcher dispatch $this !rebuild "[itcl::code $this Rebuild]; list"
179
180    # Resize event
181    $_dispatcher register !resize
182    $_dispatcher dispatch $this !resize "[itcl::code $this DoResize]; list"
183
184    # Rotate event
185    $_dispatcher register !rotate
186    $_dispatcher dispatch $this !rotate "[itcl::code $this DoRotate]; list"
187
188    # Legend event
189    $_dispatcher register !legend
190    $_dispatcher dispatch $this !legend "[itcl::code $this RequestLegend]; list"
191
192    #
193    # Populate parser with commands handle incoming requests
194    #
195    $_parser alias image [itcl::code $this ReceiveImage]
196    $_parser alias dataset [itcl::code $this ReceiveDataset]
197    $_parser alias legend [itcl::code $this ReceiveLegend]
198
199    # Create image for legend colorbar.
200    set _image(legend) [image create photo]
201
202    # Initialize the view to some default parameters.
203    array set _view {
204        qw      0.36
205        qx      0.25
206        qy      0.50
207        qz      0.70
208        zoom    1.0
209        xpan    0
210        ypan    0
211        ortho   0
212    }
213    set _arcball [blt::arcball create 100 100]
214    set q [list $_view(qw) $_view(qx) $_view(qy) $_view(qz)]
215    $_arcball quaternion $q
216
217    array set _settings {
218        -axisflymode            "static"
219        -axislabels             1
220        -axisminorticks         1
221        -axisvisible            1
222        -colormapdiscrete       0
223        -colormapvisible        1
224        -edges                  0
225        -field                  "Default"
226        -heightmapscale         50
227        -isheightmap            0
228        -isolinecolor           black
229        -isolinesvisible        1
230        -legendvisible          1
231        -lighting               1
232        -numisolines            10
233        -opacity                100
234        -outline                0
235        -savelighting           1
236        -saveopacity            100
237        -saveoutline            0
238        -stretchtofit           0
239        -wireframe              0
240        -xgrid                  0
241        -ygrid                  0
242        -zgrid                  0
243    }
244    array set _changed {
245        -colormap                0
246        -numisolines             0
247        -opacity                 0
248    }
249    itk_component add view {
250        canvas $itk_component(plotarea).view \
251            -highlightthickness 0 -borderwidth 0
252    } {
253        usual
254        ignore -highlightthickness -borderwidth -background
255    }
256
257    itk_component add fieldmenu {
258        menu $itk_component(plotarea).menu \
259            -relief flat \
260            -tearoff no
261    } {
262        usual
263        ignore -background -foreground -relief -tearoff
264    }
265    set c $itk_component(view)
266    bind $c <Configure> [itcl::code $this EventuallyResize %w %h]
267    bind $c <4> [itcl::code $this Zoom in 0.25]
268    bind $c <5> [itcl::code $this Zoom out 0.25]
269    bind $c <KeyPress-Left>  [list %W xview scroll 10 units]
270    bind $c <KeyPress-Right> [list %W xview scroll -10 units]
271    bind $c <KeyPress-Up>    [list %W yview scroll 10 units]
272    bind $c <KeyPress-Down>  [list %W yview scroll -10 units]
273    bind $c <Enter> "focus %W"
274    bind $c <Control-F1> [itcl::code $this ToggleConsole]
275
276    # Fix the scrollregion in case we go off screen
277    $c configure -scrollregion [$c bbox all]
278
279    set _map(id) [$c create image 0 0 -anchor nw -image $_image(plot)]
280    set _map(cwidth) -1
281    set _map(cheight) -1
282    set _map(zoom) 1.0
283    set _map(original) ""
284
285    set f [$itk_component(main) component controls]
286    itk_component add reset {
287        button $f.reset -borderwidth 1 -padx 1 -pady 1 \
288            -highlightthickness 0 \
289            -image [Rappture::icon reset-view] \
290            -command [itcl::code $this CameraReset]
291    } {
292        usual
293        ignore -highlightthickness
294    }
295    pack $itk_component(reset) -side top -padx 2 -pady { 2 0 }
296    Rappture::Tooltip::for $itk_component(reset) "Reset the view to the default zoom level"
297
298    itk_component add zoomin {
299        button $f.zin -borderwidth 1 -padx 1 -pady 1 \
300            -highlightthickness 0 \
301            -image [Rappture::icon zoom-in] \
302            -command [itcl::code $this Zoom in]
303    } {
304        usual
305        ignore -highlightthickness
306    }
307    pack $itk_component(zoomin) -side top -padx 2 -pady { 2 0 }
308    Rappture::Tooltip::for $itk_component(zoomin) "Zoom in"
309
310    itk_component add zoomout {
311        button $f.zout -borderwidth 1 -padx 1 -pady 1 \
312            -highlightthickness 0 \
313            -image [Rappture::icon zoom-out] \
314            -command [itcl::code $this Zoom out]
315    } {
316        usual
317        ignore -highlightthickness
318    }
319    pack $itk_component(zoomout) -side top -padx 2 -pady { 2 0 }
320    Rappture::Tooltip::for $itk_component(zoomout) "Zoom out"
321
322    itk_component add mode {
323        Rappture::PushButton $f.mode \
324            -onimage [Rappture::icon surface] \
325            -offimage [Rappture::icon surface] \
326            -variable [itcl::scope _settings(-isheightmap)] \
327            -command [itcl::code $this AdjustSetting -isheightmap] \
328    }
329    Rappture::Tooltip::for $itk_component(mode) \
330        "Toggle the surface/contour on/off"
331    pack $itk_component(mode) -padx 2 -pady { 2 0 }
332
333    itk_component add stretchtofit {
334        Rappture::PushButton $f.stretchtofit \
335            -onimage [Rappture::icon stretchtofit] \
336            -offimage [Rappture::icon stretchtofit] \
337            -variable [itcl::scope _settings(-stretchtofit)] \
338            -command [itcl::code $this AdjustSetting -stretchtofit] \
339    }
340    Rappture::Tooltip::for $itk_component(stretchtofit) \
341        "Stretch plot to fit window on/off"
342    pack $itk_component(stretchtofit) -padx 2 -pady 2
343
344    if { [catch {
345        BuildContourTab
346        BuildAxisTab
347        BuildCameraTab
348    } errs] != 0 } {
349        global errorInfo
350        puts stderr "errs=$errs errorInfo=$errorInfo"
351    }
352
353    # Hack around the Tk panewindow.  The problem is that the requested
354    # size of the 3d view isn't set until an image is retrieved from
355    # the server.  So the panewindow uses the tiny size.
356    set w 10000
357    pack forget $itk_component(view)
358    blt::table $itk_component(plotarea) \
359        0,0 $itk_component(view) -fill both -reqwidth $w
360    blt::table configure $itk_component(plotarea) c1 -resize none
361
362    # Bindings for panning via mouse
363    bind $itk_component(view) <ButtonPress-2> \
364        [itcl::code $this Pan click %x %y]
365    bind $itk_component(view) <B2-Motion> \
366        [itcl::code $this Pan drag %x %y]
367    bind $itk_component(view) <ButtonRelease-2> \
368        [itcl::code $this Pan release %x %y]
369
370    #bind $itk_component(view) <ButtonRelease-3> \
371    #    [itcl::code $this Pick %x %y]
372
373    # Bindings for panning via keyboard
374    bind $itk_component(view) <KeyPress-Left> \
375        [itcl::code $this Pan set -10 0]
376    bind $itk_component(view) <KeyPress-Right> \
377        [itcl::code $this Pan set 10 0]
378    bind $itk_component(view) <KeyPress-Up> \
379        [itcl::code $this Pan set 0 -10]
380    bind $itk_component(view) <KeyPress-Down> \
381        [itcl::code $this Pan set 0 10]
382    bind $itk_component(view) <Shift-KeyPress-Left> \
383        [itcl::code $this Pan set -2 0]
384    bind $itk_component(view) <Shift-KeyPress-Right> \
385        [itcl::code $this Pan set 2 0]
386    bind $itk_component(view) <Shift-KeyPress-Up> \
387        [itcl::code $this Pan set 0 -2]
388    bind $itk_component(view) <Shift-KeyPress-Down> \
389        [itcl::code $this Pan set 0 2]
390
391    # Bindings for zoom via keyboard
392    bind $itk_component(view) <KeyPress-Prior> \
393        [itcl::code $this Zoom out]
394    bind $itk_component(view) <KeyPress-Next> \
395        [itcl::code $this Zoom in]
396
397    bind $itk_component(view) <Enter> "focus $itk_component(view)"
398
399    if {[string equal "x11" [tk windowingsystem]]} {
400        # Bindings for zoom via mouse
401        bind $itk_component(view) <4> [itcl::code $this Zoom out]
402        bind $itk_component(view) <5> [itcl::code $this Zoom in]
403    }
404
405    set _image(download) [image create photo]
406    eval itk_initialize $args
407    Connect
408    set _beforeConnect 0
409}
410
411# ----------------------------------------------------------------------
412# DESTRUCTOR
413# ----------------------------------------------------------------------
414itcl::body Rappture::VtkHeightmapViewer::destructor {} {
415    Disconnect
416    image delete $_image(plot)
417    image delete $_image(download)
418    catch { blt::arcball destroy $_arcball }
419}
420
421itcl::body Rappture::VtkHeightmapViewer::DoResize {} {
422    if { $_width < 2 } {
423        set _width 500
424    }
425    if { $_height < 2 } {
426        set _height 500
427    }
428    set _start [clock clicks -milliseconds]
429    SendCmd "screen size [expr $_width - 20] $_height"
430
431    set font "Arial 8"
432    set lh [font metrics $font -linespace]
433    set h [expr {$_height - 2 * ($lh + 2)}]
434    if { $h != $_legendHeight } {
435        EventuallyRequestLegend
436    } else {
437        DrawLegend
438    }
439    set _resizePending 0
440}
441
442itcl::body Rappture::VtkHeightmapViewer::DoRotate {} {
443    set q [list $_view(qw) $_view(qx) $_view(qy) $_view(qz)]
444    SendCmd "camera orient $q"
445    set _rotatePending 0
446}
447
448itcl::body Rappture::VtkHeightmapViewer::EventuallyRequestLegend {} {
449    if { !$_legendPending } {
450        set _legendPending 1
451        $_dispatcher event -idle !legend
452    }
453}
454
455itcl::body Rappture::VtkHeightmapViewer::EventuallyResize { w h } {
456    set _width $w
457    set _height $h
458    $_arcball resize $w $h
459    if { !$_resizePending } {
460        set _resizePending 1
461        $_dispatcher event -after 250 !resize
462    }
463}
464
465set rotate_delay 100
466
467itcl::body Rappture::VtkHeightmapViewer::EventuallyRotate { q } {
468    foreach { _view(qw) _view(qx) _view(qy) _view(qz) } $q break
469    if { !$_rotatePending } {
470        set _rotatePending 1
471        global rotate_delay
472        $_dispatcher event -after $rotate_delay !rotate
473    }
474}
475
476# ----------------------------------------------------------------------
477# USAGE: add <dataobj> ?<settings>?
478#
479# Clients use this to add a data object to the plot.  The optional
480# <settings> are used to configure the plot.  Allowed settings are
481# -color, -brightness, -width, -linestyle, and -raise.
482# ----------------------------------------------------------------------
483itcl::body Rappture::VtkHeightmapViewer::add {dataobj {settings ""}} {
484    if { ![$dataobj isvalid] } {
485        return;                         # Object doesn't contain valid data.
486    }
487    array set params {
488        -color auto
489        -width 1
490        -linestyle solid
491        -brightness 0
492        -raise 0
493        -description ""
494        -param ""
495        -type ""
496    }
497    array set params $settings
498    set params(-description) ""
499    set params(-param) ""
500    array set params $settings
501
502    if {$params(-color) == "auto" || $params(-color) == "autoreset"} {
503        # can't handle -autocolors yet
504        set params(-color) white
505    }
506    set pos [lsearch -exact $_dlist $dataobj]
507    if {$pos < 0} {
508        lappend _dlist $dataobj
509    }
510    set _obj2ovride($dataobj-color) $params(-color)
511    set _obj2ovride($dataobj-width) $params(-width)
512    set _obj2ovride($dataobj-raise) $params(-raise)
513    $_dispatcher event -idle !rebuild
514}
515
516
517# ----------------------------------------------------------------------
518# USAGE: delete ?<dataobj1> <dataobj2> ...?
519#
520#       Clients use this to delete a dataobj from the plot.  If no dataobjs
521#       are specified, then all dataobjs are deleted.  No data objects are
522#       deleted.  They are only removed from the display list.
523#
524# ----------------------------------------------------------------------
525itcl::body Rappture::VtkHeightmapViewer::delete {args} {
526    if { [llength $args] == 0} {
527        set args $_dlist
528    }
529    # Delete all specified dataobjs
530    set changed 0
531    foreach dataobj $args {
532        set pos [lsearch -exact $_dlist $dataobj]
533        if { $pos < 0 } {
534            continue;                   # Don't know anything about it.
535        }
536        # Remove it from the dataobj list.
537        set _dlist [lreplace $_dlist $pos $pos]
538        array unset _obj2ovride $dataobj-*
539        array unset _settings $dataobj-*
540        set changed 1
541    }
542    # If anything changed, then rebuild the plot
543    if { $changed } {
544        $_dispatcher event -idle !rebuild
545    }
546}
547
548# ----------------------------------------------------------------------
549# USAGE: get ?-objects?
550# USAGE: get ?-visible?
551# USAGE: get ?-image view?
552#
553# Clients use this to query the list of objects being plotted, in
554# order from bottom to top of this result.  The optional "-image"
555# flag can also request the internal images being shown.
556# ----------------------------------------------------------------------
557itcl::body Rappture::VtkHeightmapViewer::get {args} {
558    if {[llength $args] == 0} {
559        set args "-objects"
560    }
561    set op [lindex $args 0]
562    switch -- $op {
563        "-objects" {
564            # put the dataobj list in order according to -raise options
565            set dlist {}
566            foreach dataobj $_dlist {
567                if { ![IsValidObject $dataobj] } {
568                    continue
569                }
570                if {[info exists _obj2ovride($dataobj-raise)] &&
571                    $_obj2ovride($dataobj-raise)} {
572                    set dlist [linsert $dlist 0 $dataobj]
573                } else {
574                    lappend dlist $dataobj
575                }
576            }
577            return $dlist
578        }
579        "-visible" {
580            set dlist {}
581            foreach dataobj $_dlist {
582                if { ![IsValidObject $dataobj] } {
583                    continue
584                }
585                if { ![info exists _obj2ovride($dataobj-raise)] } {
586                    # No setting indicates that the object isn't visible.
587                    continue
588                }
589                # Otherwise use the -raise parameter to put the object to
590                # the front of the list.
591                if { $_obj2ovride($dataobj-raise) } {
592                    set dlist [linsert $dlist 0 $dataobj]
593                } else {
594                    lappend dlist $dataobj
595                }
596            }
597            return $dlist
598        }           
599        -image {
600            if {[llength $args] != 2} {
601                error "wrong # args: should be \"get -image view\""
602            }
603            switch -- [lindex $args end] {
604                view {
605                    return $_image(plot)
606                }
607                default {
608                    error "bad image name \"[lindex $args end]\": should be view"
609                }
610            }
611        }
612        default {
613            error "bad option \"$op\": should be -objects or -image"
614        }
615    }
616}
617
618#
619# scale  --
620#
621#       This gets called either incrementally as new simulations are
622#       added or all at once as a sequence of heightmaps.
623#       This  accounts for all objects--even those not showing on the
624#       screen.  Because of this, the limits are appropriate for all
625#       objects as the user scans through data in the ResultSet viewer.
626#
627itcl::body Rappture::VtkHeightmapViewer::scale {args} {
628    foreach dataobj $args {
629        if { ![$dataobj isvalid] } {
630            continue;                   # Object doesn't contain valid data.
631        }
632        foreach axis { x y } {
633            set lim [$dataobj limits $axis]
634            if { ![info exists _limits($axis)] } {
635                set _limits($axis) $lim
636                continue
637            }
638            foreach {min max} $lim break
639            foreach {amin amax} $_limits($axis) break
640            if { $amin > $min } {
641                set amin $min
642            }
643            if { $amax < $max } {
644                set amax $max
645            }
646            set _limits($axis) [list $amin $amax]
647            set units [$dataobj hints ${axis}units]
648            set found($units) 1
649        }
650        foreach { fname lim } [$dataobj fieldlimits] {
651            if { ![info exists _limits($fname)] } {
652                set _limits($fname) $lim
653                continue
654            }
655            foreach {min max} $lim break
656            foreach {fmin fmax} $_limits($fname) break
657            if { $fmin > $min } {
658                set fmin $min
659            }
660            if { $fmax < $max } {
661                set fmax $max
662            }
663            set _limits($fname) [list $fmin $fmax]
664        }
665    }
666    if { [array size found] > 1 } {
667        set _settings(-stretchtofit) 1
668    } else {
669        # Check if the range of the x and y axes requires that we stretch
670        # the contour to fit the plotting area.  This can happen when the
671        # x and y scales differ greatly (> 100x)
672        foreach {xmin xmax} $_limits(x) break
673        foreach {ymin ymax} $_limits(y) break
674        if { (($xmax - $xmin) > (($ymax -$ymin) * $_maxScale)) ||
675             ((($xmax - $xmin) * $_maxScale) < ($ymax -$ymin)) } {
676            set _settings(-stretchtofit) 1
677        }
678    }
679}
680
681# ----------------------------------------------------------------------
682# USAGE: download coming
683# USAGE: download controls <downloadCommand>
684# USAGE: download now
685#
686# Clients use this method to create a downloadable representation
687# of the plot.  Returns a list of the form {ext string}, where
688# "ext" is the file extension (indicating the type of data) and
689# "string" is the data itself.
690# ----------------------------------------------------------------------
691itcl::body Rappture::VtkHeightmapViewer::download {option args} {
692    switch $option {
693        coming {
694            if {[catch {
695                blt::winop snap $itk_component(plotarea) $_image(download)
696            }]} {
697                $_image(download) configure -width 1 -height 1
698                $_image(download) put #000000
699            }
700        }
701        controls {
702            set popup .vtkviewerdownload
703            if { ![winfo exists .vtkviewerdownload] } {
704                set inner [BuildDownloadPopup $popup [lindex $args 0]]
705            } else {
706                set inner [$popup component inner]
707            }
708            set _downloadPopup(image_controls) $inner.image_frame
709            set num [llength [get]]
710            set num [expr {($num == 1) ? "1 result" : "$num results"}]
711            set word [Rappture::filexfer::label downloadWord]
712            $inner.summary configure -text "$word $num in the following format:"
713            update idletasks            ;# Fix initial sizes
714            return $popup
715        }
716        now {
717            set popup .vtkviewerdownload
718            if {[winfo exists .vtkviewerdownload]} {
719                $popup deactivate
720            }
721            switch -- $_downloadPopup(format) {
722                "image" {
723                    return [$this GetImage [lindex $args 0]]
724                }
725                "vtk" {
726                    return [$this GetVtkData [lindex $args 0]]
727                }
728            }
729            return ""
730        }
731        default {
732            error "bad option \"$option\": should be coming, controls, now"
733        }
734    }
735}
736
737# ----------------------------------------------------------------------
738# USAGE: Connect ?<host:port>,<host:port>...?
739#
740# Clients use this method to establish a connection to a new
741# server, or to reestablish a connection to the previous server.
742# Any existing connection is automatically closed.
743# ----------------------------------------------------------------------
744itcl::body Rappture::VtkHeightmapViewer::Connect {} {
745    global readyForNextFrame
746    set readyForNextFrame 1
747    set _reset 1
748    set _hosts [GetServerList "vtkvis"]
749    if { "" == $_hosts } {
750        return 0
751    }
752    set result [VisViewer::Connect $_hosts]
753    if { $result } {
754        if { $_reportClientInfo }  {
755            # Tell the server the viewer, hub, user and session.
756            # Do this immediately on connect before buffering any commands
757            global env
758
759            set info {}
760            set user "???"
761            if { [info exists env(USER)] } {
762                set user $env(USER)
763            }
764            set session "???"
765            if { [info exists env(SESSION)] } {
766                set session $env(SESSION)
767            }
768            lappend info "hub" [exec hostname]
769            lappend info "client" "vtkheightmapviewer"
770            lappend info "user" $user
771            lappend info "session" $session
772            SendCmd "clientinfo [list $info]"
773        }
774        set w [winfo width $itk_component(view)]
775        set h [winfo height $itk_component(view)]
776        EventuallyResize $w $h
777    }
778    return $result
779}
780
781#
782# isconnected --
783#
784#       Indicates if we are currently connected to the visualization server.
785#
786itcl::body Rappture::VtkHeightmapViewer::isconnected {} {
787    return [VisViewer::IsConnected]
788}
789
790#
791# disconnect --
792#
793itcl::body Rappture::VtkHeightmapViewer::disconnect {} {
794    Disconnect
795    set _reset 1
796}
797
798#
799# Disconnect --
800#
801#       Clients use this method to disconnect from the current rendering
802#       server.
803#
804itcl::body Rappture::VtkHeightmapViewer::Disconnect {} {
805    VisViewer::Disconnect
806
807    $_dispatcher cancel !rebuild
808    $_dispatcher cancel !resize
809    $_dispatcher cancel !rotate
810    $_dispatcher cancel !legend
811    # disconnected -- no more data sitting on server
812    array unset _datasets
813    array unset _data
814    array unset _colormaps
815    array unset _obj2datasets
816    global readyForNextFrame
817    set readyForNextFrame 1
818}
819
820# ----------------------------------------------------------------------
821# USAGE: ReceiveImage -bytes <size> -type <type> -token <token>
822#
823# Invoked automatically whenever the "image" command comes in from
824# the rendering server.  Indicates that binary image data with the
825# specified <size> will follow.
826# ----------------------------------------------------------------------
827itcl::body Rappture::VtkHeightmapViewer::ReceiveImage { args } {
828    global readyForNextFrame
829    set readyForNextFrame 1
830    array set info {
831        -token "???"
832        -bytes 0
833        -type image
834    }
835    array set info $args
836    set bytes [ReceiveBytes $info(-bytes)]
837    if { $info(-type) == "image" } {
838        if 0 {
839            set f [open "last.ppm" "w"]
840            puts $f $bytes
841            close $f
842        }
843        $_image(plot) configure -data $bytes
844        set time [clock seconds]
845        set date [clock format $time]
846        #puts stderr "$date: received image [image width $_image(plot)]x[image height $_image(plot)] image>"       
847        if { $_start > 0 } {
848            set finish [clock clicks -milliseconds]
849            #puts stderr "round trip time [expr $finish -$_start] milliseconds"
850            set _start 0
851        }
852    } elseif { $info(type) == "print" } {
853        set tag $this-print-$info(-token)
854        set _hardcopy($tag) $bytes
855    }
856}
857
858#
859# ReceiveDataset --
860#
861itcl::body Rappture::VtkHeightmapViewer::ReceiveDataset { args } {
862    if { ![isconnected] } {
863        return
864    }
865    set option [lindex $args 0]
866    switch -- $option {
867        "scalar" {
868            set option [lindex $args 1]
869            switch -- $option {
870                "world" {
871                    foreach { x y z value tag } [lrange $args 2 end] break
872                }
873                "pixel" {
874                    foreach { x y value tag } [lrange $args 2 end] break
875                }
876            }
877        }
878        "vector" {
879            set option [lindex $args 1]
880            switch -- $option {
881                "world" {
882                    foreach { x y z vx vy vz tag } [lrange $args 2 end] break
883                }
884                "pixel" {
885                    foreach { x y vx vy vz tag } [lrange $args 2 end] break
886                }
887            }
888        }
889        "names" {
890            foreach { name } [lindex $args 1] {
891                #puts stderr "Dataset: $name"
892            }
893        }
894        default {
895            error "unknown dataset option \"$option\" from server"
896        }
897    }
898}
899
900# ----------------------------------------------------------------------
901# USAGE: Rebuild
902#
903# Called automatically whenever something changes that affects the
904# data in the widget.  Clears any existing data and rebuilds the
905# widget to display new data.
906# ----------------------------------------------------------------------
907itcl::body Rappture::VtkHeightmapViewer::Rebuild {} {
908    set w [winfo width $itk_component(view)]
909    set h [winfo height $itk_component(view)]
910    if { $w < 2 || $h < 2 } {
911        $_dispatcher event -idle !rebuild
912        return
913    }
914
915    # Turn on buffering of commands to the server.  We don't want to
916    # be preempted by a server disconnect/reconnect (which automatically
917    # generates a new call to Rebuild).   
918    StartBufferingCommands
919
920    if { $_width != $w || $_height != $h || $_reset } {
921        set _width $w
922        set _height $h
923        $_arcball resize $w $h
924        DoResize
925        if { $_settings(-stretchtofit) } {
926            AdjustSetting -stretchtofit
927        }
928    }
929    if { $_reset } {
930        #
931        # Reset the camera and other view parameters
932        #
933        InitSettings -isheightmap -background
934
935        # Let's see how this goes.  I think it's preferable to overloading the
936        # axis title with the exponent.
937        SendCmd "axis exp 0 0 0 1"
938
939        SendCmd "axis lrot z 90"
940        set q [list $_view(qw) $_view(qx) $_view(qy) $_view(qz)]
941        $_arcball quaternion $q
942        if {$_settings(-isheightmap) } {
943            if { $_view(ortho)} {
944                SendCmd "camera mode ortho"
945            } else {
946                SendCmd "camera mode persp"
947            }
948            DoRotate
949            SendCmd "camera reset"
950        }
951        PanCamera
952        StopBufferingCommands
953        SendCmd "imgflush"
954        StartBufferingCommands
955    }
956
957    set _first ""
958    # Start off with no datasets are visible.
959    SendCmd "dataset visible 0"
960    set scale [GetHeightmapScale]
961    foreach dataobj [get -objects] {
962        if { [info exists _obj2ovride($dataobj-raise)] &&  $_first == "" } {
963            set _first $dataobj
964        }
965        set _obj2datasets($dataobj) ""
966        foreach comp [$dataobj components] {
967            set tag $dataobj-$comp
968            if { ![info exists _datasets($tag)] } {
969                set bytes [$dataobj vtkdata $comp]
970                if 0 {
971                    set f [open /tmp/vtkheightmap.vtk "w"]
972                    puts $f $bytes
973                    close $f
974                }
975                set length [string length $bytes]
976                if { $_reportClientInfo }  {
977                    set info {}
978                    lappend info "tool_id"       [$dataobj hints toolId]
979                    lappend info "tool_name"     [$dataobj hints toolName]
980                    lappend info "tool_version"  [$dataobj hints toolRevision]
981                    lappend info "tool_title"    [$dataobj hints toolTitle]
982                    lappend info "dataset_label" [$dataobj hints label]
983                    lappend info "dataset_size"  $length
984                    lappend info "dataset_tag"   $tag
985                    SendCmd [list "clientinfo" $info]
986                }
987                SendCmd "dataset add $tag data follows $length"
988                append _outbuf $bytes
989                set _datasets($tag) 1
990                SetObjectStyle $dataobj $comp
991            }
992            lappend _obj2datasets($dataobj) $tag
993            if { [info exists _obj2ovride($dataobj-raise)] } {
994                # Setting dataset visible enables outline
995                # and heightmap
996                SendCmd "dataset visible 1 $tag"
997            }
998            if { ![info exists _comp2scale($tag)] ||
999                 $_comp2scale($tag) != $scale } {
1000                SendCmd "heightmap heightscale $scale $tag"
1001                set _comp2scale($tag) $scale
1002            }
1003        }
1004    }
1005    if { $_first != ""  } {
1006        $itk_component(field) choices delete 0 end
1007        $itk_component(fieldmenu) delete 0 end
1008        array unset _fields
1009        set _curFldName ""
1010        foreach cname [$_first components] {
1011            foreach fname [$_first fieldnames $cname] {
1012                if { [info exists _fields($fname)] } {
1013                    continue
1014                }
1015                foreach { label units components } \
1016                    [$_first fieldinfo $fname] break
1017                $itk_component(field) choices insert end "$fname" "$label"
1018                $itk_component(fieldmenu) add radiobutton -label "$label" \
1019                    -value $label -variable [itcl::scope _curFldLabel] \
1020                    -selectcolor red \
1021                    -activebackground $itk_option(-plotbackground) \
1022                    -activeforeground $itk_option(-plotforeground) \
1023                    -font "Arial 8" \
1024                    -command [itcl::code $this Combo invoke]
1025                set _fields($fname) [list $label $units $components]
1026                if { $_curFldName == "" } {
1027                    set _curFldName $fname
1028                    set _curFldLabel $label
1029                }
1030            }
1031        }
1032        $itk_component(field) value $_curFldLabel
1033    }
1034    InitSettings -stretchtofit -outline
1035
1036    if { $_reset } {
1037        SendCmd "axis tickpos outside"
1038        foreach axis { x y z } {
1039            SendCmd "axis lformat $axis %g"
1040        }
1041       
1042        foreach axis { x y z } {
1043            if { $axis == "z" } {
1044                set label [$_first hints label]
1045            } else {
1046                set label [$_first hints ${axis}label]
1047            }
1048            if { $label == "" } {
1049                if {$axis == "z"} {
1050                    if { [string match "component*" $_curFldName] } {
1051                        set label [string toupper $axis]
1052                    } else {
1053                        set label $_curFldLabel
1054                    }
1055                } else {
1056                    set label [string toupper $axis]
1057                }
1058            }
1059            # May be a space in the axis label.
1060            SendCmd [list axis name $axis $label]
1061
1062            if {$axis == "z" && [$_first hints ${axis}units] == ""} {
1063                set units [lindex $_fields($_curFldName) 1]
1064            } else {
1065                set units [$_first hints ${axis}units]
1066            }
1067            if { $units != "" } {
1068                # May be a space in the axis units.
1069                SendCmd [list axis units $axis $units]
1070            }
1071        }
1072        #
1073        # Reset the camera and other view parameters
1074        #
1075        ResetAxes
1076        set q [list $_view(qw) $_view(qx) $_view(qy) $_view(qz)]
1077        $_arcball quaternion $q
1078        if {$_settings(-isheightmap) } {
1079            if { $_view(ortho)} {
1080                SendCmd "camera mode ortho"
1081            } else {
1082                SendCmd "camera mode persp"
1083            }
1084            DoRotate
1085            SendCmd "camera reset"
1086        }
1087        PanCamera
1088        InitSettings -xgrid -ygrid -zgrid \
1089            -axisvisible -axislabels -heightmapscale -field -isheightmap \
1090            -numisolines
1091        if { [array size _fields] < 2 } {
1092            blt::table forget $itk_component(field) $itk_component(field_l)
1093        }
1094        RequestLegend
1095        set _reset 0
1096    }
1097    global readyForNextFrame
1098    set readyForNextFrame 0;            # Don't advance to the next frame
1099
1100    # Actually write the commands to the server socket.  If it fails, we don't
1101    # care.  We're finished here.
1102    blt::busy hold $itk_component(hull)
1103    StopBufferingCommands
1104    blt::busy release $itk_component(hull)
1105}
1106
1107# ----------------------------------------------------------------------
1108# USAGE: CurrentDatasets ?-all -visible? ?dataobjs?
1109#
1110# Returns a list of server IDs for the current datasets being displayed.  This
1111# is normally a single ID, but it might be a list of IDs if the current data
1112# object has multiple components.
1113# ----------------------------------------------------------------------
1114itcl::body Rappture::VtkHeightmapViewer::CurrentDatasets {args} {
1115    set flag [lindex $args 0]
1116    switch -- $flag {
1117        "-all" {
1118            if { [llength $args] > 1 } {
1119                error "CurrentDatasets: can't specify dataobj after \"-all\""
1120            }
1121            set dlist [get -objects]
1122        }
1123        "-visible" {
1124            if { [llength $args] > 1 } {
1125                set dlist {}
1126                set args [lrange $args 1 end]
1127                foreach dataobj $args {
1128                    if { [info exists _obj2ovride($dataobj-raise)] } {
1129                        lappend dlist $dataobj
1130                    }
1131                }
1132            } else {
1133                set dlist [get -visible]
1134            }
1135        }           
1136        default {
1137            set dlist $args
1138        }
1139    }
1140    set rlist ""
1141    foreach dataobj $dlist {
1142        foreach comp [$dataobj components] {
1143            set tag $dataobj-$comp
1144            if { [info exists _datasets($tag)] && $_datasets($tag) } {
1145                lappend rlist $tag
1146            }
1147        }
1148    }
1149    return $rlist
1150}
1151
1152itcl::body Rappture::VtkHeightmapViewer::CameraReset {} {
1153    array set _view {
1154        qw      0.36
1155        qx      0.25
1156        qy      0.50
1157        qz      0.70
1158        zoom    1.0
1159        xpan    0
1160        ypan    0
1161    }
1162    if { $_first != "" } {
1163        set location [$_first hints camera]
1164        if { $location != "" } {
1165            array set _view $location
1166        }
1167    }
1168    set q [list $_view(qw) $_view(qx) $_view(qy) $_view(qz)]
1169    $_arcball quaternion $q
1170    if {$_settings(-isheightmap) } {
1171        DoRotate
1172    }
1173    SendCmd "camera reset"
1174}
1175
1176# ----------------------------------------------------------------------
1177# USAGE: Zoom in
1178# USAGE: Zoom out
1179# USAGE: Zoom reset
1180#
1181# Called automatically when the user clicks on one of the zoom
1182# controls for this widget.  Changes the zoom for the current view.
1183# ----------------------------------------------------------------------
1184itcl::body Rappture::VtkHeightmapViewer::Zoom {option} {
1185    switch -- $option {
1186        "in" {
1187            set _view(zoom) [expr {$_view(zoom)*1.25}]
1188            SendCmd "camera zoom $_view(zoom)"
1189        }
1190        "out" {
1191            set _view(zoom) [expr {$_view(zoom)*0.8}]
1192            SendCmd "camera zoom $_view(zoom)"
1193        }
1194        "reset" {
1195            array set _view {
1196                zoom    1.0
1197                xpan    0
1198                ypan    0
1199            }
1200            SendCmd "camera reset"
1201        }
1202    }
1203}
1204
1205itcl::body Rappture::VtkHeightmapViewer::PanCamera {} {
1206    set x $_view(xpan)
1207    set y $_view(ypan)
1208    SendCmd "camera pan $x $y"
1209}
1210
1211
1212# ----------------------------------------------------------------------
1213# USAGE: Rotate click <x> <y>
1214# USAGE: Rotate drag <x> <y>
1215# USAGE: Rotate release <x> <y>
1216#
1217# Called automatically when the user clicks/drags/releases in the
1218# plot area.  Moves the plot according to the user's actions.
1219# ----------------------------------------------------------------------
1220itcl::body Rappture::VtkHeightmapViewer::Rotate {option x y} {
1221    switch -- $option {
1222        "click" {
1223            $itk_component(view) configure -cursor fleur
1224            set _click(x) $x
1225            set _click(y) $y
1226        }
1227        "drag" {
1228            if {[array size _click] == 0} {
1229                Rotate click $x $y
1230            } else {
1231                set w [winfo width $itk_component(view)]
1232                set h [winfo height $itk_component(view)]
1233                if {$w <= 0 || $h <= 0} {
1234                    return
1235                }
1236
1237                if {[catch {
1238                    # this fails sometimes for no apparent reason
1239                    set dx [expr {double($x-$_click(x))/$w}]
1240                    set dy [expr {double($y-$_click(y))/$h}]
1241                }]} {
1242                    return
1243                }
1244                if { $dx == 0 && $dy == 0 } {
1245                    return
1246                }
1247                set q [$_arcball rotate $x $y $_click(x) $_click(y)]
1248                EventuallyRotate $q
1249                set _click(x) $x
1250                set _click(y) $y
1251            }
1252        }
1253        "release" {
1254            Rotate drag $x $y
1255            $itk_component(view) configure -cursor ""
1256            catch {unset _click}
1257        }
1258        default {
1259            error "bad option \"$option\": should be click, drag, release"
1260        }
1261    }
1262}
1263
1264itcl::body Rappture::VtkHeightmapViewer::Pick {x y} {
1265    foreach tag [CurrentDatasets -visible] {
1266        SendCmd "dataset getscalar pixel $x $y $tag"
1267    }
1268}
1269
1270# ----------------------------------------------------------------------
1271# USAGE: $this Pan click x y
1272#        $this Pan drag x y
1273#        $this Pan release x y
1274#
1275# Called automatically when the user clicks on one of the zoom
1276# controls for this widget.  Changes the zoom for the current view.
1277# ----------------------------------------------------------------------
1278itcl::body Rappture::VtkHeightmapViewer::Pan {option x y} {
1279    switch -- $option {
1280        "set" {
1281            set w [winfo width $itk_component(view)]
1282            set h [winfo height $itk_component(view)]
1283            set x [expr $x / double($w)]
1284            set y [expr $y / double($h)]
1285            set _view(xpan) [expr $_view(xpan) + $x]
1286            set _view(ypan) [expr $_view(ypan) + $y]
1287            PanCamera
1288            return
1289        }
1290        "click" {
1291            set _click(x) $x
1292            set _click(y) $y
1293            $itk_component(view) configure -cursor hand1
1294        }
1295        "drag" {
1296            if { ![info exists _click(x)] } {
1297                set _click(x) $x
1298            }
1299            if { ![info exists _click(y)] } {
1300                set _click(y) $y
1301            }
1302            set w [winfo width $itk_component(view)]
1303            set h [winfo height $itk_component(view)]
1304            set dx [expr ($_click(x) - $x)/double($w)]
1305            set dy [expr ($_click(y) - $y)/double($h)]
1306            set _click(x) $x
1307            set _click(y) $y
1308            set _view(xpan) [expr $_view(xpan) - $dx]
1309            set _view(ypan) [expr $_view(ypan) - $dy]
1310            PanCamera
1311        }
1312        "release" {
1313            Pan drag $x $y
1314            $itk_component(view) configure -cursor ""
1315        }
1316        default {
1317            error "unknown option \"$option\": should set, click, drag, or release"
1318        }
1319    }
1320}
1321
1322# ----------------------------------------------------------------------
1323# USAGE: InitSettings <what> ?<value>?
1324#
1325# Used internally to update rendering settings whenever parameters
1326# change in the popup settings panel.  Sends the new settings off
1327# to the back end.
1328# ----------------------------------------------------------------------
1329itcl::body Rappture::VtkHeightmapViewer::InitSettings { args } {
1330    foreach spec $args {
1331        if { [info exists _settings($_first${spec})] } {
1332            # Reset global setting with dataobj specific setting
1333            set _settings($spec) $_settings($_first${spec})
1334        }
1335        AdjustSetting $spec
1336    }
1337}
1338
1339#
1340# AdjustSetting --
1341#
1342#       Changes/updates a specific setting in the widget.  There are
1343#       usually user-setable option.  Commands are sent to the render
1344#       server.
1345#
1346itcl::body Rappture::VtkHeightmapViewer::AdjustSetting {what {value ""}} {
1347    if { $_beforeConnect } {
1348        return
1349    }
1350    switch -- $what {
1351        "-axisflymode" {
1352            set mode [$itk_component(axisflymode) value]
1353            set mode [$itk_component(axisflymode) translate $mode]
1354            set _settings($what) $mode
1355            SendCmd "axis flymode $mode"
1356        }
1357        "-axislabels" {
1358            set bool $_settings($what)
1359            SendCmd "axis labels all $bool"
1360        }
1361        "-axisminorticks" {
1362            set bool $_settings($what)
1363            foreach axis { x y z } {
1364                SendCmd "axis minticks ${axis} $bool"
1365            }
1366        }
1367        "-axisvisible" {
1368            set bool $_settings($what)
1369            SendCmd "axis visible all $bool"
1370        }
1371        "-xgrid" - "-ygrid" - "-zgrid" {
1372            set axis [string tolower [string range $what 1 1]]
1373            set bool $_settings($what)
1374            SendCmd "axis grid $axis $bool"
1375        }
1376        "-background" {
1377            set bg [$itk_component(background) value]
1378            array set fgcolors {
1379                "black" "white"
1380                "white" "black"
1381                "grey"  "black"
1382            }
1383            set fg $fgcolors($bg)
1384            configure -plotbackground $bg -plotforeground $fg
1385            $itk_component(view) delete "legend"
1386            SendCmd "screen bgcolor [Color2RGB $bg]"
1387            SendCmd "outline color [Color2RGB $fg]"
1388            SendCmd "axis color all [Color2RGB $fg]"
1389            DrawLegend
1390        }
1391        "-colormap" {
1392            set _changed($what) 1
1393            StartBufferingCommands
1394            set color [$itk_component(colormap) value]
1395            set _settings($what) $color
1396            if { $color == "none" } {
1397                if { $_settings(-colormapvisible) } {
1398                    SendCmd "heightmap surface 0"
1399                    set _settings(-colormapvisible) 0
1400                }
1401            } else {
1402                if { !$_settings(-colormapvisible) } {
1403                    SendCmd "heightmap surface 1"
1404                    set _settings(-colormapvisible) 1
1405                }
1406                SetCurrentColormap $color
1407                if {$_settings(-colormapdiscrete)} {
1408                    set numColors [expr $_settings(-numisolines) + 1]
1409                    SendCmd "colormap res $numColors $color"
1410                }
1411            }
1412            StopBufferingCommands
1413            EventuallyRequestLegend
1414        }
1415        "-colormapvisible" {
1416            set bool $_settings($what)
1417            SendCmd "heightmap surface $bool"
1418        }
1419        "-colormapdiscrete" {
1420            set bool $_settings($what)
1421            set numColors [expr $_settings(-numisolines) + 1]
1422            # FIXME: don't use StartBufferingCommands
1423            StartBufferingCommands
1424            if {$bool} {
1425                SendCmd "colormap res $numColors"
1426                # Discrete colormap requires preinterp on
1427                SendCmd "heightmap preinterp on"
1428            } else {
1429                SendCmd "colormap res default"
1430                # FIXME: add setting for preinterp (default on)
1431                SendCmd "heightmap preinterp on"
1432            }
1433            StopBufferingCommands
1434            EventuallyRequestLegend
1435        }
1436        "-edges" {
1437            set bool $_settings($what)
1438            SendCmd "heightmap edges $bool"
1439        }
1440        "-field" {
1441            set label [$itk_component(field) value]
1442            set fname [$itk_component(field) translate $label]
1443            set _settings($what) $fname
1444            if { [info exists _fields($fname)] } {
1445                foreach { label units components } $_fields($fname) break
1446                if { $components > 1 } {
1447                    set _colorMode vmag
1448                } else {
1449                    set _colorMode scalar
1450                }
1451                set _curFldName $fname
1452                set _curFldLabel $label
1453            } else {
1454                puts stderr "unknown field \"$fname\""
1455                return
1456            }
1457            set label [$_first hints label]
1458            if { $label == "" } {
1459                if { [string match "component*" $_curFldName] } {
1460                    set label Z
1461                } else {
1462                    set label $_curFldLabel
1463                }
1464            }
1465            # May be a space in the axis label.
1466            SendCmd [list axis name z $label]
1467
1468            if { [$_first hints zunits] == "" } {
1469                set units [lindex $_fields($_curFldName) 1]
1470            } else {
1471                set units [$_first hints zunits]
1472            }
1473            if { $units != "" } {
1474                # May be a space in the axis units.
1475                SendCmd [list axis units z $units]
1476            }
1477            # Get the new limits because the field changed.
1478            ResetAxes
1479            SendCmd "dataset scalar $_curFldName"
1480            SendCmd "heightmap colormode scalar $_curFldName"
1481            Zoom reset
1482            UpdateContourList
1483            DrawLegend
1484        }
1485        "-heightmapscale" {
1486            if { $_settings(-isheightmap) } {
1487                set scale [GetHeightmapScale]
1488                # Have to set the datasets individually because we are
1489                # tracking them in _comp2scale.
1490                foreach dataset [CurrentDatasets -all] {
1491                    SendCmd "heightmap heightscale $scale $dataset"
1492                    set _comp2scale($dataset) $scale
1493                }
1494                ResetAxes
1495            }
1496        }
1497        "-isheightmap" {
1498            set bool $_settings($what)
1499            set c $itk_component(view)
1500            StartBufferingCommands
1501            # Fix heightmap scale: 0 for contours, 1 for heightmaps.
1502            if { $bool } {
1503                set _settings(-heightmapscale) 50
1504                set _settings(-opacity) $_settings(-saveopacity)
1505                set _settings(-lighting) $_settings(-savelighting)
1506                set _settings(-outline) 0
1507            } else {
1508                set _settings(-heightmapscale) 0
1509                set _settings(-lighting) 0
1510                set _settings(-opacity) 100
1511                set _settings(-outline)  $_settings(-saveoutline)
1512            }
1513            InitSettings -lighting -opacity -outline
1514            set scale [GetHeightmapScale]
1515            # Have to set the datasets individually because we are
1516            # tracking them in _comp2scale.
1517            foreach dataset [CurrentDatasets -all] {
1518                SendCmd "heightmap heightscale $scale $dataset"
1519                set _comp2scale($dataset) $scale
1520            }
1521            if { $bool } {
1522                $itk_component(lighting) configure -state normal
1523                $itk_component(opacity) configure -state normal
1524                $itk_component(scale) configure -state normal
1525                $itk_component(opacity_l) configure -state normal
1526                $itk_component(scale_l) configure -state normal
1527                $itk_component(outline) configure -state disabled
1528                if {$_view(ortho)} {
1529                    SendCmd "camera mode ortho"
1530                } else {
1531                    SendCmd "camera mode persp"
1532                }
1533            } else {
1534                $itk_component(lighting) configure -state disabled
1535                $itk_component(opacity) configure -state disabled
1536                $itk_component(scale) configure -state disabled
1537                $itk_component(opacity_l) configure -state disabled
1538                $itk_component(scale_l) configure -state disabled
1539                $itk_component(outline) configure -state normal
1540                SendCmd "camera mode image"
1541            }
1542            if {$_settings(-stretchtofit)} {
1543                if {$scale == 0} {
1544                    SendCmd "camera aspect window"
1545                } else {
1546                    SendCmd "camera aspect square"
1547                }
1548            }
1549            ResetAxes
1550            if { $bool } {
1551                set q [list $_view(qw) $_view(qx) $_view(qy) $_view(qz)]
1552                $_arcball quaternion $q
1553                SendCmd "camera orient $q"
1554            } else {
1555                bind $c <ButtonPress-1> {}
1556                bind $c <B1-Motion> {}
1557                bind $c <ButtonRelease-1> {}
1558            }
1559            Zoom reset
1560            # Fix the mouse bindings for rotation/panning and the
1561            # camera mode. Ideally we'd create a bindtag for these.
1562            if { $bool } {
1563                # Bindings for rotation via mouse
1564                bind $c <ButtonPress-1> \
1565                    [itcl::code $this Rotate click %x %y]
1566                bind $c <B1-Motion> \
1567                    [itcl::code $this Rotate drag %x %y]
1568                bind $c <ButtonRelease-1> \
1569                    [itcl::code $this Rotate release %x %y]
1570            }
1571            StopBufferingCommands
1572        }
1573        "-isolinecolor" {
1574            set color [$itk_component(isolinecolor) value]
1575            if { $color == "none" } {
1576                if { $_settings(-isolinesvisible) } {
1577                    SendCmd "heightmap isolines 0"
1578                    set _settings(-isolinesvisible) 0
1579                }
1580            } else {
1581                if { !$_settings(-isolinesvisible) } {
1582                    SendCmd "heightmap isolines 1"
1583                    set _settings(-isolinesvisible) 1
1584                }
1585                SendCmd "heightmap isolinecolor [Color2RGB $color]"
1586            }
1587            DrawLegend
1588        }
1589        "-isolinesvisible" {
1590            set bool $_settings($what)
1591            SendCmd "heightmap isolines $bool"
1592            DrawLegend
1593        }
1594        "-legendvisible" {
1595            if { !$_settings($what) } {
1596                $itk_component(view) delete legend
1597            }
1598            DrawLegend
1599        }
1600        "-lighting" {
1601            if { $_settings(-isheightmap) } {
1602                set _settings(-savelighting) $_settings(-lighting)
1603                set bool $_settings($what)
1604                SendCmd "heightmap lighting $bool"
1605            } else {
1606                SendCmd "heightmap lighting 0"
1607            }
1608        }
1609        "-numisolines" {
1610            set _settings($what) [$itk_component(numisolines) value]
1611            set _currentNumIsolines $_settings($what)
1612            UpdateContourList
1613            set _changed($what) 1
1614            SendCmd "heightmap contourlist [list $_contourList]"
1615            if {$_settings(-colormapdiscrete)} {
1616                set numColors [expr $_settings($what) + 1]
1617                SendCmd "colormap res $numColors"
1618                EventuallyRequestLegend
1619            } else {
1620                DrawLegend
1621            }
1622        }
1623        "-opacity" {
1624            set _changed($what) 1
1625            set val [expr $_settings($what) * 0.01]
1626            if { $_settings(-isheightmap) } {
1627                set _settings(-saveopacity) $_settings($what)
1628                SendCmd "heightmap opacity $val"
1629            } else {
1630                SendCmd "heightmap opacity 1.0"
1631            }
1632        }
1633        "-outline" {
1634            if { $_settings(-isheightmap) } {
1635                SendCmd "outline visible 0"
1636            } else {
1637                set _settings(-saveoutline) $_settings($what)
1638                set bool $_settings($what)
1639                SendCmd "outline visible $bool"
1640            }
1641        }
1642        "-stretchtofit" {
1643            set bool $_settings($what)
1644            if { $bool } {
1645                set heightScale [GetHeightmapScale]
1646                if {$heightScale == 0} {
1647                    SendCmd "camera aspect window"
1648                } else {
1649                    SendCmd "camera aspect square"
1650                }
1651            } else {
1652                SendCmd "camera aspect native"
1653            }
1654            Zoom reset
1655        }
1656        "-wireframe" {
1657            set bool $_settings($what)
1658            SendCmd "heightmap wireframe $bool"
1659        }
1660        default {
1661            error "don't know how to fix $what"
1662        }
1663    }
1664}
1665
1666#
1667# RequestLegend --
1668#
1669#       Request a new legend from the server.  The size of the legend
1670#       is determined from the height of the canvas. 
1671#
1672# This should be called when
1673#       1.  A new current colormap is set.
1674#       2.  Window is resized.
1675#       3.  The limits of the data have changed.  (Just need a redraw).
1676#       4.  Number of isolines have changed. (Just need a redraw).
1677#       5.  Legend becomes visible (Just need a redraw).
1678#
1679itcl::body Rappture::VtkHeightmapViewer::RequestLegend {} {
1680    set _legendPending 0
1681    set font "Arial 8"
1682    set w 12
1683    set lineht [font metrics $font -linespace]
1684    # color ramp height = (canvas height) - (min and max value lines) - 2
1685    set h [expr {$_height - 2 * ($lineht + 2)}]
1686    set _legendHeight $h
1687
1688    set fname $_curFldName
1689    if { [string match "component*" $fname] } {
1690        set title ""
1691    } else {
1692        if { [info exists _fields($fname)] } {
1693            foreach { title units } $_fields($fname) break
1694            if { $units != "" } {
1695                set title [format "%s (%s)" $title $units]
1696            }
1697        } else {
1698            set title $fname
1699        }
1700    }
1701    # If there's a title too, substract one more line
1702    if { $title != "" } {
1703        incr h -$lineht
1704    }
1705    if { $h < 1 } {
1706        return
1707    }
1708    # Set the legend on the first heightmap dataset.
1709    if { $_currentColormap != ""  } {
1710        set cmap $_currentColormap
1711        SendCmd "legend $cmap scalar $_curFldName {} $w $h 0"
1712    }
1713}
1714
1715#
1716# ResetAxes --
1717#
1718#       Set axis z bounds and range
1719#
1720itcl::body Rappture::VtkHeightmapViewer::ResetAxes {} {
1721    if { ![info exists _limits($_curFldName)]} {
1722        SendCmd "dataset maprange all"
1723        SendCmd "axis autorange z on"
1724        SendCmd "axis autobounds z on"
1725        return
1726    }
1727    foreach { xmin xmax } $_limits(x) break
1728    foreach { ymin ymax } $_limits(y) break
1729    foreach { vmin vmax } $_limits($_curFldName) break
1730
1731    global tcl_precision
1732    set tcl_precision 17
1733    set xr [expr $xmax - $xmin]
1734    set yr [expr $ymax - $ymin]
1735    set vr [expr $vmax - $vmin]
1736    set r  [expr ($yr > $xr) ? $yr : $xr]
1737    if { $vr < 1.0e-17 } {
1738        set dataScale 1.0
1739    } else {
1740        set dataScale [expr $r / $vr]
1741    }
1742    set heightScale [GetHeightmapScale]
1743    set bmin [expr $heightScale * $dataScale * $vmin]
1744    set bmax [expr $heightScale * $dataScale * $vmax]
1745    if {$heightScale > 0} {
1746        set zpos [expr - $bmin]
1747        SendCmd "heightmap pos 0 0 $zpos"
1748    } else {
1749        SendCmd "heightmap pos 0 0 0"
1750    }
1751    set bmax [expr $bmax - $bmin]
1752    set bmin 0
1753    SendCmd "dataset maprange explicit $_limits($_curFldName) $_curFldName"
1754    SendCmd "axis bounds z $bmin $bmax"
1755    SendCmd "axis range z $_limits($_curFldName)"
1756}
1757
1758#
1759# SetCurrentColormap --
1760#
1761itcl::body Rappture::VtkHeightmapViewer::SetCurrentColormap { name } {
1762    # Keep track of the colormaps that we build.
1763    if { $name != "none" && ![info exists _colormaps($name)] } {
1764        BuildColormap $name
1765        set _colormaps($name) 1
1766    }
1767    set _currentColormap $name
1768    SendCmd "heightmap colormap $_currentColormap"
1769}
1770
1771
1772#
1773# BuildColormap --
1774#
1775#       Build the designated colormap on the server.
1776#
1777itcl::body Rappture::VtkHeightmapViewer::BuildColormap { name } {
1778    set cmap [ColorsToColormap $name]
1779    if { [llength $cmap] == 0 } {
1780        set cmap "0.0 0.0 0.0 0.0 1.0 1.0 1.0 1.0"
1781    }
1782    set wmap "0.0 1.0 1.0 1.0"
1783    SendCmd "colormap add $name { $cmap } { $wmap }"
1784}
1785
1786# ----------------------------------------------------------------------
1787# CONFIGURATION OPTION: -mode
1788# ----------------------------------------------------------------------
1789itcl::configbody Rappture::VtkHeightmapViewer::mode {
1790    switch -- $itk_option(-mode) {
1791        "heightmap" {
1792            set _settings(-isheightmap) 1
1793        }
1794        "contour" {
1795            set _settings(-isheightmap) 0
1796        }
1797        default {
1798            error "unknown mode settings \"$itk_option(-mode)\""
1799        }
1800    }
1801    if { !$_reset } {
1802        AdjustSetting -isheightmap
1803    }
1804}
1805
1806# ----------------------------------------------------------------------
1807# CONFIGURATION OPTION: -plotbackground
1808# ----------------------------------------------------------------------
1809itcl::configbody Rappture::VtkHeightmapViewer::plotbackground {
1810    if { [isconnected] } {
1811        set rgb [Color2RGB $itk_option(-plotbackground)]
1812        if { !$_reset } {
1813            SendCmd "screen bgcolor $rgb"
1814        }
1815        $itk_component(view) configure -background $itk_option(-plotbackground)
1816    }
1817}
1818
1819# ----------------------------------------------------------------------
1820# CONFIGURATION OPTION: -plotforeground
1821# ----------------------------------------------------------------------
1822itcl::configbody Rappture::VtkHeightmapViewer::plotforeground {
1823    if { [isconnected] } {
1824        set rgb [Color2RGB $itk_option(-plotforeground)]
1825        if { !$_reset } {
1826            SendCmd "outline color $rgb"
1827            SendCmd "axis color all $rgb"
1828        }
1829    }
1830}
1831
1832itcl::body Rappture::VtkHeightmapViewer::limits3 { dataobj } {
1833    lappend limits x [$dataobj limits x]
1834    lappend limits y [$dataobj limits y]
1835    if { [catch { $dataobj limits $_curFldName } vlim] != 0 } {
1836        set vlim [$dataobj limits v]
1837    }
1838    lappend limits v $vlim
1839    return $limits
1840}
1841
1842itcl::body Rappture::VtkHeightmapViewer::BuildContourTab {} {
1843
1844    set fg [option get $itk_component(hull) font Font]
1845    #set bfg [option get $itk_component(hull) boldFont Font]
1846
1847    set inner [$itk_component(main) insert end \
1848        -title "Contour/Surface Settings" \
1849        -icon [Rappture::icon contour2]]
1850    $inner configure -borderwidth 4
1851
1852    checkbutton $inner.legend \
1853        -text "Legend" \
1854        -variable [itcl::scope _settings(-legendvisible)] \
1855        -command [itcl::code $this AdjustSetting -legendvisible] \
1856        -font "Arial 9"
1857
1858    checkbutton $inner.wireframe \
1859        -text "Wireframe" \
1860        -variable [itcl::scope _settings(-wireframe)] \
1861        -command [itcl::code $this AdjustSetting -wireframe] \
1862        -font "Arial 9"
1863
1864    itk_component add lighting {
1865        checkbutton $inner.lighting \
1866            -text "Enable Lighting" \
1867            -variable [itcl::scope _settings(-lighting)] \
1868            -command [itcl::code $this AdjustSetting -lighting] \
1869            -font "Arial 9"
1870    } {
1871        ignore -font
1872    }
1873    checkbutton $inner.edges \
1874        -text "Edges" \
1875        -variable [itcl::scope _settings(-edges)] \
1876        -command [itcl::code $this AdjustSetting -edges] \
1877        -font "Arial 9"
1878
1879    itk_component add outline {
1880        checkbutton $inner.outline \
1881            -text "Outline" \
1882            -variable [itcl::scope _settings(-outline)] \
1883            -command [itcl::code $this AdjustSetting -outline] \
1884            -font "Arial 9"
1885    } {
1886        ignore -font
1887    }
1888    checkbutton $inner.stretch \
1889        -text "Stretch to fit" \
1890        -variable [itcl::scope _settings(-stretchtofit)] \
1891        -command [itcl::code $this AdjustSetting -stretchtofit] \
1892        -font "Arial 9"
1893
1894    checkbutton $inner.isolines \
1895        -text "Isolines" \
1896        -variable [itcl::scope _settings(-isolinesvisible)] \
1897        -command [itcl::code $this AdjustSetting -isolinesvisible] \
1898        -font "Arial 9"
1899
1900    checkbutton $inner.colormapDiscrete \
1901        -text "Discrete Colormap" \
1902        -variable [itcl::scope _settings(-colormapdiscrete)] \
1903        -command [itcl::code $this AdjustSetting -colormapdiscrete] \
1904        -font "Arial 9"
1905
1906    itk_component add field_l {
1907        label $inner.field_l -text "Field" -font "Arial 9"
1908    } {
1909        ignore -font
1910    }
1911    itk_component add field {
1912        Rappture::Combobox $inner.field -width 10 -editable no
1913    }
1914    bind $inner.field <<Value>> \
1915        [itcl::code $this AdjustSetting -field]
1916
1917    label $inner.colormap_l -text "Colormap" -font "Arial 9"
1918    itk_component add colormap {
1919        Rappture::Combobox $inner.colormap -width 10 -editable no
1920    }
1921    $inner.colormap choices insert end \
1922        "BCGYR"              "BCGYR"            \
1923        "BGYOR"              "BGYOR"            \
1924        "blue"               "blue"             \
1925        "blue-to-brown"      "blue-to-brown"    \
1926        "blue-to-orange"     "blue-to-orange"   \
1927        "blue-to-grey"       "blue-to-grey"     \
1928        "green-to-magenta"   "green-to-magenta" \
1929        "greyscale"          "greyscale"        \
1930        "nanohub"            "nanohub"          \
1931        "rainbow"            "rainbow"          \
1932        "spectral"           "spectral"         \
1933        "ROYGB"              "ROYGB"            \
1934        "RYGCB"              "RYGCB"            \
1935        "brown-to-blue"      "brown-to-blue"    \
1936        "grey-to-blue"       "grey-to-blue"     \
1937        "orange-to-blue"     "orange-to-blue"   \
1938        "none"               "none"
1939
1940    $itk_component(colormap) value "BCGYR"
1941    bind $inner.colormap <<Value>> \
1942        [itcl::code $this AdjustSetting -colormap]
1943
1944    label $inner.isolinecolor_l -text "Isolines Color" -font "Arial 9"
1945    itk_component add isolinecolor {
1946        Rappture::Combobox $inner.isolinecolor -width 10 -editable no
1947    }
1948    $inner.isolinecolor choices insert end \
1949        "black"              "black"            \
1950        "blue"               "blue"             \
1951        "cyan"               "cyan"             \
1952        "green"              "green"            \
1953        "grey"               "grey"             \
1954        "magenta"            "magenta"          \
1955        "orange"             "orange"           \
1956        "red"                "red"              \
1957        "white"              "white"            \
1958        "none"               "none"
1959
1960    $itk_component(isolinecolor) value "black"
1961    bind $inner.isolinecolor <<Value>> \
1962        [itcl::code $this AdjustSetting -isolinecolor]
1963
1964    label $inner.background_l -text "Background Color" -font "Arial 9"
1965    itk_component add background {
1966        Rappture::Combobox $inner.background -width 10 -editable no
1967    }
1968    $inner.background choices insert end \
1969        "black"              "black"            \
1970        "white"              "white"            \
1971        "grey"               "grey"             
1972
1973    $itk_component(background) value "white"
1974    bind $inner.background <<Value>> \
1975        [itcl::code $this AdjustSetting -background]
1976
1977    itk_component add opacity_l {
1978        label $inner.opacity_l -text "Opacity" -font "Arial 9"
1979    } {
1980        ignore -font
1981    }
1982    itk_component add opacity {
1983        ::scale $inner.opacity -from 0 -to 100 -orient horizontal \
1984            -variable [itcl::scope _settings(-opacity)] \
1985            -showvalue off \
1986            -command [itcl::code $this AdjustSetting -opacity]
1987    }
1988    itk_component add scale_l {
1989        label $inner.scale_l -text "Scale" -font "Arial 9"
1990    } {
1991        ignore -font
1992    }
1993    itk_component add scale {
1994        ::scale $inner.scale -from 0 -to 100 -orient horizontal \
1995            -variable [itcl::scope _settings(-heightmapscale)] \
1996            -showvalue off \
1997            -command [itcl::code $this AdjustSetting -heightmapscale]
1998    }
1999    label $inner.numisolines_l -text "Number of Isolines" -font "Arial 9"
2000    itk_component add numisolines {
2001        Rappture::Spinint $inner.numisolines \
2002            -min 0 -max 50 -font "arial 9"
2003    }
2004    $itk_component(numisolines) value $_settings(-numisolines)
2005    bind $itk_component(numisolines) <<Value>> \
2006        [itcl::code $this AdjustSetting -numisolines]
2007
2008    frame $inner.separator1 -height 2 -relief sunken -bd 1
2009    frame $inner.separator2 -height 2 -relief sunken -bd 1
2010
2011    blt::table $inner \
2012        0,0 $inner.field_l -anchor w -pady 2 \
2013        0,1 $inner.field -anchor w -pady 2 -fill x \
2014        1,0 $inner.colormap_l -anchor w -pady 2  \
2015        1,1 $inner.colormap   -anchor w -pady 2 -fill x  \
2016        2,0 $inner.isolinecolor_l  -anchor w -pady 2  \
2017        2,1 $inner.isolinecolor    -anchor w -pady 2 -fill x  \
2018        3,0 $inner.background_l -anchor w -pady 2 \
2019        3,1 $inner.background -anchor w -pady 2  -fill x \
2020        4,0 $inner.numisolines_l -anchor w -pady 2 \
2021        4,1 $inner.numisolines -anchor w -pady 2 \
2022        5,0 $inner.stretch    -anchor w -pady 2 -cspan 2 \
2023        6,0 $inner.edges      -anchor w -pady 2 -cspan 2 \
2024        7,0 $inner.legend     -anchor w -pady 2 -cspan 2 \
2025        8,0 $inner.colormapDiscrete -anchor w -pady 2 -cspan 2 \
2026        9,0 $inner.wireframe  -anchor w -pady 2 -cspan 2\
2027        10,0 $inner.isolines   -anchor w -pady 2 -cspan 2 \
2028        11,0 $inner.separator1 -padx 2 -fill x -cspan 2 \
2029        12,0 $inner.outline    -anchor w -pady 2 -cspan 2 \
2030        13,0 $inner.separator2 -padx 2 -fill x -cspan 2 \
2031        14,0 $inner.lighting   -anchor w -pady 2 -cspan 2 \
2032        15,0 $inner.opacity_l -anchor w -pady 2 \
2033        15,1 $inner.opacity   -fill x   -pady 2 \
2034        16,0 $inner.scale_l   -anchor w -pady 2 -cspan 2 \
2035        16,1 $inner.scale     -fill x   -pady 2 -cspan 2 \
2036
2037    blt::table configure $inner r* c* -resize none
2038    blt::table configure $inner r17 c1 -resize expand
2039}
2040
2041itcl::body Rappture::VtkHeightmapViewer::BuildAxisTab {} {
2042
2043    set fg [option get $itk_component(hull) font Font]
2044    #set bfg [option get $itk_component(hull) boldFont Font]
2045
2046    set inner [$itk_component(main) insert end \
2047        -title "Axis Settings" \
2048        -icon [Rappture::icon axis2]]
2049    $inner configure -borderwidth 4
2050
2051    checkbutton $inner.visible \
2052        -text "Axes" \
2053        -variable [itcl::scope _settings(-axisvisible)] \
2054        -command [itcl::code $this AdjustSetting -axisvisible] \
2055        -font "Arial 9"
2056    checkbutton $inner.labels \
2057        -text "Axis Labels" \
2058        -variable [itcl::scope _settings(-axislabels)] \
2059        -command [itcl::code $this AdjustSetting -axislabels] \
2060        -font "Arial 9"
2061    label $inner.grid_l -text "Grid" -font "Arial 9"
2062    checkbutton $inner.xgrid \
2063        -text "X" \
2064        -variable [itcl::scope _settings(-xgrid)] \
2065        -command [itcl::code $this AdjustSetting -xgrid] \
2066        -font "Arial 9"
2067    checkbutton $inner.ygrid \
2068        -text "Y" \
2069        -variable [itcl::scope _settings(-ygrid)] \
2070        -command [itcl::code $this AdjustSetting -ygrid] \
2071        -font "Arial 9"
2072    checkbutton $inner.zgrid \
2073        -text "Z" \
2074        -variable [itcl::scope _settings(-zgrid)] \
2075        -command [itcl::code $this AdjustSetting -zgrid] \
2076        -font "Arial 9"
2077    checkbutton $inner.minorticks \
2078        -text "Minor Ticks" \
2079        -variable [itcl::scope _settings(-axisminorticks)] \
2080        -command [itcl::code $this AdjustSetting -axisminorticks] \
2081        -font "Arial 9"
2082
2083
2084    label $inner.mode_l -text "Mode" -font "Arial 9"
2085
2086    itk_component add axisflymode {
2087        Rappture::Combobox $inner.mode -width 10 -editable no
2088    }
2089    $inner.mode choices insert end \
2090        "static_triad"    "static" \
2091        "closest_triad"   "closest" \
2092        "furthest_triad"  "farthest" \
2093        "outer_edges"     "outer"         
2094    $itk_component(axisflymode) value "static"
2095    bind $inner.mode <<Value>> [itcl::code $this AdjustSetting -axisflymode]
2096
2097    blt::table $inner \
2098        0,0 $inner.visible -anchor w -cspan 4 \
2099        1,0 $inner.labels  -anchor w -cspan 4 \
2100        2,0 $inner.minorticks  -anchor w -cspan 4 \
2101        4,0 $inner.grid_l  -anchor w \
2102        4,1 $inner.xgrid   -anchor w \
2103        4,2 $inner.ygrid   -anchor w \
2104        4,3 $inner.zgrid   -anchor w \
2105        5,0 $inner.mode_l  -anchor w -padx { 2 0 } \
2106        5,1 $inner.mode    -fill x -cspan 3
2107
2108    blt::table configure $inner r* c* -resize none
2109    blt::table configure $inner r7 c6 -resize expand
2110    blt::table configure $inner r3 -height 0.125i
2111}
2112
2113
2114itcl::body Rappture::VtkHeightmapViewer::BuildCameraTab {} {
2115    set inner [$itk_component(main) insert end \
2116        -title "Camera Settings" \
2117        -icon [Rappture::icon camera]]
2118    $inner configure -borderwidth 4
2119
2120    label $inner.view_l -text "view" -font "Arial 9"
2121    set f [frame $inner.view]
2122    foreach side { front back left right top bottom } {
2123        button $f.$side  -image [Rappture::icon view$side] \
2124            -command [itcl::code $this SetOrientation $side]
2125        Rappture::Tooltip::for $f.$side "Change the view to $side"
2126        pack $f.$side -side left
2127    }
2128
2129    blt::table $inner \
2130        0,0 $inner.view_l -anchor e -pady 2 \
2131        0,1 $inner.view -anchor w -pady 2
2132
2133    set labels { qx qy qz qw xpan ypan zoom }
2134    set row 1
2135    foreach tag $labels {
2136        label $inner.${tag}label -text $tag -font "Arial 9"
2137        entry $inner.${tag} -font "Arial 9"  -bg white \
2138            -textvariable [itcl::scope _view($tag)]
2139        bind $inner.${tag} <Return> \
2140            [itcl::code $this camera set ${tag}]
2141        bind $inner.${tag} <KP_Enter> \
2142            [itcl::code $this camera set ${tag}]
2143        blt::table $inner \
2144            $row,0 $inner.${tag}label -anchor e -pady 2 \
2145            $row,1 $inner.${tag} -anchor w -pady 2
2146        blt::table configure $inner r$row -resize none
2147        incr row
2148    }
2149    checkbutton $inner.ortho \
2150        -text "Orthographic Projection" \
2151        -variable [itcl::scope _view(ortho)] \
2152        -command [itcl::code $this camera set ortho] \
2153        -font "Arial 9"
2154    blt::table $inner \
2155            $row,0 $inner.ortho -cspan 2 -anchor w -pady 2
2156    blt::table configure $inner r$row -resize none
2157    incr row
2158
2159    blt::table configure $inner c* r* -resize none
2160    blt::table configure $inner c2 -resize expand
2161    blt::table configure $inner r$row -resize expand
2162}
2163
2164#
2165#  camera --
2166#
2167itcl::body Rappture::VtkHeightmapViewer::camera {option args} {
2168    switch -- $option {
2169        "show" {
2170            puts [array get _view]
2171        }
2172        "set" {
2173            set who [lindex $args 0]
2174            set x $_view($who)
2175            set code [catch { string is double $x } result]
2176            if { $code != 0 || !$result } {
2177                return
2178            }
2179            switch -- $who {
2180                "ortho" {
2181                    if {$_view(ortho)} {
2182                        SendCmd "camera mode ortho"
2183                    } else {
2184                        SendCmd "camera mode persp"
2185                    }
2186                }
2187                "xpan" - "ypan" {
2188                    PanCamera
2189                }
2190                "qx" - "qy" - "qz" - "qw" {
2191                    set q [list $_view(qw) $_view(qx) $_view(qy) $_view(qz)]
2192                    $_arcball quaternion $q
2193                    EventuallyRotate $q
2194                }
2195                "zoom" {
2196                    SendCmd "camera zoom $_view(zoom)"
2197                }
2198            }
2199        }
2200    }
2201}
2202
2203itcl::body Rappture::VtkHeightmapViewer::GetVtkData { args } {
2204    set bytes ""
2205    foreach dataobj [get] {
2206        foreach comp [$dataobj components] {
2207            set tag $dataobj-$comp
2208            set contents [$dataobj vtkdata $comp]
2209            append bytes "$contents\n"
2210        }
2211    }
2212    return [list .vtk $bytes]
2213}
2214
2215itcl::body Rappture::VtkHeightmapViewer::GetImage { args } {
2216    if { [image width $_image(download)] > 0 &&
2217         [image height $_image(download)] > 0 } {
2218        set bytes [$_image(download) data -format "jpeg -quality 100"]
2219        set bytes [Rappture::encoding::decode -as b64 $bytes]
2220        return [list .jpg $bytes]
2221    }
2222    return ""
2223}
2224
2225itcl::body Rappture::VtkHeightmapViewer::BuildDownloadPopup { popup command } {
2226    Rappture::Balloon $popup \
2227        -title "[Rappture::filexfer::label downloadWord] as..."
2228    set inner [$popup component inner]
2229    label $inner.summary -text "" -anchor w
2230    radiobutton $inner.vtk_button -text "VTK data file" \
2231        -variable [itcl::scope _downloadPopup(format)] \
2232        -font "Arial 9 " \
2233        -value vtk 
2234    Rappture::Tooltip::for $inner.vtk_button "Save as VTK data file."
2235    radiobutton $inner.image_button -text "Image File" \
2236        -variable [itcl::scope _downloadPopup(format)] \
2237        -font "Arial 9 " \
2238        -value image
2239    Rappture::Tooltip::for $inner.image_button \
2240        "Save as digital image."
2241
2242    button $inner.ok -text "Save" \
2243        -highlightthickness 0 -pady 2 -padx 3 \
2244        -command $command \
2245        -compound left \
2246        -image [Rappture::icon download]
2247
2248    button $inner.cancel -text "Cancel" \
2249        -highlightthickness 0 -pady 2 -padx 3 \
2250        -command [list $popup deactivate] \
2251        -compound left \
2252        -image [Rappture::icon cancel]
2253
2254    blt::table $inner \
2255        0,0 $inner.summary -cspan 2  \
2256        1,0 $inner.vtk_button -anchor w -cspan 2 -padx { 4 0 } \
2257        2,0 $inner.image_button -anchor w -cspan 2 -padx { 4 0 } \
2258        4,1 $inner.cancel -width .9i -fill y \
2259        4,0 $inner.ok -padx 2 -width .9i -fill y
2260    blt::table configure $inner r3 -height 4
2261    blt::table configure $inner r4 -pady 4
2262    raise $inner.image_button
2263    $inner.vtk_button invoke
2264    return $inner
2265}
2266
2267#
2268# SetObjectStyle --
2269#
2270#       Set the style of the heightmap/contour object.  This gets calls
2271#       for each dataset once as it is loaded.  It can overridden by
2272#       the user controls.
2273#
2274#
2275itcl::body Rappture::VtkHeightmapViewer::SetObjectStyle { dataobj comp } {
2276    # Parse style string.
2277    set tag $dataobj-$comp
2278    array set style {
2279        -color BCGYR
2280        -opacity 1.0
2281        -levels 10
2282    }
2283    set stylelist [$dataobj style $comp]
2284    if { $stylelist != "" } {
2285        array set style $stylelist
2286    }
2287    # This is too complicated.  We want to set the colormap, number of
2288    # isolines and opacity for the dataset.  They can be the default values,
2289    # the style hints loaded with the dataset, or set by user controls.  As
2290    # datasets get loaded, they first use the defaults that are overidden
2291    # by the style hints.  If the user changes the global controls, then that
2292    # overrides everything else.  I don't know what it means when global
2293    # controls are specified as style hints by each dataset.  It complicates
2294    # the code to handle aberrant cases.
2295
2296    if { $_changed(-opacity) } {
2297        set style(-opacity) [expr $_settings(-opacity) * 0.01]
2298    }
2299    if { $_changed(-numisolines) } {
2300        set style(-levels) $_settings-(numisolines)
2301    }
2302    if { $_changed(-colormap) } {
2303        set style(-color) $_settings(-colormap)
2304    }
2305    if { $_currentColormap == "" } {
2306        $itk_component(colormap) value $style(-color)
2307    }
2308    if { [info exists style(-stretchtofit)] } {
2309        set _settings(-stretchtofit) $style(-stretchtofit)
2310        AdjustSetting -stretchtofit
2311    }
2312
2313    if { $_currentNumIsolines != $style(-levels) } {
2314        set _currentNumIsolines $style(-levels)
2315        set _settings(-numisolines) $_currentNumIsolines
2316        $itk_component(numisolines) value $_currentNumIsolines
2317        UpdateContourList
2318        DrawLegend
2319    }
2320    SendCmd "outline add $tag"
2321    SendCmd "outline color [Color2RGB $itk_option(-plotforeground)] $tag"
2322    SendCmd "outline visible $_settings(-outline) $tag"
2323    set scale [GetHeightmapScale]
2324    SendCmd "[list heightmap add contourlist $_contourList $scale $tag]"
2325    set _comp2scale($tag) $_settings(-heightmapscale)
2326    SendCmd "heightmap edges $_settings(-edges) $tag"
2327    SendCmd "heightmap wireframe $_settings(-wireframe) $tag"
2328    SetCurrentColormap $style(-color)
2329    set color [$itk_component(isolinecolor) value]
2330    SendCmd "heightmap isolinecolor [Color2RGB $color] $tag"
2331    SendCmd "heightmap lighting $_settings(-isheightmap) $tag"
2332    SendCmd "heightmap isolines $_settings(-isolinesvisible) $tag"
2333    SendCmd "heightmap surface $_settings(-colormapvisible) $tag"
2334    SendCmd "heightmap opacity $style(-opacity) $tag"
2335    set _settings(-opacity) [expr $style(-opacity) * 100.0]
2336}
2337
2338itcl::body Rappture::VtkHeightmapViewer::IsValidObject { dataobj } {
2339    if {[catch {$dataobj isa Rappture::Field} valid] != 0 || !$valid} {
2340        return 0
2341    }
2342    return 1
2343}
2344
2345# ----------------------------------------------------------------------
2346# USAGE: ReceiveLegend <colormap> <title> <min> <max> <size>
2347#
2348# Invoked automatically whenever the "legend" command comes in from
2349# the rendering server.  Indicates that binary image data with the
2350# specified <size> will follow.
2351# ----------------------------------------------------------------------
2352itcl::body Rappture::VtkHeightmapViewer::ReceiveLegend { colormap title min max size } {
2353    #puts stderr "ReceiveLegend colormap=$colormap title=$title range=$min,$max size=$size"
2354    if { [isconnected] } {
2355        set bytes [ReceiveBytes $size]
2356        if { ![info exists _image(legend)] } {
2357            set _image(legend) [image create photo]
2358        }
2359        $_image(legend) configure -data $bytes
2360        #puts stderr "read $size bytes for [image width $_image(legend)]x[image height $_image(legend)] legend>"
2361        if { [catch {DrawLegend} errs] != 0 } {
2362            global errorInfo
2363            puts stderr "errs=$errs errorInfo=$errorInfo"
2364        }
2365    }
2366}
2367
2368#
2369# DrawLegend --
2370#
2371#       Draws the legend in the own canvas on the right side of the plot area.
2372#
2373itcl::body Rappture::VtkHeightmapViewer::DrawLegend {} {
2374    set fname $_curFldName
2375    set c $itk_component(view)
2376    set w [winfo width $c]
2377    set h [winfo height $c]
2378    set font "Arial 8"
2379    set lineht [font metrics $font -linespace]
2380   
2381    if { [string match "component*" $fname] } {
2382        set title ""
2383    } else {
2384        if { [info exists _fields($fname)] } {
2385            foreach { title units } $_fields($fname) break
2386            if { $units != "" } {
2387                set title [format "%s (%s)" $title $units]
2388            }
2389        } else {
2390            set title $fname
2391        }
2392    }
2393    set x [expr $w - 2]
2394    if { !$_settings(-legendvisible) } {
2395        $c delete legend
2396        return
2397    }
2398    if { [$c find withtag "legend"] == "" } {
2399        set y 2
2400        # If there's a legend title, create a text item for the title.
2401        $c create text $x $y \
2402                -anchor ne \
2403                -fill $itk_option(-plotforeground) -tags "title legend" \
2404                -font $font
2405        $c create text $x $y \
2406            -anchor ne \
2407            -fill $itk_option(-plotforeground) -tags "vmax legend" \
2408            -font $font
2409        incr y $lineht
2410        $c create image $x $y \
2411            -anchor ne \
2412            -image $_image(legend) -tags "colormap legend"
2413        $c create rectangle $x $y 1 1 \
2414            -fill "" -outline "" -tags "sensor legend"
2415        $c create text $x [expr {$h-2}] \
2416            -anchor se \
2417            -fill $itk_option(-plotforeground) -tags "vmin legend" \
2418            -font $font
2419        $c bind sensor <Enter> [itcl::code $this EnterLegend %x %y]
2420        $c bind sensor <Leave> [itcl::code $this LeaveLegend]
2421        $c bind sensor <Motion> [itcl::code $this MotionLegend %x %y]
2422    }
2423    $c delete isoline
2424    set x2 $x
2425    set iw [image width $_image(legend)]
2426    set ih [image height $_image(legend)]
2427    set x1 [expr $x2 - ($iw*12)/10]
2428    set color [$itk_component(isolinecolor) value]
2429
2430    # Draw the isolines on the legend.
2431    array unset _isolines
2432    if { $color != "none"  && [info exists _limits($_curFldName)] &&
2433         $_settings(-isolinesvisible) && $_currentNumIsolines > 0 } {
2434
2435        foreach { vmin vmax } $_limits($_curFldName) break
2436        set range [expr double($vmax - $vmin)]
2437        if { $range <= 0.0 } {
2438            set range 1.0;              # Min is greater or equal to max.
2439        }
2440        set tags "isoline legend"
2441        set offset [expr 2 + $lineht]
2442        if { $title != "" } {
2443            incr offset $lineht
2444        }
2445        foreach value $_contourList {
2446            set norm [expr 1.0 - (($value - $vmin) / $range)]
2447            set y1 [expr int(round(($norm * $ih) + $offset))]
2448            for { set off 0 } { $off < 3 } { incr off } {
2449                set _isolines([expr $y1 + $off]) $value
2450                set _isolines([expr $y1 - $off]) $value
2451            }
2452            $c create line $x1 $y1 $x2 $y1 -fill $color -tags $tags
2453        }
2454    }
2455
2456    $c bind title <ButtonPress> [itcl::code $this Combo post]
2457    $c bind title <Enter> [itcl::code $this Combo activate]
2458    $c bind title <Leave> [itcl::code $this Combo deactivate]
2459    # Reset the item coordinates according the current size of the plot.
2460    if { [info exists _limits($_curFldName)] } {
2461        foreach { vmin vmax } $_limits($_curFldName) break
2462        $c itemconfigure vmin -text [format %g $vmin]
2463        $c itemconfigure vmax -text [format %g $vmax]
2464    }
2465    set y 2
2466    # If there's a legend title, move the title to the correct position
2467    if { $title != "" } {
2468        $c itemconfigure title -text $title
2469        $c coords title $x $y
2470        incr y $lineht
2471    }
2472    $c coords vmax $x $y
2473    incr y $lineht
2474    $c coords colormap $x $y
2475    $c coords sensor [expr $x - $iw] $y $x [expr $y + $ih]
2476    $c raise sensor
2477    $c coords vmin $x [expr {$h - 2}]
2478}
2479
2480#
2481# EnterLegend --
2482#
2483itcl::body Rappture::VtkHeightmapViewer::EnterLegend { x y } {
2484    SetLegendTip $x $y
2485}
2486
2487#
2488# MotionLegend --
2489#
2490itcl::body Rappture::VtkHeightmapViewer::MotionLegend { x y } {
2491    Rappture::Tooltip::tooltip cancel
2492    set c $itk_component(view)
2493    set cw [winfo width $c]
2494    set ch [winfo height $c]
2495    if { $x >= 0 && $x < $cw && $y >= 0 && $y < $ch } {
2496        SetLegendTip $x $y
2497    }
2498}
2499
2500#
2501# LeaveLegend --
2502#
2503itcl::body Rappture::VtkHeightmapViewer::LeaveLegend { } {
2504    Rappture::Tooltip::tooltip cancel
2505    .rappturetooltip configure -icon ""
2506}
2507
2508#
2509# SetLegendTip --
2510#
2511itcl::body Rappture::VtkHeightmapViewer::SetLegendTip { x y } {
2512    set fname $_curFldName
2513    set c $itk_component(view)
2514    set w [winfo width $c]
2515    set h [winfo height $c]
2516    set font "Arial 8"
2517    set lineht [font metrics $font -linespace]
2518   
2519    set ih [image height $_image(legend)]
2520    # Subtract off the offset of the color ramp from the top of the canvas
2521    set iy [expr $y - ($lineht + 2)]
2522
2523    if { [string match "component*" $fname] } {
2524        set title ""
2525    } else {
2526        if { [info exists _fields($fname)] } {
2527            foreach { title units } $_fields($fname) break
2528            if { $units != "" } {
2529                set title [format "%s (%s)" $title $units]
2530            }
2531        } else {
2532            set title $fname
2533        }
2534    }
2535    # If there's a legend title, increase the offset by the line height.
2536    if { $title != "" } {
2537        incr iy -$lineht
2538    }
2539
2540    # Make a swatch of the selected color
2541    if { [catch { $_image(legend) get 10 $iy } pixel] != 0 } {
2542        return
2543    }
2544
2545    if { ![info exists _image(swatch)] } {
2546        set _image(swatch) [image create photo -width 24 -height 24]
2547    }
2548    set color [eval format "\#%02x%02x%02x" $pixel]
2549    $_image(swatch) put black  -to 0 0 23 23
2550    $_image(swatch) put $color -to 1 1 22 22
2551
2552    # Compute the value of the point
2553    if { [info exists _limits($fname)] } {
2554        foreach { vmin vmax } $_limits($fname) break
2555        set t [expr 1.0 - (double($iy) / double($ih-1))]
2556        set value [expr $t * ($vmax - $vmin) + $vmin]
2557    } else {
2558        set value 0.0
2559    }
2560    set tipx [expr $x + 15]
2561    set tipy [expr $y - 5]
2562    .rappturetooltip configure -icon $_image(swatch)
2563    if { [info exists _isolines($y)] } {
2564        Rappture::Tooltip::text $c [format "$title %g (isoline)" $_isolines($y)]
2565    } else {
2566        Rappture::Tooltip::text $c [format "$title %g" $value]
2567    }
2568    Rappture::Tooltip::tooltip show $c +$tipx,+$tipy   
2569}
2570
2571# ----------------------------------------------------------------------
2572# USAGE: _dropdown post
2573# USAGE: _dropdown unpost
2574# USAGE: _dropdown select
2575#
2576# Used internally to handle the dropdown list for this combobox.  The
2577# post/unpost options are invoked when the list is posted or unposted
2578# to manage the relief of the controlling button.  The select option
2579# is invoked whenever there is a selection from the list, to assign
2580# the value back to the gauge.
2581# ----------------------------------------------------------------------
2582itcl::body Rappture::VtkHeightmapViewer::Combo {option} {
2583    set c $itk_component(view)
2584    switch -- $option {
2585        post {
2586            foreach { x1 y1 x2 y2 } [$c bbox title] break
2587            set x1 [expr [winfo width $itk_component(view)] - [winfo reqwidth $itk_component(fieldmenu)]]
2588            set x [expr $x1 + [winfo rootx $itk_component(view)]]
2589            set y [expr $y2 + [winfo rooty $itk_component(view)]]
2590            tk_popup $itk_component(fieldmenu) $x $y
2591        }
2592        activate {
2593            $c itemconfigure title -fill red
2594        }
2595        deactivate {
2596            $c itemconfigure title -fill $itk_option(-plotforeground)
2597        }
2598        invoke {
2599            $itk_component(field) value $_curFldLabel
2600            AdjustSetting -field
2601        }
2602        default {
2603            error "bad option \"$option\": should be post, unpost, select"
2604        }
2605    }
2606}
2607
2608itcl::body Rappture::VtkHeightmapViewer::GetHeightmapScale {} {
2609    if {  $_settings(-isheightmap) } {
2610        set val $_settings(-heightmapscale)
2611        set sval [expr { $val >= 50 ? double($val)/50.0 : 1.0/(2.0-(double($val)/50.0)) }]
2612        return $sval
2613    }
2614    return 0
2615}
2616
2617itcl::body Rappture::VtkHeightmapViewer::SetOrientation { side } {
2618    array set positions {
2619        front  "0.707107 0.707107 0 0"
2620        back   "0 0 0.707107 0.707107"
2621        left   "0.5 0.5 -0.5 -0.5"
2622        right  "0.5 0.5 0.5 0.5"
2623        top    "1 0 0 0"
2624        bottom "0 1 0 0"
2625    }
2626    foreach name { qw qx qy qz } value $positions($side) {
2627        set _view($name) $value
2628    }
2629    set q [list $_view(qw) $_view(qx) $_view(qy) $_view(qz)]
2630    $_arcball quaternion $q
2631    SendCmd "camera orient $q"
2632    SendCmd "camera reset"
2633    set _view(xpan) 0
2634    set _view(ypan) 0
2635    set _view(zoom) 1.0
2636}
2637
2638itcl::body Rappture::VtkHeightmapViewer::UpdateContourList {} {
2639    if {$_currentNumIsolines == 0} {
2640        set _contourList ""
2641        return
2642    }
2643    if { ![info exists _limits($_curFldName)] } {
2644        return
2645    }
2646    foreach { vmin vmax } $_limits($_curFldName) break
2647    set v [blt::vector create \#auto]
2648    $v seq $vmin $vmax [expr $_currentNumIsolines+2]
2649    $v delete end 0
2650    set _contourList [$v range 0 end]
2651    blt::vector destroy $v
2652}
Note: See TracBrowser for help on using the repository browser.