/usr/share/doc/mathgl/mathgl_en/mathgl_en

<!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: 2.10 FAQ</title>

<meta name="description" content="MathGL 2.1.2: 2.10 FAQ">
<meta name="keywords" content="MathGL 2.1.2: 2.10 FAQ">
<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="FAQ"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="mathgl_en_18.html#Reduce-memory-usage" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_20.html#General-concepts" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="mathgl_en_9.html#Examples" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_9.html#Examples" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_20.html#General-concepts" title="Next chapter"> &gt;&gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </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="FAQ-1"></a>
<h2 class="section">2.10 FAQ</h2>

<dl compact="compact">
<dt> <strong>The plot does not appear</strong></dt>
<dd><p>Check that points of the plot are located inside the bounding box and resize the bounding box using <a href="mathgl_en_32.html#ranges">ranges</a> function. Check that the data have correct dimensions for selected type of plot. Be sure that  <code>Finish()</code> is called after the plotting functions (or be sure that the plot is saved to a file). Sometimes the light reflection from flat surfaces (like, <a href="mathgl_en_40.html#dens">dens</a>) can look as if the plot were absent.
</p>
</dd>
<dt> <strong>I can not find some special kind of plot.</strong></dt>
<dd><p>Most &ldquo;new&rdquo; types of plots can be created by using the existing drawing functions. For example, the surface of curve rotation can be created by a special function <a href="mathgl_en_39.html#torus">torus</a>, or as a parametrically specified surface by <a href="mathgl_en_40.html#surf">surf</a>. See also, <a href="mathgl_en_18.html#Hints">Hints</a>. If you can not find a specific type of plot, please e-mail me and this plot will appear in the next version of MathGL library.
</p>
</dd>
<dt> <strong>Should I know some graphical libraries (like OpenGL) before using the MathGL library?</strong></dt>
<dd><p>No. The MathGL library is self-contained and does not require the knowledge of external libraries.
</p>
</dd>
<dt> <strong>In which language is the library written? For which languages does it have an interface?</strong></dt>
<dd><p>The core of the MathGL library is written in C++. But there are interfaces for: pure C, Fortran, Pascal, Forth, and its own command language MGL. Also there is a large set of interpreted languages, which are supported (Python, Java,  ALLEGROCL, CHICKEN, Lisp, CFFI, C#, Guile, Lua, Modula 3, Mzscheme, Ocaml, Octave, Perl, PHP, Pike, R, Ruby, Tcl). These interfaces are written using SWIG (both pure C functions and classes) but only the interface for Python and Octave is included in the build system. The reason is that I don&rsquo;t know any other interpreted languages :(. Note that most other languages can use (link to) the pure C functions.
</p>
</dd>
<dt> <strong>How can I use MathGL with Fortran?</strong></dt>
<dd><p>You can use MathGL as is with <code>gfortran</code> because it uses by default the AT&amp;T notation for external functions. For other compilers (like Visual Fortran) you have to switch on the AT&amp;T notation manually. The AT&amp;T notation requires that the symbol &lsquo;<samp>_</samp>&rsquo; is added at the end of each function name, function argument(s) is passed by pointers and the string length(s) is passed at the end of the argument list. For example:
</p>
<p><em>C function</em> &ndash; <code>void mgl_fplot(HMGL graph, const char *fy, const char *stl, int n);</code>
</p>
<p><em>AT&amp;T function</em> &ndash; <code>void mgl_fplot_(uintptr_t *graph, const char *fy, const char *stl, int *n, int ly, int ls);</code>
</p>
<p>Fortran users also should add C++ library by the option <code>-lstdc++</code>. If library was built with <code>enable-double=ON</code> (this default for v.2.1 and later) then all real numbers must be <code>real*8</code>. You can make it automatic if use option <code>-fdefault-real-8</code>.
</p>
</dd>
<dt> <strong>How can I print in Russian/Spanish/Arabic/Japanese, and so on?</strong></dt>
<dd><p>The standard way is to use Unicode encoding for the text output. But the MathGL library also has interface for 8-bit (char *) strings with internal conversion to Unicode. This conversion depends on the current locale OS. You may change it by <code>setlocale()</code> function. For example, for Russian text in CP1251 encoding you may use <code>setlocale(LC_CTYPE, &quot;ru_RU.cp1251&quot;);</code> (under MS Windows the name of locale may differ &ndash; <code>setlocale(LC_CTYPE, &quot;russian_russia.1251&quot;)</code>). I strongly recommend not to use the constant <code>LC_ALL</code> in the conversion. Since it also changes the number format, it may lead to mistakes in formula writing and reading of the text in data files. For example, the program will await a &lsquo;<samp>,</samp>&rsquo; as a decimal point but the user will enter &lsquo;<samp>.</samp>&rsquo;.
</p>
</dd>
<dt> <strong>How can I exclude a point or a region of plot from the drawing?</strong></dt>
<dd><p>There are 3 general ways. First, the point with <code>NAN</code> value as one of the coordinates (including color/alpha range) will never be plotted. Second, special functions <code>SetCutBox</code>() and <code>CutOff</code>() define the condition when the points should be omitted (see <a href="mathgl_en_31.html#Cutting">Cutting</a>). Last, you may change the transparency of a part of the plot by the help of functions <a href="mathgl_en_42.html#surfa">surfa</a>, <a href="mathgl_en_42.html#surf3a">surf3a</a> (see <a href="mathgl_en_42.html#Dual-plotting">Dual plotting</a>). In last case the transparency is switched on smoothly.
</p>
</dd>
<dt> <strong>I use VisualStudio, CBuilder or some other compiler (not MinGW/gcc). How can I link the MathGL library?</strong></dt>
<dd><p>In version 2.0, main classes (<code>mglGraph</code> and <code>mglData</code>) contains only <code>inline</code> functions and are acceptable for any compiler with the same binary files. However, if you plan to use widget classes (QMathGL, Fl_MathGL, ...) or to access low-level features (mglBase, mglCanvas, ...) then you have to recompile MathGL by yours compiler.
</p>
<p>Note, that you have to make import library(-ies) *.lib for provided binary *.dll. This procedure depend on used compiler &ndash; please read documentation for yours compiler. For VisualStudio, it can be done by command <code>lib.exe /DEF:libmgl.def /OUT:libmgl.lib</code>.
</p>
</dd>
<dt> <strong>How I can build MathGL under Windows?</strong></dt>
<dd><p>Generally, it is the same procedure as for Linux or MacOS &ndash; see section <a href="mathgl_en_4.html#Installation">Installation</a>. The simplest way is using the combination CMake+MinGW. Also you may need some extra libraries like GSL, PNG, JPEG and so on. All of them can be found at <a href="http://gnuwin32.sourceforge.net/packages.html">http://gnuwin32.sourceforge.net/packages.html</a>. After installing all components, just run <a href="http://www.cmake.org/cmake/help/runningcmake.html">cmake-gui</a> configurator and build the MathGL itself.
</p>
</dd>
<dt> <strong>How many people write this library?</strong></dt>
<dd><p>Most of the library was written by one person. This is a result of nearly a year of work (mostly in the evening and on holidays): I spent half a year to write the kernel and half a year to a year on extending, improving the library and writing documentation. This process continues now :). The build system (cmake files) was written mostly by D.Kulagin, and the export to PRC/PDF was written mostly by M.Vidassov.
</p>
</dd>
<dt> <strong>How can I display a bitmap on the figure?</strong></dt>
<dd><p>You can import data into a <code>mglData</code> instance by function <a href="mathgl_en_56.html#import">import</a> and display it by <a href="mathgl_en_40.html#dens">dens</a> function. For example, for black-and-white bitmap you can use the code: <code>mglData bmp; bmp.Import(&quot;fname.png&quot;,&quot;wk&quot;); gr-&gt;Dens(bmp,&quot;wk&quot;);</code>.
</p>
</dd>
<dt> <strong>How can I use MathGL in Qt, FLTK, wxWidgets etc.?</strong></dt>
<dd><p>There are special classes (widgets) for these libraries: QMathGL for Qt, Fl_MathGL for FLTK and so on. If you don&rsquo;t find the appropriate class then you can create your own widget that displays a bitmap using mglCanvas::GetRGB().
</p>
</dd>
<dt> <strong>How can I create 3D in PDF?</strong></dt>
<dd><p>Just use <code>WritePRC</code>() method which also create PDF file if enable-pdf=ON at MathGL configure.
</p>
</dd>
<dt> <strong>How can I create TeX figure?</strong></dt>
<dd><p>Just use <code>WriteTEX</code>() method which create LaTeX files with figure itself &lsquo;<samp><var>fname</var>.tex</samp>&rsquo;, with MathGL colors &lsquo;<samp>mglcolors.tex</samp>&rsquo; and main file &lsquo;<samp>mglmain.tex</samp>&rsquo;. Last one can be used for viewing image by command like <code>pdflatex mglmain.tex</code>.
</p>
</dd>
<dt> <strong>Can I use MathGL in JavaScript?</strong></dt>
<dd><p>Yes, sample JavaScript file is located in texinfo/ folder of sources. You should provide JSON data with 3d image for it (can be created by <code>WriteJSON</code>() method). Script allows basic manipulation with plot: zoom, rotation, shift. Sample of JavaScript pictures can be found in <a href="http://mathgl.sf.net/json.html">http://mathgl.sf.net/json.html</a>.
</p>



</dd>
<dt> <strong>How I can change the font family?</strong></dt>
<dd><p>First, you should download new font files from <a href="http://mathgl.sourceforge.net/download.html">here</a> or from <a href="http://sourceforge.net/project/showfiles.php?group_id=152187&amp;package_id=267177">here</a>. Next, you should load the font files into mglGraph class instance <var>gr</var> by the following command: <code>gr-&gt;LoadFont(fontname,path);</code>. Here <var>fontname</var> is the base font name like &lsquo;<samp>STIX</samp>&rsquo; and <var>path</var> sets the location of font files. Use <code>gr-&gt;RestoreFont();</code> to start using the default font.
</p>
</dd>
<dt> <strong>How can I draw tick out of a bounding box?</strong></dt>
<dd><p>Just set a negative value in <a href="mathgl_en_32.html#ticklen">ticklen</a>. For example, use <code>gr-&gt;SetTickLen(-0.1);</code>.
</p>
</dd>
<dt> <strong>How can I prevent text rotation?</strong></dt>
<dd><p>Just use <code>SetRotatedText(false)</code>. Also you can use axis style &lsquo;<samp>U</samp>&rsquo; for disable only tick labels rotation.
</p>
</dd>
<dt> <strong>What is <code>*.so</code>? What is <code>gcc</code>? How I can use <code>make</code>?</strong></dt>
<dd><p>They are standard GNU tools. There is special FAQ about its usage under Windows &ndash; <a href="http://www.mingw.org/wiki/FAQ">http://www.mingw.org/wiki/FAQ</a>.
</p>
</dd>
<dt> <strong>How can I draw equal axis range even for rectangular image?</strong></dt>
<dd><p>Just use <code>Aspect(NAN,NAN)</code> for each subplot, or at the beginning of the drawing.
</p>

</dd>
</dl>




<hr size="6">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="mathgl_en_18.html#Reduce-memory-usage" title="Previous section in reading order"> &lt; </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_20.html#General-concepts" title="Next section in reading order"> &gt; </a>]</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">[<a href="mathgl_en_9.html#Examples" title="Beginning of this chapter or previous chapter"> &lt;&lt; </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_9.html#Examples" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="mathgl_en_20.html#General-concepts" title="Next chapter"> &gt;&gt; </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>
mathgl-doc-en 2.1.3.1-4ubuntu3 / usr / share / doc / mathgl / mathgl_en / mathgl_en_19.html
