The Graph tree editor is an annotation tool designed for viewing and editing tree structures saved in FS file format. For details, see FS file format description. Both the analytical and tectogrammatical level of PDT annotation can be found in .fs file format on this CD.
The trees consist of nodes labeled by attribute-value pairs and are displayed with the root at the top of the screen. Users can configure the displayed attributes for all the nodes, screen font, colours etc. The tree can be rearranged in various ways, the editing functions include: subtree cutting and pasting, editing of the attribute values, changing the governor of the node or selecting the node to root the tree.
The editor enables to use macros, that are programmed in a specifically designed macro language. The Graph editor can be used in graphical or batch mode, where it works as an interpret of the macro language.
The Graph editor runs under Windows 3.x, Windows 95, Windows 98 and Windows 2000 systems.
The Graph editor runs under Windows 3.x, Windows 95, Windows 98 and Windows 2000 systems.
Copy the content of the directory graph into the file system on your harddrive (or, in case of any trouble, you might want to download the file graph.zip and unpack it in your designated Windows directory; please be aware that sometimes not all files from a directory are displayed in Windows Explorer). Run the program Graph.exe; in some cases, it might be possible to run it directly from the CD (try it here; graph.exe).
Opens new file containing only one one-node tree with one default attribute. The file is untitled and needs to be saved under a new name later. There can be at most one untitled file open in the application at any moment.
OpenOpens an existing file that the user chooses in the Open dialog box. The code page
is determined depending on the file extension
Saves the active file to the disk and codes the Czech characters back according to the file extension (see the File|Open command for the list of recognized extensions). The backup file is created; for files with standard extension FSx, the backup file extension is FBx (where x is one of 1,2 or space), for any other file it is FBX. Only modified files can be saved.
Save As...Prompts user for a new name of the file and then performs Save command.
Save AllSaves all open modified files complying to the rules above. Unmodified files are not saved.
RevertRecovers the file to its state at the last save. Any changes made after that are lost.
ExitDisplays the next tree of the active file.
PreviousDisplays previous tree of the active file.
Go To...Displays tree with specified number. Entering zero causes the editor to go to the last tree in the active file.
NumberDisplays the number of the currently displayed (active) tree in the file.
NewInserts a new tree in front of the active tree. The new tree contains only one node. Attribute values are filled with defaults.
InsertInserts the tree from the Clipboard to the position preceding the active tree. Because the attributes of the tree from the Clipboard can differ from those in the file, the sets of attributes are compared and only the corresponding values are copied. If there still remain undefined attributes in the file, the user is prompted to confirm the operation. The remaining attributes are then filled with defaults. This procedure is always applied in case of copying a tree from the Clipboard to the file.
AppendAppends the tree from the Clipboard to the end of the active file. See the Insert command section to learn more about copying trees from the Clipboard.
DeleteDeletes the active tree from the file. If it is the only tree in the file, the file is closed after user's confirmation.
Deletes the subtree of the active node, or the whole tree if the root is active, and places it into the Clipboard.
CopyCopies the subtree of the active node to the Clipboard. The displayed tree is not modified.
PastePastes the tree from the Clipboard as the last son of the active node. See the Tree|Insert section to learn more about copying trees from the Clipboard.
Paste LeftPastes the tree from the Clipboard as a left brother of the active node.
Paste RightPastes the tree from the Clipboard as a right brother of the active node.
RotateRotates the active node (with its subtree) and its right brother (with its subtree). This command is useful after adding the last son of some node to move it to the correct place by rotating it (without using the mouse).
Displays the Node Edit dialog box with the list of all attributes defined
for the file and the values assigned to them in the active node.
The window displays the following function buttons:
Copies all the attribute values of the active node to the node clipboard. This clipboard is different from the tree and value clipboards mentioned above.
PasteReplaces the active node attribute values with the corresponding values from the node clipboard. Remaining attribute values are not changed.
FindCreates a new node and connects it as the last son of the active node. All the attribute values of this node are filled with defaults.
Make RootActivates the left brother of the active node in the circular sons list, i.e. if the active node is the leftest son, it activates the rightest son.
RightActivates the right brother of the active node in the circular sons list.
UpActivates the parent node of the active node.
DownActivates the leftmost son of the active node.
Displays only the value of the first attribute for each node.
FullDisplays the values of all attributes for each node.
CustomizedOpens the dialog window in which the user can select the attributes that should be displayed. Click the attribute name to select/deselect it. Always at least one attribute has to be selected.
Hidden SubtreesToggle displaying the hidden subtrees of the tree. See the description of FS file format for details on hiding selected subtrees.
ClipboardDisplays the tree Clipboard in a separate window. Results of the operations Subtree|Cut and Subtree|Copy are automatically appended. The Clipboard window is not treated as a regular file because of its heterogenity (the trees can originate in different files with different sets of attributes) and therefore only limited number of commands is available.
AttributesDisplays Attributes dialog box with names and types of all attributes defined in the file. Available sub-commands:
Displays Bookmarks dialog box with list of all defined bookmarks.
Bookmark is an identifier that represents specified tree in the file
and it should be used for marking trees to find them fast later.
If the tree is deleted or window closed, bookmark is automatically
deleted from the list.
Available sub-commands:
A Block is a group of trees limited by the beginning tree and the end tree within one file. Commands in this menu enable to manipulate the block as a whole and thus make intermediate grade between file and tree. Another block command is located under View|Attributes|Set.
Set beginThe active tree is marked as the beginning of the block.
Set EndThe active tree is marked as the end of the block.
Go To BeginDisplays the beginning tree of the block (as if it was a bookmark).
Go To EndDisplays the end tree of the block.
Macros On BlockMoves the block to the position preceding the active tree. The blocks can be moved between different files and therefore the Paste command described in Tree|Insert is applied.
CopyCopies the block before the active tree. The blocks can be copied between different files and therefore pasting procedure described in Tree|Insert is applied.
DeleteDeletes the block, after prompting user for confirmation.
OpenOpens the specified file and places all the trees it contains as a block before the active tree. Pasting procedure described in Tree|Insert is applied.
Save As...Saves the current block as a separate file. The block is not deleted from the active file.
Example:
@P1 warning | /* the values of the positional attribute "warning" will be displayed in shadow text colour */ |
@P label | /* if 2 or no value is set for attribute, its values display in normal text colour */ |
@P3 error | /* the values of the positional attribute "error" will be displayed in highlight text colour */ |
At the end of this menu there is list of all open windows. The user can activate a window by choosing it from this list.
CascadeCascades all open windows.
TileTiles all open windows.
Arrange IconsArranges iconic windows along the bottom of the application window.
Close AllCloses all open windows and prompts user to save all modified files.
Displays the help window containing a smaller version of this manual.
AboutThe application is designed so that it could be controlled either only by keyboard or mouse (except for inputting text). However, the best solution is to combine both attitudes. The application makes it easy providing keyboard hotkeys and menu shortcuts on graphical toolbar in addition to standard menu controls. Trees can also be easily modified clicking and dragging the mouse.
I. MOUSE CONTROL
Some of the menu commands can be called from keyboard:
File -> Save | F2 |
Tree -> Next | > |
Tree -> Previous | < |
Subtree -> Cut | F5 |
Subtree -> Copy | F6 |
Subtree -> Paste | F7 |
Node -> Edit | Enter |
Node -> Find... | F3 |
The toolbar in the top part of the display area offers icons as shortcuts to menu commands. Place the mouse over the icon to display the description in the bottom status bar.