| 1 |
lars |
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
|
|
|
2 |
<HTML>
|
|
|
3 |
<HEAD>
|
|
|
4 |
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso-iso-8859-1">
|
|
|
5 |
<LINK REL="Start" HREF="index.html">
|
|
|
6 |
<LINK REL="Contents" HREF="toc.html">
|
|
|
7 |
<LINK REL="Prev" HREF="1221AdjustingthesizeoftheLEDdigits.html">
|
|
|
8 |
<STYLE TYPE="text/css"><!--
|
|
|
9 |
BODY { font-family: serif }
|
|
|
10 |
H1 { font-family: sans-serif }
|
|
|
11 |
H2 { font-family: sans-serif }
|
|
|
12 |
H3 { font-family: sans-serif }
|
|
|
13 |
H4 { font-family: sans-serif }
|
|
|
14 |
H5 { font-family: sans-serif }
|
|
|
15 |
H6 { font-family: sans-serif }
|
|
|
16 |
SUB { font-size: smaller }
|
|
|
17 |
SUP { font-size: smaller }
|
|
|
18 |
PRE { font-family: monospace }
|
|
|
19 |
A { text-decoration: none }
|
|
|
20 |
--></STYLE>
|
|
|
21 |
</HEAD>
|
|
|
22 |
<BODY>
|
|
|
23 |
<A HREF="toc.html">Contents</A>
|
|
|
24 |
<A HREF="1221AdjustingthesizeoftheLEDdigits.html">Previous</A>
|
|
|
25 |
<HR NOSHADE>
|
|
|
26 |
|
|
|
27 |
<H1><A NAME="13">13 Code defines in JpGraph</A></H1>
|
|
|
28 |
<P> Various settings in JpGraph are controlled by overall DEFINEs in the
|
|
|
29 |
configuration file "jpg-config.inc.php". Most of these defines have
|
|
|
30 |
default values that should be valid for most usage.</P>
|
|
|
31 |
<P> In the rest of this chapter all constants are described with default
|
|
|
32 |
value and usage.</P>
|
|
|
33 |
<P></P>
|
|
|
34 |
<TABLE cellpadding="3" cellspacing="0" class="codedefines">
|
|
|
35 |
<TR><TH>Define, default value</TH><TH>Comment</TH></TR>
|
|
|
36 |
<TR><TD valign="top">"CACHE_DIR", "/tmp/jpgraph_cache/"</TD><TD>The full
|
|
|
37 |
absolute name of directory to be used as a cache. This directory<STRONG>
|
|
|
38 |
must</STRONG> be readable and writable for PHP. Must end with '/'</TD></TR>
|
|
|
39 |
<TR><TD valign="top">"TTF_DIR", "/usr/local/fonts/ttf/"</TD><TD>
|
|
|
40 |
Directory for JpGraph TTF fonts. Must end with '/' The fonts must follow
|
|
|
41 |
the naming conventions as used by the supplied TTF fonts in JpGraph.</TD>
|
|
|
42 |
</TR>
|
|
|
43 |
<TR><TD valign="top">"CSIMCACHE_DIR", "csimcache/"</TD><TD>Directory for
|
|
|
44 |
cache directory for CSIM graphs. Must end with '/' Cache directory
|
|
|
45 |
specification for use with CSIM graphs that are using the cache. The
|
|
|
46 |
directory must be the filesystem name as seen by PHP and the 'http'
|
|
|
47 |
version must be the same directory but as seen by the HTTP server
|
|
|
48 |
relative to the 'htdocs' directory. If a relative path is specified it
|
|
|
49 |
is taken to be relative from where the image script is executed. Note:
|
|
|
50 |
The default setting is to create a subdirectory in the directory from
|
|
|
51 |
where the image script is executed and store all files there. As usual
|
|
|
52 |
this directory must be writable by the PHP process.</TD></TR>
|
|
|
53 |
<TR><TD valign="top">"CSIMCACHE_HTTP_DIR", "csimcache"</TD><TD>Directory
|
|
|
54 |
for JpGraph TTF fonts. Must end with '/' Cache directory specification
|
|
|
55 |
for use with CSIM graphs that are using the cache. The directory must
|
|
|
56 |
be the filesystem name as seen by PHP and the 'http' version must be
|
|
|
57 |
the same directory but as seen by the HTTP server relative to the
|
|
|
58 |
'htdocs' directory. If a relative path is specified it is taken to be
|
|
|
59 |
relative from where the image script is executed. Note: The default
|
|
|
60 |
setting is to create a subdirectory in the directory from where the
|
|
|
61 |
image script is executed and store all files there. As usual this
|
|
|
62 |
directory must be writable by the PHP process.</TD></TR>
|
|
|
63 |
<TR><TD valign="top">"CHINESE_TTF_FONT", "bkai00mp.ttf"</TD><TD> Actual
|
|
|
64 |
name of the TTF file used together with FF_CHINESE aka FF_BIG5 This is
|
|
|
65 |
the TTF file being used when the font family is specified as either
|
|
|
66 |
FF_CHINESE or FF_BIG5</TD></TR>
|
|
|
67 |
<TR><TD valign="top">"LANGUAGE_CYRILLIC", false</TD><TD> Special unicode
|
|
|
68 |
Cyrillic language support.</TD></TR>
|
|
|
69 |
<TR><TD valign="top">"CYRILLIC_FROM_WINDOWS", false</TD><TD> If you are
|
|
|
70 |
setting this config to true the conversion will assume that the input
|
|
|
71 |
text is windows 1251, if false it will assume koi8-r</TD></TR>
|
|
|
72 |
<TR><TD valign="top">'MINCHO_TTF_FONT', 'ipam.ttf'</TD><TD> Japanese
|
|
|
73 |
TrueType font used with FF_MINCHO</TD></TR>
|
|
|
74 |
<TR><TD valign="top">'PMINCHO_TTF_FONT', 'ipamp.ttf'</TD><TD> Japanese
|
|
|
75 |
TrueType font used with FF_PMINCHO</TD></TR>
|
|
|
76 |
<TR><TD valign="top">'GOTHIC_TTF_FONT', 'ipag.ttf'</TD><TD> Japanese
|
|
|
77 |
TrueType font used with FF_GOTHIC</TD></TR>
|
|
|
78 |
<TR><TD valign="top">'PGOTHIC_TTF_FONT', 'ipagp.ttf'</TD><TD> Japanese
|
|
|
79 |
TrueType font used with FF_PGOTHIC</TD></TR>
|
|
|
80 |
<TR><TD valign="top">"INSTALL_PHP_ERR_HANDLER", false</TD><TD> Determine
|
|
|
81 |
if the library should also setup the default PHP error handler to
|
|
|
82 |
generate a graphic error message. This is useful during development to
|
|
|
83 |
be able to see the error message as an image instead as a "red-cross"
|
|
|
84 |
in a page where an image is expected.</TD></TR>
|
|
|
85 |
<TR><TD valign="top">"CATCH_PHPERRMSG", true</TD><TD> Should the library
|
|
|
86 |
examine the global php_errmsg string and convert any error in it to a
|
|
|
87 |
graphical representation. This is handy for the occasions when, for
|
|
|
88 |
example, header files cannot be found and this results in the graph not
|
|
|
89 |
being created and just a "red-cross" image would be seen. This should
|
|
|
90 |
be turned off for a production site.</TD></TR>
|
|
|
91 |
<TR><TD valign="top">"USE_LIBRARY_GD2",false</TD><TD>Specify if we
|
|
|
92 |
should use GD 2.x or GD 1.x If you have GD 2.x installed it is
|
|
|
93 |
recommended that you use it since it will give a slightly, slightly
|
|
|
94 |
better visual appearance for arcs. If you don't have GD2 installed this
|
|
|
95 |
must be set to false!</TD></TR>
|
|
|
96 |
<TR><TD valign="top">'USE_TRUECOLOR',true</TD><TD>Should the image be a
|
|
|
97 |
truecolor image? Note 1: Can only be used with GD 2.0.2 and above. Note
|
|
|
98 |
2: GD 2.0.1 + PHP 4.0.6 on Win32 crashes when trying to use truecolor.
|
|
|
99 |
Truecolor support is to be considered alpha since GD 2.x is still not
|
|
|
100 |
considered stable (especially on Win32). Note 3: MUST be enabled to get
|
|
|
101 |
background images working with GD2 Note 4: If enabled then truetype
|
|
|
102 |
fonts will look very ugly => You can't have both background images and
|
|
|
103 |
truetype fonts in the same image until these bugs has been fixed in GD
|
|
|
104 |
2.01</TD></TR>
|
|
|
105 |
<TR><TD valign="top">"USE_CACHE",false</TD><TD>Should the cache be used
|
|
|
106 |
at all? By setting this to false no files will be generated in the
|
|
|
107 |
cache directory. The difference from READ_CACHE being that setting
|
|
|
108 |
READ_CACHE to false will still create the image in the cache directory
|
|
|
109 |
just not use it. By setting USE_CACHE=false no files will even be
|
|
|
110 |
generated in the cache directory.</TD></TR>
|
|
|
111 |
<TR><TD valign="top">"READ_CACHE",true</TD><TD>Should we try to find an
|
|
|
112 |
image in the cache before generating it? Set this define to false to
|
|
|
113 |
bypass the reading of the cache and always regenerate the image. Note
|
|
|
114 |
that even if reading the cache is disabled the cached will still be
|
|
|
115 |
updated with the newly generated image. Set also "USE_CACHE" below.</TD>
|
|
|
116 |
</TR>
|
|
|
117 |
<TR><TD valign="top">"DEFAULT_GFORMAT","auto"</TD><TD>Default graphic
|
|
|
118 |
format set to "auto" which will automatically choose the best available
|
|
|
119 |
format in the order png,gif,jpg (The supported format depends on what
|
|
|
120 |
your PHP installation supports)</TD></TR>
|
|
|
121 |
<TR><TD valign="top">"USE_IMAGE_ERROR_HANDLER",true</TD><TD> Determine
|
|
|
122 |
if the error handler should be image based or purely text based. Image
|
|
|
123 |
based makes it easier since the script will always return an image even
|
|
|
124 |
in case of errors.</TD></TR>
|
|
|
125 |
<TR><TD valign="top">"USE_APPROX_COLORS",true</TD><TD>If the color
|
|
|
126 |
palette is full should JpGraph try to allocate the closest match? If
|
|
|
127 |
you plan on using background image or gradient fills it might be a good
|
|
|
128 |
idea to enable this. If not you will otherwise get an error saying that
|
|
|
129 |
the color palette is exhausted. The drawback of using approximations is
|
|
|
130 |
that the colors might not be exactly what you specified. Note1: This
|
|
|
131 |
does only apply to a palette image, not true color images since they
|
|
|
132 |
don't have the limitations of maximum number of colors.</TD></TR>
|
|
|
133 |
<TR><TD valign="top">"ERR_DEPRECATED",false</TD><TD>Should usage of
|
|
|
134 |
deprecated functions and parameters give a fatal error? (Useful to
|
|
|
135 |
check if code is future proof.)</TD></TR>
|
|
|
136 |
<TR><TD valign="top">"BRAND_TIMING",false</TD><TD>Should the time taken
|
|
|
137 |
to generate each picture be branded to the lower left in corner in each
|
|
|
138 |
generated image? Useful for performance measurements generating graphs</TD>
|
|
|
139 |
</TR>
|
|
|
140 |
<TR><TD valign="top">"BRAND_TIME_FORMAT","Generated in: %01.3fs"</TD><TD>
|
|
|
141 |
What format should be used for the timing string?</TD></TR>
|
|
|
142 |
</TABLE>
|
|
|
143 |
<P> The following defines should very rarely need to be changed</P>
|
|
|
144 |
<P></P>
|
|
|
145 |
<TABLE cellpadding="3" cellspacing="0" class="codedefines">
|
|
|
146 |
<TR><TH>Define, default value</TH><TH>Comment</TH></TR>
|
|
|
147 |
<TR><TD valign="top">"CACHE_FILE_GROUP","wwwadmin"</TD><TD>What group
|
|
|
148 |
should the cached file belong to (Set to "" will give the default group
|
|
|
149 |
for the "PHP-user") Please note that the Apache user must be a member
|
|
|
150 |
of the specified group since otherwise it is impossible for Apache to
|
|
|
151 |
set the specified group.</TD></TR>
|
|
|
152 |
<TR><TD valign="top">"CACHE_FILE_MOD",0664</TD><TD>What permissions
|
|
|
153 |
should the cached file have (Set to "" will give the default
|
|
|
154 |
permissions for the "PHP-user")</TD></TR>
|
|
|
155 |
<TR><TD valign="top">"USE_BRESENHAM",false</TD><TD>Decide if we should
|
|
|
156 |
use the Bresenham circle algorithm or the built in Arc(). Bresenham
|
|
|
157 |
gives better visual appearance of circles but is more CPU intensive and
|
|
|
158 |
slower then the built in Arc() function in GD. Turned off by default
|
|
|
159 |
for speed</TD></TR>
|
|
|
160 |
<TR><TD valign="top">"_CSIM_SPECIALFILE","_csim_special_"</TD><TD>
|
|
|
161 |
Special file name to indicate that we only want to calc the image map in
|
|
|
162 |
the call to Graph::Stroke() used internally from the GetHTMLCSIM()
|
|
|
163 |
method.</TD></TR>
|
|
|
164 |
<TR><TD valign="top">"_CSIM_DISPLAY","_jpg_csimd"</TD><TD>HTTP GET
|
|
|
165 |
argument that is used with image map to indicate to the script to just
|
|
|
166 |
generate the image and not the full CSIM HTML page.</TD></TR>
|
|
|
167 |
</TABLE>
|
|
|
168 |
|
|
|
169 |
<P> </P>
|
|
|
170 |
<P>&nbsp</P>
|
|
|
171 |
</DIV><HR NOSHADE>
|
|
|
172 |
<A HREF="toc.html">Contents</A>
|
|
|
173 |
<A HREF="1221AdjustingthesizeoftheLEDdigits.html">Previous</A>
|
|
|
174 |
</BODY>
|
|
|
175 |
</HTML>
|