126 lines
13 KiB
HTML
126 lines
13 KiB
HTML
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Adding images and country flags to the background of the graph</title><link rel="stylesheet" type="text/css" href="manual.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.0"><link rel="home" href="index.html" title="JpGraph Manual"><link rel="up" href="ch14.html" title="Chapter 14. Common features for all Cartesian (x,y) graph types"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Adding images and country flags to the background of the graph</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center">Chapter 14. Common features for all Cartesian (x,y) graph types</th><td width="20%" align="right"> </td></tr></table><hr></div><div class="sect1" title="Adding images and country flags to the background of the graph"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="sec2.img-country-background"></a>Adding images and country flags to the background of the graph</h2></div></div></div>
|
|||
|
|
|
|||
|
|
<p>The background can not only be a solid (or semi-transperant) color. It is also
|
|||
|
|
possible to use images as backgrounds. These can be arbitrary user specified images
|
|||
|
|
in any format (as determined by there file suffix). Since the library has a built in
|
|||
|
|
support for all established countries (as of 20 Dec 2008) in regards to there flags
|
|||
|
|
(all flags are encoded within the library) it is also possible to use a country flag
|
|||
|
|
as a background. This could be considered a special case of the user defined image
|
|||
|
|
background.</p>
|
|||
|
|
<p>
|
|||
|
|
</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem">
|
|||
|
|
<p><code class="code">Graph::SetBackgroundImage($aFileName,$aBgType=BGIMG_FILLPLOT,$aImgFormat='auto')</code></p>
|
|||
|
|
</li><li class="listitem">
|
|||
|
|
<p><code class="code">Graph::SetBackgroundImageMix($aMix)</code></p>
|
|||
|
|
</li><li class="listitem">
|
|||
|
|
<p><code class="code">Graph::SetBackgroundImagePos($aXpos,$aYpos)</code></p>
|
|||
|
|
</li><li class="listitem">
|
|||
|
|
<p><code class="code">Graph::SetBackgroundCountryFlag($aName,$aBgType=BGIMG_FILLPLOT,$aMix=100)</code></p>
|
|||
|
|
</li></ol></div><p>
|
|||
|
|
</p>
|
|||
|
|
<p>For both background images and flags it is possible to define how the image should
|
|||
|
|
be used on the page with the background type parameters. This parameter specifies
|
|||
|
|
how the image should be placed on the graph. The following options are
|
|||
|
|
available:</p>
|
|||
|
|
<p>
|
|||
|
|
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
|
|||
|
|
<p>BGIMG_FILLPLOT . This means that the background image will be scaled
|
|||
|
|
to that it exactly fits the plot area</p>
|
|||
|
|
</li><li class="listitem">
|
|||
|
|
<p>BGIMG_FILLFRAME . This means the the background image will be scaled
|
|||
|
|
so that it exactly fits the entire graph</p>
|
|||
|
|
</li><li class="listitem">
|
|||
|
|
<p>BGIMG_COPY . This means that the background image will be copied in
|
|||
|
|
tis original size without and size adjustments</p>
|
|||
|
|
</li><li class="listitem">
|
|||
|
|
<p>BGIMG_CENTER . Almost the same as BGIMG_COPY but this also means that
|
|||
|
|
the image will be automatically centered in the graph</p>
|
|||
|
|
</li><li class="listitem">
|
|||
|
|
<p>BGIMG_FREE, This is a variant of the BGIMG_COPY but in this case the
|
|||
|
|
image will be free on its own and have no color blending with the margin
|
|||
|
|
color</p>
|
|||
|
|
</li></ul></div><p>
|
|||
|
|
</p>
|
|||
|
|
<p>To help explain these types of backgrounds they are illustrated below by adding
|
|||
|
|
the image in <a class="xref" href="ch14s15.html#fig.background-image-for-examples" title="Figure 14.87. Background image (a closeup of our burnt server)">Figure 14.87. Background image (a closeup of our burnt
|
|||
|
|
server)</a> as a background
|
|||
|
|
to the plain graph in <a class="xref" href="ch14s15.html#fig.graph-for-background" title="Figure 14.86. The graph that will be used to add backgrounds to">Figure 14.86. The graph that will be used to add backgrounds
|
|||
|
|
to</a>. In order not
|
|||
|
|
to have the background image take to much emphasis in the graph we specify the
|
|||
|
|
mixing to 25% with a call to</p>
|
|||
|
|
<p>
|
|||
|
|
</p><div class="hl-main"><table class="hl-table" width="100%"><tr><td class="hl-gutter" align="right" valign="top"><pre>1
|
|||
|
|
</pre></td><td class="hl-main" valign="top"><pre><span class="hl-code">$graph->SetBackgroundImageMix(25);</span></pre></td></tr></table></div><p>
|
|||
|
|
</p>
|
|||
|
|
<p>
|
|||
|
|
</p><div class="informaltable">
|
|||
|
|
<table border="0"><colgroup><col class="c1"><col class="c2"></colgroup><tbody><tr><td valign="bottom">
|
|||
|
|
<div class="figure"><a name="fig.graph-for-background"></a><p class="title"><b>Figure 14.86. The graph that will be used to add backgrounds
|
|||
|
|
to</b></p><div class="figure-contents">
|
|||
|
|
|
|||
|
|
<div class="mediaobject"><img src="images/graph_for_background_example.png" alt="The graph that will be used to add backgrounds to"></div>
|
|||
|
|
</div></div><br class="figure-break">
|
|||
|
|
</td><td valign="bottom">
|
|||
|
|
<div class="figure"><a name="fig.background-image-for-examples"></a><p class="title"><b>Figure 14.87. Background image (a closeup of our burnt
|
|||
|
|
server)</b></p><div class="figure-contents">
|
|||
|
|
|
|||
|
|
<div class="mediaobject"><img src="images/heat1.jpg" alt="Background image (a closeup of our burnt server)"></div>
|
|||
|
|
</div></div><br class="figure-break">
|
|||
|
|
</td></tr></tbody></table>
|
|||
|
|
</div><p>
|
|||
|
|
</p>
|
|||
|
|
<p>In the table below the various options for adjusting the size and position of the
|
|||
|
|
background image are shown</p>
|
|||
|
|
<p>
|
|||
|
|
</p><div class="informaltable">
|
|||
|
|
<table border="0"><colgroup><col class="c1"><col class="c2"></colgroup><tbody><tr><td align="center">
|
|||
|
|
<p>
|
|||
|
|
</p><div class="figure"><a name="fig.background_type_ex0"></a><p class="title"><b>Figure 14.88. BGIMG_COPY <code class="uri"><a class="uri" href="example_src/background_type_ex0.html" target="_top">(<code class="filename">background_type_ex0.php</code>)</a></code> </b></p><div class="figure-contents"> <span class="inlinemediaobject"><img src="images/background_type_ex0.png" alt="BGIMG_COPY (background_type_ex0.php)"></span> </div></div><p><br class="figure-break">
|
|||
|
|
</p>
|
|||
|
|
<p><code class="code">BGIMG_COPY</code></p>
|
|||
|
|
</td><td align="center">
|
|||
|
|
<p>
|
|||
|
|
</p><div class="figure"><a name="fig.background_type_ex1"></a><p class="title"><b>Figure 14.89. BGIMG_CENTER <code class="uri"><a class="uri" href="example_src/background_type_ex1.html" target="_top">(<code class="filename">background_type_ex1.php</code>)</a></code> </b></p><div class="figure-contents"> <span class="inlinemediaobject"><img src="images/background_type_ex1.png" alt="BGIMG_CENTER (background_type_ex1.php)"></span> </div></div><p><br class="figure-break">
|
|||
|
|
</p>
|
|||
|
|
<p><code class="code">BGIMG_CENTER</code></p>
|
|||
|
|
</td></tr><tr><td align="center">
|
|||
|
|
<p>
|
|||
|
|
</p><div class="figure"><a name="fig.background_type_ex2"></a><p class="title"><b>Figure 14.90. BGIMG_FREE <code class="uri"><a class="uri" href="example_src/background_type_ex2.html" target="_top">(<code class="filename">background_type_ex2.php</code>)</a></code> </b></p><div class="figure-contents"> <span class="inlinemediaobject"><img src="images/background_type_ex2.png" alt="BGIMG_FREE (background_type_ex2.php)"></span> </div></div><p><br class="figure-break">
|
|||
|
|
</p>
|
|||
|
|
<p><code class="code">BGIMG_FREE</code></p>
|
|||
|
|
</td><td align="center">
|
|||
|
|
<p>
|
|||
|
|
</p><div class="figure"><a name="fig.background_type_ex3"></a><p class="title"><b>Figure 14.91. BGIMG_FILLPLOT <code class="uri"><a class="uri" href="example_src/background_type_ex3.html" target="_top">(<code class="filename">background_type_ex3.php</code>)</a></code> </b></p><div class="figure-contents"> <span class="inlinemediaobject"><img src="images/background_type_ex3.png" alt="BGIMG_FILLPLOT (background_type_ex3.php)"></span> </div></div><p><br class="figure-break">
|
|||
|
|
</p>
|
|||
|
|
<p><code class="code">BGIMG_FILLPLOT</code></p>
|
|||
|
|
</td></tr><tr><td align="center">
|
|||
|
|
<p>
|
|||
|
|
</p><div class="figure"><a name="fig.background_type_ex4"></a><p class="title"><b>Figure 14.92. BGIMG_FILLFRAME <code class="uri"><a class="uri" href="example_src/background_type_ex4.html" target="_top">(<code class="filename">background_type_ex4.php</code>)</a></code> </b></p><div class="figure-contents"> <span class="inlinemediaobject"><img src="images/background_type_ex4.png" alt="BGIMG_FILLFRAME (background_type_ex4.php)"></span> </div></div><p><br class="figure-break">
|
|||
|
|
</p>
|
|||
|
|
<p><code class="code">BGIMG_FILLFRAME</code></p>
|
|||
|
|
</td><td> </td></tr></tbody></table>
|
|||
|
|
</div><p>
|
|||
|
|
</p>
|
|||
|
|
<p></p>
|
|||
|
|
<div class="sect2" title="Using country flags as backgrounds"><div class="titlepage"><div><div><h3 class="title"><a name="id2553256"></a>Using country flags as backgrounds</h3></div></div></div>
|
|||
|
|
|
|||
|
|
<p>The method <code class="code">Graph::SetBackgroundCountryFlag($aName,$aBgType,$aMix)</code>
|
|||
|
|
makes it possible to use an of the built-in country flags as a background i the
|
|||
|
|
same way as any other user specified background image. All included country
|
|||
|
|
flags as of Dec 2008 are listed in <a class="xref" href="apf.html" title="Appendix F. List of all country flags">Appendix F. <i>List of all country flags</i></a>. The
|
|||
|
|
background country flag is specified by its short name as listed in <a class="xref" href="apf.html" title="Appendix F. List of all country flags">Appendix F. <i>List of all country flags</i></a>.</p>
|
|||
|
|
<p>
|
|||
|
|
</p><div class="caution" title="Caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Caution</h3>
|
|||
|
|
<p>The dynamics of world politics and geographic boundaries will no doubt
|
|||
|
|
make the list of included countries obsolete almost at the same time the
|
|||
|
|
library is released. The intention is that all currently known country
|
|||
|
|
and similar geographic entities should be included. Any missing flags
|
|||
|
|
shall and can not be interpreted as any political stand it is merely a
|
|||
|
|
consequence of political changes since the library was released or a
|
|||
|
|
possible oversight or simply a mistake either human or algorithmically
|
|||
|
|
in how the country flags are produced. </p>
|
|||
|
|
</div><p>
|
|||
|
|
</p>
|
|||
|
|
</div>
|
|||
|
|
</div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"><a accesskey="u" href="ch14.html">Up</a></td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
|