XY Graph Tab
Tkgraph Control Panel -- XY Graph Tab
- Select None button
- Clear the current graph selection. Only
graphs which are selected may be modified on
this tab. Selected graphs appear with a grey
background.
- Select One button
- Prepare the page for modifying one graph.
After pressing
this button, the user must left-click on
a graph on the page to select it.
- Select Some button
- Prepare the page for modifying multiple
graphs. After pressing this button, the user
must select one or more graphs for modifying.
Selection is done by either:
Left-clicking on a graph to set it as the
only selected graph
Control-left-clicking on a graph to toggle
it's selection state.
- Select All button
- Select every xy graph on the page.
- Autoscale button
- Autoscale every xy graph on the page.
(This is a bug. only selected graphs
should be autoscaled)
- Delete button
- Delete the selected graph(s).
- Raise button
- Sometimes items on the page will be obscured by other
page items. This button will raise the selected graphs
above every other item on the page so they are not obscured.
- Lower button
- Sometimes items on the page obscure other page items.
This button will lower the selected graphs
above every other item on the page so they do not obscure
any other page items.
- Update Values
- Fill in every entry area below with the
values from the currently selected graph. If
more than one graph is selected, the values
from only one graph are used.
The following is a description of the graph
properties that can be modified in this tab.
Each property is shown as a checkbutton, a label,
and an entry area.
THE CHECKBUTTON MUST BE SELECTED IN ORDER FOR THE PROPERTY TO BE CHANGED.
The value in the entry area will be used as the new value for that property.
- Graph Titles
- Title
- The title for the graph
- Title font
- The font to use for the graph title.
Pressing the button will open up the
font selector dialog to allow the
user to select a font name.
- Subtitle
- The subtitle for the graph.
- Subtitle font
- The font to use for the graph subtitle.
Pressing the button will open up the
font selector dialog to allow the
user to select a font name.
- Axis Labels
- X Axis Label
- The label to use for the X (horizontal)
axis.
- X Axis Label Font
- The font to use for drawing the X Axis
Label. Pressing the button will open up the
font selector dialog
to allow the user to select a font name.
- Y Axis Label
- The label to use for the Y (vertical)
axis.
- X Axis Label Font
- The font to use for drawing the Y Axis
Label. Pressing the button will open up the
font selector dialog
to allow the user to select a font name.
- Axis Limits
- X Axis Min
- The minimum value to be displayed on the x
axis.
- X Axis Max
- The maximum value to be displayed on the x
axis.
- Y Axis Min
- The minimum value to be displayed on the y
axis.
- Y Axis Max
- The maximum value to be displayed on the y
axis.
- Tickmark Intervals
- X Axis Major Tick Interval
- The spacing, in graph coordinates, between
the major x tickmarks.
- X Axis Minor Tick Interval
- The spacing, in graph coordinates, between
the minor x tickmarks. If this is not
a factor of the x major tick interval,
then the minor tickmarks won't line up with
the major tickmarks.
- X Axis Tick Origin
- The value at which to start drawing the
tickmarks. Tickmarks are drawn at increasing
and decreasing values starting at the
tickmark origin and continuing until the
edges of the graph are reached. The value
given for this tick origin is guaranteed
to have a major tickmark.
- X Axis Tick Format
- A C-style floating point format. This value is
passed directly to sprintf() for displaying the
tickmark values. The leading % and trailing f are
required. Actually, any C format identifier may be
used. Beware, though: tickmark values are stored
internally as floating-point numbers.
Only use C format identifiers that are
intended for floating-point values, such as
%e
, %f
, and
%g
. If you use others then you
may crash the program.
If no format is given then %g
is used. Use %.0f
to simulate the
behaviour of %d
.
- Y Axis Major Tick Interval
- The spacing, in graph coordinates, between
the major y tickmarks.
- Y Axis Minor Tick Interval
- The spacing, in graph coordinates, between
the minor y tickmarks. If this is not
a factor of the y major tick interval,
then the minor tickmarks won't line up with
the major tickmarks.
- Y Axis Tick Origin
- The value at which to start drawing the
tickmarks. Tickmarks are drawn at increasing
and decreasing values starting at the
tickmark origin and continuing until the
edges of the graph are reached. The value
given for this tick origin is guaranteed
to have a major tickmark.
- Y Axis Tick Format
- A C-style floating point format. This value is
passed directly to sprintf() for displaying the
tickmark values. The leading % and trailing f are
required. Actually, any C format identifier may be
used. Beware, though: tickmark values are stored
internally as floating-point numbers.
Only use C format identifiers that are
intended for floating-point values, such as
%e
, %f
, and
%g
. If you use others then you
may crash the program.
If no format is given then %g
is used. Use %.0f
to simulate the
behaviour of %d
.
- Tickmark sizes
- X Axis Major Tick Size
- The size, in pixels of the major tickmarks
along the x axis.
- X Axis Minor Tick Size
- The size, in pixels of the minor tickmarks
along the x axis.
- Y Axis Major Tick Size
- The size, in pixels of the major tickmarks
along the y axis.
- Y Axis Minor Tick Size
- The size, in pixels of the minor tickmarks
along the y axis.
- Graph Buffers
- West Buffer
- This is the amount of space allocated to the left of the graph
for drawing the Y axis label. The Y axis label is centered
in this space.
- North Buffer
- This is the amount of space allocated above the graph
for drawing the graph title and subtitle. The graph title is
centered 2/3 to the top of the space. The graph subtitle is
centered 1/3 to the top of the space.
- East Buffer
- This is the amount of space allocated to the right of the graph.
It is not currently used for anything.
- South Buffer
- This is the amount of space allocated below the graph
for drawing the X axis label. The X axis label is centered
in this space.
- Graph Coordinates
- X0 Position
- Setting this will move the left side of the graph
to the specified X value. The graph is resized,
not moved, to accomodate the change.
- y0 Position
- Setting this will move the top side of the graph
to the specified Y value. The graph is resized,
not moved, to accomodate the change.
- X1 Position
- Setting this will move the right side of the graph
to the specified X value. The graph is resized,
not moved, to accomodate the change.
- Y1 Position
- Setting this will move the bottom side of the graph
to the specified Y value. The graph is resized,
not moved, to accomodate the change.
- Horiz/Vert Bars
- Vertical Bar Positions
- A space-separated list of values for
drawing vertical bars. If the values lie
within the x axis boundaries, a line will be
drawn at these positions and extending from
the bottom to the top of the graph.
- Horizontal Bar Positions
- A space-separated list of values for
drawing horizontal bars. If the values lie
within the y axis boundaries, a line will be
drawn at these positions and extending from
the bottom to the top of the graph.
- Bar width
- The width, in pixels, of the horizontal and vertical
bars.
- Bar color
- The color of the horizontal and vertical bars.
Either color name or the rgb value may be used. For example,
either the color name "steel blue" or the rgb value "#4682b4"
may be used.
- Miscellaneous
- Outline Color
- This is used to change the color of the
outline around the graph. Set this
to an empty string to make the outline
go away. Either color name or the rgb
value may be used. For example, either the
color name "steel blue" or the rgb value
"#4682b4" may be used.
- Tick Label Font
- The font to use for drawing the tick labels.
Pressing the button will open up the font selector dialog
to allow the user to select a font name.
- Tick Label Color
- The color to use for drawing tickmark labels.
Either color name or the rgb value may be
used.
- Tickmark Color
- The color to use for drawing the tickmarks.
Either color name or the rgb value may be
used.