1 % luamesh: compute and draw meshes with lua, luamplib and tikz
3 % Originally written by Maxime Chupin <mc@melusine.eu.org>,
6 % Distributed under the terms of the GNU free documentation licence:
7 % http://www.gnu.org/licenses/fdl.html
8 % without any invariant section or cover text.
10 \documentclass{lltxdoc
}
11 \usepackage{tcolorbox
}
16 \title{\Verb+luamesh+: compute and draw meshes with
\lualatex}
17 \author{Maxime Chupin
\email{mc@melusine.eu.org
}}
20 \newcommand*
\commande{\noindent\hspace{-
30pt
}%
21 \SaveVerb[aftersave=
{%
26 \newcommand*
\textme[1]{\textcolor{black
}{\rmfamily\textit{#1}}}
27 \newcommand*
\meta[1]{% % meta
28 \textme{\ensuremath{\langle}#1\ensuremath{\rangle}}}
29 \newcommand*
\optstar{% % optional star
30 \meta{\ensuremath{*
}}\xspace}
33 \setlength{\fboxsep}{2pt
}
35 codes=
{\catcode`\«
\active \catcode`\×
\active },
36 defineactive=
{\makefancyog\makefancytimes},
37 formatcom=
\color{red
},
40 % rendre «...» équivalent à \meta{...}
42 \newcommandx\makefancyog[0][addprefix=
\global]{%
43 \def«#
#1»
{\meta{#
#1}}}}
44 % rendre × équivalent à \optstar
46 \newcommandx\makefancytimes[0][addprefix=
\global]{%
50 \tcbuselibrary{listings,breakable
}
52 \definecolor{vert
}{rgb
}{0.1,
0.4,
0.1}
53 \definecolor{bleu
}{rgb
}{0.1,
0.1,
0.4}
55 numberstyle=
\footnotesize\color{vert
},
56 keywordstyle=
\ttfamily\bfseries\color{blue
},
57 basicstyle=
\ttfamily\footnotesize,
58 commentstyle=
\itshape\color{vert
},
59 stringstyle=
\ttfamily,
60 showstringspaces=false,
64 defaultdialect=
[LaTeX
]TeX,
68 \lstdefinelanguage{lua
}
69 {morekeywords=
{for,end,function,do,if,else,elseif,then,
70 tex.print,tex.sprint,io.read,io.open,string.find,string.explode,require
},
72 morecomment=
[s
]{--
[[}{]]},
76 \newtcblisting{Exemple
}{%
77 arc=
0pt,outer arc=
0pt,
79 colframe=red!
75!black,
81 boxsep=
0pt,left=
5pt,right=
5pt,top=
5pt,bottom=
5pt, bottomtitle =
83 boxrule=
0pt,bottomrule=
0.5pt,toprule=
0.5pt, toprule at break =
84 0pt, bottomrule at break =
0pt,
85 listing options=
{breaklines
},
88 \newtcblisting{commandshell
}{colback=black,colupper=white,colframe=black,
90 listing only,boxsep=
0pt,listing
91 options=
{style=tcblatex,language=sh
},
92 every listing line=
{\textcolor{red
}{\small\ttfamily\bfseries user \$>
}}}
94 \newtcblisting{latexcode
}{
96 listing only,boxsep=
0pt,listing
97 options=
{style=tcblatex
}}
100 \newcommand\luamesh{\Verb+luamesh+
\xspace}
102 \newenvironment{optionsenum
}[1][]
103 {\begin{description
}[font=
\color{red
}\ttfamily]}
111 The package
\Verb|luamesh| allows to compute and draw
2D triangulation
112 of Delaunay. The algorithm is written with lua, and depending of the
113 choice of the ``engine'', the draw is done by MetaPost (with
114 \Verb|luamplib|) or by
\Verb|tikz|.
116 The Delaunay triangulation algorithm is the Bowyer and Watson
117 algorithm. Several macros are provided to draw the global mesh, the
118 set of points, a particular step of the algorithm.
121 \section{Installation
}
123 \subsection{With Linux
}
125 To install
\luamesh with
\TeX live, you have to create the local
126 \Verb+texmf+ directory in your
\Verb+home+.
132 Then we have to files to place in the correct directories. First, the
133 \Verb+luamesh.sty+ file must be in the directory:
135 \Verb+~/texmf/tex/latex/luamesh/+
137 and secondly, the
\Verb+luamesh.lua+ must be in the directory:
139 \Verb+~/texmf/scripts/luamesh/+
142 Once you have done this,
\luamesh can be included in your
document
148 \subsection{Dependencies
}
150 This package is built upon two main packages to draw the
153 \item \Verb+luamplib+ to use MetaPost via the
\luatex library
155 \item or
\Verb+tikz+.
157 We will see how to choose between these two
\emph{drawing engines
}.
159 Moreover, the following packages are necessary:
161 \item \Verb+xkeyval+ to manage the optional arguments;
162 \item \Verb+xcolor+ to use colors (needed by
\Verb+luamplib+);
163 \item \Verb+ifthen+ to help the programming with
\TeX.
167 \section{The Basic Macros
}
169 If you want to use this package, you must compile your
document with
173 lualatex mylatexfile.tex
176 Let us recall that this package provides macros to draw two
177 dimensional triangulations (or meshes).
179 \subsection{Draw a Complete Mesh
}
181 \commande|
\buildMeshBW[«options»
]{«list of points» or «file name»
}|
\medskip
183 This macro produce the Delaunay triangulation (using the Bowyer and
184 Watson algorithm) of the given
\meta{list of points
}. The list of
185 points must be given in the following way :
187 \verb+(x1,y1);(x2,y2);(x3,y3);...;(xn,yn)+
191 \buildMeshBW{(
0.3,
0.3);(
1.5,
1);(
4,
0);(
4.5,
2.5);(
1.81,
2.14);(
2.5,
0.5);(
2.8,
1.5)
}
194 \subsubsection{The Options
}
196 There are several options to customize the drawing.
198 \item[mode = int (default) or ext:
] this option allows to
199 use either the previously described set of point in the argument, or
200 a file, containing, line by line (
2 columns), the points. Such a
209 \item[bbox = none (default) or show:
] this option allows to draw the
210 added points to form a
\emph{bounding box
}\footnote{The bounding
211 box is defined by four points place at
15\% around the box
212 defined by $(x_
{\min},y_
{\min})$, $(x_
{\min},y_
{\max})$,
213 $(x_
{\max},y_
{\max})$, and $(x_
{\min},y_
{\max})$.
} and the corresponding
214 triangulation. By default, these triangles are removed at the end of
216 \item[color =
\meta{value
} (default: black):
] The
color of the
218 \item[colorBbox =
\meta{value
} (default: black):
] The
color of the
219 drawing for the elements (points and triangles) belonging to the
221 \item[print = none (default) or points:
] To label the vertices of the
222 triangulations with an adding dot.
223 \item[meshpoint =
\meta{value
} (default: P):
] The letter(s) used to
224 label the vertices of the triangulation. It is include in the math
225 mode delimiters
\Verb+$...$+. The bounding box points are labeled
226 with a star exponent, and numbered from
1 to
4.
227 \item[tikz (boolean, default:false):
] By default, this boolean is set
228 to
\Verb+false+, and MetaPost (with
\Verb+luamplib+) is used to draw
229 the picture. With this option, it is
\Verb+tikz+ the
\textit{drawing
231 \item[scale =
\meta{value
} (default:
1cm):
] The scale option defines
232 the scale at which the picture is draw (the same for the two
233 axis). It must contain the unit of length (cm,
237 To illustrate the options, let us show you an example. We consider a
238 file
\Verb+mesh.txt+:
261 \subsection{Draw the Set of Points
}
263 \commande|
\tracePointsMesh[«options»
]{«list of points» or «file name»
}|
266 \subsection{Draw a Step of the Bowyer and Watson Algorithm
}
268 \commande|
\meshAddPointBW[«options»
]{«list of points» or «file name»
}{«point» or «number of line»
}|
271 \section{The
\emph{inc
} Macros
}
273 \section{Gallery of Examples
}
281 %%% ispell-local-dictionary: "american"