summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.tex')
-rw-r--r--Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.tex58
1 files changed, 46 insertions, 12 deletions
diff --git a/Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.tex b/Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.tex
index 96d6411efbd..2c0631b7ed6 100644
--- a/Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.tex
+++ b/Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.tex
@@ -1,21 +1,22 @@
%#!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/26 v1.0}
+\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{convert} (ImageMagick) command.
+with \texttt{sips} (Darwin/macOS)/\texttt{magick} (ImageMagick) command.
\end{abstract}
\section{Motivation}
-\texttt{graphicx} package supports already many graphics image formats as bellow.
+\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
@@ -25,10 +26,13 @@ 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 the following image converters.
+with two image converters.
\begin{itemize}
-\item \texttt{sips}: pre-installed command in Darwin/macOS
-\item \texttt{convert}: bundled command in ImageMagick
+\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}
@@ -44,17 +48,37 @@ Load \textsf{graphicxpsd} package after loading \textsf{graphicx} package.
The list of available options is the following.
\begin{itemize}
-\item |dvipdfmx|, |xetex|, |pdftex|, |luatex|: supported driver options;
+\item |dvipdfmx|, |xetex|, |pdftex|, |luatex|:
+supported driver options;
You can also give specific driver option from global option.
-\item |sips| (default), |imagemagick|: supported converter
+\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 LuaTeX.
-
+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
@@ -65,9 +89,19 @@ Typeset the following {\LaTeX} document with LuaTeX.
\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}