View Source: tkined(1) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages
tkined
!!!tkined
NAME
SYNOPSIS
DESCRIPTION
FILE MENU
SELECT MENU
CUSTOMIZATION
SEE ALSO
FILES
AUTHORS
----
!!NAME


tkined - An Interactive Network Editor based on Tk.
!!SYNOPSIS


__tkined__ ?''file1 file2 ...''?


________________________________________________________________________________________________________________________________________
!!DESCRIPTION


Tkined is an interactive editor for creating and maintaining
network maps. Tkined is programmable and can therefore be
used as a graphical frontend for quite a number of
applications that normally act on a network map (e.g.
network management systems, network simulators).
Applications run as separate processes that communicate with
tkined through a simple protocol. The most common way to
implement a tkined application is to use the network
management extension Tnm(n) for the Tool Command Language
Tcl(n) which encapsulated the protocol and provides access
to the editor using the ined(n) Tcl command.


Tkined has evolved from the original ined editor which was
written on top of the Unidraw/Interviews framework. Tkined
in its current form is a set of Tk(1) scripts and some C
code that handles the internal state of tkined
objects.


This man page is intended to provide a short overview over
menus provided by the Tkined editor.
!!FILE MENU


The File menu contains commands to save, load or print
network maps.


__Clear__ Clear the current map.


__Open...__ Load a previously saved map. The saved map
file contains a script of ined commands that will
reconstruct the map. Loading a map may also restart tkined
applications.


__Merge...__ Merge a previously saved map into the
current map.


__Save...__ Save the current map to the current file
name. Tkined will write into the file named noname.tki if
you never specified a different file name.


__Save As...__ Save the current map after choosing a new
file name.


__Print...__ Print or store the current network map in
!PostScript format. You are prompted to enter a print command
or to select a file name which will capture the !PostScript
output.


__Import...__ Import a background image. The image file
must have the X11 bitmap format.


__History...__ The editor maintains a history of recently
used map files in ~/.tkined/.history. The history command
allows to open a map file from the list of recently used
tkined maps. This allows to jump from map to map very
quickly.


__New View__ Create a new view. This looks much like
spawning a new tkined process, but a new view allows you to
copy and paste between the views and saves some
resources.


__Close View__ Close the tkined view. The tkined process
will exit if you close the last tkined view.
!!SELECT MENU


The Select menu contains commands that modify the set of
currently selection objects.


__Select All__ This command selects all objects shown on
the canvas.


__Select Neighbours__


Add all objects linked directly to a selected object to the
current selection.


__Select Member__


Add all member of all selected groups to the current
selection.


__Select by Type__


Add all objects of a given type to the current
selection.


__Select by Name__


Query the user for a regular or glob style expression and
add all objects to the current selection whose name matches
the expression.


__Select by Address__


Query the user for a regular or glob style expression and
add all objects to the current selection whose address
matches the expression.


__Select by Label__


Query the user for a regular or glob style expression and
add all objects to the current selection whose current label
contents matches the expression.


__Select by Attribute__


Query the user for an attribute and a regular or glob style
expression and add all objects to the current selection
where the content of the selected attribute matches the
expression.


The Edit menu contains the following commands for editing
maps.


__Attribute-__


Create a new attribute for all selected objects (also avail
by Button 3 popup menu).


__Attribute-__


Delete an attribute from all selected objects, if existing
(also avail by Button 3 popup menu).


__Attribute-__


Change an attribute for all selected objects.


__Set Label__ Set the label of all selected objects the
value of an attribute.


__Scale Factor__


Set the scaling factor of all selected bar- and
stripcharts.


__Grid Spacing__


Set the spacing between grid points in pixel.


__Align to Grid__


Align the selected objects on the grid. Objects not selected
will not be touched.


__Undo__ Undo the last change you made. Note that undo
currently cannot undo a delete command. If you are not sure
you really want to delete, use the cut command (see
below).


__Redo__ Redo the last undone change. A sequence like
undo undo redo redo should always bring you back in the
initial state.


__Delete__ Delete the current selection. All objects will
get lost since this command does not update the undo
buffer.


__Cut__ Delete the current selection and place all
deleted objects on the clipboard. The clipboard is a global
buffer shared by all views. You can use the cut command to
copy objects form one view to another.


__Copy__ Copy the current selection on the clipboard
without deleting the objects from the current
view.


__Paste__ Paste the objects stored on the clipboard into
the current view.


The Structure menu contains commands to modify the structure
of the map.


__Bring to Front__


Bring the selected objects to the front of the map.
Background images ignore this command.


__Send to Back__


Send the selected objects to the back of the
map.


__Group__ Create a new group object. The current
selection will become the members of the new group
object.


__Ungroup__ Delete a group object. The member of the
group will become visible again or the group frame will be
deleted if the group is currently expanded.


__Collapse__ Collapse an expanded group to show its icon.
A new group is always initially collapsed.


__Expand__ Expand a group object so that the member of
the group become visible. The group itself is shown as a
rectangle enclosing its members.


__Join Group__ This command can be used to add objects to
an existing group. You have to select the objects to add and
the group to add to. A dialog will ask you to select the
parent group if there are ambiguities.


__Leave Group__


All selected objects will be removed from any group they
belong to.


The Icon menu contains six sub menus allowing to manipulate
the appearance of tkined objects.


__Node__ This sub menu contains all configured node
icons.


__Network__ This sub menu contains all configured network
representations.


__Group__ This sub menu contains icons for group
objects.


__Reference__ This sub menu contains icons for reference
objects.


__Font__ The Font sub menu contains symbolic names for
all available fonts.


__Color__ The Color sub menu contains symbolic names for
the colors available. This sub menu will only appear if you
are working on a color display. Tkined will map all colors
to black if your application or your saved map expects color
definitions and you are sitting in front of a monochrome
display.


The Options menu allows you to set the page size and
orientation and offers some checkbuttons to control the
look-and-feel of tkined.


__Media__ This sub menu controls the size of the drawing
area.


__Orientation__


Set the orientation of the selected media. You can choose
between landscape and portrait mode.


__Flip Toolbox__


Toggle the Toolbox appearance (the box containing the tools
to create new tkined objects) between left and
top.


__Show Toolbox__


You can show or hide the tkined toolbox (the box containing
the tools to create new tkined objects) using the Show
Toolbox toggle.


__Lock Editor__


Locking the editor disallows creation and deletion of
objects. You can Unlock the editor by turning the Lock
Editor switch off again.


__Memory Validation__


If you have compiled and installed the Tk/Tcl libraries and
tkined with the memory validation define, this toggle
enables/disables memory validation. Note: Memory validation
is very time consuming and at least not even recommended for
debugging.


__Memory Trace__


If you have compiled and installed the Tk/Tcl libraries and
tkined with the memory validation define set, this toggles
enable/disable of memory allocation tracing. Trace
information is written to stderr of tkined.


__Memory Info__


If you have compiled and installed the Tk/Tcl libraries and
tkined with the memory validation define set, this prints
some memory usage statistics to stderr of
tkined.


__Strict Motif__


Toggle tkined's appearance between a nicer motif-like and
strict motif look-and-feel, as done by John within
tk.


The Help menu contains some infos about the editor and some
short help texts.


__General__ General information about
tkined.


__Status__ Some status information about the editor. This
is mainly for maintenance.


__Key Bindings__


A short note about the key bindings inside the canvas. This
may help you to learn about the various ways to use the
mouse buttons.
!!CUSTOMIZATION


You can customize the tkined editor to your specific needs.
You may load your own icon bitmaps and define the width of
various network types. All customization is done using
tkined.defaults files, that are very similar to xrdb(1)
files. Since there is no way to access the defaults database
of the server from within tk, the defaults files are
searched in the current directory, ~/.tkined,
$tkined(library)/site and $tkined(library) in this
order.


__width__


__height__ You can specify the default width and height
of the drawing area using the with and height
attribute.


__node i__ You may specify icons to represent machines
for the i-th node menu entry. The definition consists of two
strings. The first one is the filename of the bitmap and the
second is the name of the icon as shown in the node menu. A
colon can be used to create a path of submenus, e.g.
Sun:!SparcStation 2.


__group i__ The definition of an icon for a collapsed
group is done in the same way as for a node
icon.


__network i__ The definition of the i-th network consists
of the line thickness to use and the name that appears in
the menu.


__reference i__


The definition of an icon for a reference object is done in
the same way as for a node icon.


__interpreter i__


The i-th interpreter is defined by its file name. It is the
responsibility of the interpreter to define new menus using
the ined create MENU command.


__font i__ The font menu is build using the font
definitions. The i-th menu entry represents font i which
must be given as an X11 font name followed by the name used
in the font menu.


__color i__ The contents of the color menu is given by an
X11 color name and the name for this color used in the color
menu. The color menu does not appear on monochrome
displays.
!!SEE ALSO


Tcl(n), Tk(n), scotty(1)
!!FILES


/usr/local/lib/tkined1.5.0/tkined.defaults


/usr/local/lib/tkined1.5.0/init.tcl


/usr/local/lib/tkined1.5.0/bitmaps/*.xbm


$HOME/.tkined/tkined.defaults


$HOME/.tkined/*.xbm


$HOME/.tkined/.history
!!AUTHORS


Juergen Schoenwaelder
Guntram Hueske
----
3 pages link to tkined(1):
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
Last edited on Monday, June 3, 2002 6:51:15 pm by "perry"
Edit PageHistory Diff Info LikePages
Upcoming meetings

Past meetings
