daVinci API Definition - Overview of Commands

daVinci_commands  ::=       	/*List of API commands for option -init.*/
    [daVinci_commands1].
daVinci_commands1 ::=
    daVinci_command | daVinci_command,daVinci_commands1.

daVinci_command ::=		/*Commands of the API (top-level). */
    graph(graph_cmd) 			/*Graph category. Details.*/
  | multi(multi_cmd)			/*Multi category. Details.*/
  | menu(menu_cmd)			/*Menu category. Details.*/
  | app_menu(app_menu_cmd)		/*App_menu category. Details.*/
  | set(set_cmd)			/*Set category. Details.*/
  | window(window_cmd)			/*Window category. Details.*/
  | tcl(tcl_cmd)			/*Tcl category. Details.*/
  | special(special_cmd)		/*Special category. Details.*/
  | visual(visual_cmd)		        /*Visual category. Details.*/
  | drag_and_drop(drag_and_drop_cmd)    /*Drag and Drop category. Details.*/
  | nothing.				/*No operation, for syncronization.*/

graph_cmd ::=			/*Send and update graphs. Details.*/
    new(graphterm)			/*Send new graph. Details.*/
  | new_placed(graphterm)	 	/*Dito, better layout. Details.*/
  | update(node_updates,edge_updates)	/*Send graph updates. Details.*/
  | update(mixed_updates)	        /*Send graph updates. Details.*/
  | change_attr(attr_changes)		/*Change attributes. Details.*/
  | update_and_change_attr(node_updates,edge_updates,attr_changes)	
  				        /*Combination of both. Details.*/
  | update_and_change_attr(mixed_updates,attr_changes)
  				        /*Combination of both. Details.*/
  | change_type(type_changes).		/*Change type. Details.*/
	
multi_cmd ::=			/*For multi-graph mode. Details.*/
    new_context				/*Open graph context. Details.*/
  | open_context(context_id)		/*Dito, but ID is given. Details.*/
  | set_context(context_id).		/*Switch to context. Details.*/
  | set_context(context_id,window_id).	/*Switch to context and window. Details.*/
	
menu_cmd ::= 			/*Call functions of menu. Details.*/
    file(file_menu_cmd)			/*File menu category. Details.*/
  | view(view_menu_cmd)			/*View menu category. Details.*/
  | navigation(navigation_menu_cmd)	/*Navigation menu category. Details.*/
  | abstraction(abstraction_menu_cmd)	/*Abstraction menu category. Details.*/
  | layout(layout_menu_cmd).		/*Layout menu category. Details.*/
	
file_menu_cmd ::=		/*File menu functions. Details.*/
    new					/*Clear graph. Get Details.*/
  | open_graph(filename)		/*Load graph from file. Details.*/
  | open_graph_placed(filename)		/*Dito, better layout. Details.*/
  | open_status(filename)		/*Load status from file. Details.*/
  | save_graph(filename)		/*Save graph as term. Details.*/
  | save_status(filename)		/*Save graph as status. Details.*/
  | print(filename)			/*Save as PostScript. Details.*/
  | print				/*Open print dialog. Details.*/
  | close				/*Close graph window. Details.*/
  | exit.				/*Exit daVinci. Details.*/
	
view_menu_cmd ::=		/*View menu functions. Details.*/
    open_new_view			/*Open additional view. Details.*/
  | open_survey_view			/*Open survey view. Details.*/
  | full_scale				/*Set scale to 100%. Details.*/
  | fit_scale_to_window			/*Set scale to fit. Details.*/
  | scale(integer)			/*Set scale to integer. Details.*/
  | scale				/*Open Scale dialog. Details.*/
  | graph_info				/*Open Graph Info dialog. Details.*/
  | daVinci_info.			/*Open daVinci Info dialog. Details.*/
	
navigation_menu_cmd ::=		/*Navigation menu functions. Details.*/
    select_parents(node_ids)		/*Select parents of nodes. Details.*/
  | select_siblings(node_ids)		/*Select siblings of nodes. Details.*/
  | select_children(node_ids)		/*Select children of nodes. Details.*/
  | navigator(node_id,direction,boolean)/*Navigate in graph. Details.*/ 
  | navigator				/*Open Navigator dialog. Details.*/
  | find(string,boolean,boolean)	/*Find a node. Details.*/
  | find.				/*Open Find dialog. Details.*/
	
abstraction_menu_cmd ::=	/*Abstraction menu functions. Details.*/
    hide_subgraph(node_ids)		/*Hide subgraphs of nodes. Details.*/
  | show_subgraph(node_ids)		/*Show subgraphs of nodes. Details.*/
  | restore_all_subgraphs		/*Show all hidden subgr. Details.*/
  | hide_edges(node_ids)		/*Hide edges of nodes. Details.*/
  | show_edges(node_ids)		/*Show edges of nodes. Details.*/
  | restore_all_edges.			/*Show all hidden edges. Details.*/
	
layout_menu_cmd ::=		/*Layout menu functions. Details.*/
    improve_all				/*Start layout algorithm. Details.*/
  | improve_edges			/*Dito, only dummy nodes. Details.*/
  | improve_selected			/*Dito, only selected and dummy nodes. Details.*/
  | improve_nodes(node_ids)		/*Dito, only supplied and dummy nodes. Details.*/
  | improve_spacing			/*Compact graph layout. Details.*/
  | orientation(orientation).		/*Switch orientation. Details.*/
	
app_menu_cmd ::=		/*Create menus/icons. Details.*/
    create_menus(menus)			/*Add menus in Edit. Details.*/
  | create_icons(icons)			/*Add icons in icon-bar. Details.*/
  | activate_menus(menu_ids)		/*Enable menus. Details.*/
  | activate_icons(icon_ids)		/*Enable icons. Details.*/
  | control_file_events.		/*Get events of File menu. Details.*/
	
set_cmd ::=			/*Set options. Details.*/
    layout_accuracy(integer)	        /*Layout algorithm params. Details.*/
  | keep_nodes_at_levels(boolean)	/*Keep nodes at levels. Details.*/
  | font_size(integer)			/*Node font size. Details.*/
  | gap_width(integer)			/*Min. node distance. Details.*/
  | gap_height(integer)			/*Min. level distance. Details.*/
  | multi_edge_gap(integer)		/*Distance for multi-edges. Details.*/
  | self_edge_radius(integer)		/*Distance for self-edges. Details.*/
  | scrolling_on_selection(boolean)	/*Auto focusing node. Details.*/
  | animation_speed(integer)		/*Speed of animation. Details.*/
  | no_cache(boolean)			/*Control pixmap caching Details.*/
  | rules_first(boolean).		/*Control attribute evaluation. Details*/
	
window_cmd ::=			/*Control windows. Details.*/
    title(string)			/*Set window title. Details.*/
  | show_message(string)		/*Left footer message. Details.*/
  | show_status(string)			/*Right footer message. Details.*/
  | position(integer,integer)		/*Window origin x/y. Details.*/
  | size(integer,integer) 		/*Window width/height. Details.*/
  | raise				/*Raise window. Details.*/
  | iconify				/*Iconify window. Details.*/
  | deiconify				/*Deiconify window. Details.*/
  | activate				/*Enable interaction. Details.*/
  | deactivate				/*Disable interaction. Details.*/
  | file_browser(boolean,string,string,string,string,btypes,boolean).
		 			/*Show file browser. Details.*/
	
tcl_cmd ::=			/*Tcl/Tk interface. Details.*/
    eval(string)			/*Eval Tcl/Tk script. Details.*/
  | eval_file(filename).		/*Dito, from file. Details.*/
	
special_cmd ::=			/*Special commands. Details.*/
    select_nodes(node_ids)		/*Select specified nodes. Details.*/
  | select_edge(edge_id)		/*Select specified edge. Details.*/
  | focus_node(node_id)			/*Scroll to specified node. Details.*/
  | focus_node_animated(node_id)	/*Dito, with animation. Details.*/
  | show_url(string). 			/*Display HTML-page. Details.*/
	
visual_cmd ::=			/*Visualization definitions. Details.*/
    new_rules(visual_rules)		/*Define new rules. Details.*/
  | add_rules(visual_rules).		/*Add or modify rules. Details.*/
	
drag_and_drop_cmd ::=			/*Drag and Drop. Details.*/
    dragging_on				/*Drag and Drop on. Details.*/
  | dragging_off			/*Drag and Drop off. Details.*/
  | new_node_at_coord(node_update)	/*Insert node at drop position. Details.*/
  | new_edge_and_node_at_coord(node_update,edge_update).
					/*Insert node and edge at drop position. Details.*/