/usr/share/doc/mathgl/mathgl_en/mathgl_en_36.html is in mathgl-doc-en 2.1.3.1-4ubuntu3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
<html>
<!-- This manual is for MathGL (version 2.1.2), a collection of classes and routines for scientific plotting. Please report any errors in this manual to mathgl.abalakin@gmail.org.
Copyright C 2008-2012 Alexey A. Balakin.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
Texts. A copy of the license is included in the section entitled "GNU
Free Documentation License."
-->
<!-- Created on December 22, 2013 by texi2html 1.82
texi2html was written by:
Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Many creative people.
Send bugs and suggestions to <texi2html-bug@nongnu.org>
-->
<head>
<title>MathGL 2.1.2: 4.7 Text printing</title>
<meta name="description" content="MathGL 2.1.2: 4.7 Text printing">
<meta name="keywords" content="MathGL 2.1.2: 4.7 Text printing">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2html 1.82">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
pre.display {font-family: serif}
pre.format {font-family: serif}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: serif; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: serif; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.roman {font-family:serif; font-weight:normal;}
span.sansserif {font-family:sans-serif; font-weight:normal;}
ul.toc {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Text-printing"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="mathgl_en_35.html#Primitives" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_37.html#Axis-and-Colorbar" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="mathgl_en_29.html#MathGL-core" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_29.html#MathGL-core" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_47.html#Widget-classes" title="Next chapter"> >> </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="mathgl_en.html#Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_88.html#Index" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<a name="Text-printing-1"></a>
<h2 class="section">4.7 Text printing</h2>
<a name="index-Puts"></a>
<a name="index-Putsw"></a>
<a name="index-Text"></a>
<a name="index-Label"></a>
<a name="index-fgets"></a>
<p>These functions draw the text. There are functions for drawing text in arbitrary place, in arbitrary direction and along arbitrary curve. MathGL can use arbitrary font-faces and parse many TeX commands (for more details see <a href="mathgl_en_25.html#Font-styles">Font styles</a>). All these functions have 2 variant: for printing 8-bit text (<code>char *</code>) and for printing Unicode text (<code>wchar_t *</code>). In first case the conversion into the current locale is used. So sometimes you need to specify it by <code>setlocale()</code> function. The <var>size</var> argument control the size of text: if positive it give the value, if negative it give the value relative to <code>SetFontSize()</code>. The font type (STIX, arial, courier, times and so on) can be selected by function LoadFont(). See section <a href="mathgl_en_31.html#Font-settings">Font settings</a>.
</p>
<p>The font parameters are described by string. This string may set the text color ‘<samp>wkrgbcymhRGBCYMHW</samp>’ (see <a href="mathgl_en_22.html#Color-styles">Color styles</a>). Also, after delimiter symbol ‘<samp>:</samp>’, it can contain characters of font type (‘<samp>rbiwou</samp>’) and/or align (‘<samp>LRC</samp>’) specification. The font types are: ‘<samp>r</samp>’ – roman (or regular) font, ‘<samp>i</samp>’ – italic style, ‘<samp>b</samp>’ – bold style, ‘<samp>w</samp>’ – wired style, ‘<samp>o</samp>’ – over-lined text, ‘<samp>u</samp>’ – underlined text. By default roman font is used. The align types are: ‘<samp>L</samp>’ – align left (default), ‘<samp>C</samp>’ – align center, ‘<samp>R</samp>’ – align right. For example, string ‘<samp>b:iC</samp>’ correspond to italic font style for centered text which printed by blue color.
</p>
<p>If string contains symbols ‘<samp>aA</samp>’ then text is printed at absolute position {<var>x</var>, <var>y</var>} (supposed to be in range [0,1]) of picture (for ‘<samp>A</samp>’) or subplot/inplot (for ‘<samp>a</samp>’). If string contains symbol ‘<samp>@</samp>’ then box around text is drawn.
</p>
<p>See section <a href="mathgl_en_11.html#Text-features">Text features</a>, for sample code and picture.
</p>
<p><a name="text"></a>
</p><dl>
<dt><a name="index-text"></a><u>MGL command:</u> <b>text</b><i> <code>x y</code> 'text' ['fnt'='' <code>size=-1</code>]</i></dt>
<dt><a name="index-text-1"></a><u>MGL command:</u> <b>text</b><i> <code>x y z</code> 'text' ['fnt'='' <code>size=-1</code>]</i></dt>
<dt><a name="index-Puts-1"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Puts</b><i> (<code>mglPoint</code> p, <code>const char *</code>text, <code>const char *</code>fnt=<code>":C"</code>, <code>mreal</code> size=<code>-1</code>)</i></dt>
<dt><a name="index-Putsw-1"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Putsw</b><i> (<code>mglPoint</code> p, <code>const wchar_t *</code>text, <code>const char *</code>fnt=<code>":C"</code>, <code>mreal</code> size=<code>-1</code>)</i></dt>
<dt><a name="index-Puts-2"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Puts</b><i> (<code>mreal</code> x, <code>mreal</code> y, <code>const char *</code>text, <code>const char *</code>fnt=<code>":AC"</code>, <code>mreal</code> size=<code>-1</code>)</i></dt>
<dt><a name="index-Putsw-2"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Putsw</b><i> (<code>mreal</code> x, <code>mreal</code> y, <code>const wchar_t *</code>text, <code>const char *</code>fnt=<code>":AC"</code>, <code>mreal</code> size=<code>-1</code>)</i></dt>
<dt><a name="index-mgl_005fputs"></a><u>C function:</u> <code>void</code> <b>mgl_puts</b><i> (<code>HMGL</code> gr, <code>mreal</code> x, <code>mreal</code> y, <code>mreal</code> z, <code>const char *</code>text, <code>const char *</code>fnt, <code>mreal</code> size)</i></dt>
<dt><a name="index-mgl_005fputsw"></a><u>C function:</u> <code>void</code> <b>mgl_putsw</b><i> (<code>HMGL</code> gr, <code>mreal</code> x, <code>mreal</code> y, <code>mreal</code> z, <code>const wchar_t *</code>text, <code>const char *</code>fnt, <code>mreal</code> size)</i></dt>
<dd><p>The function plots the string <var>text</var> at position <var>p</var> with fonts specifying by the criteria <var>fnt</var>. The size of font is set by <var>size</var> parameter (default is <code>-1</code>).
</p></dd></dl>
<dl>
<dt><a name="index-text-2"></a><u>MGL command:</u> <b>text</b><i> <code>x y dx dy</code> 'text' ['fnt'=':L' <code>size=-1</code>]</i></dt>
<dt><a name="index-text-3"></a><u>MGL command:</u> <b>text</b><i> <code>x y z dx dy dz</code> 'text' ['fnt'=':L' <code>size=-1</code>]</i></dt>
<dt><a name="index-Puts-3"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Puts</b><i> (<code>mglPoint</code> p, <code>mglPoint</code> d, <code>const char *</code>text, <code>const char *</code>fnt=<code>":L"</code>, <code>mreal</code> size=<code>-1</code>)</i></dt>
<dt><a name="index-Putsw-3"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Putsw</b><i> (<code>mglPoint</code> p, <code>mglPoint</code> d, <code>const wchar_t *</code>text, <code>const char *</code>fnt=<code>":L"</code>, <code>mreal</code> size=<code>-1</code>)</i></dt>
<dt><a name="index-mgl_005fputs_005fdir"></a><u>C function:</u> <code>void</code> <b>mgl_puts_dir</b><i> (<code>HMGL</code> gr, <code>mreal</code> x, <code>mreal</code> y, <code>mreal</code> z, <code>mreal</code> dx, <code>mreal</code> dy, <code>mreal</code> dz, <code>const char *</code>text, <code>const char *</code>fnt, <code>mreal</code> size)</i></dt>
<dt><a name="index-mgl_005fputsw_005fdir"></a><u>C function:</u> <code>void</code> <b>mgl_putsw_dir</b><i> (<code>HMGL</code> gr, <code>mreal</code> x, <code>mreal</code> y, <code>mreal</code> z, <code>mreal</code> dx, <code>mreal</code> dy, <code>mreal</code> dz, <code>const wchar_t *</code>text, <code>const char *</code>fnt, <code>mreal</code> size)</i></dt>
<dd><p>The function plots the string <var>text</var> at position <var>p</var> along direction <var>d</var> with specified <var>size</var>. Parameter <var>fnt</var> set text style and text position: above (‘<samp>T</samp>’) or under (‘<samp>t</samp>’) the line.
</p></dd></dl>
<p><a name="fgets"></a>
</p><dl>
<dt><a name="index-fgets-1"></a><u>MGL command:</u> <b>fgets</b><i> <code>x y</code> 'fname' [<code>n=0</code> 'fnt'='' <code>size=-1.4</code>]</i></dt>
<dt><a name="index-fgets-2"></a><u>MGL command:</u> <b>fgets</b><i> <code>x y z</code> 'fname' [<code>n=0</code> 'fnt'='' <code>size=-1.4</code>]</i></dt>
<dd><p>Draws unrotated <var>n</var>-th line of file <var>fname</var> at position {<var>x</var>,<var>y</var>,<var>z</var>} with specified <var>size</var>. By default parameters from <a href="mathgl_en_31.html#font">font</a> command are used.
</p></dd></dl>
<dl>
<dt><a name="index-text-4"></a><u>MGL command:</u> <b>text</b><i> ydat 'text' ['fnt'='']</i></dt>
<dt><a name="index-text-5"></a><u>MGL command:</u> <b>text</b><i> xdat ydat 'text' ['fnt'='']</i></dt>
<dt><a name="index-text-6"></a><u>MGL command:</u> <b>text</b><i> xdat ydat zdat 'text' ['fnt'='']</i></dt>
<dt><a name="index-Text-1"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Text</b><i> (<code>const mglDataA &</code>y, <code>const char *</code>text, <code>const char *</code>fnt=<code>""</code>, <code>const char *</code>opt=<code>""</code>)</i></dt>
<dt><a name="index-Text-2"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Text</b><i> (<code>const mglDataA &</code>y, <code>const wchar_t *</code>text, <code>const char *</code>fnt=<code>""</code>, <code>const char *</code>opt=<code>""</code>)</i></dt>
<dt><a name="index-Text-3"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Text</b><i> (<code>const mglDataA &</code>x, <code>const mglDataA &</code>y, <code>const char *</code>text, <code>const char *</code>fnt=<code>""</code>, <code>const char *</code>opt=<code>""</code>)</i></dt>
<dt><a name="index-Text-4"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Text</b><i> (<code>const mglDataA &</code>x, <code>const mglDataA &</code>y, <code>const wchar_t *</code>text, <code>const char *</code>fnt=<code>""</code>, <code>const char *</code>opt=<code>""</code>)</i></dt>
<dt><a name="index-Text-5"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Text</b><i> (<code>const mglDataA &</code>x, <code>const mglDataA &</code>y, <code>const mglDataA &</code>z, <code>const char *</code>text, <code>const char *</code>fnt=<code>""</code>, <code>const char *</code>opt=<code>""</code>)</i></dt>
<dt><a name="index-Text-6"></a><u>Method on <code>mglGraph</code>:</u> <code>void</code> <b>Text</b><i> (<code>const mglDataA &</code>x, <code>const mglDataA &</code>y, <code>const mglDataA &</code>z, <code>const wchar_t *</code>text, <code>const char *</code>fnt=<code>""</code>, <code>const char *</code>opt=<code>""</code>)</i></dt>
<dt><a name="index-mgl_005ftext_005fy"></a><u>C function:</u> <code>void</code> <b>mgl_text_y</b><i> (<code>HMGL</code> gr, <code>HCDT</code> y, <code>const char *</code>text, <code>const char *</code>fnt, <code>const char *</code>opt)</i></dt>
<dt><a name="index-mgl_005ftextw_005fy"></a><u>C function:</u> <code>void</code> <b>mgl_textw_y</b><i> (<code>HMGL</code> gr, <code>HCDT</code> y, <code>const wchar_t *</code>text, <code>const char *</code>fnt, <code>const char *</code>opt)</i></dt>
<dt><a name="index-mgl_005ftext_005fxy"></a><u>C function:</u> <code>void</code> <b>mgl_text_xy</b><i> (<code>HCDT</code> x, <code>HCDT</code> y, <code>const char *</code>text, <code>const char *</code>fnt, <code>const char *</code>opt)</i></dt>
<dt><a name="index-mgl_005ftextw_005fxy"></a><u>C function:</u> <code>void</code> <b>mgl_textw_xy</b><i> (<code>HCDT</code> x, <code>HCDT</code> y, <code>const wchar_t *</code>text, <code>const char *</code>fnt, <code>const char *</code>opt)</i></dt>
<dt><a name="index-mgl_005ftext_005fxyz"></a><u>C function:</u> <code>void</code> <b>mgl_text_xyz</b><i> (<code>HCDT</code> x, <code>HCDT</code> y, <code>HCDT</code> z, <code>const char *</code>text, <code>const char *</code>fnt, <code>const char *</code>opt)</i></dt>
<dt><a name="index-mgl_005ftextw_005fxyz"></a><u>C function:</u> <code>void</code> <b>mgl_textw_xyz</b><i> (<code>HCDT</code> x, <code>HCDT</code> y, <code>HCDT</code> z, <code>const wchar_t *</code>text, <code>const char *</code>fnt, <code>const char *</code>opt)</i></dt>
<dd><p>The function draws <var>text</var> along the curve between points {<var>x</var>[i], <var>y</var>[i], <var>z</var>[i]} by font style <var>fnt</var>. The string <var>fnt</var> may contain symbols ‘<samp>t</samp>’ for printing the text under the curve (default), or ‘<samp>T</samp>’ for printing the text above the curve. The sizes of 1st dimension must be equal for all arrays <code>x.nx=y.nx=z.nx</code>. If array <var>x</var> is not specified then its an automatic array is used with values equidistantly distributed in interval [<var>Min</var>.x, <var>Max</var>.x] (see <a href="mathgl_en_32.html#Ranges-_0028bounding-box_0029">Ranges (bounding box)</a>). If array <var>z</var> is not specified then <var>z</var>[i] = <var>Min</var>.z is used. String <var>opt</var> contain command options (see <a href="mathgl_en_27.html#Command-options">Command options</a>).
</p></dd></dl>
<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="mathgl_en_35.html#Primitives" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_37.html#Axis-and-Colorbar" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="mathgl_en_29.html#MathGL-core" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_29.html#MathGL-core" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_47.html#Widget-classes" title="Next chapter"> >> </a>]</td>
</tr></table>
<p>
<font size="-1">
This document was generated by <em>Build Daemon user</em> on <em>December 22, 2013</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html 1.82</em></a>.
</font>
<br>
</p>
</body>
</html>
|