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]{\color{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[\color{red
}\texttt{mode = int (default) or ext
}:
] the mode option allow 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
211 \subsection{Draw the Set of Points
}
213 \commande|
\tracePointsMesh[«options»
]{«list of points» or «file name»
}|
216 \subsection{Draw a Step of the Bowyer and Watson Algorithm
}
218 \commande|
\meshAddPointBW[«options»
]{«list of points» or «file name»
}{«point» or «number of line»
}|
221 \section{The
\emph{inc
} Macros
}
223 \section{Gallery of Examples
}
231 %%% ispell-local-dictionary: "american"