--- name: "ltximg" section: "1" platform: "linux" package: "texlive-doc" version: "2026.1-1" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/ltximg" --- # ltximg(1) LaTeX environments to image and standalone files ## NAME ltximg - LaTeX environments to image and standalone files ## SYNOPSIS **ltximg** \[\<*options*\>\] \[--\] \<*filename*\>.\<*tex*\|*ltx*\> ## DESCRIPTION **ltximg** automates the process of extracting and converting environments from LaTeX file to image formats and *standalone* files using *ghostscript* and *poppler-utils*. Generates a one file with only extracted environments and other with all extracted environments converted to `"\includegraphics"`. By default the extracted environments are: **preview** **pspicture** **tikzpicture** **pgfpicture** **psgraph** **postscript** **PSTexample** ## OPTIONS Options that accept a value require either a blank space or `"="` between the option and the value. Multiple short options can be bundling and if the last option takes a comma separated list you need `"--"` at the end. Relative or absolute paths for directories and files is not supported. If used without \[\<*options*\>\] the extracted environments are converted to *pdf* image format and saved in `"./images"` directory using `"pdflatex"` and *preview* package for process. General script options: - **-h**, **--help** Display command line help and exit. - **-v**, **--version** Display current version and exit. - **-V**, **--verbose** Verbose printing information. - **-l**, **--log** Write `".log"` file with debug information. - **-t**, **--tif** Create `".tif"` files using *ghostscript*. - **-b**, **--bmp** Create `".bmp"` files using *ghostscript*. - **-j**, **--jpg** Create `".jpg"` files using *ghostscript*. - **-p**, **--png** Create `".png"` files using *ghostscript*. - **-e**, **--eps** Create `".eps"` files using *pdftops*. - **-s**, **--svg** Create `".svg"` files using *pdftocairo*. - **-P**, **--ppm** Create `".ppm"` files using *pdftoppm*. - **-g**, **--gray** Gray scale for images using *ghostscript*. - **-f**, **--force** Capture `"\psset"` and `"\tikzset"` to extract. - **-n**, **--noprew** Create images files without *preview* package. - **-r** *integer*, **--runs**=*integer* Set the number of times the compiler will run on the *input* file for environment extraction (default: 1). - **-d** *integer*, **--dpi**=*integer* Dots per inch resolution for images (default: 150). - **-m** *integer*, **--margins**=*integer* Set margins in bp for *pdfcrop* (default: 0). - **-o** *filename*, **--output**=*filename* Create *output* file. - **--imgdir**=*dirname* Set name of directory to save images and files (default: images). - **--prefix**=*string* Set *prefix* append to each generated files (default: fig). - **--myverb**=*macroname* Add `"\macroname"` to verbatim inline search (default: myverb). - **--clean**=*doc*\|*pst*\|*tkz*\|*all*\|*off* Removes specific block text in *output* file (default: doc). - **--zip** Compress files generated in `".zip"` format. - **--tar** Compress files generated in `".tar.gz"` format. - **--srcenv** Create files with only code of environments. - **--subenv** Create standalone files for environments. - **--shell** Enable `"\write18{SHELL COMMAND}"`. - **--latex** Using `"latex>dvips>ps2pdf"` for compiler *input* and `"pdflatex"` for compiler *output*. - **--dvips** Using `"latex>dvips>ps2pdf"` for compiler *input* and `"latex>dvips>ps2pdf"` for compiler *output*. - **--dvilua** Using `"dvilualatex>dvips>ps2pdf"` for compiler *input* and `"lualatex"` for compiler *output*. - **--dvipdf** Using `"latex>dvipdfmx"` for compiler *input* and `"latex>dvipdfmx"` for compiler *output*. - **--xetex** Using `"xelatex"` for compiler *input* and *output*. - **--luatex** Using `"lualatex"` for compiler *input* and *output*. - **--arara** Use `"arara"` for compiler *input* and *output*. - **--latexmk** Using `"latexmk"` for compiler *output* file. - **--norun** Run script, but no create images files. - **--nopdf** Don't create a `".pdf"` image files. - **--nocrop** Don't run *pdfcrop*. - **--extrenv**=*env1,env2,...* Add new environments to extract. - **--skipenv**=*env1,env2,...* Skip some default environments to extract. - **--verbenv**=*env1,env2,...* Add new verbatim environments. - **--writenv**=*env1,env2,...* Add new verbatim write environments. - **--deltenv**=*env1,env2,...* Delete environments in *output* file. ## EXAMPLE **ltximg** --latex -e -p --subenv -o test-out.ltx test-in.ltx Create a `"./images"` directory (if it doesn't exist) with all extracted environments converted to `".pdf"`, `".eps"`, `".png"` and *standalone* files, a file *test-in-fig-all.ltx* with all extracted environments and the file *test-out.ltx* with all environments converted to `"\includegraphics"` using `"latex>dvips>ps2pdf"` and *preview* package for *test-in.ltx* and `"pdflatex"` for *test-out.ltx*. ## DOCUMENTATION For full documentation use: texdoc **ltximg** ## ISSUES AND REPORTS **Repository** : \ **Bug tracker**: \ ## AUTHOR Pablo González Luengo, *pablgonz@yahoo.com*. ## COPYRIGHT AND LICENSE Copyright 2013-2021 Pablo González, *pablgonz@yahoo.com*. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. ## SEE ALSO [**gs**(1)](/gs/1.md), [**dvips**(1)](/dvips/1.md), [**ps2pdf**(1)](/ps2pdf/1.md), [**pdfcrop**(1)](/pdfcrop/1.md), [**pdftops**(1)](/pdftops/1.md), [**pdftocairo**(1)](/pdftocairo/1.md), [**pdftoppm**(1)](/pdftoppm/1.md)