> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/ja/sononotopikku/28-inserting-images-es.md). # 画像の挿入 es 画像は、ほとんどの科学文書において不可欠な要素です。LaTeX には、画像を扱い、必要どおりに表示させるためのさまざまな方法があります。この記事では、一般的な形式で画像を挿入する方法、画像を小さくしたり大きくしたりする方法、そして文書内で画像への参照を追加する方法を説明します。 ## はじめに 以下は、LaTeX で画像を取り込む例です。 ```latex \documentclass{article} \usepackage{graphicx} \graphicspath{ {images/} } \begin{document} 宇宙は広大で、 大規模に、私たちが見渡すあらゆる場所で。 \includegraphics{universe} 上に銀河の画像があります \end{document} ``` ![InsertingImagesEx1.png](/files/0c8d70d3477d0438746f31bb765196a004d561c3) LaTeX には画像を自力で操作する機能がないため、パッケージを読み込む必要があります **graphicx**。このパッケージを使うには、文書のプリアンブルに次の行を追加してください ```latex \usepackage{graphicx} ``` コマンド `\graphicspath{ {images/} }` は、画像がという名前のフォルダに保存されていることを LaTeX に示します *images* 現在のディレクトリの下にあります。 コマンド `\includegraphics{universe}` は、文書に画像を挿入する役割を担います。ここで、 *universe* は拡張子を除いた画像ファイル名です。したがって *universe.PNG* は次のようになります *universe*。画像ファイル名には空白文字や複数の句読点を含めてはいけません。 注： *ファイル拡張子を指定することもできますが、推奨されるのは* 省略することです。拡張子を省略すると、LaTeX は対応しているすべての形式を検索します。詳細は次の節を参照してください [高解像度画像と低解像度画像の生成](#generando-imgenes-en-alta-y-baja-resolucin). [Overleaf で例を開く](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## 画像フォルダへのパス 複数の画像を含む文書を作成するとき、プロジェクトを整理しておく方法の一つは、それらを別のフォルダに保存することです。 導入の例では、これは次のコマンドによって実現されます `\graphicspath{ {images/} }` これは、LaTeX に対して画像をフォルダ内で探すよう指示します *images*。パスは *相対的な* 現在の作業ディレクトリに対してです。 フォルダへのパスは ***相対的な*** （推奨）メインの .tex ファイルと同じディレクトリ、またはそのサブフォルダのいずれかにフォルダがある場合、または ***絶対的な*** 正確なパスを指定する必要がある場合です。たとえば: ```latex %Windows 形式の絶対パス: \graphicspath{ {c:/user/images/} } %Unix 系形式（Linux、OS X）の絶対パス \graphicspath{ {/home/user/images/} } ``` このコマンドでは末尾にスラッシュが必要であることに注意してください `/` また、パスは二重の波括弧で囲む必要があります。 整理のために画像を複数のフォルダに保存している場合は、複数のパスを指定することもできます。たとえば、2つのフォルダがあり、1つが *images1* で、もう一方が *images2*、次のコマンドを使います ```latex \graphicspath{ {images1/}{images2/} } ``` パスを指定しない場合、LaTeX は .tex ファイルが保存されている現在のフォルダで画像を検索します。 [Overleaf で例を開く](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## 画像のサイズ変更と回転 LaTeX で画像を取り込む際に、幅、高さ、位置などを変更するための追加パラメータを指定したい場合は、次の構文で可能です: ```latex Overleaf は、オンラインで編集するための優れたプロ向けツールで、 LaTeX プロジェクトを共有し、バックアップできます。さらに、 かなり充実したヘルプドキュメントも提供しています。 \includegraphics[scale=1.5]{lion-logo} ``` ![InsertingImagesEx2.png](/files/2bb383b5c99d884f0c5380ae4181f68abe07fa0f) コマンド `\includegraphics[scale=1.5]{lion-logo}` 画像を文書に挿入します *lion-logo* 文書に挿入し、追加パラメータ `scale=1.5` で画像は元のサイズの 1.5 倍に拡大されます。 画像を指定した高さと幅にリサイズすることもできます。 ```latex Overleaf は、オンラインで編集するための優れたプロ向けツールで、 LaTeX プロジェクトを共有し、バックアップできます。さらに、 かなり充実したヘルプドキュメントも提供しています。 \includegraphics[width=3cm, height=4cm]{lion-logo} ``` ![InsertingImagesEx3.png](/files/c3b03db57229c3ac796106a78fa9a2bc54b01084) おそらくもうお分かりのとおり、角括弧内のパラメータ `[width=3cm, height=4cm]` は画像の幅と高さを定義します。これらのパラメータにはさまざまな単位 [異なる単位](#gua-de-referencia) を使えます。これらのパラメータでは測定単位を使用できます。もし値だけを指定した場合 *width*、 画像の長さを文書内の他の要素に対する相対値で指定することもできます。たとえば、画像の幅を本文と同じにしたい場合: ```latex Overleaf は、オンラインで編集するための優れたプロ向けツールで、 LaTeX プロジェクトを共有し、バックアップできます。さらに、 かなり充実したヘルプドキュメントも提供しています。 \includegraphics[width=\textwidth]{universe} ``` ![InsertingImagesEx5.png](/files/24a478f5ce8aa55a2e41a34c3fd3af6a72518410) 〜の代わりに `\textwidth` LaTeX に標準で含まれている他の単位を使うこともできます: *\columnsep, \linewidth, \textheight, \paperheight, etc*。次を参照してください [リファレンスガイドを参照してください](#gua-de-referencia) 単位のより詳しい説明については 文書に画像を含める際の非常に一般的な別の選択肢として、回転させることがあります。これは LaTeX ではとても簡単です: ```latex Overleaf は、オンラインで編集するための優れたプロ向けツールで、 LaTeX プロジェクトを共有し、バックアップできます。さらに、 かなり充実したヘルプドキュメントも提供しています。 \includegraphics[scale=1.2, angle=45]{lion-logo} ``` ![InsertingImagesEx4.png](/files/36aeb581f6c32636c5519255dd52a0868a6c5b32) パラメータ `angle=45` は、画像を反時計回りに 45 度回転させます。時計回りに回転させるには負の数を使います。 [Overleaf で例を開く](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## 画像の配置 前の節では文書に画像を挿入する方法を説明しましたが、画像とテキストの組み合わせが期待どおりにならないことがあります。これを変えるには、新しい環境を使う必要があります: ```latex 次の例では、図は この文のすぐ下に配置されます。 \begin{figure}[h] \includegraphics[width=8cm]{Plot} \end{figure} ``` ![InsertingImagesEx6.png](/files/301871a9fad6975e8e0046dcc5b68591fa02409b) 環境 `figure` は、文書内で画像をフローティング要素として表示するために使います。つまり、画像をこの環境の中に入れるだけでよく *figure* 、どこに現れるかを気にする必要はなくなります。LaTeX が文書の流れにぴったり合うように配置してくれます。 原則としてこれはとても便利ですが、画像がどこに現れるかをより細かく制御したいこともあります。図の位置を指定するために追加パラメータを使えます。例では、 `begin{figure}[h]`、角括弧内のパラメータが図の位置を指定します *こちら* （ここでは英語）。以下に、指定可能な位置の値の一覧表を示します。 | パラメータ | 位置 | | ----- | ------------------------------------------------------------------------------- | | h | フローティング要素を「ここ」に配置します。つまり、コード内に現れる位置とほぼ同じ場所です（ただし、配置は必ずしも正確ではありません）。 | | t | 図をページの先頭に挿入します。 | | b | 図をページの末尾に挿入します。 | | p | フローティング要素を、図だけを含む別ページに挿入します。 | | ! | LaTeX が画像の「良い」位置を決めるために使うパラメータを上書きします。 | | H | フローティング要素をコード内に現れるのとまったく同じ場所に配置します。パッケージを読み込む必要があります `float`。これはある程度 h! に相当します。 | 次の例では、画像を生成するコードは文書の末尾にあるにもかかわらず、文書の先頭に画像が表示されることがわかります。 ```latex この図では、次のことを示す棒グラフが見えます いくつかの重要な データを、時間の経過とともに調査したアンケートの結果です。 \begin{figure}[t] \includegraphics[width=8cm]{Plot} \centering \end{figure} ``` ![InsertingImagesEx7.png](/files/ae5a48a366000113ccf7f7a8fc1db2b74ce95c1e) 追加のコマンド `\centering` が画像を中央揃えにします。既定の配置は左寄せです。 図の周りにテキストを回り込ませることもできます。文書に小さな画像が含まれているとき、これにより本文の見た目が良くなります。 ```latex \begin{wrapfigure}{r}{0.25\textwidth} %この図は右側に配置されます \centering \includegraphics[width=0.25\textwidth]{mesh} \end{wrapfigure} 2変数関数を描画する方法はいくつかあります, どの情報に注目したいかによって異なります。たとえば、 関数のメッシュを見て 微分がより見やすくなるようにしたいなら、次のようなプロットを使えます 左のものです。 \begin{wrapfigure}{l}{0.25\textwidth} \centering \includegraphics[width=0.25\textwidth]{contour} \end{wrapfigure} 一方で、もし興味があるのが 特定の値だけであれば、等高線プロットを使えます。 等高線プロットを使えます、等高線 プロットを使えます、等高線プロットを使えます、 等高線プロットを使えます、等高線プロットを使えます、 左のもののような等高線プロットを使えます。 一方で、もし興味があるのが 特定の値だけであれば、等高線プロットを使えます。 等高線プロットを使えます、等高線 プロットを使えます、等高線プロットを使えます、 等高線プロットを使えます、等高線プロットを使えます、 等高線プロットを使えます、 左のもののように。 ``` ![InsertingImagesEx8.png](/files/b118c1f1f07cfd868d07f24eed36997f59aa2d19) 例のコマンドが動作するには、パッケージを読み込む必要があります **wrapfig**。プリアンブルに次の行を追加してください ```latex \usepackage{wrapfig} ``` パッケージを読み込んだら、環境を使えます *wrapfigure* 次のコマンドで `\begin{wrapfigure}{l}{0.25\textwidth} \end{wrapfigure}`。この環境には、波括弧内に 2 つの追加パラメータがあることに注意してください。以下でコードを詳しく説明します。 **{l}** 図の配置を設定します。左には l、右には r を使います。さらに、book クラスなどを使っている場合は、l と r の代わりに、ページの外側の端には o、内側の端には i を使えます。 **{0.25\textwidth}** これは画像を含むボックスの幅を設定します。画像そのものの幅ではなく、それは includegraphics コマンドで設定する必要があります。例では相対単位を使っていますが、通常の単位（cm、mm、in など）も使えます。可能な単位の一覧はリファレンスガイドを参照してください。 **\centering** 前に説明したとおりですが、前の例では、画像はページ全体に対してではなく、画像を含むボックスに対して中央揃えされます。 画像配置についてより詳しい情報は、記事を参照してください [画像と表の配置](/latex/ja/to/02-positioning-images-and-tables.md) [Overleaf で例を開く](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## ラベル、キャプション、参照の追加 画像の簡単な説明を含むキャプションや、後で画像を参照するために使えるラベルを追加できるのは、非常に長い文書を扱うときにとても便利です。 ### キャプション キャプションを追加する例から始めましょう: ```latex \begin{figure}[h] \caption{パラメトリックプロットの例 ($\sin (x), \cos(x), x$)} \centering \includegraphics[width=0.5\textwidth]{spiral} \end{figure} ``` ![InsertingImagesEx9.png](/files/20494d30fa4f6f21867e0e186db34c5180773e7e) とても簡単です。コマンドを追加するだけです `\caption{キャプションの例}` そして波括弧内に表示したいテキストを書きます。キャプションがどこに印字されるかは、そのコマンドをどこに挿入するかによります。もしコマンドの上に置けば *includegraphics* キャプションは画像の上に表示され、そのコマンドの下に置けば図の下部に表示されます。 キャプションを図の横に配置することもできます。パッケージ **sidecap** を使うと、前の例と非常によく似たコードでテキストを追加できます。 ```latex \documentclass{article} \usepackage[rightcaption]{sidecap} \usepackage{graphicx} %画像を管理するためのパッケージ \graphicspath{ {images/} } \begin{SCfigure}[0.5][h] \caption{パラメトリックプロットの例。 このキャプションは右側に表示されます} \includegraphics[width=0.6\textwidth]{spiral} \end{SCfigure} ``` ![InsertingImagesEx10.png](/files/8b6d557e7a9aa07e442f893537ed4b655187c363) この例には新しいコマンドが 2 つあります: **\usepackage\[rightcaption]{sidecap}** おそらくもうご存じのとおり、このコマンドは sidecap というパッケージを読み込みますが、追加のパラメータとして rightcaption があります。このパラメータが、キャプションをどこに印字するかを決めます。この場合は画像の右側ですが、leftcaption を使ってキャプションを左側に移動することもできます。book 系のクラスを使う文書では、さらに outercaption と innercaption を使って、ページ端に対する外側または内側にキャプションを印字することもできます。 **\begin{SCfigure}\[0.5]\[h] \end{SCfigure}** figure に似た環境を定義します。最初のパラメータは、画像サイズに対するキャプションの幅です。2つ目のパラメータ h は figure 環境と同じ役割を持ちます。詳細は画像配置の節を参照してください。 必要であれば、キャプション形式のより高度な扱いも可能です。次を参照してください [追加資料](#lecturas-adicionales) より多くの参考文献を確認してください ### ラベルと相互参照 図は、LaTeX 文書中の他の多くの要素（数式、表、グラフなど）と同様に、本文中から参照できます。これはとても簡単です。環境 *figure* または *SCfigure*、そのラベルを使って図を参照します。 ```latex \begin{figure}[h] \centering \includegraphics[width=0.25\textwidth]{mesh} \caption{きれいなプロット} \label{fig:mesh1} \end{figure} 図 \ref{fig:mesh1} でわかるように、 関数は 0 付近で増加します。また、\pageref{fig:mesh1} のページでは 同じ例です。 ``` ![InsertingImagesEx11.png](/files/13af469e58c91046e4e5ca3834700ce2074d971c) この例には相互参照を生成するコマンドが 3 つあります。 **\label{fig:mesh1}** 図のラベルを設定します。ラベルは文書内のさまざまな種類の要素に使えるため、例の fig: のように接頭辞を付けるのがよい習慣です。 **\ref{fig:mesh1}** このコマンドは図に割り当てられた番号を出力します。番号は自動的に生成され、後で参照対象の前に図が挿入された場合には更新されます。 **\pageref{fig:mesh1}** ラベルで参照された画像が現れるページ番号を出力します。 コマンド `\caption` によるキャプションの追加は、ラベルを追加して図を参照するために必須です。 LaTeX のもう一つの重要な機能は、次を自動生成できることです *図一覧*。これは次で簡単に実現できます: ```latex \listoffigures ``` ![InsertingImagesEx12.png](/files/fffbd12d9931aba2a6c3032bd9c94fdd191dcb78) このコマンドはキャプションのある図でのみ機能します。図一覧の生成にキャプションを使うためです。前の例では、この記事で使われている画像が一覧表示されています。 重要な注意: *LaTeX で相互参照を使う場合、プロジェクトは 2 回コンパイルする必要があります。そうしないと、参照、ページ参照、および図一覧が機能しません*. [Overleaf で例を開く](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## 高解像度画像と低解像度画像の生成 現時点では、コマンドで画像ファイル名を指定する場合は *\includegraphics* ファイル拡張子を省略しています。しかし、それは必須ではなく、とても便利なことがあります。拡張子を省略すると、LaTeX はあらかじめ設定された画像ディレクトリ内で対応する画像形式を検索します。検索はある順序で行われ、その順序は変更できます。 これは、文書の下書き版から最終版へ移行するときにとても役立ちます。下書き（記事、書籍、レポートなどを書いている途中）では、文書をより速くコンパイルできるように、低解像度の画像（通常は .png 形式）を使えると望ましいです。これに対して最終版では、品質の高い文書にするために高解像度の画像を含めることが望まれます。 これは次の方法で実現できます: * コマンドでファイル拡張子を指定しない *\includegraphics*、そして * プリアンブルで拡張子の順序を指定する したがって、同じ画像に 2 つの版がある場合、たとえば venndiagram.pdf（高解像度）と venndiagram.png（低解像度）です。文書を作成・デバッグしている間は、次の行をプリアンブルに追加できます - ```latex \DeclareGraphicsExtensions{.png,.pdf} ``` 上のコマンドにより、同じ名前で拡張子の異なる 2 つの画像が見つかった場合は .png ファイルが使われ、何らかの理由でこのファイルがなくなった場合は pdf 版が次の候補になります。 文書を書き終えたら、高解像度版だけを使うために、拡張子を指定する行を次のように変更します: ```latex \DeclareGraphicsExtensions{.pdf,.png} ``` さらに、上で説明した技法を改良することもできます。PDF が事前に PNG に変換されていない場合は、文書をコンパイルしている間に LaTeX に低解像度の .png 画像を生成させることができます。これを実現するには、プリアンブルの次の後に以下を含めます `\usepackage{graphicx}`. ```latex \usepackage{epstopdf} \epstopdfDeclareGraphicsRule{.pdf}{png}{.png}{convert #1 \OutputFile} \DeclareGraphicsExtensions{.png,.pdf} ``` venndiagram2.pdf は存在するが venndiagram2.png が存在しない場合、vendiagramm2-pdf-converted-to.png ファイルが作成され、代わりに読み込まれます。コマンド *convert #1* が変換を担当します この方法を選ぶ場合、覚えておくべきことがいくつかあります: * 自動変換を機能させるには、次を実行する必要があります *pdflatex* オプション付きで `--shell-escape`. * 最終版では、次の行をコメントアウトすることを忘れないでください `\epstopdfDeclareGraphicsRule`。こうすることで、高解像度画像だけが読み込まれます。優先順位の順序を変更することも忘れないでください。 [Overleaf で例を開く](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## リファレンスガイド **LaTeX における単位と計測** | 略語 | 定義 | | ------------ | -------------------------- | | pt | ポイント。長さの既定単位です。約 0.3515 mm | | mm | 1 ミリメートル | | cm | 1 センチメートル | | を | 1 インチ | | ex | 〜の高さ **x** 現在のフォントでの | | em | 〜の幅 **m** 現在のフォントでの | | \columnsep | 列間 | | \columnwidth | 列の幅 | | \linewidth | 現在の環境での行幅 | | \paperwidth | 用紙の幅 | | \paperheight | 用紙の高さ | | \textwidth | 本文の幅 | | \textheight | 本文の高さ | | \unitlength | 環境内の長さ単位 *picture* | **LaTeX で使える画像の種類について** **latex** latex コマンドで文書をコンパイルすると、ベクター形式である EPS 形式の画像しか使えません。 **pdflatex** PDF を生成するために pdflatex コマンドで文書をコンパイルする場合は、いくつかの種類の画像を使えます- ``` JPG: 写真の挿入に最適な選択肢 PNG: 図の挿入に最適な選択肢（何らかの理由でベクターグラフィックを使えない場合）とスクリーンショット PDF: 文書では PDF を使うのが一般的ですが、一般に PDF は後で取り込める 1 枚の画像だけで構成されることもあります。 EPS: EPS 画像は epstopdf パッケージを使って含めることができます（このパッケージはシステムにインストールするだけでよく、一度インストールすれば .tex ファイル内で追加のコマンドは不要です） ``` **ベクターグラフィックス、それともビットマップ？** 画像は、ビットマップ形式またはベクターグラフィックスのどちらでも含めることができます。一般には気にする必要はありませんが、形式を選べる場合は、ベクターグラフィックなら PDF か EPS 形式で保存するのが最善であり、ビットマップなら JPG か PNG 形式が推奨されます。これは、PDF や EPS 形式のファイル内にビットマップを入れると、保存に多くの容量を必要とするからです。 [Overleaf で例を開く](https://www.sharelatex.com/project/new/template?zipUrl=/project/52f4102815577d644c0017fb/download/zip\&templateName=InsertingImages\&compiler=pdflatex) ## さらに読む 詳細は以下を参照： * [画像と表の配置](/latex/ja/to/02-positioning-images-and-tables.md) * [表と図の一覧](/latex/ja/to/03-lists-of-tables-and-figures.md) * [片面印刷と両面印刷の文書](/latex/ja/shu-shi-she-ding/08-single-sided-and-double-sided-documents.md) * [LaTeX における長さ](/latex/ja/shu-shi-she-ding/01-lengths-in-latex.md) * [**floatrow** フローティング要素（表と図）のキャプションを高度に管理するためのパッケージ](http://tug.ctan.org/tex-archive/macros/latex/contrib/floatrow/floatrow.pdf) * [**sidecap** サイド図のキャプション用のパッケージ文書](ftp://ctan.tug.org/tex-archive/macros/latex/contrib/sidecap/sidecap.pdf) * [**epstopdf** パッケージ文書（PDF から EPS への変換）](https://www.google.com/url?sa=t\&rct=j\&q=\&esrc=s\&source=web\&cd=3\&cad=rja\&ved=0CEEQFjAC\&url=http%3A%2F%2Fmirror.hmc.edu%2Fctan%2Fmacros%2Flatex%2Fcontrib%2Foberdiek%2Fepstopdf.pdf\&ei=N4v2UpK7D4eHqQHz2IDACg\&usg=AFQjCNG9CxIXjrbc22kl-8QweEXeEauFew\&sig2=qamKo3qpid8CEqzsHhpIrQ\&bvm=bv.60983673,d.aWM) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/ja/sononotopikku/28-inserting-images-es.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.