Tuesday, October 15, 2019

Serialize/Deserialize a Gnocl Tree Widget

The options and command set of the gnocl::tree widget allow for easy creation and editing of data arranged and displayed in a tree structure. What is lacking in the Gtk api is an equivalent of the GtkTreeView serialize and deserialize functionality.

Creating a similar offering for the gnocl::tree is not altogether difficult to implement because it is possible to sequentially extract data from a tree which can then be saved for later use (serialize). When the data is next needed for use, it can be sequentially added to a new tree widget (deserialize).

The sampe code below will produce the following,  the tree on the left is created through the direct addtion of data, whereas the tree on the right (with treelines) is created by deserializing the data set of the first tree.





When data contained in a tree was serialzed the following list was returned and save to disk. Each line of list represents a row in the tree where the first item is the node path, and the second item, the data itself. More specifically, the data contains the valued held in each cel on each row. Hence, 2 values for 2 columns per row. 

0 {Mamals 0}
{0 0} {Cat 4}
{0 1} {Dog 4}
{0 2} {Human 2}
1 {ABC 0}
{1 0} {Parrots 0}
{1 0 0} {Cockatoo 2}
{1 0 1} {Amazone 2}
{1 1} {Predator 0}
{1 1 0} {Hawk 2}
{1 1 1} {Eagle 2}
2 {Bugs 0}
{2 0} {Beetle 6}
{2 1} {Spider 8}
{2 2} {Worm 0}

The path ids in the above form provide a means of identifying a specific row in the tree. The number of digits in the path id indicate the level of depth within the tree. In this example there are in fact three tree structures  displayed simulaneously, namely Mammals (0), Birds (1) and Insects (2).

Whenever an entry is added, the target doesn't exist and so, when deserializing the final element of the path id is ignored. In the case of the tree roots, (Mammals, Birds and Insects in the above example), the first and last nodes are the same, hence the path id set to "".



#---------------
# simple-tree.tcl
#---------------
#!/bin/sh
#\
exec tclsh "$0" "$@"

package require Gnocl

# TODO: Perhaps these two procs can be embedded into the C code?

proc serialize { wid } {
    foreach node [$wid nodeList] {
        ::lappend nodes $node [$wid getRow $node]
    }
    foreach key [::dict keys $nodes] {
        append res "[::list $key] [::list [::dict get $nodes $key]]\n"
    }
    return $res
}

proc deserialize {wid data} {
    foreach { pos val } $data {
        if { [::llength $pos] == 1 } { set pos "" }
        $wid add [::lrange $pos 0 end-1] [::list $val]   
    }
}

#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

# its necessary to have similar trees, i.e. same number of columns and data types.
set tree(1) [gnocl::tree \
    -ruleHint 1 \
    -onSelectionChanged {
        # use join to safely convert the list to a string.
        puts [ %w get [join %p] 0]
        # to get an entire row:
        puts [join %p]~~~[%w getRow [join %p] ]
       } \
    -types {string string} \
    -titles {"Type" "# of Legs"}]

set tree(2) [gnocl::tree \
    -treeLines 1 \
    -onSelectionChanged {
        # use join to safely convert the list to a string.
        puts [ %w get [join %p] 0]
        # to get an entire row:
        puts [join %p]~~~[%w getRow [join %p] ]
       } \
    -types {string string} \
    -titles {"Type" "# of Legs"}]

# add some items in a hap-hazard sort of way ;-)

$tree(1) add {} {Mammals Birds Insects}
$tree(1) add 0 {{Cat 4} {Dog 4} {Human 2}}

foreach {paro pred} [$tree(1) add 1 {Parrots Raptor}] {}

$tree(1) add $paro {{Cockatoo 2} {Sparrow 2}}
$tree(1) add $pred {{Hawk 2} {Eagle 2}}
$tree(1) add 2 {{Beetle 6} {Spider 8} {Centipede ?}}

set fp [open treeData.dat w]
puts $fp [serialize $tree(1)]
close $fp

set fp [open treeData.dat r]
deserialize $tree(2) [read $fp]
close $fp

set box1 [gnocl::vBox -label TreeView-1 -children $tree(1) -fill 1 -expand 1]
set box2 [gnocl::vBox -label TreeView-2 -children $tree(2) -fill 1 -expand 1]
set box [gnocl::hBox -children [list $box1 $box2] -fill 1 -expand 1]

foreach pid {0 1 2} {
    $tree(1) expand -path $pid -recursive 1
    $tree(2) expand -path $pid -recursive 1
}

gnocl::window -child $box -setSize 0.35

Cloning a Gnocl Widget Made Simple

A while ago I saw a StackoverFlow request about cloning widgets. Ok, the request was about cloning Gtk widgets in C, but here's the solution in Tcl using the Gnocl package. For a some time now its been possible to query the Gnocl package about the various options and commands available to each widget and its this ability combined with the cget (configuration get) command that allows property and data values to be extracted from a widget. Here's a very simple example based upon a button. 



#!/bin/sh
# the next line restarts using tclsh \
exec tclsh "$0" "$@"

if { [catch { package present Gnocl } ] } { package require Gnocl }

## clone specified widget
#/param    wid the widget to clone
#/returns   wid of newly created clone object

#
proc gnocl::clone { wid } {
               
        foreach item [split [string trim [gnocl::[$wid class] options]] \n] {
                # get list of options from internal help,
                # trim away option information
                set item [string range $item 0 [string first " " $item]-1]
                lappend res $item [$wid cget $item]
        }
       
        return [gnocl::[$wid class] {*}$res]
}

## test proc

#
proc main { } {

        set but [gnocl::button -text %#New -onClicked { puts "HIDIHI" } ]
       
        gnocl::window -child $but \
              -x 500 -y 500 -width 300 -title ORIGINAL
        gnocl::window -child [gnocl::clone $but] \
              -x 850 -y 500 -width 300 -title CLONE
       
}

main

Recent Changes. September 2019.

 Just a few enhancements to the code this month.

   gnocl::application
        o new option -title

  gnocl::labelEntry, gnocl::labelText, gnocl::labelWidget
        o new option -orientation

  gnocl::window
        o -geometry, list of four integers x, y, width, height.
        o cget -geometry returns same values as command geometry

  gnocl::label
        o cget -baseColor now returns correct value.

Saturday, July 06, 2019

Recent Changes. June 2019.

Spent most of my available time Tcl coding during June, none the less, a couple of bug fixes sorted out.

 gnocl::text
        o fixed buffer overflow bug in the 'tag ranges' subcommand.
        o fixed bug in "tag properties" commmand, now returns correct values for -foreground, -background, -fontRise, -rise and -font.   

Saturday, June 01, 2019

Recent Changes. May 2019.

    Some minor but useful changes and additions.

    drag and drop operations
        o -onDropData substitution string %d (data) now reassigned to %D,
          %d will now be replaced by widget data assigned by the -data option.
    gnocl::entry
        o new options -primaryIconTooltip and -secondaryIconTooltip.
    gnocl::comboEntry
        o cget -baseColor now works.
        o new options -onDragData, -onDropData and -afterDropData.
        o on activiation empty strings are no longer added to the dropdown list.
        o problem fixed with %d substitution within -onChanged event commands.
    gnocl::text
        o Now defaults to -wrapMode word.    

Monday, April 01, 2019

Recent Changes, April 2019

How time flies! I knew that I hadn't made one of this blog posts for some time but, didn't think that it such a long time ago. Well, some enhancements to the core modules has taken place although not too many.  In a nutshell a couple of bug fixes and some enhancements to a few widget options. As usual latest code available from SourceForge.



2019-03:
    gnocl::label
        o new commands push/pull, synonyms for set and get, when label used as simpler status bar.
    gnocl::text
        o -onSelection will now be respond to selections made via the keyboard.
    gnocl::fileChooserButton
        o %d substitution string implemented for -onFileSet callbacks.
    gnocl::comboBox
        o renamed onChanged command to changed.
        o problems with -onPopup and -onPopulateMenu options now fixed.       
2019-02
    gnocl::fileChooserButton
        o new command clear, resets file selection to 'none'.
        o added -fileName (include full path in utf8)
2019-01
    gnocl::comboBox
        o new option -widthGroup.

Saturday, November 10, 2018

Recent Changes, October 2018

Just a few enhancements to the module core, the most useful perhap being the  -onScroll signal handler for the eventBox widget.

2018-10
    gnocl::eventBox
        o added -onScroll, extra subsitution string %c returns child widget id.
    gnocl::text
        o insert command with -tags option now works again whilst when markup tags enabled
        o insert command now returns updated insert position (end of text)
        o get command, specifying a single pos will now return single character.
        o new command, clearSelection
    gnoc::scrolledWindow
        o cget -child now works.
    gnocl::label
        o get command will now return markup string dependent on widget configuration.
        o added command, reLabel.
    gnocl::separator
        o added -colour/-color
    gnocl::stockItem  
        o now recognizes %~ percent string for VFS
    gnocl::application
        o Problems with adding new items to menus now fixed.
    gnocl::menuBar
        o new command, nItems. Returns the total number of items in the menubar.   


json_shell_utils.tcl