<pagelist> section

Context:

<pages width="1024" height="600">
    <pagelist>
        <page>
        ...
        </page>
        <page>
        ...
        </page>
    </pagelist>
</pages>

The <pages> section has two available attributes. These define the width and height in pixels that the pages in the XML file are designed for. You would typically keep all of the coordinates within the bounds defined by these two values but the page will in fact be drawn without error if any gauges go outside of those bounds. You just won’t see them unless you translate the page with the ‘translate live’ console command.

At boot time SDC examines the monitor’s resolution (which originates from the Pi firmware or from the config.txt file depending on your monitor) and it uses the width and height from the XML file to scale the page so that it should all be visible. The page will be scaled using the GPU so that the pages fit within the screen. Aspect ratio will be maintained. If width and height are not provided, then no scaling will occur.

You should design your pages so that no scaling is required (i.e. the page width and height are the same as the monitor’s resolution). The scaling is really there so that if you load an XML file designed for a different resolution then it will be displayed in full.

The <pagelist> section represents a set of pages, where each page is separately defined as per the structure above. Each page in turn is a collection of gauges.

The pagelist itself has no attributes, it only consists of a collection of <page> entries. See the <page> section for details of how pages are constructed.