134 lines
12 KiB
HTML
134 lines
12 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML><HEAD><style type="text/css">
|
||
|
|
<!--
|
||
|
|
A:link {font-family: helvetica, arial, geneva, sans-serif; font-size: small; text-decoration: none; color: #000000}
|
||
|
|
A:visited {font-family: helvetica, arial, geneva, sans-serif; font-size: small; text-decoration: none; color: #000000}
|
||
|
|
A:hover {font-family: helvetica, arial, geneva, sans-serif; font-size: small; text-decoration: underline; color: #FF0000}
|
||
|
|
A.no:link {font-family:inherit; font-size: inhreit;text-decoration: none; color: #000000}
|
||
|
|
A.no:visited {font-family:inherit; font-size: inherit;text-decoration: none; color: #000000}
|
||
|
|
A.no:hover {font-family:inherit; font-size: inherit;text-decoration: none; color: #000000}
|
||
|
|
th {font-family: helvetica, arial; color : black; font-size:90%; background : #b7c8b7; border-right:black solid 1pt; border-bottom:black solid 1pt;}
|
||
|
|
td {font-family: helvetica, arial; color : black; font-size:90%; background : white; border-right:black solid 1pt; border-bottom:black solid 1pt;}
|
||
|
|
|
||
|
|
//-->
|
||
|
|
</style></HEAD><hr><div style="padding-left:4px;border-left:solid black 1px;border-top:solid black 1px;border-bottom:solid black 2px;border-right:solid black 2px;background-color:#deaa87;font-family:courier new;font-size:16pt;">Class <a class="no" name="_C_LINEARSCALE"><b>LinearScale</b></a></div>
|
||
|
|
<i>(Defined in: jpgraph.php : 4397)</i><br> <br><table cellspaceing=0 cellpadding=4 style="border:solid #303030 1px;"><tr><td align="center" style="background:lightgray;" > <a href="LinearScale.html" style="font-family:arial;font-weight:bold;color:darkblue;">LinearScale</a> </td></tr><tr><td valign=top> <a href="LinearScale.html#_LINEARSCALE_SETAUTOMAX">SetAutoMax()</a> <br>
|
||
|
|
<a href="LinearScale.html#_LINEARSCALE_SETAUTOMIN">SetAutoMin()</a> <br>
|
||
|
|
<a href="LinearScale.html#_LINEARSCALE_SETAUTOTICKS">SetAutoTicks()</a> <br>
|
||
|
|
<a href="LinearScale.html#_LINEARSCALE_SETGRACE">SetGrace()</a> <br>
|
||
|
|
</td></tr></table> <p><div style="font-weight:bold;font-family:arial;font-size:100%;">Class usage and Overview</div>This class is the main scale class and implements the linear and integer scale for the axis. <p>
|
||
|
|
<div style="font-weight:bold;font-family:arial;font-size:85%;">See also related classes:</div><a href="Axis.html">Axis</a> and <a href="LogScale.html">LogScale</a> <p> <hr><span style="font-family:arial;font-size:120%;font-weight:bold;">Class Methods</span><hr><p>
|
||
|
|
<p> <div style='font-family: helvetica, arial, geneva, sans-serif;margin-bottom:4px;border-left:solid black 1px;border-top:solid black 1px;border-bottom:solid black 2px;border-right:solid black 2px;font-size:120%;background:#dde9af;padding:4px;'><a class="no" name="_LINEARSCALE_SETAUTOMAX"><span style="color:#555555;">LinearScale ::</span><br><b>SetAutoMax</b>($aMax)</a></div>
|
||
|
|
|
||
|
|
<span style='font-family:arial;font-size:95%;'><i>Fix the maximum value for a scale</i></span><p>
|
||
|
|
|
||
|
|
<table cellspacing=0 style='border:black solid 1pt;' width=100%>
|
||
|
|
<tr><th width=25%>Argument</th><th width=15%>Default</th><th width=60%>Description</th></tr>
|
||
|
|
<tr><td style='border-right:black solid 1pt;font-family:courier;font-size:100%;font-weight:bold;'><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB">$aMax</span>
|
||
|
|
</span>
|
||
|
|
|
||
|
|
</td><td style='border-right:black solid 1pt;font-family:courier;font-size:100%;font-weight:bold;'> </td><td>Maximum value</td></tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div style="font-weight:bold;font-family:arial;font-size:90%;">Description:</div>Fix a maximum value for a scale eventhough autoscaling is used for the min value. <br>
|
||
|
|
|
||
|
|
<div style="font-weight:bold;font-family:arial;font-size:90%;"><p>Example:</div><div style="padding:5px;border:dashed gray 1px;background-color:#f3f3f3;font-family:courier new;font-size:90%;font-weight:bold;"><b><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB"></span><span style="color: #FF8000">// For a negative scale we might want to make sure it
<br />// always start at the top from 0
<br /></span><span style="color: #0000BB">$graph</span><span style="color: #007700">-></span><span style="color: #0000BB">y2scale</span><span style="color: #007700">-></span><span style="color: #0000BB">SetAutoMax</span><span style="color: #007700">(</span><span style="color: #0000BB">0</span><span style="color: #007700">);</span><span style="color: #0000BB"></span>
|
||
|
|
</span>
|
||
|
|
</b></div><br>
|
||
|
|
<p>
|
||
|
|
<p> <div style='font-family: helvetica, arial, geneva, sans-serif;margin-bottom:4px;border-left:solid black 1px;border-top:solid black 1px;border-bottom:solid black 2px;border-right:solid black 2px;font-size:120%;background:#dde9af;padding:4px;'><a class="no" name="_LINEARSCALE_SETAUTOMIN"><span style="color:#555555;">LinearScale ::</span><br><b>SetAutoMin</b>($aMin)</a></div>
|
||
|
|
|
||
|
|
<span style='font-family:arial;font-size:95%;'><i>Set the minimum data value when the autoscaling is used.</i></span><p>
|
||
|
|
|
||
|
|
<table cellspacing=0 style='border:black solid 1pt;' width=100%>
|
||
|
|
<tr><th width=25%>Argument</th><th width=15%>Default</th><th width=60%>Description</th></tr>
|
||
|
|
<tr><td style='border-right:black solid 1pt;font-family:courier;font-size:100%;font-weight:bold;'><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB">$aMin</span>
|
||
|
|
</span>
|
||
|
|
|
||
|
|
</td><td style='border-right:black solid 1pt;font-family:courier;font-size:100%;font-weight:bold;'> </td><td>Min value</td></tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div style="font-weight:bold;font-family:arial;font-size:90%;">Description:</div>Set the minimum data value when the autoscaling is used. Usefull if you want a fix minimum (like 0) but automtic maximum value. <br>
|
||
|
|
|
||
|
|
<div style="font-weight:bold;font-family:arial;font-size:90%;"><p>Example:</div><div style="padding:5px;border:dashed gray 1px;background-color:#f3f3f3;font-family:courier new;font-size:90%;font-weight:bold;"><b><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB"></span><span style="color: #FF8000">// Just let the maximum be autoscaled
<br /></span><span style="color: #0000BB">$graph</span><span style="color: #007700">-></span><span style="color: #0000BB">yaxis</span><span style="color: #007700">-></span><span style="color: #0000BB">scale</span><span style="color: #007700">-></span><span style="color: #0000BB">SetAutoMin</span><span style="color: #007700">(</span><span style="color: #0000BB">0</span><span style="color: #007700">);</span><span style="color: #0000BB"></span>
|
||
|
|
</span>
|
||
|
|
</b></div><br>
|
||
|
|
<p>
|
||
|
|
<p> <div style='font-family: helvetica, arial, geneva, sans-serif;margin-bottom:4px;border-left:solid black 1px;border-top:solid black 1px;border-bottom:solid black 2px;border-right:solid black 2px;font-size:120%;background:#dde9af;padding:4px;'><a class="no" name="_LINEARSCALE_SETAUTOTICKS"><span style="color:#555555;">LinearScale ::</span><br><b>SetAutoTicks</b>($aFlag)</a></div>
|
||
|
|
|
||
|
|
<span style='font-family:arial;font-size:95%;'><i>Determine ticks automtically with manual scale</i></span><p>
|
||
|
|
|
||
|
|
<table cellspacing=0 style='border:black solid 1pt;' width=100%>
|
||
|
|
<tr><th width=25%>Argument</th><th width=15%>Default</th><th width=60%>Description</th></tr>
|
||
|
|
<tr><td style='border-right:black solid 1pt;font-family:courier;font-size:100%;font-weight:bold;'><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB">$aFlag</span>
|
||
|
|
</span>
|
||
|
|
|
||
|
|
</td><td style='border-right:black solid 1pt;font-family:courier;font-size:100%;font-weight:bold;'><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB">true</span>
|
||
|
|
</span>
|
||
|
|
</td><td>TRUE = determine ticks automatically</td></tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div style="font-weight:bold;font-family:arial;font-size:90%;">Description:</div>This is used in conjunction when a manual scale is specified. In normall cases one has also to specify major and minor tick steps.
|
||
|
|
<p>
|
||
|
|
For example:<br>
|
||
|
|
|
||
|
|
$graph->SetScale("textlin",0,70);<br>
|
||
|
|
$graph->yscale->ticks->Set(10,2);
|
||
|
|
<p>
|
||
|
|
However by instead using
|
||
|
|
<p>
|
||
|
|
$graph->SetScale("textlin",0,70);<br>
|
||
|
|
$graph->yscale->SetAutoTicks();
|
||
|
|
<p>
|
||
|
|
The major and minor ticks are determined automatically.
|
||
|
|
<p>
|
||
|
|
The thing you have to be aware of is that the specified min and max values might be slightly modified so that the end/beginning of the scale will fall on a major tick step.
|
||
|
|
<p>
|
||
|
|
By default the auto ticks are off.
|
||
|
|
|
||
|
|
|
||
|
|
<br>
|
||
|
|
<div style="font-weight:bold;font-family:arial;font-size:90%;">See also:</div><ul><li><a href="Graph.html#_GRAPH_SETSCALE">Graph::SetScale()</a></ul>
|
||
|
|
<div style="font-weight:bold;font-family:arial;font-size:90%;"><p>Example:</div><div style="padding:5px;border:dashed gray 1px;background-color:#f3f3f3;font-family:courier new;font-size:90%;font-weight:bold;"><b><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB"></span><span style="color: #FF8000">// Manually set Y-scale min=30, max=90
<br /></span><span style="color: #0000BB">$graph</span><span style="color: #007700">-></span><span style="color: #0000BB">SetScale</span><span style="color: #007700">(</span><span style="color: #DD0000">'textlin'</span><span style="color: #007700">,</span><span style="color: #0000BB">30</span><span style="color: #007700">,</span><span style="color: #0000BB">90</span><span style="color: #007700">);
<br />
<br /></span><span style="color: #FF8000">// Let JpGraph figure out suitable tick marks
<br /></span><span style="color: #0000BB">$graph</span><span style="color: #007700">-></span><span style="color: #0000BB">yscale</span><span style="color: #007700">-></span><span style="color: #0000BB">SetAutoTicks</span><span style="color: #007700">();
<br />
<br /></span><span style="color: #0000BB"></span>
|
||
|
|
</span>
|
||
|
|
</b></div><br>
|
||
|
|
<p>
|
||
|
|
<p> <div style='font-family: helvetica, arial, geneva, sans-serif;margin-bottom:4px;border-left:solid black 1px;border-top:solid black 1px;border-bottom:solid black 2px;border-right:solid black 2px;font-size:120%;background:#dde9af;padding:4px;'><a class="no" name="_LINEARSCALE_SETGRACE"><span style="color:#555555;">LinearScale ::</span><br><b>SetGrace</b>($aGraceTop, $aGraceBottom)</a></div>
|
||
|
|
|
||
|
|
<span style='font-family:arial;font-size:95%;'><i>// Specify scale "grace" value (top and bottom)</i></span><p>
|
||
|
|
|
||
|
|
<table cellspacing=0 style='border:black solid 1pt;' width=100%>
|
||
|
|
<tr><th width=25%>Argument</th><th width=15%>Default</th><th width=60%>Description</th></tr>
|
||
|
|
<tr><td style='border-right:black solid 1pt;font-family:courier;font-size:100%;font-weight:bold;'><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB">$aGraceTop</span>
|
||
|
|
</span>
|
||
|
|
|
||
|
|
</td><td style='border-right:black solid 1pt;font-family:courier;font-size:100%;font-weight:bold;'> </td><td>Top grace value</td></tr>
|
||
|
|
|
||
|
|
<tr><td style='border-right:black solid 1pt;font-family:courier;font-size:100%;font-weight:bold;'><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB">$aGraceBottom</span>
|
||
|
|
</span>
|
||
|
|
|
||
|
|
</td><td style='border-right:black solid 1pt;font-family:courier;font-size:100%;font-weight:bold;'><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB">0</span>
|
||
|
|
</span>
|
||
|
|
</td><td>Bottom grace value</td></tr>
|
||
|
|
</table>
|
||
|
|
|
||
|
|
<div style="font-weight:bold;font-family:arial;font-size:90%;">Description:</div>By default the autoscaling determines the minimum and maximum as close to the plots min and max values as possible. Sometimes this might not be suitable and you need some more "air". For example if you plot a bar plot with values on top of the bar. If the bar reaces the max value (which is also the scale end point) the value on top of the bar might be out in the margin.)
|
||
|
|
<p>
|
||
|
|
By specifyin the grace you get added space. The value specified is interpretated as extra percentage of the total scale range.
|
||
|
|
<p>
|
||
|
|
For example if the scale range (without grace) is (0,100) and you add 10% top grace (with SetGrace(10)) the modified scale will be (0,110) and if you use a 100% top grace the scale will be (0,200) and so on. <br>
|
||
|
|
|
||
|
|
<div style="font-weight:bold;font-family:arial;font-size:90%;"><p>Example:</div><div style="padding:5px;border:dashed gray 1px;background-color:#f3f3f3;font-family:courier new;font-size:90%;font-weight:bold;"><b><span style="color: #000000">
|
||
|
|
<span style="color: #0000BB">$graph</span><span style="color: #007700">-></span><span style="color: #0000BB">xaxis</span><span style="color: #007700">-></span><span style="color: #0000BB">scale</span><span style="color: #007700">-></span><span style="color: #0000BB">SetGrace</span><span style="color: #007700">(</span><span style="color: #0000BB">50</span><span style="color: #007700">);</span><span style="color: #0000BB"></span>
|
||
|
|
</span>
|
||
|
|
</b></div><br>
|
||
|
|
<p> <hr> <p></html>
|