                      dvipsk-w32.tar.xz について
                         --- dvipsk-5.994 ---

dvipsk-5.994 では正式に株式会社アスキーによって開発された日本語パッチ p1.7b
および ttk さんの upTeX パッチが採用されています。日本語を扱うには vf-a2bk.tar.xz
も必要です。 また mktexpk を有効にするために mftools.tar.xz もインス
トールしておいて下さい。

[1] インストール法
    TeX のインストールディレクトリ (デフォルトは c:/w32tex) で
    dvipsk-w32.tar.xz と vf-a2bk.tar.xz を展開します:
    c:
    cd \w32tex
    tar xvf dvipsk-w32.tar.xz
    tar xvf vf-a2bk.tar.xz

    NTT jTeX でも dvips.exe を使用できますが，これを可能にするには
    vf-n2bk.tar.xz も TeX のインストールディレクトリで展開しておきます。
    tar xvf vf-n2bk.tar.xz

[2] 実行ファイルの説明
    (1) dvips.exe
        日本語にも対応した dvi を ps に変換するドライバです。

    (2) gsftopk.exe
        これは gsftopk バージョン 1.19.2 であり，
        gsftopk FontName DPI のように使用します。具体的には
        gsftopk ptmr8r 600 などとします。実際にはこれは mktexpk
        から自動呼び出しされます。PATH の通ったディレクトリに
        GSDLL32.DLL が無ければいけません。
        texmf-dist/fonts/map/dvips/base/psfonts.map に記述してあるもの、および
        texmf-dist/dvips/config/config.gsftopk に列記してあるマップファイルに
        記述してあるフォントから pk フォントを作成することができます。

    (3) bkmk2uni.exe
        これは platex, hyperref, dvips, distiller を使用して、PDF
        文書を作成するとき、日本語を含む bookmarks (しおり) などを可能に
        するためのツールです。dvips が出力した PostScript において、
        /Title (string) , /Subject (string), /Author (string),
        /Keywords (string) /T (string) /Subj (string) /Contents (string)
        なる部分の string を bigendian Unicode に変更して出力します。

        dvips -Ppdf -z -f foo[.dvi] | bkmk2uni >foo.ps

        bkmk2uni は、オプション -e を付けると、euc-japan から unicode
        への変換をするようになります。 NTT-jTeX の jlatex の場合には、
        TeX ソースのコードには無関係に上記の string は必ず euc-japan に
        固定されています。従って jlatex から得られた dvi を dvips で
        処理し、結果に bkmk2uni を使うときには次のようにオプション -e
        を付けて下さい:

        dvips -Ppdf -z -f foo[.dvi] | bkmk2uni -e >foo.ps

        上のようにして得られた foo.ps を distiller で処理して下さい。
        bookmarks (しおり) は、\section などのデータから自動作成されます
        が、Acrobat Reader の文書情報で表示される情報を埋め込むには、
        hyperref package のオプションで次のようにすれば良いです:
        \usepackage[dvips,pdftitle={タイトル},%
        pdfauthor={鈴木太郎},pdfsubject={サブタイトル},%
        pdfkeywords={TeX,文書処理,メタフォント},other keys]{hyperref}

        また、text annotation は 次のような special をソースに記述して
        おきます:

        \special{ps: SDict begin [
        /Contents (注釈の本文)
        /Rect [70 600 170 700]
        /Open false
        /Color [0 1 1]
        /Title (注釈の題名)
        /Subtype /Text
        /ANN pdfmark end}

    (4) bmeps.exe
        dvips で埋め込める画像ファイルは、eps 形式だけです。
        bmeps.exe は Dirk Krause による、bitmap 画像を eps 形式に変換する
        高機能なユーティリティです。bmeps の全機能を dvips に取り込んで、
        dvips をコンパイルしなおすこともできるのですが、dvips をあまり
        複雑にするのは好ましくないと判断し、そのようにはしていません。
        bmeps.exe を、dvips を補助する外部プログラムとして使用するという
        方を選択しています。
        libpng, libjpeg, zlib, libpnm/ppm/pgm/pbm とリンクしていますから、
        png, jpeg, pnm, ppm, pgm, pbm 形式のファイルを eps に変換することが
        できます。dvips を insecure mode (オプション -R0) で使用すれば、
        上記画像を dvips の実行時に自動的に eps に変換しながら埋め込む
        こともできます。以下簡単に説明します。

        (o) bmeps.exe の使用法

        bmeps.exe のコマンドラインでの使用法は
        bmeps -h
        とすると表示されますが、ここで説明しておきます。
        一般に
        bmeps Options InputFile [OutputFile]
        とすれば良いでしょう。OutputFile を省略すると、標準出力に出力
        します。オプションは以下のようです:
        -p#
             # は数値で、1, 2, or 3 を指定します。出力 PostScript の
             PS level を指定します。デフォルトは 2 です。
        -b
             BoundingBox 用ファイル (必須) だけを作成する場合に指定します。
             bmeps -b foo.png foo.bb
             のように使用します。
        -c
             color printing をオンにします。これは PS level 1 では無視
             されます。
        -g
             color printing をオフにし、gray scale で出力します。
             -c あるいは -g を必ず指定して下さい。
        -e<encoding>
             Encoding mechanism を指定します。デフォルトは ASCII-hex です。
             r を指定すると、run-length-encoding
             8 を指定すると、ASCII-85-encoding
             となります。
             f は PS level 3 で有効なもので flate encoding をオンにします。
             これらを組合すことも可能です。
             例:
             -ef     ASCII-hex and flate encoding
             -e8f    ASCII-85 and flate encoding
             -erf    ASCII-hex, run-length and flate encoding
             -er8f   ASCII-85, run-length and flate encoding
        -d
             draft mode をオンにします。イメージは出力されず、
             単に placeholder が出力されます。
        -a<alpha-channel-options>
             PS level 3 では mask を利用したイメージを出力できます。
             png イメージのalpha channel を mask に convert
             できます。元画像の alpha channel が不透明度を表す場合は
             o (小文字のオウ)、透明度を表す場合は
             t を指定して下さい。
             l (小文字のエル) を指定すると、full opacity ピクセルだけ
             が描画されます。
             m を指定すると、背景と前景をミックスするそうです。
             s#,#,# (例 s128,255,128) とすると、背景色を指定することが
             できます。

        以上が bmeps.exe の基本的使用法です。詳細はサブディレクトリ bmeps
        に入れてある、オリジナルのドキュメントを読んで下さい。ドキュメント
        中には dvips の機能を拡張した場合のことも書いてありますが、dvips
        の機能を拡張してはいませんのでその部分はあてはまりませんので注意
        して下さい。

        次に、dvips を insecure mode で使用して、dvips の実行時に
        bitmap 画像を自動的に eps 変換して埋め込む方法を説明します。
        まず、BoundingBox 用ファイル foo.bb は必ず必要ですから
        bmeps -b foo.png foo.bb
        のようにして、作成しておかなければいけません。
        (p)LaTeX ソースには次のように書いておけば OK です。

        \documentclass[12pt]{jarticle}
        \usepackage[dvips]{graphicx}
        \DeclareGraphicsRule{.png}{eps}{.bb}{`bmeps -c -tpng #1}
        ... ...
        \begin{document}
        ... ...
        \includegraphics[width=.8\textwidth]{foo.png}
        ... ...
        \end{document}

        このソースを smpl.tex だとすると、
        platex smpl のコンパイルが終わったあと、

        dvips -R0 -Ppdf smpl

        のようにします。オプション -R0 (insecure mode) に注意して下さい。
        他の画像フォーマットについても同様です。

    (5) fixill.exe
        Illustrator はサムネイルを付けると、バイトカウントを誤って付ける
        というバグを持っています。dvips(k), odvips はこれらのバグが
        あっても eps 埋め込み時にエラーにならないように訂正されていますが、
        バイトカウントを正しく訂正する perl script を Rokicki さんが
        作って下さいました (fixill.pl)。 fixill.exe は perl を使って
        fixill.pl を実行するためのローダです。perl をインストールしていない
        と使えません。
        fixill  <orgeps.eps  >neweps.eps
        のようにして使用します。

[3] 日本語 map ファイルの選択
    通常はデフォルトのまま使用して困らないと思います。しかし otf パッケージ
    などの関係で、map を指定したい場合があると思いますので、これに関して
    説明します。

    (1) デフォルトの設定では、通常の日本語には Ryumin-Light と GothicBBB-Medium
        が当てられ、otf パッケージ用には Hiragino ProN が当てられます。

    (2) 全て Ryumin-Lignt と GothicBBB-Medium にしたい場合、
        dvips -u+standard-ps.map dviname
        または
        dvips -u+standard04-ps.map dviname
        とします。後者は JIS-2004 漢字を使いたい場合に指定します。(以下同様)。
        オプションの '+' 文字に注意して下さい。これが無いと、psfonts.map
        が読まれなくなりますので、必ず忘れないようにして下さい。

    (3) Hiragino を使用したい場合、
        dvips -u+hiragino-ps.map dviname
        dvips -u+hiragino04-ps.map dviname

    (4) Hiragino ProN を使用したい場合、
        dvips -u+hiraginopron-ps.map dviname
        dvips -u+hiraginopron04-ps.map dviname

    (5) 小塚 Pro を使用したい場合、
        dvips -u+kozuka-ps.map dviname
        dvips -u+kozuka04-ps.map dviname

    (6) 小塚 Pr6N を使用したい場合、
        dvips -u+kozukapr6n-ps.map dviname
        dvips -u+kozukapr6n04-ps.map dviname

    (7) Morisawa を使用したい場合、
        dvips -u+moriisawa-ps.map dviname
        dvips -u+moriisawa04-ps.map dviname

    (8) Morisawa Pr6N を使用したい場合、
        dvips -u+moriisawapr6n-ps.map dviname
        dvips -u+moriisawapr6n04-ps.map dviname

[4] 追加説明
    (1) デフォルトの DPI を 600 にしていますので, これを変更するには
        texmf-dist/dvips/config/config.ps において
        D 600
        となっている行を変更して下さい。

    (2) マニュアルはこの文書と同じディレクトリ texmf-dist/doc/dvips/base
        にあります．

    (3) CM Type1 fonts 等を 出力ファイルに埋め込むには
        dvips -D600 -Pdl foo[.dvi]
        などとします。オプション -Pdl によって，config.dl に記述してある
        map ファイルを追加読み込みします。bluesky-dl.map などを読み込むように
        あらかじめ設定してあります。この場合殆どの Type1 フォントを
        ダウンロードするようになります。
        dl は download を連想するように考えられた名前です。
        CM Type1 fonts は、t1fonts.tar.xz をインストールすると使用
        できます。BlueSky Type1 フォントには msam6 などが抜けています
        が、例えば \usepackage{type1cm} としておけば、他で代用してくれますの
        で大丈夫です。type1cm パッケージは ltxpkgs.tar.xz をインストール
        すれば、使用できます。

    (4) PSプリンタで印刷する場合には、内臓のフォントはダウンロードしない
        でも良いので
        dvips -D600 -Pbi foo[.dvi]
        などとします。オプション -Pbi によって，config.bi に記述してある
        map ファイルを追加読み込みします。プリンタ内臓フォントについては
        PS ファイル自身にはフォントの名前が記述され、印刷時にはプリンタの
        フォントデータが使用されます。通常のプリンタに存在しないと思われる
        フォントについてはダウンロードするようにしています。
        bi は builtin を連想するように考えられた名前です。
        CM Type1 fonts は、t1fonts.tar.xz をインストールすると使用
        できます。

    (5) Acrobat Distiller への入力ファイルの場合、Base 14 fonts は
        ダウンロードしなくてよいので、 -Ppdf オプションを使えるように
        しています。Acrobat Distiller への入力ファイルを作成するには
        -Ppdf オプションを使うとよいでしょう。
        Acrobat Reader 4.0 以降では、Times が TimesNewRoman で、Helvetica
        が Arial で置き換えられるので、意図した出力と違って困る場合には
        -Pdl オプションを使ってもよいです。この場合、PDF サイズは
        若干大きくなるでしょう。

    (6) 日本語に対して、振る舞いがおかしい場合、オプション -noomega
        を追加して試して下さい。
--------------
A. Kakuto
