Subversion Repositories cheapmusic

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
98 - 1
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><title>Chapter 3. PHPlot Concepts</title><link rel="stylesheet" type="text/css" href="phplotdoc.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="PHPlot Reference Manual" /><link rel="up" href="part1.html" title="Part I. PHPlot Programming" /><link rel="prev" href="starting-next.html" title="2.7. What's Next?" /><link rel="next" href="conc-overview.html" title="3.2. Programming Overview" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. PHPlot Concepts</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="starting-next.html">Prev</a> </td><th width="60%" align="center">Part I. PHPlot Programming</th><td width="20%" align="right"> <a accesskey="n" href="conc-overview.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a id="concepts"></a>Chapter 3. PHPlot Concepts</h2></div></div></div><div class="abstract"><p class="title"><strong></strong></p><p>
3
This chapter explains the operation and use of PHPlot.
4
For advanced topics, see <a class="xref" href="advanced.html" title="Chapter 4. PHPlot Advanced Topics">Chapter 4, <em>PHPlot Advanced Topics</em></a>.
5
  </p></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="conc-defs"></a>3.1. Definitions</h2></div></div></div><div class="abstract"><p class="title"><strong></strong></p><p>
6
This section contains definitions of terms used throughout the PHPlot
7
Reference Manual.
8
  </p></div><p>
9
  </p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><a id="def-alpha"></a>Alpha value</span></dt><dd><p>
10
A component in a color system which represents the amount of transparency,
11
or opacity.  At one extreme, an alpha value indicates an opaque object
12
which covers or hides whatever was drawn before it. At the other extreme,
13
it indicates a completely transparent object which has no affect on
14
whatever was drawn before it.
15
        </p></dd><dt><span class="term"><a id="def-dataset"></a>Data Set</span></dt><dd><p>
16
A set of data points which represent some function, trend, samples, etc.
17
        </p></dd><dt><span class="term"><a id="def-devcoor"></a>Device Coordinates</span></dt><dd><p>
18
The coordinate space used by GD to create images. The origin is at the
19
upper left corner, X increases to the right, Y increases down, and the units
20
are pixels. Also known as Pixel Coordinates or GD Coordinates.
21
        </p></dd><dt><span class="term"><a id="def-element"></a>Element</span></dt><dd><p>
22
A component of a graph, such as a label, tick mark, axis, or plot.
23
        </p></dd><dt><span class="term"><a id="def-gd"></a>GD</span></dt><dd><p>
24
A programming library used to create and manipulate images.
25
GD can be found at the <a class="ulink" href="http://libgd.org/" target="_top">GD Graphics
26
Library home page</a>, but is also included with PHP releases.
27
You can think of GD as a software implementation of a video card.
28
GD is also available via a PHP extension, and that is what PHPlot uses to
29
create images.
30
        </p></dd><dt><span class="term"><a id="def-graph"></a>Graph</span></dt><dd><p>
31
A complete, labeled, graphical representation of some data sets.
32
In PHPlot, a graph contains a single plot and other elements such as axes,
33
tick marks, and labels.
34
        </p></dd><dt><span class="term"><a id="def-horizplot"></a>Horizontal Plot</span></dt><dd><p>
35
A plot in which the Y (vertical) axis represents the independent variable, and
36
the X (horizontal) axis represents the dependent variable values.
37
In a horizontal bar chart, for example, the bars extend to the right from the
38
Y axis. A horizontal plot might represent X = F(Y), for example.
39
(Note: This usage is specific to PHPlot. An alternate approach, not
40
used by PHPlot, is to swap the X and Y axis orientation to make horizontal
41
plots.)
42
        </p></dd><dt><span class="term"><a id="def-image"></a>Image</span></dt><dd><p>
43
A graphical image, represented as data. For example, a PNG file is an image
44
in PNG format which is stored in a file. PHPlot creates images using the GD
45
library. A PHPlot image contains one or more graphs (but usually only one).
46
        </p></dd><dt><span class="term"><a id="def-palette"></a>Palette Image</span></dt><dd><p>
47
A color image file, or image in memory, in which each pixel value is an
48
index into a color map which contains the actual color. Typically, the
49
pixel value is 8 bits, limiting this type of image to 256 distinct colors.
50
See also <a class="link" href="concepts.html#def-truecolor">Truecolor Image</a>.
51
        </p></dd><dt><span class="term"><a id="def-plot"></a>Plot</span></dt><dd><p>
52
The graphical representation of one or more data sets.
53
In PHPlot, each graph contains a single plot, but a plot
54
can contain representation of multiple data sets (for example,
55
you can have 3 line charts on a plot).
56
        </p><p>
57
Less formally, the term 'plot' is often used for the overall output of
58
PHPlot: an image with a complete graphical representation of data, with
59
labels, legend, title, etc.
60
        </p></dd><dt><span class="term"><a id="def-relativecoor"></a>Relative Coordinates</span></dt><dd><p>
61
A coordinate space in which the X and Y coordinates represent a fraction of
62
the size of an object. The point (0,0) is defined as the upper left corner
63
of the object, and (1,1) is the lower right corner. (Relative coordinate values
64
are not restricted to the range 0 to 1, however.) So a point specification
65
in relative coordinates to an object is independent of the size of the object.
66
This coordinate system is used by <a class="xref" href="SetLegendPosition.html" title="SetLegendPosition"><span class="refentrytitle">SetLegendPosition</span></a>.
67
        </p></dd><dt><span class="term"><a id="def-truecolor"></a>Truecolor Image</span></dt><dd><p>
68
A color image file, or image in memory, in which each pixel value has a
69
complete representation of the color of that pixel. The pixels may use 24
70
bits, with 8 bits each for red, blue, and green color components, or 32
71
bits with an additional alpha component.
72
See also <a class="link" href="concepts.html#def-palette">Palette Image</a>.
73
        </p></dd><dt><span class="term"><a id="def-vertplot"></a>Vertical Plot</span></dt><dd><p>
74
A plot in which the X axis represents the independent variable, and the Y
75
axis represents the dependent variable values. This is the usual orientation
76
for plots, and might represent Y = F(X).
77
Compare with <a class="link" href="concepts.html#def-horizplot">horizontal plot</a>.
78
        </p></dd><dt><span class="term"><a id="def-worldcoor"></a>World Coordinates</span></dt><dd><p>
79
The coordinate space of the plotted data. This is the real world
80
coordinate space, in the units of whatever the plotted data measures.
81
The origin of the world coordinate space is the 0,0 point on the X and Y
82
axes.
83
The X coordinate increases to the right, and the Y coordinate increases upwards.
84
Note that the Y direction of world coordinates is opposite that of device
85
coordinates.
86
(World coordinates are only defined for plots in an orthogonal X/Y
87
coordinate space, so there are no world coordinates for pie charts.)
88
        </p></dd></dl></div><p>
89
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="starting-next.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="part1.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="conc-overview.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.7. What's Next? </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.2. Programming Overview</td></tr></table></div></body></html>