Blame view

site/jpgraph/docs/chunkhtml/ch08s05.html 5.39 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
  <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Formatting text paragraphs</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="ch08.html" title="Chapter 8. Text and font handling"></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">Formatting text paragraphs</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center">Chapter 8. Text and font handling</th><td width="20%" align="right"> </td></tr></table><hr></div><div class="sect1" title="Formatting text paragraphs"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2498877"></a>Formatting text paragraphs</h2></div></div></div>
              
              <p>The text rendering engine within the library offers some basic text paragraph
                  formatting.</p>
              <p>
                  </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem">
                          <p>It is possible to use multi line text combined as a paragraph</p>
                      </li><li class="listitem">
                          <p>It is possible to adjust the text alignment within the paragraph to be
                              left, right or center adjusted. This works in the same way as you would
                              expect in a word-processor.</p>
                      </li><li class="listitem">
                          <p>If enabled the text rendering will support automatic line breaks at a
                              certain column. The line breaks are intelligent not to break words in
                              the middle.</p>
                      </li></ul></div><p>
              </p>
              <p>All text handling is centralized to the class <code class="code">Text</code> (defined in file
                      <code class="filename">jpgraph_text.inc.php</code>) which is used both to add arbitrary
                  text to the graph as well as internally within the library to manipulate text on
                  labels and titles. All such texts are an instance of the Text class.</p>
              <p>The paragraph alignment is controlled by the method
                      <code class="code">Text::SetParagraphAlign($aAlignment)</code>. The argument is a text string
                  that should be one of <code class="code">'left'</code>, <code class="code">'right'</code> or
                      <code class="code">'center'</code>. </p>
              <p>
                  </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
                      <p>Unfortunately the library does not support an "even" paragraph alignment
                          which in word processors adjust the kerning between individual characters to
                          make the text have even left and right sides. Implementing this would
                          require a much higher complexity than can be motivated for the type of text
                          needed in a graph library.</p>
                  </div><p>
              </p>
              <p>In the <a class="xref" href="ch08s05.html#fig.textpalignex1" title="Figure 8.5. The different types of paragraph alignments (textpalignex1.php)">Figure 8.5. The different types of paragraph alignments <code class="uri"><a class="uri" href="example_src/textpalignex1.html" target="_top">(<code class="filename">textpalignex1.php</code>)</a></code> </a> the same text paragraph is rendered with the
                  possible paragraph alignments.</p>
              <p>
                  </p><div class="figure"><a name="fig.textpalignex1"></a><p class="title"><b>Figure 8.5. The different types of paragraph alignments <code class="uri"><a class="uri" href="example_src/textpalignex1.html" target="_top">(<code class="filename">textpalignex1.php</code>)</a></code> </b></p><div class="figure-contents">  <span class="inlinemediaobject"><img src="images/textpalignex1.png" alt="The different types of paragraph alignments (textpalignex1.php)"></span> </div></div><p><br class="figure-break">
              </p>
              <p>Inserting a newline character "\n" in text will cause the text line to break and
                  start on the next row. Note that the newline must be surrounded with double-quotes
                  and not single quotes.</p>
              <p>
                  </p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
                      <p>Bitmap fonts that are rotated, i.e. vertical, does not support automatic
                          line breaking. If line breaking is needed with vertical text then one of the
                          TTF fonts muts be used.</p>
                  </div><p>
              </p>
          </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="ch08.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>