summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/graphicxpsd/graphicxpsd.tex
blob: 96d6411efbd23eb0d7d88e9acb74c1b54a082419 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
%#!rm -f tigerpsdfmt4* && lualatex -shell-escape graphicxpsd
\documentclass[luatex]{article}
\usepackage{shortvrb}\MakeShortVerb{\|}
\usepackage{graphicx}
\usepackage{graphicxpsd}
\title{\textsf{graphicxpsd} Package}
\author{Munehiro Yamamoto}
\date{2018/01/26 v1.0}
\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.
\end{abstract}

\section{Motivation}
\texttt{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 the following image converters.
\begin{itemize}
\item \texttt{sips}: pre-installed command in Darwin/macOS
\item \texttt{convert}: bundled command in 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), |imagemagick|: supported converter
\end{itemize}

\section{Example}

Typeset the following {\LaTeX} document with LuaTeX.

\begin{quote}
\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.

\includegraphics{tigerpsdfmt.psd}

\end{document}