PGtikz.pl - Insert images into problems that are generated using LaTeX and TikZ.
This is a convenience macro for utilizing the LaTeXImage object to insert TikZ images into problems. Create a TikZ image as follows:
$image = createTikZImage();
$image->BEGIN_TIKZ
\draw (-2,0) -- (2,0);
\draw (0,-2) -- (0,2);
\draw (0,0) circle[radius=1.5];
END_TIKZThe LaTeX code is in a perl interpolated heredoc, so you may need to be careful with backslashes. In the above, \d does not require escaping the backslash. But if the code needed a double backslash line break, you would need to use \\\\.
If math content is within the LaTeX code, delimit it with \(...\) instead of with dollar signs.
Then insert the image into the problem with
image(insertGraph($image));There are several LaTeXImage parameters that may need to be set for the LaTeXImage object return by createTikZImage to generate the desired image.
$image->tex() Add the tikz commands that define the image.
This takes a single string parameter. It is
generally best to use single quotes around the
string. Escaping of special characters may be
needed in some cases.
$image->tikzOptions() Add options that will be passed to
\begin{tikzpicture}. This takes a single
string parameter.
For example:
$image->tikzOptions(
"x=.5cm,y=.5cm,declare function={f(\x)=sqrt(\x);}"
);
$image->tikzLibraries() Add additional tikz libraries to load. This
takes a single string parameter.
For example:
$image->tikzLibraries("arrows.meta,calc");
$image->texPackages() Add tex packages to load. This takes an array for
its parameter. Each element of this array should
either be the package name as a string, or an
array with two elements, the first of which is the
package name as a string and the second of which
is a string containing the options for the package.
For example:
$image->texPackages([
"pgfplots",
["hf-tikz", "customcolors"],
["xcolor", "cmyk,table"]
]);
$image->addToPreamble() Additional commands to add to the TeX preamble.
This takes a single string parameter.
$image->ext() Set the file type to be used for the image.
The valid image types are 'png', 'gif', 'svg',
and 'pdf'. The default is an 'svg' image. You
should determine if an 'svg' image works well with
the TikZ code that you utilize. If not, then use
this method to change the exension to 'png' or
'gif'.
This macro sets the extension to 'pdf' when a
hardcopy is generated.
$image->convertOptions() If ImageMagick's convert command is used to build
the output image (presently only done for 'png'
output) these input and output options will be
used. For example:
$image->convertOptions({
input => {density => 300},
output => {quality => 100, resize => "500x500"}
});
For a complete list of options, see:
https://imagemagick.org/script/command-line-options.php