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
}
14 \usepackage[tikz
]{bclogo
}
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,
65 morekeywords=
{buildMeshBW,buildMeshBWinc,drawPointsMesh,
66 drawPointsMeshinc, meshAddPointBW, meshAddPointBWinc
}% frame=tb
69 \lstdefinelanguage{lua
}
70 {morekeywords=
{for,end,function,do,if,else,elseif,then,
71 tex.print,tex.sprint,io.read,io.open,string.find,string.explode,require
},
73 morecomment=
[s
]{--
[[}{]]},
77 \newtcblisting{Exemple
}{%
78 arc=
0pt,outer arc=
0pt,
80 colframe=red!
75!black,
82 boxsep=
0pt,left=
5pt,right=
5pt,top=
5pt,bottom=
5pt, bottomtitle =
84 boxrule=
0pt,bottomrule=
0.5pt,toprule=
0.5pt, toprule at break =
85 0pt, bottomrule at break =
0pt,
86 listing options=
{breaklines
},
89 \newtcblisting{commandshell
}{colback=black,colupper=white,colframe=black,
91 listing only,boxsep=
0pt,listing
92 options=
{style=tcblatex,language=sh
},
93 every listing line=
{\textcolor{red
}{\small\ttfamily\bfseries user \$>
}}}
95 \newtcblisting{latexcode
}{
97 listing only,boxsep=
0pt,listing
98 options=
{style=tcblatex
}}
101 \newcommand\luamesh{\Verb+luamesh+
\xspace}
103 \newenvironment{optionsenum
}[1][]
104 {\begin{description
}[font=
\color{red
}\ttfamily]}
107 \newenvironment{warning
}{%
108 \setlength{\logowidth}{24pt
}
110 arc=
0pt,outer arc=
0pt,colback=gray!
10!white,colframe=gray!
60!white,
111 boxsep=
0pt,left=
5pt,right=
5pt,top=
5pt,bottom=
5pt, bottomtitle =
3pt, toptitle=
3pt,
112 boxrule=
0pt,bottomrule=
0.5pt,toprule=
0.5pt
}
115 \begin{wrapfigure
}[2]{L
}{17pt
}%
122 {\end{tcolorbox
}\medskip}
127 %% === Page de garde ===================================================
128 \thispagestyle{empty
}
129 \begin{tikzpicture
}[remember picture, overlay
]
130 \node[below right, shift=
{(-
4pt,
4pt)
}] at (current page.north west)
{%
131 \includegraphics{fond.pdf
}%
136 \includegraphics{luamesh
}\\
137 {\large compute and draw meshes with
\lualatex}\\
[1cm
]
138 \parbox{0.6\textwidth}{
140 mode=ext,step=badtriangles,
141 colorNew =green!
20!red,
149 \parbox{0.4\textwidth}{\Large\raggedleft
150 \textbf{Contributor
}\\
151 Maxime
\textsc{Chupin
}
155 Version
0.1,
25 novembre
2016\\
156 \url{http://melusine.eu.org/syracuse/G/delaunay/
}
158 %% == Page de garde ====================================================
164 The package
\Verb|luamesh| allows to compute and draw
2D triangulation
165 of Delaunay. The algorithm is written with lua, and depending of the
166 choice of the ``engine'', the draw is done by MetaPost (with
167 \Verb|luamplib|) or by
\Verb|tikz|.
169 The Delaunay triangulation algorithm is the Bowyer and Watson
170 algorithm. Several macros are provided to draw the global mesh, the
171 set of points, a particular step of the algorithm.
174 \section{Installation
}
176 \subsection{With Linux
}
178 To install
\luamesh with
\TeX live, you have to create the local
179 \Verb+texmf+ directory in your
\Verb+home+.
185 Then we have to files to place in the correct directories. First, the
186 \Verb+luamesh.sty+ file must be in the directory:
188 \Verb+~/texmf/tex/latex/luamesh/+
190 and secondly, the
\Verb+luamesh.lua+ must be in the directory:
192 \Verb+~/texmf/scripts/luamesh/+
195 Once you have done this,
\luamesh can be included in your
document
201 \subsection{Dependencies
}
203 This package is built upon two main packages to draw the
206 \item \Verb+luamplib+ to use MetaPost via the
\luatex library
208 \item or
\Verb+tikz+.
210 We will see how to choose between these two
\emph{drawing engines
}.
212 Moreover, the following packages are necessary:
214 \item \Verb+xkeyval+ to manage the optional arguments;
215 \item \Verb+xcolor+ to use colors (needed by
\Verb+luamplib+);
216 \item \Verb+ifthen+ to help the programming with
\TeX.
220 \section{The Basic Macros
}
222 If you want to use this package, you must compile your
document with
226 lualatex mylatexfile.tex
229 Let us recall that this package provides macros to draw two
230 dimensional triangulations (or meshes).
232 \subsection{Draw a Complete Mesh
}
234 \commande|
\buildMeshBW[«options»
]{«list of points» or «file name»
}|
\medskip
236 This macro produce the Delaunay triangulation (using the Bowyer and
237 Watson algorithm) of the given
\meta{list of points
}. The list of
238 points must be given in the following way :
240 \verb+(x1,y1);(x2,y2);(x3,y3);...;(xn,yn)+
244 \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)
}
247 \subsubsection{The Options
}
249 There are several options to customize the drawing.
251 \item[mode = int (default) or ext:
] this option allows to
252 use either the previously described set of point in the argument, or
253 a file, containing, line by line (
2 columns), the points. Such a
262 \item[bbox = none (default) or show:
] this option allows to draw the
263 added points to form a
\emph{bounding box
}\footnote{The bounding
264 box is defined by four points place at
15\% around the box
265 defined by $(x_
{\min},y_
{\min})$, $(x_
{\min},y_
{\max})$,
266 $(x_
{\max},y_
{\max})$, and $(x_
{\min},y_
{\max})$.
} and the corresponding
267 triangulation. By default, these triangles are removed at the end of
269 \item[color =
\meta{value
} (default: black):
] The
color of the
271 \item[colorBbox =
\meta{value
} (default: black):
] The
color of the
272 drawing for the elements (points and triangles) belonging to the
274 \item[print = none (default) or points:
] To label the vertices of the
275 triangulations with an adding dot.
276 \item[meshpoint =
\meta{value
} (default: P):
] The letter(s) used to
277 label the vertices of the triangulation. It is include in the math
278 mode delimiters
\Verb+$...$+. The bounding box points are labeled
279 with a star exponent, and numbered from
1 to
4.
280 \item[tikz (boolean, default:false):
] By default, this boolean is set
281 to
\Verb+false+, and MetaPost (with
\Verb+luamplib+) is used to draw
282 the picture. With this option, it is
\Verb+tikz+ the
\textit{drawing
284 \item[scale =
\meta{value
} (default:
1cm):
] The scale option defines
285 the scale at which the picture is draw (the same for the two
286 axis). It must contain the unit of length (cm,
290 To illustrate the options, let us show you an example. We consider a
291 file
\Verb+mesh.txt+:
315 The drawing engine is not here very relevant. But it is useful to
316 understand how the drawing is made. However, the engine will make sens
317 for the so called
\emph{inc
} macros (section~
\ref{sec:inc
}), where we
318 will be allowed to add code before and after the generated one by
322 \subsection{Draw the Set of Points
}
324 \commande|
\drawPointsMesh[«options»
]{«list of points» or «file name»
}|
327 \subsection{Draw a Step of the Bowyer and Watson Algorithm
}
329 \commande|
\meshAddPointBW[«options»
]{«list of points» or «file name»
}{«point» or «number of line»
}|
332 \section{The
\emph{inc
} Macros
}\label{sec:inc
}
334 \section{Gallery of Examples
}
342 %%% ispell-local-dictionary: "american"