\documentstyle{jarticle}

\title{Tgif2tex(ver.1.40)の使い方}
\author{中野浩嗣\\(nakano@elcom.nitech.ac.jp)}
\date{1997年8月19日}


\begin{document}
\maketitle

\section{はじめに}
Tgifを用いて複数ページからなる発表用スライドを作成したり、\LaTeX で書か
れている論文中にTgifで作成した図を張り付けることがよく行われる。ところが、
tgifを用いると、図中の文字列に`$\sqrt{n\log n}$'のような数式がうまく書け
ず、かわりに`\verb+√n log n+'などと書くことが多い。これを解決するのが
tgif2texである。tgif2texを用いれば、tgifの図中の文字列として
`\verb+$\sqrt{n\log n}$+'と書いておけば、これを\LaTeX の文字列と処理させ
ることができ、`$\sqrt{n\log n}$'と印刷される。

\section{インストール}
Tgif2texをインストールするには、tgif2texの１行目の
\begin{quote}
\verb+#!/usr/local/bin/perl+
\end{quote}
と、先頭あたりにある
\begin{quote}
\verb+$latex_command='jlatex';+\\
\verb+$article='j-article';+
\end{quote}
を環境にあわせて適切に変更すればよい。
なお、Tgif2texは次の環境で動作確認をした。
\begin{itemize}
\item Tgif-3.0J0 (patchlevel 13)
\item NTT版JTeX 1.52 (based on TeX 3.141)
\item ASCII版JTeX 1.7 (based on TeX 2.99)
\item dvi2ps (j-version) 1.91j
\item perl (version 5.001)
\item nkf (version 1.4)
\end{itemize}
多少バージョンが異なっても動作すると思われる。

\section{Tgif2texの使い方}
Tgifの利用法として、例えば、次の2つがあげられる。
\begin{enumerate}
\item \LaTeX で書かれた論文中にtgifで書いた図を張り付ける。
\item 発表用のスライドとして、複数ページにわたる図を書く。
\end{enumerate}
これら２つの場合にtgif2texをどのように用いるかを例をあげて説明する。

\subsection{\LaTeX にtgifの図を張り付ける}
例えば次のような図を論文の中に張り付けたいとする。

\input{pythagoras.tps}

このときは、tgifで次のような図を書く。
(この図のファイル名をsample1.objとする。)

\input{original.tps}

ここで、`file=pythagoras'はこの図をtgif2texで保存するためのファイル名を
表し、大きな四角形は図の範囲(つまり図の枠)を表している。
`file=pythagoras'はこの枠外でなければならない。描いた図を
sample1.objに保存する。
そこで、
\begin{verbatim}
> tgif2tex sample1
\end{verbatim}
を実行する。すると、tgif2texは２つのファイルpythagoras.tpsと
pythagoras.dpsを生成する。pythagoras.dpsは、sample1.psから文字列の部分を
取り除いたものである。pythagoras.tpsには、その取り除かれた文字列を\LaTeX 
のpicture環境を用いて描いたものである。tgif2texが生成した図を\LaTeX の文
章中に張り付けるには、
\begin{verbatim}
\input{pythagoras.tps}
\end{verbatim}
とすればよい。tgifの複数ペー
ジに図を１つずつ書いた場合は、各ページの`file='で指定した名前で、tps、
dpsファイルに保存する。\LaTeX の文字として変換せず、psの文字として置いておき
たい場合、その文字列の先頭を`.'(ピリオド)にしておく。つまり、
`\verb+$\sqrt{n\log n}$+'は、$\sqrt{n\log n}$に変換されるが、
`\verb+.$\sqrt{n\log n}$+'は、`\verb+$\sqrt{n\log n}$+'となる。
(前のピタゴラスの定理の証明の例はこれを用いて作成した。)
\LaTeX に変換したい文字列が`.'から始まる場合は先頭にダミーのスペースを
いれておけばよい。

\subsection{複数ページからなるスライドを作る}
いま、複数ページ(３ページとする)からなるスライドを作ったとする。
これをsample2.objとする。
\begin{verbatim}
> tgif2tex -slide sample2
\end{verbatim}
を実行すると、tgif2texは７つのファイル
\begin{quote}
sample2.1.tps、sample2.1.dps\\
sample2.2.tps、sample2.2.dps\\
sample2.3.tps、sample2.3.dps\\
sample2.tex
\end{quote}
を生成する。ここで、sample2.1.tpsとsample2.1.dpsは、それぞれ１ページ目の
tpsファイル、dpsファイルである。また、sample2.texは、sample2.1.tps、
sample2.2.tps、sample2.3.tpsを取り込んだ\LaTeX ファイルである。
\begin{verbatim}
> jlatex sample2.tex
\end{verbatim}
を実行すると、文字列が\LaTeX で処理された３ページのスライドからなる
dviファイル、sample2.dviが生成される。
あとは、dvi2psを用いてPostscriptに変換してプリントアウトすればよい。

\section{Tgif2texの使い方のコツ}
\begin{itemize}
\item 枠(表示させたい全てを含むような大きなBox)は必ずつける。
\item 文字列の長さが大きく変わることがあるので、Left、Right、Centerの
      horizontal alignmentを利用して、ずれをなくす。(vertical alignment
      は未対応。)
\item 図中の文字列を\LaTeX の文字列として扱うだけなので、数式だけでなく
      \LaTeX のコマンドならなんでも書ける。\LaTeX での行列や表も、やる気
      になれば図に埋め込めるだろう。
\item 漢字を使わないときは、tgifでRyuminの上の空白(つまり漢字フォントを
使わない)を選択しておく。そうすれば、漢字フォントを持たない
Postscriptプリンタでもプリントアウトできる。(海外にpostscriptで論
文を投稿するときに重要。)
\end{itemize}

\section{オプション}
\begin{description}
\item[-dvi]    jlatexを実行し、dviファイルまで作る。(スライドモードのみ)
\item[-euc]    tpsをeucとして出力。(これがデフォルト。)
\item[-h]      コマンドラインオプションを表示。
\item[-jis]    tpsをjisとして出力。(デフォルト:euc)
\item[-m mag]  mag倍に図を拡大。(１未満なら縮小。)
\item[-merge file] 複数のpsファイルを入力と指定した場合に、
		それらをマージしたものをfileに出力。(スライドモードのみ)
\item[-p char] Postscriptへのエスケープキャラクタ。(デフォルト： .(ピリオド))
\item[-pagenum] ページ番号をつける。(スライドモードのみ)
\item[-s]      静か。
\item[-slide]  スライドモード。
\item[-sjis]    tpsをsjisとして出力。(デフォルト:euc)
\item[-v]      やかましい(デフォルト)。
\item[-vv]     とてもやかましい。
\end{description}
\end{document}
