File: doc_en.texi

package info (click to toggle)
mathgl 2.4.2.1-5
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 32,488 kB
  • sloc: cpp: 81,486; ansic: 3,138; pascal: 1,562; python: 37; makefile: 17; sh: 7
file content (189 lines) | stat: -rw-r--r-- 6,432 bytes parent folder | download | duplicates (2)
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
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
\input texinfo
@documentencoding UTF-8
@documentlanguage en

@setfilename mathgl_en.info
@include version.texi
@settitle MathGL @value{VERSION}
@syncodeindex pg cp
@comment %**end of header

@copying
This manual is for MathGL (version @value{VERSION}), a collection of classes and routines for scientific plotting. Please report any errors in this manual to @email{mathgl.abalakin@@gmail.org}.

@include copyright.texi
@end copying

@dircategory MathGL documentation system
@direntry
* MathGL: (mathgl). The library for scientific graphics.
@end direntry

@titlepage
@title MathGL
@subtitle for version @value{VERSION}
@author A.A. Balakin (@uref{http://mathgl.sourceforge.net/})
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@contents

@node Top
@top MathGL

This file documents the Mathematical Graphic Library (MathGL), a collection of classes and routines for scientific plotting. It corresponds to release @value{VERSION} of the library. Please report any errors in this manual to @email{mathgl.abalakin@@gmail.org}. More information about MathGL can be found at the project homepage, @uref{http://mathgl.sourceforge.net/}.

@include copyright.texi

@menu
* Website::
* Overview::
* Examples::
* General concepts::
* MathGL core::
* Widget classes::
* Data processing::
* MGL scripts::
* UDAV::
* Other classes::
* All samples::
* Symbols and hot-keys::
* File formats::
* TeX-like symbols::
* Plotting time::
* Copying This Manual::
* Index::
@end menu

@macro nav {}
@html
<nav style="float:right;border:1px solid black;padding:3px;margin-left:7px">
@end html
@ @ @ref{Main, Main page}@*
@ @ @ref{News}@*
@ @ @ref{Pictures}@*
@ @ @ref{Download}@*
@comment @ @ @ref{Download}

@html
<table style="background-color: #fff; padding: 5px;" cellspacing=0>
<tr><td><img src="http://groups.google.com/intl/en/images/logos/groups_logo_sm.gif" height=25 width=117 alt="Google Groups"></td></tr>
<tr><td style="padding-left: 5px;font-size: 110%"> <a target=_blank href="http://groups.google.com/group/mathgl"><b>MathGL</b></a> </td></tr>
</table>
</nav>
@end html
@end macro

@macro external {}
@html
<footer>
<!--LiveInternet counter--><script type="text/javascript"><!--
document.write("<a href='http://www.liveinternet.ru/click' "+
"target=_blank><img src='http://counter.yadro.ru/hit?t12.2;r"+
escape(document.referrer)+((typeof(screen)=="undefined")?"":
";s"+screen.width+"*"+screen.height+"*"+(screen.colorDepth?
screen.colorDepth:screen.pixelDepth))+";u"+escape(document.URL)+
";"+Math.random()+
"' alt='' title='LiveInternet: number of views during 24"+
" hours, number of visitors during 24 hours and during today' "+
"border=0 width=88 height=31><\/a>")//--></script><!--/LiveInternet-->

<a target=_blank href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=152187&amp;type=2" alt="SourceForge.net Logo" border="0" height="37" width="125"></a>

<a target=_blank href="http://www.thefreecountry.com/"> <img src="http://www.thefreecountry.com/images/tfc88x31green.gif" alt="thefreecountry.com: Free Programmers' Resources, Free Webmasters' Resources, Free Security Resources, Free Software" border="0" height="31" width="88"></a>

<a target=_blank href="http://sourceforge.net/donate/index.php?group_id=152187"><img src="http://images.sourceforge.net/images/project-support.jpg" width="88" height="32" border="0" alt="Support This Project" /> </a>
</footer>
@end html
@end macro

@macro fig {fname,text}
@center @image{../\fname\.png, 11cm, , \text\, png}
@end macro
@macro pfig {fname,text}
@center @uref{../pdf/\fname\.pdf, @image{../png/\fname\.png, 11cm, , \text\, png}}
@c @center @image{../png/\fname\, 11cm, , \text\. See also @uref{../pdf/\fname\.pdf, 3D PDF} sample, .png}
@end macro
@macro ufig {fname,width,text}
@center @image{../udav/\fname\.png, \width\cm, , \text\, png}
@end macro
@macro sfig {plot,text}
@ref{\text\, @image{../small/\plot\-sm.png,3cm, , , png}}
@end macro


@macro sref {arg}
@xref{\arg\}, for sample code and picture.
@end macro

@node Website, Overview, , Top
@include web_en.texi

@node Overview, Examples, Website, Top
@include overview_en.texi

@node Examples, General concepts, Overview, Top
@include example_en.texi

@node General concepts, MathGL core, Examples, Top
@include concept_en.texi

@node MathGL core, Widget classes, General concepts, Top
@include core_en.texi

@node Widget classes, Data processing, MathGL core, Top
@include widget_en.texi

@node Data processing, MGL scripts, Widget classes, Top
@include data_en.texi

@node MGL scripts, UDAV, Data processing, Top
@include parse_en.texi

@node UDAV, Other classes, MGL scripts, Top
@include udav_en.texi

@node Other classes, All samples, UDAV, Top
@include other_en.texi

@node All samples, Symbols and hot-keys, Other classes, Top
@include samples.texi

@node Symbols and hot-keys, File formats, All samples, Top
@appendix Symbols and hot-keys
@include symbols_en.texi

@node File formats, TeX-like symbols, Symbols and hot-keys, Top
@appendix File formats
@include formats_en.texi

@node TeX-like symbols, Plotting time, File formats, Top
@appendix TeX-like symbols
@include appendix_en.texi

@node Plotting time, Copying This Manual, TeX-like symbols, Top
@appendix Plotting time
@nav{}

Table below show plotting time in seconds for all samples in file @uref{http://sourceforge.net/p/mathgl/code/HEAD/tree/mathgl-2x/examples/samples.cpp, examples/samples.cpp}. The test was done in my laptop (i5-2430M) with 64-bit Debian.

Few words about the speed. Firstly, direct bitmap drawing (Quality=4,5,6) is faster than buffered one (Quality=0,1,2), but sometimes it give incorrect result (see @ref{cloud}) and don't allow to export in vector or 3d formats (like EPS, SVG, PDF ...). Secondly, lower quality is faster than high one generally, i.e. Quality=1 is faster than Quality=2, and Quality=0 is faster than Quality=1. However, if plot contain a lot of faces (like @ref{cloud}, @ref{surf3}, @ref{pipe}, @ref{dew}) then Quality=0 may become slow, especially for small images. Finally, smaller images are drawn faster than larger ones.

Results for image size 800*600 (default one).
@include time.texi

Results for image size 1920*1440 (print quality)
@include time_big.texi

@node Copying This Manual, Index, Plotting time, Top
@appendix GNU Free Documentation License
@include fdl.texi

@node Index, , Copying This Manual, Top
@unnumbered Index

@printindex cp

@bye