Content-type: text/html; charset=UTF-8 Man page of DUMP

DUMP

Section: PD Piglet Users Manual (1P)
Updated: PD Piglet Users Manual
Index Return to Main Contents

NAME

DUMP - Dump the graphics window to a file

SYNOPSIS

DUM [:F][:R][:T{bmp|gif|jpg|png|pgm|ppm|xbm}] <plotname> <EOC>

DESCRIPTION

The DUMP command creates a dump of the current graphic window in the file "./<plotname>.<suffix>". If <plotname> is not specified, the name of the current cell will be used instead. DUMP internally creates a raw netpbm (http://netpbm.sourceforge.net/) ppm-formatted image file, but is able to call external netpbm routines to convert the output to several other popular formats. The format can be changed with the :T option to be one of: .bmp, .gif, .jpg, .pgm, .png, .ppm or .xbm. The default format is .png.

For most purposes, the .png format produces the smallest file size. Dumping the demo file "PLAN" resulted in a 1-megabyte .ppm, a 60k .jpg, a 10k .gif, and a 5kbyte .png file. PNG provided a 200:1 compression over the raw PPM file!

Remember that Piglet's command-line options do not allow blank space, so ":Tgif" works, while ":T gif" is an error.

The :R option swaps black and white pixels saving lots of black ink for dumps that will be printed out on paper.

IMPLEMENTATION DETAILS

Other image-file types can be easily added to the source code of the com_dump() routine if a suitable conversion program can be found.

OPTIONS

:F

Fit the device before dumping the window. After the dump, the previous window settings are restored.

:R

Reverse video: swap black and white pixels in the dumpfile to save ink.

:T<image_type>

Select various output image formats using one of

    :Tbmp       Microsoft Windows or OS/2 Bitmap format
    :Tgif       Graphics Interchange format
    :Tjpg       Joint Photographic Experts Group format
    :Tpgm       Portable Grey Map format
    :Tpng       Portable Net Graphics format
    :Tppm       Portable Pix Map format
    :Txbm       X11 windows bitmap format

piglet(1p) add_arc(1p) add_circle(1p) add_instance(1p) add_line(1p) add_note(1p) add_oval(1p) add_polygon(1p) add_rectangle(1p) add_text(1p) archive(1p) area(1p) background(1p) bye(1p) change(1p) copy(1p) date(1p) define(1p) delete(1p) display(1p) distance(1p) dump(1p) echo(1p) edit(1p) equate(1p) exit(1p) files(1p) fsize(1p) grid(1p) group(1p) help(1p) identify(1p) input(1p) interrupt(1p) layer(1p) level(1p) list(1p) lock(1p) macro(1p) menu(1p) move(1p) plot(1p) point(1p) process(1p) purge(1p) quit(1p) redo(1p) retrieve(1p) save(1p) search(1p) set(1p) shell(1p) show(1p) smash(1p) split(1p) step(1p) stretch(1p) trace(1p) tslant(1p) undo(1p) units(1p) version(1p) window(1p) wrap(1p) memory(1p) time(1p)

AUTHOR

Rick Walker (walker AT omnisterra DOT com)

The PD Piglet homepage is at http://www.omnisterra.com/walker/linux/piglet/intro.htm.

Index

NAME

SYNOPSIS

DESCRIPTION

IMPLEMENTATION DETAILS
OPTIONS

SEE ALSO

AUTHOR

This document was created by man2html, using the manual pages.
Time: 23:02:03 GMT, May 05, 2026