Content-type: text/html Manpage of SAVE

SAVE

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

NAME

SAVE - Save the current file or device to disk  

SYNOPSIS

SAVE <newname>  

DESCRIPTION

Saves the current drawing to a file. Currently files are saved in the directory "./cells" with the the name and extension of <cellname>.d. Later versions of PD Piglet will add a search path to give flexibility for the directory used. If <newname> is given, the current cell is saved (duplicated) to the file "./cells/<newname>.d". In this case the current drawing is still marked modified and will cause an error message if an attempt is made to exit the editor before saving the current drawing.

The SAVE file is a human readable transcript of the exact commands that you typed and moused to create the cell in the first place. You can edit this file (carefully) and the textual changes will take effect next time you start a new Piglet and read in the definition. The "<cellname>.d" file contains the definition of the cell <cellname>. If <cellname> includes other cells, they will only be called by name in <cellname>.d and will not be defined unless the program can find the corresponding ".d" files. In other words, if you mail a friend a ".d" file, they will be unable to reconstruct your cell if it has any hierarchy. If you want a full, self-contained definition of your work, then you should use the "ARCHIVE" command which defines every cell used in a given drawing.

If there have been any NONAME instances created with the WRAP command, they will be automatically smashed when the device is written to disk. The wrapped instances will still remain in memory, however, so a given device may be written multiple times without destroying the temporary hierarchy created with the wrap command. When the editor is finally closed, all NONAME instances will be permanently lost.

Most commands may be terminated by typing either an EOC or the name of another command. SAVE is an exception to this rule. In the event that the user accidently types the SAVE command more than once, Piglet will quietly ignore the extra SAVE commands. This prevents a command like "SAVE SAVE <a_new_cellname> EXI" from erroneously saving to the current cell in addition to <a_new_cellname>.d.

 

SEE ALSO

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
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 19:41:46 GMT, May 14, 2010