* 위키 패키지 목록: [패키지목록]
'''graphicx'''

LaTeX 문서에 다양한 종류의 그래픽 파일을 직접 포함시킬 수 있도록
해 주는 패키지이다. 
 * 예전의 epsfig, psfig 패키지의 \psfig 명령을 대신한다. 

[[TableOfContents]]

== 사용법 ==
=== 패키지 로드 ===

이 패키지를 사용하려면 preamble에서 패키지를 로드해야 한다.
{{{
\usepackage{graphicx}
}}}

이 패키지는 기본적으로 장치 의존적 그래픽(device-dependent graphics)을 
처리하기 위한 것이기 때문에 어떤 결과물을 만들 것이냐에 따라 적절한 패키지 선택사항을
사용해야 한다. 
 * pdfTeX을 pdf mode로 실행하는 경우 `[pdftex]` 옵션을 주는 것이 좋다. (생략해도 괜찮음)
 * dvi mode로 latex을 실행하는 경우, dvi 드라이버를 지정한다. 예: {{{
\usepackage[dvips]{graphicx}
}}}
 * xelatex, lualatex에서는 드라이버 옵션을 생략한다.

=== `\includegraphics` 명령 ===

외부 그래픽 파일 LaTeX 문서에 넣으려면 본문에서 원하는 위치에서 `\includegraphics` 명령을 사용한다. 예를들어, `file.pdf`라는 파일을 
집어넣고 싶으면:
{{{#!vim tex
\includegraphics{file.pdf}
}}}

이 명령도 옵션을 통해 그림의 크기, 회전, 잘라내기 등 여러가지 설정을 
할 수 있다. 아무 옵션도 없이 명령을 사용하면 원래 크기 그대로 온전히
나타난다. 그림 파일의 확장자를 지정하지 않으면 jpg, png, pdf 중에서 존재하는 것을 골라서 
읽어들이며 EPS 파일은 PDF로 변환하여 읽어들인다.

=== `\includegraphics` 명령의 옵션 ===

 * `bb` (Bounding Bbox) : 공백으로 분리된 4개의 숫자를 지정.
 * `bblx,bblly,bburx,bbury` : bounding box의 각 값을 개별적으로 지정
 * `natwidth,natheight` : bounding box의 다른 방법. natheight=h,natwidth=w 라고 지정하면 bb = 0 0 h w 와 같은 의미
 * `hiresbb` : true 또는 false. 
 * `viewport` : 숫자 4개. 
 * `trim` : 숫자 4개. 잘라낼 길이를 지정. trim = 1 2 3 4 이면 왼쪽에서 1bp, 아래쪽에서 2bp, 오른쪽에서 3bp, 위에서 4bp 잘라냄. 
 * `angle` : 회전각
 * `origin` : 회전의 중심
 * `width` : 폭
 * `height` : 높이
 * `totalheight` : 전체 높이 (height + depth)
 * `keepaspectratio`: 가로세로 비율 유지
 * `scale` : 확대/축소. scale=.5 이면 50%로 축소. 
 * `clip` : true 또는 false. 
 * `draft` : treu 또는 false.
 * `type` : 그래픽 타입을 지정.
 * `ext` : 파일 확장자 지정.
 * `read` : 파일 확장자 지정. type과 함께 사용해야 함.
 * `command` : 파일에 적용할 명령. type 과 함께 사용해야 함.

예:
{{{#!vim tex
\includegraphics[scale=.5,angle=-60]{file.eps}
}}}

=== `figure` 환경에 넣기 ===

그냥 `\includegraphics`로만 그림을 넣어주면 명령을 쓴 자리에 
들어간다. 이 그림을 위치도 조절하고 캡션도 달고 레이블도 달고 하려면 
`figure` 환경에 넣어주면 된다.
{{{#!vim tex
\begin{figure}[ht]
  \includegraphics{file.eps}
  \caption{여기에 그림 설명}
  \label{fig2}
\end{figure}
}}}

`figure` 환경 등과 관련해서는 [떠다니는개체],
캡션에 대해서는 [CaptionOfFloats], label과 관련해서는
[상호참조] 페이지에서 상세한 정보를 얻을 수 있다.

== 그림 포맷 ==
=== JPG, PNG, PDF ===
 * 이 세 형식의 그림은 (dvips 드라이버를 제외하고) 보편적으로 인식한다.
 * pdfTeX은 이밖에 JBIG2 포맷도 처리한다.
=== EPS ===
 * `[dvips]` 옵션이 주어지면 사용할 수 있는 그림은 EPS뿐이다.
 * pdfTeX, XeTeX, LuaTeX 엔진의 경우, eps 그림은 repstopdf라는 유틸리티를 통하여 자동으로 pdf로 변환되어 처리된다.
=== 기타 포맷의 그림 ===
 * bmp, tiff 등 기타 포맷의 그림은 미리 png로 변환해두는 것이 가장 좋은 방법이다.
 * 즉시 변환(on the fly) 해결책은 `--shell-escape` 옵션이 필요하고 다음과 같은 것이 있다.
    * epstopdf 패키지를 이용하는 방법 {{{
\usepackage{epstopdf}
\\epstopdfDeclareGraphicsRule{.gif}{png}{.png}{ convert #1 \OutputFile }
\AppendGraphicsExtensions{.gif}
}}}
    * converter를 지정하는 방법 (Windows에서는 안 됨) {{{
\DeclareGraphicsRule{.gif}{png}{.png}{`convert #1 `basename #1 .gif`-gif-converted-to.png}
}}}

== 그림 파일의 폴더 ==
{{{
\graphicspath{{path1}{path2}}
}}}

== 그림 파일의 이름 ==
 * 원칙적으로 그림 파일은 공백없는 아스키 문자만으로 이루어진 것이 문제를 일으키지 않는다.
 * 공백이 있거나 확장자 이외의 온점(.)을 포함한 복잡한 그림 이름의 경우 grffile 패키지를 이용할 수 있다.
 * 한글이 포함된 그림 이름의 경우, Windows에서는 '''사용할 수 없다'''. 

== 참고 자료 ==
 * 이호재 (2010) [http://wiki.ktug.org/wiki/wiki.php/LaTeXWorkshop/2010?action=download&value=AtoZonFigure.pdf 그림 포함하기의 (거의) 모든 것] 외부 그림 포함하기
 * Carlisle (2005) [http://texdoc.net/texmf-dist/doc/latex/graphics/grfguide.pdf Packages in the `graphics' bundle]
 * Carlisle & Rahtz (1999) [http://texdoc.net/texmf-dist/doc/latex/graphics/graphicx.pdf The graphicx package]