summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/lualatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2024-08-27 19:31:50 +0000
committerKarl Berry <karl@freefriends.org>2024-08-27 19:31:50 +0000
commita0ffed9804111ae312b1710fe706e819495c0648 (patch)
tree24e1d59fa99b1eb5e3d321ef42c80a9260ac9994 /Master/texmf-dist/doc/lualatex
parentadcc42259991461c70441605834e890e99b5c9fb (diff)
domaincoloring (27aug24)
git-svn-id: svn://tug.org/texlive/trunk@72119 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/lualatex')
-rw-r--r--Master/texmf-dist/doc/lualatex/domaincoloring/Changes4
-rw-r--r--Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.bib11
-rw-r--r--Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.pdfbin6845040 -> 12831690 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.tex63
-rw-r--r--Master/texmf-dist/doc/lualatex/domaincoloring/titleImg.pdfbin335225 -> 334858 bytes
5 files changed, 53 insertions, 25 deletions
diff --git a/Master/texmf-dist/doc/lualatex/domaincoloring/Changes b/Master/texmf-dist/doc/lualatex/domaincoloring/Changes
index e49a69aac3c..725f4399fba 100644
--- a/Master/texmf-dist/doc/lualatex/domaincoloring/Changes
+++ b/Master/texmf-dist/doc/lualatex/domaincoloring/Changes
@@ -1,3 +1,7 @@
+0.03 2024-08-26 - use \jobname for temporary file
+ - added option force for not creating already existing pdf's
+ - allow different x|y resolutions
+ - updated documentation
0.02 2024-08-22 - edit option bgcolor
- reduced header for the intermediate eps
- renamed complex-numbers.lua
diff --git a/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.bib b/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.bib
index d109070c927..5529a63a489 100644
--- a/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.bib
+++ b/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.bib
@@ -25,3 +25,14 @@
date = {2024-08-18},
}
+@online{dm,
+ author = {Juan Carlos Ponce Campuzano},
+ title = {Dynamic Mathematics},
+ subtitle = {Domain Coloring -- Visualizing Complex Functions},
+ date = {2018-07-15},
+ urldate = {2024-08-23},
+ url ={https://www.dynamicmath.xyz/domain-coloring/},
+}
+
+
+ \ No newline at end of file
diff --git a/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.pdf b/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.pdf
index 8a8b79e4d98..bf0e31988ee 100644
--- a/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.pdf
+++ b/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.tex b/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.tex
index 63c33ec368f..cedf037ab1c 100644
--- a/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.tex
+++ b/Master/texmf-dist/doc/lualatex/domaincoloring/domaincoloring-doc.tex
@@ -1,7 +1,9 @@
-%% $Id: domaincoloring-doc.tex 952 2024-08-22 15:40:35Z herbert $
+%% $Id: domaincoloring-doc.tex 966 2024-08-26 19:55:11Z herbert $
%
\listfiles
+\def\header{Complex Functions}
+
\DocumentMetadata{}
\documentclass[fontsize=11pt,english,BCOR=10mm,DIV=12,bibliography=totoc,parskip=false,headings=small,
headinclude=false,footinclude=false,oneside]{pst-doc}
@@ -15,15 +17,19 @@
\usepackage{enumitem}
\setlist{noitemsep,nosep}
+\usepackage{makeidx}
+\makeindex
+
\usepackage{domaincoloring}
\let\DColFV\fileversion
+\setDColkeys{force=false}% only for this documentation relevant
\usepackage{hvlogos}
\usepackage{listings}
\lstset{columns=fixed,basicstyle=\ttfamily\small}
-\def\bgImage{\includegraphics[width=7cm]{titleImg}}
+\def\bgImage{\hspace{-2cm}*\includegraphics[width=14cm]{titleImg.png}}
\title{Domain Coloring of complex functions\\version \DColFV}
\author{Herbert Voß}
@@ -34,7 +40,9 @@
\section{Introduction}
-This package works only with \texttt{lualatex}!
+This package works only with \texttt{lualatex} and the option \Loption{shell-escape}!
+It creates an intermediate external EPS-file, which is automatically converted with
+\LFile{epstopdf}. The pdf is in the end imported by the macro \Lcs{includegraphics}.
\subsection{Loading the package}
The package \texttt{domaincoloring} creates acolored interpretation of the
@@ -76,16 +84,17 @@ Every math function has to be preceeded by \texttt{cmath} if it has a complex ar
\noindent
\begin{xltabular}{\linewidth}{@{} >{\ttfamily}l l X @{}}\\\toprule
\emph{name} & \emph{value} &\emph{meaning}\\\midrule
-domain & {-2,2,-2,2} & the (re,im)-coordinates for the complex system\\
-resolution & 500 & the number of steps for the re,im interval. At the moment only
-for both coordinates the same. Will be in future
-versions different for the both axes. \\
-filename & \Lcs{jobname-tmp} & name of the created external file, must be unique\\
-grfOptions &scale=0.5 & optional arguments for \Lcs{includegraphics}\\
-hsvrgb & {phi,1,r} & for the conversion into rgb\\
-funcName & & corresponding to external file\\
-bgcolor & 0 & change color to white as background for all values $r+g+b\le\text{bgcolor}$\\
-invers & false & inverted colors with $color=|color-255|$\\
+\Lkeyword{domain} & {-2,2,-2,2} & the (re,im)-coordinates for the complex system\\
+\Lkeyword{resolution} & 500 & the number of steps for the re,im interval. One value will be for
+both axes. Two values like \verb|{500,600}| for real axis and imaginary axis,\\
+\Lkeyword{filename} & \Lcs{jobname-tmp} & name of the created external file, must be unique\\
+\Lkeyword{funcName} & \texttt{\{\}} & corresponding to external file\\
+\Lkeyword{grfOptions} &scale=0.5 & optional arguments for \Lcs{includegraphics}\\
+\Lkeyword{hsvrgb} & {phi+pi,1,r} & for the conversion into rgb\\
+\Lkeyword{bgcolor} & -1 & change color to white as background for all values $-1\le r+g+b\le\text{bgcolor}$\\
+\Lkeyword{invers} & false & inverted colors with $color=|color-255|$\\
+\Lkeyword{force} & true & With \texttt{force=false} an existing pdf file will be used
+without calculating a new one.\\
\bottomrule
\end{xltabular}
@@ -96,7 +105,7 @@ invers & false & inverted colors with $color=|color-255|$\\
\subsection{The default with function $f(z)=z$}
\begin{lstlisting}
-\DomainColoring{z}\qquad % default filename \jobname-tmp.png
+\DomainColoring{z} % default filename \jobname-tmp.png
\end{lstlisting}
\noindent
@@ -111,7 +120,9 @@ invers & false & inverted colors with $color=|color-255|$\\
f(z) &= \cos(z)/\sin(z^4-1)
\end{align}
-in Lua-notation: \verb|cmath.cos(z)/cmath.sin(z^4-1)|.
+in Lua-notation: \verb|cmath.cos(z)/cmath.sin(z^4-1)|. All complex functions
+must be preceeded by \texttt{cmath.}. For real functions the prefix \texttt{math.}
+can be omitted.
\begin{lstlisting}
\DomainColoring[domain={-2.5,2.5,-2.5,2.5},resolution=500,
@@ -138,7 +149,7 @@ in Lua-notation: \verb|cmath.cos(z)/cmath.sin(z^4-1)|.
filename=\jobname-tmp1c]{cmath.cos(z)/cmath.sin(z^4-1)}}
-With \Lcs{bgcolor}\texttt{=<int>} all RGB-combinations with a sum $R+G+B <= \text{int}$ are set to
+With \Lkeyword{bgcolor}\texttt{=<int>} all RGB-combinations with a sum $R+G+B <= \text{int}$ are set to
the color white.
\subsection{Option for \Lcs{includegraphics}}
@@ -159,9 +170,9 @@ With \Lkeyword{grfOptions} one can define optional arguments for \Lcs{includegra
\subsection{Higher resolution}
The resolution is more or less the number of pixels for the given domain.
-In later versions of this package it may be possible to have different values
-for the two coordinates. By now the one value for \Lkeyword{resolution} is for
-both axes.
+It is possible to have different values
+for the two coordinates. Is only one value for \Lkeyword{resolution} given, then it is
+for both axes.
\begin{lstlisting}
@@ -182,7 +193,7 @@ both axes.
\subsection{hsv to rgb conversion}
-The color model (Wikipedia)
+The color model (Wikipedia):
\begin{center}
\includegraphics[width=0.5\linewidth]{hsv}
@@ -222,27 +233,28 @@ e.g. \texttt{hsvrgb=\{phi+2,0.5,2/r\}}
\subsection{External function definition}
The already existing file \LFile{domaincoloring-functions.lua} collects sone
definitions of complex functions $f(z)$, which can be used from inside \LaTeX\
-with the optional argument \Lkeyword{funcName}. In this case the mandatory argument
+with the optional argument \Lkeyword{funcName}\texttt{<Lua function name>}.
+In this case the mandatory argument
of \Lcs{DomainColoring} has no meaning and can be empty.
\begin{lstlisting}
\DomainColoring[filename=\jobname-tmp6a,resolution=1000,
domain={-1.5,1.5,-1.5,1.5}, grfOptions={width=0.49\linewidth},
- hsvrgb={phi+2*pi,1,1/r}, funcName=f12]{}% using predefined function
+ hsvrgb={phi+pi,1,2/r}, funcName=f12]{}% using predefined function
\hfill
\DomainColoring[filename=\jobname-tmp6b,resolution=2000,
domain={-2.3,0.7,-1.5,1.5}, grfOptions={width=0.49\linewidth},
- hsvrgb={phi+2*pi,1,1/r},funcName=f13]{}
+ hsvrgb={phi+pi,1,2/r},funcName=f13]{}
\end{lstlisting}
\noindent
\DomainColoring[filename=\jobname-tmp6a,resolution=1000,
domain={-1.5,1.5,-1.5,1.5}, grfOptions={width=0.49\linewidth},
- hsvrgb={phi+2*pi,1,1/r}, funcName=f12]{}% using predefined function
+ hsvrgb={phi+pi,1,2/r}, funcName=f12]{}% using predefined function
\hfill
\DomainColoring[filename=\jobname-tmp6b,resolution=2000,
domain={-2.3,0.7,-1.5,1.5}, grfOptions={width=0.49\linewidth},
- hsvrgb={phi+2*pi,1,1/r},funcName=f13]{}
+ hsvrgb={phi+pi,1,2/r},funcName=f13]{}
The contents of the function file of the current version of \LPack{domaincoloring} is::
@@ -254,4 +266,5 @@ The contents of the function file of the current version of \LPack{domaincolorin
\nocite{*}
\printbibliography
+\printindex
\end{document}
diff --git a/Master/texmf-dist/doc/lualatex/domaincoloring/titleImg.pdf b/Master/texmf-dist/doc/lualatex/domaincoloring/titleImg.pdf
index e68120b481d..decae34f421 100644
--- a/Master/texmf-dist/doc/lualatex/domaincoloring/titleImg.pdf
+++ b/Master/texmf-dist/doc/lualatex/domaincoloring/titleImg.pdf
Binary files differ