From 999a277e66606bd3a0ec8b526f96bd899f960699 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 30 Jan 2018 00:03:23 +0000 Subject: graphicxpsd (29jan18) git-svn-id: svn://tug.org/texlive/trunk@46477 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/graphicxpsd/README.md | 13 +++-- .../doc/latex/graphicxpsd/graphicxpsd.pdf | Bin 153318 -> 168655 bytes .../doc/latex/graphicxpsd/graphicxpsd.tex | 58 ++++++++++++++++----- .../doc/latex/graphicxpsd/test-gin-rule-psd.tex | 9 +++- 4 files changed, 61 insertions(+), 19 deletions(-) (limited to 'Master/texmf-dist/doc/latex/graphicxpsd') diff --git a/Master/texmf-dist/doc/latex/graphicxpsd/README.md b/Master/texmf-dist/doc/latex/graphicxpsd/README.md index e20f4df7158..26b3e45104d 100644 --- a/Master/texmf-dist/doc/latex/graphicxpsd/README.md +++ b/Master/texmf-dist/doc/latex/graphicxpsd/README.md @@ -1,21 +1,24 @@ -`graphicxpsd` Package -========== -Adobe Photoshop Data format (PSD) support for graphicx package +# graphicxpsd Package + +LaTeX: Adobe Photoshop Data format (PSD) support for graphicx package via PSD-to-PDF conversion This package provides Adobe Photoshop Data format (PSD) support for graphicx package -with sips (Darwin/macOS)/convert (ImageMagick) command. +with `sips` (Darwin/macOS)/`magick` (ImageMagick) command. * Major drivers support: `dvipdfmx`, `xetex`, `pdftex`, `luatex` + ## Requirements * recent [TeX Live](https://www.tug.org/texlive/) environment (TeX Live 2012 or higher release version) * Mac OS X or [ImageMagick](https://www.imagemagick.org/) + ## Installation -Copy: `graphicxpsd.sty` -> `$TEXMF/tex/platex/graphicxpsd/` +Copy: `graphicxpsd.sty` -> `$TEXMF/tex/latex/graphicxpsd/` + ## License diff --git a/Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.pdf b/Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.pdf index 47d371390ca..de0ecdc579d 100644 Binary files a/Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.pdf and b/Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.pdf differ 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} diff --git a/Master/texmf-dist/doc/latex/graphicxpsd/test-gin-rule-psd.tex b/Master/texmf-dist/doc/latex/graphicxpsd/test-gin-rule-psd.tex index 39f4e658bf0..6c45eb617f4 100644 --- a/Master/texmf-dist/doc/latex/graphicxpsd/test-gin-rule-psd.tex +++ b/Master/texmf-dist/doc/latex/graphicxpsd/test-gin-rule-psd.tex @@ -2,13 +2,18 @@ % #!rm -f tigerpsdfmt4* && xelatex -shell-escape test-gin-rule-psd % #!rm -f tigerpsdfmt4* && pdflatex -shell-escape test-gin-rule-psd %#!rm -f tigerpsdfmt4* && lualatex -shell-escape test-gin-rule-psd -\documentclass[luatex]{article}%%set as a global option +\documentclass[luatex]{article}%%set driver as global option \usepackage{graphicx} \usepackage[% - imagemagick,%default: sips + magick,%imagemagick,%%same as the one; %%default: sips + % convert,%% old ImageMagick ]{graphicxpsd} \listfiles \begin{document} +\makeatletter +PSD-to-PDF: \@gfxpsd@psdtopdf +\makeatother + %% $ file tigerpsdfmt.psd %% tigerpsdfmt.psd: Adobe Photoshop Image, 550 x 568, RGBA, 4x 8-bit channels \includegraphics{tigerpsdfmt.psd} -- cgit v1.2.3