NAME

wdmerge − filter for merging xwd image data with ditroff intermediate files

SYNOPSIS

wdmerge  [scale]

DESCRIPTION

wdmerge is a filter used for merging xwd format image data with ditroff intermediate files.  wdmerge accepts ditroff intermediate files as input, places specified image data in locations marked by transparent throughput escape sequences in the file, and writes its output on the standard output. 

Image data can be enlarged from 2 to 4 times while being merged to make up for differences in resolution between display monitors and printers. 

Specifying Image Merges in ditroff Source Files

Include an escape sequence such as that shown below anywhere within the ditroff source file corresponding to the page on which you wish the specified image to appear. 

\!H850V2500
\!Dw image.xwd 1 3

The first line: H850V2500, the postion on the page at which to align the upper left corner of the image. This is measured from the left (H850) and from the top (V2500). The units used are umt. 157 umt (at 400 dpi; 2.54 cm/inch) is approximately 1 cm on the printed page when using a 400 dpi NEWS laser beam printer.

The second line: image.xwd, specifies the name of the image file to be merged.  Next follows the border and enlargement ratio specifications.  If a value other than 0 is used for the border a border is placed around the image.  The enlargement ratio can be specified anywhere in the range 1 through 4. 

Example

This example shows how to merge an image with ditroff output and display the results on X using the previewer xprev. 

% ditroff -ms draft | wdmerge | xprev

Enlargment Ratio

If no enlargement ratio is specified within the ditroff source file, a value can be specified from the command line specifying [scale] value and passed to wdmerge.  If no specification is given, the default ratio used is 2. 

Each dot printed on a 400 dpi NEWS laser beam printer to represent image data has a diameter of the following dimensions depending on the enlargement ratio used. 

RatioDiameter
1 x0.00635cm / dot
2 x0.0127cm / dot
3 x0.01905cm / dot
4 x0.0254cm / dot

BUGS

A value of 1 must be used for both the depth of the image data (pixmap_depth) and the number of bits per pixel (bits_per_pixel).  In addition, the MSBFirst must be used for both the byte order (byte_order) and bit order (bitmap_bit_order) for the XWD file header. 

If the visual class is GrayScale, wdmerge does not look at the color map and assumes that any bit set to 1 is black. 

FILES

/usr/include/X11/XWDFile.h

SEE ALSO

ditroff(1), xwd(1X), xwud(1X), xprev(1X)

NEWS-OSRelease 4.1C