Blame view

site/jpgraph/docs/chunkhtml/ch14s15.html 13 KB
d72ac078   Guillaume   Ajout graphe V1.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
  <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-&gt;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>