14.3 Ipe object elements14 The Ipe file format14.1 The elements of an Ipe XML file14.2 The page element

14.2 The <page> element

The <page> tag has the optional attributes gridsize, title, section, and subsection. The gridsize indicates the last grid size used on this page--Ipe remembers this as it is often advantageous to have the same grid available that was used when making the page. The title is displayed on the page in a format described in the style sheet. The value of section and subsection is the title of a section starting on this page. If the attribute is not present, this page continues the section of the previous page. If the attribute is present, but its value is an empty string, then the contents of the title attribute is used instead.

The contents of the <page> element consists, in this order, of possibly empty sequences of <layer> elements, <view> elements, and Ipe object elements.

The <layer> tag takes a required attribute name, and two optional attributes visible and edit. The name has to be unique within the page, and must not contain spaces. If the value of visible is dim, the layer is displayed dimmed on the screen (not in the PDF output). The value of edit should be yes or no and indicates whether the user can select and modify the contents of the layer in the Ipe user interface (of course the user can always modify the setting of the attribute). The layer element must be empty.

If a page contains no layer element, Ipe automatically adds a default layer named "alpha", visible and editable.

The <view> tag takes a required attribute layers, and three optional attributes, duration, transition, and effect. The value of layers must be a sequence of layer names defined in this page, separated by white space. The value of duration and transition must be a real number, the value of effect must be an integer between 0 and 16 (see IpeView::TEffect for the exact meaning of those). The parameters translated directly into the page transition effect in PDF.

It is okay for a page not to contain any <view> element. Such a page will be saved to PDF including all its layers, with no special effect.

The remaining elements of the <page> are Ipe objects.


14.3 Ipe object elements14 The Ipe file format14.1 The elements of an Ipe XML file14.2 The page element