THE DVIPDFMx PROJECT

The DVIPDFMx (formerly dvipdfm-cjk) project provides an eXtended version of the dvipdfm, a DVI format to PDF translator developed by Mark A. Wicks. The primary goal of this project is to support multi-byte character encodings and large character sets for East Asian languages by CID-keyed font technology. The secondary goal is to support as many features as pdfTeX developed by Han The Thanh. This project is a combined work of the dvipdfm-jpn project by Shunsaku Hirata and its modified one, dvipdfm-kor, by Jin-Hwan Cho.

What's New

Recent changes:

• Important Note on Feb 1, 2005
  A few bugs were fixed, which occurred either in subfont scheme, e.g., CJK-LaTeX or HLaTeX, or in Truetype fonts with CIDType2 format. We encourage the users to recompile the source in the CVS repository (with the tag DVIPDFMX-20050201). For MiKTeX 2.4 users, see the Binary Packages / MiKTeX section in Obtain....
• Font Support
  PostScript Type 1 font is converted to CFF for better compression. Ordinary CFF OpenType font is supported too. Supported font formats are: PK, Type 1, TrueType, OpenType(CFF), and OpenType(CFF CID).
• Graphics and Image Support
  A little enhancement on PDF inclusion. Improved PNG support; alpha channel and tRNS chunk is fully supported. Indexed-color is no longer converted to 24-bit RGB. Experimental embedded ICC profile support for JPEG and PNG format images. BMP image format is supported. Bug fixes on TPIC support.
• Unicode Support
  A new encoding keyword "unicode" can be specified in fontmap file for TrueType and Type1 font. TrueType font must have Windows UCS2 (format 4) or UCS4 (format 12) cmap subtable. Glyph list file (PS glyph name to Unicode mapping) is required for Type1 font support. Automatic creation and embedding of ToUnicode CMap is available for Type 1, TrueType, and OpenType(CFF) font.

Obtaining DVIPDFMx

The DVIPDFMx project does not offer pre-compiled binary packages. See, section "Binary Packages" for obtaining binary packages.

Source Code

You can obtain current snapshot from http://project.ktug.or.kr/dvipdfmx/snapshot/.

An anonymous access to the CVS repository is also available. You can update your local copy of DVIPDFMx source code with the following commands:

cvs -d:pserver:anonymous@cvs.ktug.or.kr:/home/cvsroot login
cvs -d:pserver:anonymous@cvs.ktug.or.kr:/home/cvsroot co dvipdfmx

When prompted for a password for anonymous, simply press the Enter key.

To compile DVIPDFMx, you need, at least, the kpathsea library. Kpathsea library version heigher than 3.3 is recommended. In addition to this, the zlib library is required for compression support. Both zlib and libpng library is required for PNG image inclusion. Dvipdfmx optionally support libpaper library for handling paper sizes. Please read README file for more details.

Binary Packages

FreeBSD and Linux

DVIPDFMx is available from the FreeBSD ports/package collection.

Microsoft Windows

• W32TeX
  A TeX implementation based on Web2c, maintained by Akira Kakuto. It includes pTeX and many localized version of TeX related programs especially useful for Japanese typesetting.
• MiKTeX
  An up-to-date implementation of TeX and related programs for MS-Windows by Christian Schenk. [Cabinet binary packages: miktex-dvipdfmx.cab for MiKTeX 2.2 (20030313), miktex-dvipdfmx.cab for MiKTeX 2.3 (20031110)].

  Important Note for MiKTeX 2.4 Users: DVIPDFMx in the MiKTeX 2.4 distribution does not work smoothly because of several reasons. We encourage the users to update as follows:

  1. Change the executable file C:\texmf\miktex\bin\dvipdfmx.exe to dvipdfmx.exe for MiKTeX 2.4 (DVIPDFMX-20050201 recompiled on Feb 3, 2005).

  2. Change the configuration file C:\texmf\miktex\config\miktex.ini to miktex.ini for MiKTeX 2.4 (modified ttf2pk and ttf2tfm sections).

  3. Put Adobe Glyph List 2.0 (Sep 20, 2002) in the directory C:\texmf\dvipdfm\CMap.

  4. Extract the zip file ttf2pk directory for MiKTeX 2.4 (complete collection of SFD files for ttf2pk, ttf2tfm, and DVIPDFMx) into the directory C:\texmf.

MacOS X

See, pTeX package for MacOSX (in Japanese) for Japanese environment.

Features

Most features/enhancement added to dvipdfm in DVIPDFMx is related to multi-byte encoding/font support, especially CJK.

Compatible TeX Packages

In addtion to TeX/LaTeX, the following TeX variants and TeX/LaTeX packages are supported:

• ASCII pTeX
  Full support available including vertical writing extension.
• CJK-LaTeX package
  DVIPDFMx requires SFD files to remap multiple single-byte fonts back to the original double-byte fonts.
• ConTeXt
  The ConTeXt driver file spec-dpx.tex for DVIPDFMx is contained in the beta version of ConTeXt since December 4, 2002. Choose dvipdfmx as output option.
• HLaTeX package
  Same as the CJK-LaTeX support, requires SFD files.
• NTT jTeX
  Support for NTT jTeX is not tested well. NTT jTeX output can be supported with virtual-font package vf-n2bk.tar.gz distributed by Akira Kakuto or SFD files.
• Omega [Broken Link?]

Supported Font Format

The following font formats are supported:

• PostScript Type 1
  PostScript Type 1 font is embedded as subset font in Type 1C (CFF) format. (Multiple-Master is not supported)
• OpenType
  All features supported in Type 1 font are available for OpenType/CFF (OpenType font with PostScript outline data). CID-keyed font is also supported. Ordinary OpenType/CFF fonts are treated like a Type 1 font.
• TrueType
  TrueType fonts can be embedded either as a CIDFontType 2 CID-Keyed font or a TrueType (simple) font.

Dvipdfmx works better with PostScript flavored fonts, and it sometimes requires additional support files for TrueType font.

PDF Encryption

Encrypted PDF files can be generated if the -S option is given. The key bits (40-128 bits) and the permission flags are specified either in the configuration file dvipdfmx.cfg or with command line options -K (for key bits) and -P (for permission flags).

Graphics Support

Changes from the original dvipdfm:

• Full PNG transparency support and indexed-color image support (without converting to RGB).
• CJK support for MetaPost PostScript inclusion.

Examples

Some of example PDF presented in this section contains embedded CJK TrueType fonts. You need a PDF viewer supporting PDF version 1.3. For examples, AFPL Ghostscript 7.x or 8.x, GNU Ghstscript 6.x or 7.x, Adobe Acrobat Reader 4, 5, or 6, or Xpdf 2.x.

ConTeXt

Most of examples are contributed by Lei Wang.

• Chinese Zodiac
  Nice example by Lei Wang. Chinese zodiac and it's explanation: zodiac.pdf. [NOTE: This document will be opened in fullscreen mode. Please press ESC key to show menu bar in Adobe Acrobat Reader]
• Examples contributed by Lei Wang
  ConTeXt examples with Chinese (GBK encoding is used in source files). TrueType font embedded in PDF. Bookmarks [PDF (bookmark.pdf), TeX (bookmark.tex)], PDF Interaction [PDF (help-test.pdf), TeX (help-test.tex)], and MetaPost graphics [PDF (mp-test.pdf), source archive (mp-test.tar.gz)].
• Other ConTeXt Examples
  Page Size Changes [PDF (papersize.pdf), TeX (papersize.tex)] and Color Shading Example [PDF (color-shading.pdf), TeX (color-shading.tex)].

Omega/Lambda

• Gentium
  The Gentium TrueType font is embedded as a CID-keyed font. Lambda source file and OFMs for Gentium: lambda-example1.zip. It requires antomega, hyperref, and color packages.
• Pseudo-Vertical Typesetting
  Pseudo-vertical typesetting using Omega and dvipdfmx. You must have Japanese font installed to view this document (no embedded font). Source files: lambda-example2.zip. It requires Omega-J available from Akira Kakuto's W32TeX or omega-japanese package by Vincent Zoonekynd.

CJK-LaTeX Package

• HunMinJeongEum
  UTF8 encoding. TrueType font embedded, 88K bytes. Contributed by Kangsoo Kim.
• KwanDongByeolGok
  UTF8 encoding. TrueType embedded, 257K bytes.
• CJK mixed text typesetted with CJK
  GB, Big5, JIS, SJIS, KS encodings are used in the source (cjkmix2.tar.gz). PDF output with embedded TrueType (80K bytes) and without embedded font (9K bytes). MS-Windows TrueType fonts simsun.ttc, mingliu.ttc, msmincho.ttc, and batang.ttc are used.
• UTF8 text with several languages mixed
  UTF8 encoding was used in the source. Bitstream Cyberbit TrueType font is embedded, 43K bytes.

ASCII pTeX

• dpxgrfx
  A short document on using graphics in dvipdfmx. 107K bytes.
• Li Po
  A Japanese translation of Chinese classics by Li Po. Examples found at Shinsaku Fujita's Home Page. (the author of XyMTeX) TrueType font embedded, 46K bytes.

HLaTeX Package

• Korean MS-Windows TrueType Fonts
  KS encoding was used in the source. TrueType (no embedded font) with stylistic variants, 19K bytes. You need MS-Windows Korean TrueType fonts, batang.ttc and gulim.ttc.
• The Not So Short Introduction to LaTeX2e (Korean)
  KS encoding. TrueType embedded, 1.1M bytes. Contributed by the lshort-kr project team.

Resources

This section contains documents related to DVIPDFMx, some useful information for typesetting CJK text with TeX, and a small list of freely available fonts, etc...

DVIPDFMx Documents

There are no HTML or PDF manulas for DVIPDFMx.

• DVIPDFMx, an eXtension of DVIPDFM
  Presentation given at the TUG 2003 conference.
• README file and ChangeLog file.

CJK and TeX Information

The CJK.INF by Ken Lunde provide detailed information on CJK character sets and encodings. CJK Quick Start contains shareware/freeware information for reading or writing CJK text in English Windows.

If you want to consult others about typesetting CJK text with TeX, please visit

• Japanese TeX FAQ
  A page maintained by Haruhiko Okumura. (In Japanese)
• KTUG
  Korean TeX Users Group. (In Korean)

There is a mailing list for CJK package users which can be found at http://cjk.ffii.org.

CJK/Unicode Font

Many CJK/Unicode fonts are freely available in various formats and in a variety of qualities.

• Adobe Acrobat Reader - Asian font packs
  Several OpenType CID-keyed fonts are freely available from Adobe for use with Adobe Acrobat Reader. It also contains several CMap resources for standard CJK encodings and useful ToUnicode CMaps. In the recent version of asian font pack, no san-serif font...
• Microsoft Global Input Method Editors...
  ... Further Enhance East Asian Text Input: Add-on packages for Microsoft Global IME. You can find TrueType fonts as a part of additional language packs for use with Microsoft Windows OS. MS Hei and MS Song (Simplified Chinese), MingLiu (Traditional Chinese), GulimChe (Korean), and MS Gothic (Japanese) are available.
• Alan Wood's Unicode Resources
  - Unicode and Multilingual Support in HTML, Fonts, Web Browsers and Other Applications. List of Unicode TrueType/OpenType fonts available for various platforms, along with Unicode ranges covered by each font.
• Arphic TrueType and Wang TrueType Font
  Several Chinese TrueType fonts can be found from ftp://freebsd.sinica.edu.tw/pub/keith/.
• Korean Un Fonts
  Several Korean TrueType fonts can be found from http://kldp.net/projects/unfonts/. (in Korean)
• Gentium - a typeface for the nations
  Available from SIL international. Gentium is a typeface family designed to enable the diverse ethnic groups around the world who use the Latin script to produce readable, high-quality publications. It supports a wide range of Latin-based alphabets and includes glyphs that correspond to all the Latin ranges of Unicode.

Specifications

Useful documents and resources for developers.

• Adobe Solutions Network | Product and Technical Resources
  Resources for Developers, Print Service Providers, and others interested in making the most of Adobe products and technologies.
• OpenType specification
  OpenType™ Specification from Microsoft Corporation.

DVI standard is available from CTAN:dviware/driv-standard.

Copyright © 2002-2005, The DVIPDFMx Project Team <dvipdfmx@project.ktug.or.kr>
Jin-Hwan Cho and Shunsaku Hirata, Last modified on February 3, 2005.