- updated manual under holt_widget and simulation widget to reflect:

- disposition menu and places printout (holt)
  - scaling popup menu (simulation)



git-svn-id: svn://svn.gna.org/svn/sgpemv2/trunk@1186 3ecf2c5c-341e-0410-92b4-d18e462d057c
This commit is contained in:
paolo 2006-09-16 08:05:37 +00:00
parent df862714a0
commit 83cdf0efb4
4 changed files with 50 additions and 9 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 19 KiB

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 10 KiB

View File

@ -863,16 +863,36 @@ The other clicks... are all the same!
@strong{How to show/hide threads} @strong{How to show/hide threads}
With the menu item "Show Threads" under the "View" menu the user can enable or With the menu item "Show/Hide Threads" under the "View" menu the user can enable or
disable threads visibility. disable threads visibility.
@strong{Scaling the graph}
The user can select a scaling mode to view the graph.@*
This option is available with a popup menu right clicking in client area.
The options available are:
@itemize
@item @strong{No scaling} (default mode) the graph isn't scaled at all.
A white space can appear at right or bottom of the graph or even
the dimension can exceed client area. With horizontal and vertical scrollbar
the user can view all the graph surface.
@item @strong{Fit in window} the graph is resized to make visible every part of the graph.
A white (sometimes big) space can appear at right or bottom of the graph.
@item @strong{Stretch in window}like above the graph is resized but even stretched
to cover all client area.
@end itemize
Always one of these commands isn't available at a time;
the current mode doesn't appear because there isn't any reason to choose it.
@c % ------------------------------------------------- @c % -------------------------------------------------
@node The Holt graph, The Preferences dialog, The Simulation widget, From the GUI @node The Holt graph, The Preferences dialog, The Simulation widget, From the GUI
@subsection The Holt graph @subsection The Holt graph
@cindex holt @cindex holt
@image{holt_circle,7.3cm,8cm,Screenshot of the holt graph} @image{holt_circle,10.2cm,10.4cm,Screenshot of the holt graph}
The graph show the simulation status at @emph{this time}.@* The graph show the simulation status at @emph{this time}.@*
It represent resources, processes or threads (and status), It represent resources, processes or threads (and status),
@ -884,6 +904,8 @@ is displayed.
Resources are drawn as squares, processes and threads are circular, requests and Resources are drawn as squares, processes and threads are circular, requests and
allocations are in form of arrows.@* allocations are in form of arrows.@*
In center of resources are printed two lines: the name at top, the used/total places at bottom.@*
Into schedulables is shown their name.@*
An arrow from process (thread) to a resource is a request from the process to have An arrow from process (thread) to a resource is a request from the process to have
the resource; an arrow from the resource to the process denote the allocation of the the resource; an arrow from the resource to the process denote the allocation of the
resource to the process. resource to the process.
@ -898,31 +920,50 @@ The colors, as usual, are: green, yellow, red.
@strong{How to show processes or threads} @strong{How to show processes or threads}
With the menu item "Show Threads" under the "View" menu the user can switch from With the menu item "Show/Hide Threads" under the "View" menu the user can switch from
processes to threads visibility. processes to threads visibility.
@strong{How to show or hide the Holt Window} @strong{How to show or hide the Holt Window}
Holt graph, for pratical reasons, is placed in a separate frame out of the main Holt graph, for pratical reasons, is placed in a separate frame out of the main
application window.@* application window.@*
With the item "Show Holt graph" of the "View" menu is possible to show or hide With the item "Show/Hide Holt graph" of the "View" menu is possible to show or hide
this window. To close is always possible to use the standard close button or this window. To close is always possible to use the standard close button or
system menu command. system menu command.
@strong{Changing graph disposition}
The user can select the disposition of elements in the graph.@*
This option is available with a popup menu right clicking in client area.
The options available are:
@itemize
@item @strong{Dispose vertical} items are arranged vertially in two
columns, resources at left, processes (or threads) at right.
@item @strong{Dispose horizontal} items are arranged horizontally in two
rows, resources at top, processes (or threads) at bottom.
@item @strong{Dispose circular} the items are disposed along a circle.
@item @strong{Auto dispose} (default mode) one of above is select in function of
the aspect ratio of the window
@end itemize
Always one of these commands isn't available at a time;
the current mode doesn't appear because there isn't any reason to choose it.
@strong{Changing size and shape} @strong{Changing size and shape}
The user can change size of the Holt window.@* The user can change size of the Holt window.@*
As the window change size, his contents is scaled and rearranged to fit into As the window change size, his contents is scaled to fit into
the client area.@* the client area.
If the disposition is set in @emph{"Auto dispose"} mode then the disposition
can change during the resizing operation as described following.@*
If the height/width ratio is >= 5/3 the items are arranged vertially in two If the height/width ratio is >= 5/3 the items are arranged vertially in two
columns, resources at left, processes (or threads) at right.@* columns, resources at left, processes (or threads) at right.@*
If the height/width ratio is <= 3/5 the items are arranged horizontally in two If the height/width ratio is <= 3/5 the items are arranged horizontally in two
rows, resources at top, processes (or threads) at bottom.@* rows, resources at top, processes (or threads) at bottom.@*
Otherwise the items are disposed along a circle. Otherwise the items are disposed along a circle.
@image{holt_vert,12.1cm,8cm,Vertical arrangement of the holt graph}
@image{holt_horiz,4.5cm,8cm,Horizontal arrangement of the holt graph}
@c % ------------------------------------------------- @c % -------------------------------------------------
@node The Preferences dialog, Controlling the simulation, The Holt graph, From the GUI @node The Preferences dialog, Controlling the simulation, The Holt graph, From the GUI
@subsection The Preferences dialog @subsection The Preferences dialog