\documentclass[english,parskip=half-,paper=a4]{scrartcl} \usepackage[margin=1.5cm,includeheadfoot]{geometry} \RequirePackage[default]{lato} \RequirePackage[math-style=french,bold-style=ISO]{lete-sans-math} \setsansfont{Fira Sans}[Scale=MatchLowercase] \setmonofont{CascadiaMono-Light}[Scale=MatchLowercase] \usepackage{pixelarttikz-l3} \usepackage{babel} \usepackage{enumitem} \usepackage{couleurs-fr} \usepackage{minted-code} \usepackage{hologo} \usepackage{fancyvrb} \usepackage{xcolor,url} \usepackage[colorlinks]{hyperref} \setlength\parindent{0pt} \def\Lcs#1{\texttt{\textbackslash#1}\index{#1@\texttt{\textbackslash#1}}} \def\Largb#1{\texttt{\{}\textit{#1}\texttt{\}}} \def\Lpack#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Package!#1@\texttt{#1}}} \def\Loption#1{\texttt{#1}\index{#1@\texttt{#1}}\index{Option!#1@\texttt{#1}}} \def\pixlartcolorskoala{%french version :-p A=VertForet, B=Noir, C=GrisClair, D=GrisFonce, E=Beige, F=Blanc, G=BleuClair, H=VertClair, I=Marron } \subtitle{pixelart, with Ti\textit{k}Z and \hologo{LaTeX3}} \title{pixelarttikz-l3 (0.1.9)} \date{October 20, 2025} \author{Cédric Pierquet\thanks{\protect\url{cpierquet@outlook.fr}}} \raggedbottom \begin{document} \maketitle \tableofcontents \vfill \hfill% \pixlarttikz[unit=0.2,text size=0.875]{\pixlartcolorskoala}{PAkoala.csv}~~ \pixlarttikz[unit=0.2,correction]{\pixlartcolorskoala}{PAkoala.csv}% \hfill\null \vspace*{5mm} \pagebreak \section{Introduction} \subsection{Loading} To use \Lpack{pixelarttikz-l3}, simply use: \begin{codeblock}[title=Loading (only l3)] \usepackage{pixelarttikz-l3} \end{codeblock} \begin{codeblock}[title=Loading (l3 and l2)] \usepackage[legacy]{pixelarttikz-l3} %with latex2e version of package and macros \end{codeblock} \subsection{Idea(s)} The idea behind this package is to provide a command for manipulating pixelarts, with a simplified syntax. \smallskip The basis of the macro is a \texttt{csv} file, which can be external file, or with internal generated version. \smallskip For \textit{huge} pixelarts, \hologo{LuaLaTeX} is necessary for compiling ! \subsection{First example(s)} \begin{codeblock}[title=File csv sample] \begin{filecontents*}[overwrite]{base.csv} A,B,C,D A,B,D,C B,A,D,C C,A,B,D \end{filecontents*} \end{codeblock} \begin{exampleM}{} \pixlarttikz%with letters {A,B,C,D} {base.csv} \pixlarttikz[correction]%with colors {A=green,B=blue,C=orange,D=pink}% {base.csv} \pixlarttikz[correction,borders=false]%with colors w/o borders {A=green,B=blue,C=orange,D=pink}% {base.csv} \pixlarttikz[symbols]%with symbols {A=12,B=-5,C=4,D=0} {base.csv} \pixlarttikz[symbols,text size=0.875]%with symbols and custom scale {A=12,B=-5,C=4,D=0} {base.csv} \pixlarttikz[symbols]%with random symbols {A=1§2§3§4,B=5§6§7§8,C=9§10§11§12,D=13§14§15§16} {base.csv} \end{exampleM} \pagebreak \section{Global usage} \subsection{Main macro} The main macro is: \begin{codeblock}[title=Main macro] \pixlarttikz% [keys]% % {letters association}% {file.csv} \end{codeblock} Available keys are: \begin{itemize}[noitemsep] \item the key \Loption{unit} to specify unit, in cm;\hfill{}default \Loption{1} \item the boolean \Loption{codes} to display codes;\hfill{}default \Loption{true} \item the boolean \Loption{correction} to color the pixlart;\hfill{}default \Loption{false} \item the boolean \Loption{symbols} to print the symbols (one or shuffle within list);\hfill{}default \Loption{false} \item the boolean \Loption{borders} to print borders of the cells;\hfill{}default \Loption{true} \item the key \Loption{font} for the font of codes/symbols;\hfill{}default \Loption{\textbackslash sffamily} \item the key \Loption{cut} for cutting usage;\hfill{}default \Loption{empty} \item the key \Loption{text size} for adapting height automatically.\hfill{}default \Loption{0.55} \end{itemize} The \Loption{cut} key can be given within the form: % \begin{itemize} \item \Loption{x} to specify the size of the blocks; \item \Loption{+} to specify the number of blocks. \end{itemize} \subsection{Macro for individual block} The macro for individual block is (keys are identical of main macro): \begin{codeblock}[title=Individual block] \pixlarttikzblock% [keys]% % {letters association}% {block number r/c}% {file.csv} \end{codeblock} \pagebreak \subsection{Sample} \begin{codeblock}[title=Useful data] \begin{filecontents*}[overwrite]{PAkoala.csv} A,A,A,A,A,A,A,H,H,H,A,A,A,A,A,H,H,H,A,A,A,A,A,A,A,A,A,H,H,H,H,A,A,H,A,A,A,A,A,A A,A,A,A,A,A,A,A,H,A,A,A,A,A,A,H,H,A,A,A,A,A,A,A,A,A,A,H,A,A,A,A,A,H,A,A,A,A,A,A A,A,A,H,A,A,A,A,A,A,A,A,A,A,A,H,H,A,A,A,A,A,A,A,A,H,H,H,A,A,A,A,A,A,A,A,A,A,A,A A,A,A,A,A,A,A,B,E,E,E,E,A,A,A,A,A,A,A,A,A,A,A,H,H,H,A,B,B,E,E,E,E,B,A,A,A,A,A,H A,A,H,A,A,A,A,B,E,E,E,E,E,A,A,A,A,A,A,A,A,A,A,H,H,H,B,E,E,E,E,E,E,B,B,A,A,A,A,H A,A,H,A,A,B,B,E,C,C,C,C,C,E,B,B,B,E,E,E,E,E,E,B,B,B,E,C,C,C,C,C,C,E,B,B,H,H,A,A A,A,H,A,B,E,D,D,D,D,B,D,C,C,E,E,E,E,C,C,C,C,E,E,E,E,E,C,D,B,B,D,D,D,E,B,H,A,A,A A,A,A,A,B,E,D,D,F,F,D,B,D,C,C,E,C,C,C,C,C,C,C,C,E,C,C,D,B,D,D,F,F,D,E,B,A,A,A,H A,A,A,B,C,D,D,F,F,F,D,D,B,B,C,C,C,C,C,C,C,C,C,C,C,C,C,B,D,D,D,F,F,D,D,C,B,A,H,H A,A,A,B,C,D,F,F,F,F,F,D,D,D,C,C,C,C,C,C,C,C,C,C,C,C,C,D,D,F,F,F,F,F,D,C,B,A,H,H A,A,A,B,D,D,F,F,F,F,F,D,C,C,C,C,C,C,C,C,C,C,C,C,C,C,C,C,D,F,F,F,F,F,D,D,B,A,A,H A,A,A,B,D,D,G,F,F,F,F,D,C,C,B,B,B,C,C,B,B,C,C,B,B,B,C,C,D,F,F,F,F,G,D,D,B,A,A,A A,A,A,A,B,G,G,F,F,F,F,D,C,C,B,F,B,C,B,D,D,B,C,B,F,B,C,C,D,G,F,F,F,G,G,B,H,A,A,A A,A,A,A,A,B,G,G,G,F,G,D,C,C,C,B,B,C,B,D,D,B,C,B,B,C,C,C,D,G,G,F,G,G,B,H,H,H,A,A A,A,A,A,A,A,B,G,G,G,G,B,C,C,C,C,C,C,B,B,B,B,C,C,C,C,C,C,D,B,G,G,G,G,B,H,H,H,A,A A,A,A,A,A,A,A,B,B,B,B,B,C,C,C,C,C,C,B,B,B,B,C,C,C,C,C,C,D,B,B,B,B,B,A,A,H,H,A,A A,A,A,A,A,A,A,A,A,A,A,D,D,C,C,C,C,F,B,B,B,B,F,C,C,C,C,D,D,A,A,A,A,A,A,A,A,A,A,A A,A,A,A,A,A,A,A,A,A,A,B,D,D,C,C,C,F,F,B,B,F,F,C,C,C,D,D,B,A,A,A,A,A,A,A,A,A,A,A A,A,A,A,A,H,H,H,A,A,A,A,B,B,D,C,C,F,F,F,F,F,F,C,C,D,B,B,A,A,A,A,A,A,H,H,H,A,A,A A,A,A,A,H,H,H,H,A,A,A,A,B,B,D,D,D,G,G,G,G,G,G,D,D,D,D,B,A,A,A,A,A,A,A,H,H,H,A,A A,A,A,A,H,H,H,A,A,A,A,B,D,D,D,D,D,G,G,G,G,G,G,D,D,D,D,D,B,A,A,A,A,A,A,A,H,H,A,A A,A,A,H,A,A,A,A,A,A,B,C,D,D,D,G,G,G,D,D,D,D,G,G,G,D,D,D,C,B,A,H,H,A,A,A,A,H,A,A A,A,A,H,H,A,A,A,A,A,D,C,C,C,D,G,G,F,G,D,D,G,F,G,G,D,D,C,C,C,B,A,H,H,A,A,A,A,A,A A,A,A,A,A,H,H,H,H,B,D,D,C,C,D,G,G,F,F,F,F,F,F,G,G,D,D,C,C,D,B,A,A,H,H,A,A,A,A,A A,A,A,A,A,A,A,A,A,B,D,D,C,C,C,C,C,B,F,F,F,F,F,B,C,C,C,C,D,D,B,A,A,H,H,H,H,A,A,A A,A,A,H,H,A,A,A,A,B,D,D,C,C,C,C,C,C,B,F,F,F,B,C,C,C,C,C,D,D,B,A,A,A,A,H,H,A,A,A A,A,A,A,A,A,A,A,A,A,B,B,D,D,C,C,C,C,C,B,F,B,C,C,C,C,D,D,B,B,A,A,A,H,H,A,A,A,A,A A,A,A,A,A,A,A,A,A,A,B,B,B,D,D,C,C,C,C,B,F,B,C,C,C,C,D,B,B,B,A,A,A,H,H,A,A,A,A,A A,A,A,A,A,A,A,A,A,B,C,C,C,B,B,D,D,D,D,B,F,B,D,D,D,B,B,D,C,C,B,A,A,A,H,A,A,A,A,A A,A,A,A,A,A,A,A,B,C,C,C,C,C,D,B,B,B,F,F,F,F,B,B,B,D,D,C,C,C,C,B,A,A,A,A,A,A,H,H A,A,A,A,A,A,A,A,B,C,C,C,C,C,D,D,D,G,G,F,F,G,G,D,D,D,D,C,C,C,C,B,A,A,A,A,A,A,H,H A,A,A,A,A,A,A,I,B,D,C,C,C,C,C,C,C,G,G,F,F,G,G,C,C,C,C,C,C,C,D,B,I,A,A,A,A,A,A,A A,A,A,A,A,A,A,I,B,D,D,D,C,C,C,B,B,B,G,G,G,G,B,B,B,C,C,C,D,D,D,B,I,A,A,A,A,A,A,A A,A,A,A,A,H,A,I,I,B,D,D,D,D,D,C,C,C,B,D,D,B,C,C,C,C,D,D,D,B,B,I,I,A,A,A,A,A,A,A A,A,A,A,A,H,H,H,I,B,B,D,D,D,D,D,C,C,B,D,D,B,C,C,C,D,D,D,D,B,I,I,A,A,A,A,A,A,A,A A,A,H,H,H,A,A,A,I,I,I,B,B,B,D,B,B,B,B,B,B,B,B,B,B,D,B,B,B,I,I,I,A,A,A,A,A,A,H,A A,A,H,H,H,A,A,A,A,I,I,I,B,B,B,B,B,B,B,B,B,B,B,B,B,B,B,B,I,I,I,A,A,A,A,A,A,A,H,A H,H,A,H,H,A,A,A,A,A,A,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,I,A,A,A,A,A,A,A,A,A,A A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,I,I,I,I,I,I,I,I,I,A,A,A,A,A,A,A,A,A,A,A,H,A,A,A,A A,A,A,A,A,A,A,A,A,A,A,A,H,H,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,A,H,H,A,A,A,A \end{filecontents*} \def\pixlartcolorskoala{%french version :-p A=VertForet, B=Noir, C=GrisClair, D=GrisFonce, E=Beige, F=Blanc, G=BleuClair, H=VertClair, I=Marron } \end{codeblock} \pagebreak \begin{exampleM}{} \tikzset{pixlartcut/.style={semithick,blue}} \pixlarttikz% [unit=0.2,cut=8x8,text size=0.875]% {A,B,C,D,E,F,G,H,I,J}% {PAkoala.csv} \pixlarttikz% [unit=0.2,cut=8x8,correction]% {\pixlartcolorskoala}% {PAkoala.csv} \end{exampleM} \pagebreak \begin{exampleM}{} \tikzset{pixlartborder/.style={thin}} \pixlarttikzblock% [unit=0.75,cut=5+5,text size=0.9,font=\ttfamily]% {A,B,C,D,E,F,G,H,I,J}% {1/1}%first block {PAkoala.csv} \pixlarttikzblock% [unit=0.75,cut=5+5,correction]% {\pixlartcolorskoala}% {1/1}%first block, correction {PAkoala.csv} \pixlarttikzblock% [unit=0.75,cut=5+5,text size=0.9,font=\ttfamily]% {A,B,C,D,E,F,G,H,I,J}% {2/3}%intermediate block R2&C3 {PAkoala.csv} \pixlarttikzblock% [unit=0.75,cut=8x8,correction]% {\pixlartcolorskoala}% {2/3}%intermediate block R2&C3, correction {PAkoala.csv} \end{exampleM} \pagebreak \section{History} \texttt{0.1.9: first version of l3 package} \end{document}