1
Info file: VFlib-36.info, -*-Text-*-
2
produced by `texinfo-format-buffer'
3
from file `VFlib-36.texi'
4
using `texinfmt.el' version 2.38 of 3 July 1998.
15
File: VFlib-36.info, Node: vflx11, Next: vfldisol, Prev: vfltest, Up: Sample programs
21
`vflx11' displays glyph of a given font in a window. It requires X11R5
24
Usage: vflx11 [ OPTIONS... ] FONT_NAME
29
A font is opened in mode 1 (high resolution device oriented mode).
32
Bitmaps are obtained by `VF_GetOutline()' and then
33
`VF_OutlineToBitmap()'. This is effective when a font is opened in
37
A font is opened in mode 2 (low resolution device oriented mode).
40
A file name of vflibcap to be used. If this option is not given,
41
default vflibcap file is used. (Possibly, default vflibcap is
42
`/usr/local/share/VFlib/3.6.12/vflibcap'.)
45
Specify point or pixel size of characters. If this option is not
46
given, size of characters are original size of a font.
49
Specify vertical and horizontal magnification factor. If this
50
option is not given, magnification factor is 1.0.
53
Specify horizontal magnification factor. If this option is not
54
given, horizontal magnification factor is 1.0.
57
Specify vertical magnification factor. If this option is not
58
given, vertical magnification factor is 1.0.
61
Print command line arguments and key operations on a window.
64
Following operations are defined on a `vflx11' window.
77
Go to previous 4 page.
83
Go to previous 16 page.
101
Mark the current page.
104
Goto the marked page.
111
File: VFlib-36.info, Node: vfldisol, Next: ctext2pgm, Prev: vflx11, Up: Sample programs
116
`vfldisol' displays `disassembled lists' of vector data of a given font
119
Usage: vfldisol [ OPTIONS... ] FONT_NAME CODE ...
125
A file name of vflibcap to be used. If this option is not given,
126
default vflibcap file is used. (Possibly, default vflibcap is
127
`/usr/local/share/VFlib/3.6.12/vflibcap'.)
130
Resolution of device in dpi. If this option is not given, default
131
resolution of a font is used.
134
Point size of characters. If this option is not given, default
135
point size of a font is used.
138
Print hexadecimal dump of outline data instead of disassembled
145
File: VFlib-36.info, Node: ctext2pgm, Prev: vfldisol, Up: Sample programs
150
`ctext2pgm' creates an image file in PGM or PBM format from a
151
multilingual text file encoded by compound text format. It also
152
supports various text encodings such as Chinese, Japanese, Korean EUCs
153
and Shift-JIS. PGM and PBM formats are portable formats, image files
154
can be easily converted to another image format such as GIF, TIFF.
156
It supports various character sets and left-to-right and right-to-left
160
ISO 8859-1,2,3,4,5,7,8,9
161
--- Latin character sets,
162
including Hebrew which is written from right to left.
165
--- An Arabic script, written from right to left.
166
This character set is used by the multilingual editor Mule.
168
JIS X 0201, JIS X 0208, JIS X 0212
169
--- Japanese character sets.
172
--- A Chinese character set.
174
CNS 11641-1, CNS 11641-2
175
--- Chinese character sets.
178
--- A Hangle character set.
186
Usage: ctext2pgm [ OPTIONS... ] [ FILE ]
188
--- `ctext2pgm' reads FILE (if not given, reads standard input)
189
and prints image file to standard output.
191
Example: % ctext2pgm -pgm -ctext -16 -times DOC-10.txt > IMAGE.pgm
192
(Never forget to redirect the output.)
198
--- a vflibcap file to be used by `ctext2pgm'.
199
Default value is `vflibcap-ctext2pgm'.
202
Options for input encoding and script:
205
--- Assume that an encoding of input file.
206
(This is the default input encoding.) Default writing
207
directionality is set to left-to-right.
209
By this encoding, multiple character set can be used in an input
210
text by escape sequences. Mixture of scripts of left-to-right and
211
right-to-left directionalities is also supported.
213
-iso-8859-1 or -latin-1
214
--- Assume that input file is encoded by iso-8859-1.
215
Escape sequence is not allowed in input file. Default writing
216
directionality is set to left-to-right.
218
-iso-8859-2 or -latin-2
219
--- Assume that input file is encoded by iso-8859-2.
220
Escape sequence is not allowed in input file. Default writing
221
directionality is set to left-to-right.
223
-iso-8859-3 or -latin-3
224
--- Assume that input file is encoded by iso-8859-3.
225
Escape sequence is not allowed in input file. Default writing
226
directionality is set to left-to-right.
228
-iso-8859-4 or -latin-4
229
--- Assume that input file is encoded by iso-8859-4.
230
Escape sequence is not allowed in input file. Default writing
231
directionality is set to left-to-right.
233
-iso-8859-5, -cyrillic or -russian
234
--- Assume that input file is encoded by iso-8859-5.
235
Escape sequence is not allowed in input file. Default writing
236
directionality is set to left-to-right.
238
-iso-8859-7 or -greek
239
--- Assume that input file is encoded by iso-8859-7.
240
Escape sequence is not allowed in input file. Default writing
241
directionality is set to left-to-right.
243
-iso-8859-8 or -hebrew
244
--- Assume that input file is encoded by iso-8859-7.
245
Escape sequence is not allowed in input file. Default writing
246
directionality is set to right-to-left.
248
-iso-8859-9 or -latin-5
249
--- Assume that input file is encoded by iso-8859-9.
250
Escape sequence is not allowed in input file. Default writing
251
directionality is set to left-to-right.
254
--- Assume that input file is encoded by Japanese EUC.
255
Default writing directionality is set to left-to-right.
257
JIS X 0201 Roman character set is used for code set 0, JIS X 0208
258
is used for code set 1, JIS X 0201 Kana is used for code set 2, and
259
JIS X 0212 is used for code set 3.
262
--- Same as -euc-jp1 except
263
ASCII character set is used for code set 0.
266
--- Assume that input file is encoded by Korean EUC.
267
Default writing directionality is set to left-to-right.
269
ASCII character set is used for code set 0 and KSC 5601 is used for
273
--- Assume that input file is encoded by Chinese EUC by simplified Hanzi.
274
Default writing directionality is set to left-to-right.
276
ASCII character set is used for code set 0, and GB 2312 is used for
280
--- Assume that input file is encoded by Chinese EUC by traditional Hanzi.
281
Default writing directionality is set to left-to-right.
283
ASCII character set is used for code set 0, CNS 11643-1 is used for
284
code set 1, and CNS 11643-2 is used for code set 3.
287
--- Assume that input file is encoded by Shift-JIS.
288
Escape sequence is not allowed in input file. Default writing
289
directionality is set to left-to-right.
291
ASCII character set is used for code set 0, JIS X 0208 is used for
296
Options for directionality:
299
--- Select left-to-right directionality for typesetting.
301
--- Select right-to-left directionality for typesetting.
304
Options for font selection:
307
-fixed, -times, -helv or -cour
308
--- Select a font family: Fixed, Times, Helvetia, or Courier, respectively.
309
Default font family is Times.
312
--- Select a font face: bold or italic (or oblique), respectively.
313
Default face is normal.
316
--- Select a font set of 14-, 16-, 18-, or 24-dot, respectively.
317
Default font size if 16.
320
--- Select a scalable font set and scales the font to n dot.
323
--- Specify vertical and horizontal magnification factors.
327
--- Specify horizontal magnification factor.
330
--- Specify vertical magnification factor.
333
--- Print all installed character sets and font names. Then exit the program.
337
Options for typesetting:
340
--- Specify factor of baseline skip.
341
Baseline of a text is moved this value times dot-size of a selected
342
font set. Default value is 1.2.
345
--- Each line is centered.
346
Output image is vertically and horizontally centered.
349
--- Each line is flushed left.
350
This is default mode if writing directionality is left-to-right.
351
Output image is flushed left.
354
--- Each line is flushed left, but image is not flushed left.
357
--- Each line is flushed to right.
358
This is the default mode if writing directionality is
359
right-to-left. (Note that options `-flush-right' and
361
--- consider an English text including Arabic words in the same line.)
362
Output image is flushed right.
365
--- Each line is flushed right, but image is not flushed right.
368
It is important to notice that the difference of `-flush-left' and
369
`-left-line' options (and `-flush-right' and `-right-line' options). By
370
`-flush-left' option, input text is typeset to flush each line left and
371
typeset result is placed in the left of an output image. By
372
`-left-line' option, input text is typeset to flush each line left and
373
does not specify how to put the typeset result in an output image. The
374
difference appears when the horizontal size of output image is
375
explicitly given by `-pw' option.
383
--- Select binary PGM format for image output.
386
--- Select ascii PGM format for image output.
387
This is the default output mode.
390
--- Select ascii PBM format for output an image.
392
-ascii-art or -ascii-art-v
393
--- An image is printed as an ASCII art. (Vertical mode)
394
Baseline is vertical; thus this mode is similar to the `banner'
398
--- An image is printed as an ASCII art. (Horizontal mode)
399
Baseline is horizontal.
402
--- Select EPS format for image output.
403
By default, 16-dot font is printed by 12-point in EPS file. To
404
change the point size, use the -eps-ptsize option described below.
407
--- Select point size of characters for EPS output.
408
If this option is given, point size of each character is scaled to
409
PT point regardless dot size of fonts.
412
--- An image is not shipped out.
415
--- Reverse the black and white of output image.
416
(This option does not have effect when EPS is selected for image
420
--- Shrink factor for anti-aliased output.
421
N by N pixels are shrinked together and forms one pixel in an
422
output image. This option has effect when output format is PGM and
423
EPS. Default value is 1.
426
--- Specify width of output image (in pixels).
427
If this option is not given, the width of output image is the
428
smallest width to contain the glyph of all characters.
431
--- Specify height of output image (in pixels).
432
If this option is not given, the height of output image is the
433
smallest height to contain the glyph of all characters.
436
--- Specify horizontal and vertical margins of output image (in pixels).
437
Default margin is zero pixel.
440
--- Specify horizontal margin of output image (in pixels).
441
Default margin is zero pixel.
444
--- Specify vertical margin of output image (in pixels).
445
Default margin is zero pixel.
448
--- An image of typeset text is horizontaly and vertically centered.
451
--- An image of typeset text is horizontaly centered.
454
--- An image of typeset text is vertically centered.
457
--- An image of typeset text is flushed left.
460
--- An image of typeset text is flushed right.
463
--- An image of typeset text is flushed top.
466
--- An image of typeset text is flushed bottom.
472
Making input files for ctext2pgm
473
--------------------------------
475
Any text editor can be used to prepare input files for `ctext2pgm'.
476
Input files are plain texts. If you want to create an image containing
477
multiple character sets, save the files by *compound text* encoding. If
478
you want to make images of Arabic text, use the `Mule' editor. (`Mule'
479
is an extension of `GNU Emacs' for multilingual text processing.) For
480
making images of Arabic script, `ctext2pgm' only supports a text created
481
by Mule, ISO-8859-6 is not supported.
483
Unlike TeX and HTML, newlines of input files are *not* ignored and a
484
newline character in input text breaks line. Thus, input text is
485
typeset like `verbatim' environment of LaTeX or `<PRE> ... </PRE>' tag
490
Commands in input text
491
----------------------
493
Several commands can be embedded in text files such as font switch.
494
Command sequence starts by a backslash (`\') followed by one character
495
which represents command name. If you want to display a backslash
496
character itself, use double backslashes `\\'.
498
Following commands are defined:
501
`\f', `\t', `\h', `\c'
502
--- Change of font families.
503
Current font family is changed to fixed, times, Helvetia, courier,
507
--- Current font family is changed to the default font family.
508
The default font family can be specified by a command line option.
511
--- Change of font faces.
512
Current font face is changed to normal, bold, italic, respectively.
515
--- Current font face is changed to the default font face.
516
The default font face can be specified by a command line option.
519
--- Same as `\d' followed by `\D'.
522
--- Black and white of glyph of following characters are reversed.
523
This command is recommended *only* for fixed-width fonts. (For the
524
reason of current implementation, resulting bitmap is ugly for
525
proportional fonts and you cannot read the text in an image.)
527
Nesting of `\(' has no effect.
530
--- End of reversing black and white.
533
--- Print backslash itself.
541
In case you failed to obtain a desired image output, the following
542
command line options for debugging may be useful. (Debugging messages
543
are printed to standard output. The `-none' option is useful to
544
suppress printing binary image to your terminal. Otherwise, debugging
545
message and image file are printed together on your terminal!)
548
--- Print the state transition of the parser for compound text.
550
--- Print the state transition of bi-directionality handling.
552
--- Print font name to be opened.
554
--- Print each character glyph in ascii-art form.
556
--- Print each line image by in ascii-art form.
558
--- Print entire page image in ascii-art form.
560
--- Selects all debugging options above.
566
File: VFlib-36.info, Node: Difference between VFlib version 3.6 and 2, Next: Concept index, Prev: Sample programs, Up: Top
568
Difference between VFlib version 3.6 and 2
569
******************************************
571
VFlib version 3.6 and version 2 are quite different and you should
572
forget about VFlib version 2.
575
VFlib 2 was designed only for Japanese Kanji fonts
576
VFlib 3.6 can handle fonts for multilingual text printing.
578
Font metric is introduced in VFlib 3.6
579
VFlib 2 does not concepts on font metrics since it assumes all
580
characters are the same metrics. Font metrics is introduced in
581
VFlib 3.6 and proportional fonts can be used.
583
Syntax of vflibcap file
584
Syntax of vflibcap file is quite different. VFlib 2 adopted
585
termcap-like notation, but now VFlib 3.6 adopts lisp-like notation.
587
Arguments and return values of function are changed
588
In VFlib 2, bitmaps of characters are written in a frame buffer
589
which is given by argument. But in VFlib 3.6, a bitmap object is
597
File: VFlib-36.info, Node: Acknowledgments, Next: Concept index, Prev: Difference between VFlib version 3.6 and 2, Up: Top
602
Since I released VFlib version 1, so many people helped me to improve
603
VFlib. I am grateful for all of them. Special gratitude is due to
604
Satoru Tomura, Ken'ichi Handa, Werner Lemberg, and Ichiro Matsuda.
610
File: VFlib-36.info, Node: Concept index, Next: Data type index, Prev: Acknowledgments, Up: Top
618
* Arabic: ctext2pgm. 20.
619
* ASCII Japanese TeX Kanji font class: ASCII Japanese TeX Kanji font class. 4.
620
* BDF font class: BDF font class. 12.
621
* CCV: Code conversion system. 5.
622
* Chinese EUC: ctext2pgm. 10.
623
* CNS 11641: ctext2pgm. 33.
624
* code conversion system: Code conversion system. 5.
625
* code-conversion-files: Code conversion system. 5.
626
* compound text: ctext2pgm. 333.
627
* Copyright: Copyright. 5.
628
* Cyrillic: ctext2pgm. 15.
629
* eKanji font class: eKanji font class. 4.
630
* Emacs: ctext2pgm. 337.
631
* EUC: ctext2pgm. 10.
632
* explicit fonts: Explicit and implicit fonts. 4.
633
* font class: Introduction. 56.
634
* font driver: Introduction. 56.
635
* FreeType: Installing VFlib. 45.
636
* FreeType: TrueType font class. 7.
637
* GB 2312: ctext2pgm. 29.
638
* GF font class: GF font class. 4.
639
* GNU Emacs: ctext2pgm. 337.
640
* GNU Library General Public License: Copyright. 5.
641
* HBF font class: HBF font class. 4.
642
* Hebrew: ctext2pgm. 15.
643
* High resolution oriented mode: Introduction. 122.
644
* implicit fonts: Explicit and implicit fonts. 4.
645
* Installing VFlib: Installing VFlib. 4.
646
* ISO 8859: ctext2pgm. 15.
647
* Japanese comic font class: Japanese comic font class. 4.
648
* Japanese EUC: ctext2pgm. 10.
649
* JG font class: JG font class. 4.
650
* JIS X 0201: ctext2pgm. 25.
651
* JIS X 0208: ctext2pgm. 25.
652
* JIS X 0212: ctext2pgm. 25.
653
* KangXi: eKanji font class. 21.
654
* Korean EUC: ctext2pgm. 10.
655
* kpathsea: Installing VFlib. 45.
656
* KSC 5601: ctext2pgm. 37.
657
* left-to-right directionality: ctext2pgm. 13.
658
* LGPL: Copyright. 5.
659
* libVFlib.a: Installing VFlib. 185.
660
* libVFlib.a: Introduction. 34.
661
* libVFlib.so: Installing VFlib. 185.
662
* libVFlib.so: Introduction. 34.
663
* Low resolution oriented mode: Introduction. 131.
664
* Mojikyo font mapping class: Mojikyo font mapping class. 4.
665
* Morohashi DaiKanwa: eKanji font class. 24.
666
* Mule: ctext2pgm. 20.
667
* Mule: ctext2pgm. 337.
669
* PCF font class: PCF font class. 4.
671
* PK font class: PK font class. 4.
672
* right-to-left directionality: ctext2pgm. 13.
673
* Shift JIS: ctext2pgm. 155.
674
* T1Lib: Installing VFlib. 45.
675
* T1Lib: Type1 font class. 7.
676
* TeX default and TeX font mapping font class: TeX default and TeX font mapping font class. 4.
677
* TFM font class: TFM font class. 4.
678
* TrueType font class: TrueType font class. 4.
679
* Try font class: Try font class. 4.
680
* Type1 font class: Type1 font class. 4.
681
* Unicode: eKanji font class. 18.
682
* variables: Variables in vflibcap. 4.
683
* VF font class: VF font class. 4.
684
* VFlib-3_6.h: Building an application software with VFlib. 7.
685
* vflibcap: Installing VFlib. 191.
686
* vflibcap: Introduction. 46.
687
* VFLIBCAP_PARAM_var: Variables in vflibcap. 13.
688
* VFlib.fdb: Fast font file search. 5.
689
* VFlib.fdb: vflmkfdb. 17.
690
* Virtual Font library: Introduction. 71.
691
* web2c: Installing VFlib. 45.
692
* Zeit font class: Zeit font class. 4.
697
File: VFlib-36.info, Node: Data type index, Next: Function index, Prev: Concept index, Up: Top
705
* struct vf_s_bitmap: bitmap type. 15.
706
* struct vf_s_metric1: metric1 type. 13.
707
* struct vf_s_metric2: metric2 type. 13.
708
* VF_BITMAP: bitmap type. 15.
709
* VF_METRIC1: metric1 type. 13.
710
* VF_METRIC2: metric2 type. 13.
711
* VF_OUTLINE: outline type. 29.
712
* VF_OUTLINE_ELEM: outline type. 29.
717
File: VFlib-36.info, Node: Function index, Next: Program index, Prev: Data type index, Up: Top
725
* VF_ClearError: VF_ClearError(). 4.
726
* VF_CloseFont: VF_CloseFont(). 4.
727
* VF_CopyBitmap: VF_CopyBitmap(). 4.
728
* VF_DumpBitmap: VF_DumpBitmap(). 4.
729
* vf_error: vf_error. 4.
730
* VF_FreeBitmap: VF_FreeBitmap(). 4.
731
* VF_FreeMetric1: VF_FreeMetric1(). 4.
732
* VF_FreeMetric2: VF_FreeMetric2(). 4.
733
* VF_GetBitmap1: VF_GetBitmap1(). 4.
734
* VF_GetBitmap2: VF_GetBitmap2(). 4.
735
* VF_GetFontBoundingBox1: VF_GetFontBoundingBox1(). 4.
736
* VF_GetFontBoundingBox2: VF_GetFontBoundingBox2(). 4.
737
* VF_GetMetric1: VF_GetMetric1(). 4.
738
* VF_GetMetric2: VF_GetMetric2(). 4.
739
* VF_GetOutline: VF_GetOutline(). 4.
740
* VF_GetProp: VF_GetProp(). 4.
741
* VF_ImageOut_ASCIIArt: VF_ImageOut_ASCIIArt(). 4.
742
* VF_ImageOut_ASCIIArtV: VF_ImageOut_ASCIIArtV(). 4.
743
* VF_ImageOut_EPS: VF_ImageOut_EPS(). 4.
744
* VF_ImageOut_PBMAscii: VF_ImageOut_PBMAscii(). 4.
745
* VF_ImageOut_PGMAscii: VF_ImageOut_PGMAscii(). 4.
746
* VF_ImageOut_PGMRaw: VF_ImageOut_PGMRaw(). 4.
747
* VF_Init: VF_Init(). 6.
748
* VF_InstallFontDriver: VF_InstallFontDriver(). 4.
749
* VF_MakeScaledBitmap: VF_MakeScaledBitmap(). 4.
750
* VF_OpenFont1: VF_OpenFont1(). 4.
751
* VF_OpenFont2: VF_OpenFont2(). 4.
752
* VF_OutlineToBitmap: VF_OutlineToBitmap(). 4.
753
* VF_ReflectedBitmap: VF_ReflectedBitmap(). 4.
754
* VF_RotatedBitmap: VF_RotatedBitmap(). 4.
759
File: VFlib-36.info, Node: Program index, Next: Acknowledgments, Prev: Function index, Up: Top
766
* ctext2pgm: ctext2pgm. 5.
767
* vflbanner: A simple example. 5.
768
* vfldisol: vfldisol. 5.
769
* vfldrvs: vfldrvs. 5.
770
* VFlib3-config: A simple example. 146.
771
* vflmkcaptex: vflmkcaptex. 5.
772
* vflmkfdb: vflmkfdb. 5.
774
* vflserver: vflserver. 5.
775
* vfltest: vfltest. 5.