/*************************************************************************** hzview 3.1: view a hanzi (GB/BIG5) file on a dumb terminal ---------------------------------------------------------- By Fung F. Lee Copyright (C) 1989,1991,1993 Fung F. Lee ***************************************************************************/ This is a maintainance update to replace the directory path environment variable HZFONTDIR by HBFPATH, which is supported by the latest "hbf.c" by Ross Paterson. Users can now specify a list of paths to search instead of a single path. The new "hbf.c" takes care of the operating system dependent problems of file path names, and thus make hzview more portable. Moreover, you now have to type in the hbf file name with extension, i.e., "ccs16.hbf" rather than just "ccs16". /*************************************************************************** hzview 3.0: view a hanzi (GB/BIG5) file on a dumb terminal ---------------------------------------------------------- ***************************************************************************/ The biggest change in this version is the adoption of HBF as the only hanzi font format. The HBF API assumed in this program is documented in the article "Hanzi Bitmap Font (HBF) File Format Standard Version 1.0", written by Man-Chi Pong. The article can be obtained by ftp from ifcss.org:software/fonts/HBF as "HBF_std_v1.0". The HBF API implementation as in the files "hbf.c", "hbf.h", was written by Ross Paterson . Some .hbf files can be obtained by ftp from ifcss.org:software/fonts/HBF; corresponding font bitmap files are in the software/fonts directory. Users are recommended to put the .hbf files and the bitmap files into the same directory, and setenv HZFONTDIR equal to that directory. For example, if that font directory is called /user/me/fonts, then type % setenv HZFONTDIR /user/me/fonts To compile the program, type % make hzview To test the program, type % make test0 % make test1 % make test2 % make test3 You are supposed to see "huge" characters on your screen, that is, one character on screen for one "pixel" defined in the bitmap of a hanzi. That is due to the limitation of a dumb terminal. Use this program as a last resort to read long articles. You may get the .hbf files and (raw bitmap) font files from the archive site ifcss.org:software/fonts. 10 October 1993 hzview(1) NAME hzview (version 3.1) - display a hanzi (GB/BIG5) file on a dumb terminal SYNTAX hzview [ options ] [ file ] DESCRIPTION The hzview program displays a GB or BIG5 hanzi file on a dumb terminal. The possible options are -hf hanzi-font HBF hanzi font. Default is -hf ccs16.hbf (SongTi 16). -hsp inter-hanzi-spacing measure in number of columns. Default is -hsp 2. -margin left right left and right margins measured in column numbers from the left. Default is -margin 0 78. -marker character the ASCII character used to paint hanzi "bitmap". Default is -marker #. If the environment variable HBFPATH is set, (e.g. setenv HBFPATH "~/hanzi/hbf:/usr/local/hanzi/fonts/hbf"), hzview will search for the HBF (header) file under each directory in the path list HBFPATH in order. Otherwise, the current directory is the default directory. COPYRIGHT Copyright (C) 1989, 1991, 1993 Fung F. Lee All rights reserved. Permission to copy and distribute verbatim copies of the source code and accompanied documents for non-commercial purposes is granted, but changing them is not allowed. There is absolutely no warranty for this program. AUTHOR Fung F. Lee BUGS Bug reports and comments should be sent to lee@csl.stanford.edu. 1