summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/graphicxpsd/graphicxpsd.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/graphicxpsd/graphicxpsd.tex
Initial commit
Diffstat (limited to 'macros/latex/contrib/graphicxpsd/graphicxpsd.tex')
-rw-r--r--macros/latex/contrib/graphicxpsd/graphicxpsd.tex107
1 files changed, 107 insertions, 0 deletions
diff --git a/macros/latex/contrib/graphicxpsd/graphicxpsd.tex b/macros/latex/contrib/graphicxpsd/graphicxpsd.tex
new file mode 100644
index 0000000000..2c0631b7ed
--- /dev/null
+++ b/macros/latex/contrib/graphicxpsd/graphicxpsd.tex
@@ -0,0 +1,107 @@
+%#!rm -f tigerpsdfmt4* && lualatex -shell-escape graphicxpsd
+\documentclass[luatex]{article}
+\usepackage{shortvrb}\MakeShortVerb{\|}
+\usepackage{hyperref}
+\usepackage{graphicx}
+\usepackage{graphicxpsd}
+\title{\textsf{graphicxpsd} Package}
+\author{Munehiro Yamamoto}
+\date{2018/01/30 v1.1}
+\begin{document}
+\maketitle
+\begin{abstract}
+This package provides Adobe Photoshop Data format (PSD) support
+for \textsf{graphicx} package
+with \texttt{sips} (Darwin/macOS)/\texttt{magick} (ImageMagick) command.
+\end{abstract}
+
+\section{Motivation}
+\textsf{graphicx} package supports already many graphics image formats as bellow.
+\begin{itemize}
+\item non-vector formats: jpg, png, bmp, and so on
+\item PostScript-style formats: eps, ps
+\item PDF-style formats: pdf, ai
+\end{itemize}
+However, it currently does not support Adobe Photoshop Data format (PSD).
+
+Against that, we developed the \textsf{graphicxpsd} package
+to support PSD format via PSD-to-PDF conversion
+with two image converters.
+\begin{itemize}
+\item \texttt{sips}:
+pre-installed command in Darwin/macOS
+
+\item \texttt{magick}:
+bundled command in \href{https://www.imagemagick.org/}{ImageMagick}
+\end{itemize}
+
+\section{Loading \textsf{graphicxpsd} Package}
+
+Load \textsf{graphicxpsd} package after loading \textsf{graphicx} package.
+
+\begin{quote}
+\begin{verbatim}
+\usepackage{graphicx}
+\usepackage[<options>]{graphicxpsd}
+\end{verbatim}
+\end{quote}
+
+The list of available options is the following.
+\begin{itemize}
+\item |dvipdfmx|, |xetex|, |pdftex|, |luatex|:
+supported driver options;
+You can also give specific driver option from global option.
+
+\item |sips| (default), |magick| (same as |imagemagick|), |convert|\footnotemark:
+supported image converters;
+\begin{itemize}
+\item
+Darwin/macOS users do not have to do anything
+unless you choose ImageMagick as PSD-to-PDF converter.
+\item
+If you use ImageMagick~7, you may choose |magick|.
+\item
+If you should use ImageMagick~6 or lower version, you just choose |convert|.
+\end{itemize}
+\end{itemize}
+\footnotetext{When ImageMagick project had released ImageMagick~7,
+they changed \texttt{convert} to \texttt{magick}
+because that might be the usual problem with the conflict of names
+between the ImageMagick's \texttt{convert.exe} and
+the Windows ``\texttt{convert.exe}'' program,
+which complains about invalid parameters, and
+changing the Imagemagick program's name to imconvert and
+using that instead avoided the conflict.}
+
+\section{Example}
+
+Typeset the following {\LaTeX} document with Lua{\TeX} enabling the shell escape,
+that is, run |lualatex -shell-escape|.
+\begin{quote}
+\small
+\begin{verbatim}
+%#!lualatex -shell-escape
+\documentclass[luatex]{article}%%set luatex driver as global option
+\usepackage{graphicx}
+\usepackage{graphicxpsd}
+\begin{document}
+\includegraphics{tigerpsdfmt.psd}
+\end{document}
+\end{verbatim}
+\end{quote}
+Then, the result is as below.
+\begin{center}
+\includegraphics{tigerpsdfmt.psd}
+\end{center}
+Incidentally, the above \texttt{tigerpsdfmt.psd} file is converted from
+the \texttt{tiger.eps} file (a.k.a.~``cubic spline tiger''),
+which comes with Ghostscript.
+\begin{quote}
+\small
+\begin{verbatim}
+$ file tigerpsdfmt.psd
+tigerpsdfmt.psd: Adobe Photoshop Image, 550 x 568, RGBA, 4x 8-bit channels
+\end{verbatim}
+\end{quote}
+
+\end{document}