To use the functions described in this section, you will need to load
(geda page) module.
page is associated with a filename. The filename
does not necessarily have to be a file which exists and/or is
accessible in the filesystem.
Creates and returns a new, empty
page, with the given string filename.
Destroys page. The returned value is undefined.
Warning: This function closes and destroys page immediately, regardless of whether the page has been modified since loading or saving, and without asking the user.
Pages can be converted to and from strings in the gEDA schematic file format.
Parses string, which should be in the gEDA file format, to create a new
page. The initial filename for the new
Warning: Due to missing functionality in the underlying C library, this
string->pagecannot currently report invalid syntax or other problems in the string passed.
A schematic or symbol
page is composed of a set of
objects which determine both its graphical appearance and its
Returns a list of the
objects which make up page. The list can be freely modified without changing the contents of page.
Appends zero or more objects to the contents of page in the order given. Returns page.
If any of the objects is already part of a
pageother than page, or is part of a component
object, raises an
object-stateerror. Any of the objects that are already in the page are ignored.
Removes zero or more objects from the contents of page. Returns page.
Any objects that are not part of a
An ‘object-state’ error will be thrown if any of the objects satisfies any of the following conditions:
- part of a
pageother than page;
- part of component
- has attached attributes (see Attributes);
- is attached as an attribute.
pagewhich contains object (either directly or indirectly), or ‘#f’ if object is not part of a
Note: If the object argument to
object-pageis part of a component
objectwhich is itself part of a
pagewill be returned.
page has a dirty flag that is used to indicate to
applications that the
page has been modified since it was last
loaded or saved.
Returns ‘#t’ if the page's page has been marked as dirty; otherwise, returns ‘#f’.