The sets of layers a reader offers
Offer named sets of layer states beside the one the document opens under, so a reader can switch between them.
Summary
A drawing carrying its plumbing, its wiring and its walls on separate layers is read differently by each trade. A set is a named arrangement of those layers — « Plumbing », « Wiring » — that a reader offers in its own panel: one click and the drawing is the one that trade needs. The document still opens on the arrangement it states for itself.
Technically
Written at the top level of a request, under
"layer_configurations"
layer_configurations writes the alternate configurations of the document's optional content: one per named set, each listing the declared layers it shows. A set naming none shows none. The configuration the document opens under is the one the layers themselves state; these stand beside it, in the order they are written.
Request schema
-
layer_configurations— array, optional, empty by default. -
layer_configurations[].name— string, required. What a reader's panel offers the set under. -
layer_configurations[].shows— array of strings, optional, empty by default. The declared layers the set shows; every other declared layer is hidden in it.
A name a reader offers is shown to somebody reading, so it is worth writing in the language of the document rather than in the words the request uses for its layers.
A whole request that draws it
{
"layers": {
"walls": { "name": "Walls" },
"wiring": { "name": "Wiring" }
},
"layer_configurations": [
{ "name": "Wiring only", "shows": ["wiring"] },
{ "name": "Everything", "shows": ["walls", "wiring"] }
],
"standard_fonts": [{ "name": "sans", "face": "helvetica" }],
"items": [
{
"type": "text",
"rect": { "llx": 60, "lly": 740, "urx": 535, "ury": 765 },
"content": ["A drawing a reader can show one trade at a time"],
"font": "sans",
"font_size": 14
}
]
}
What is drawn, and how it comes out
Everything that can be drawn on a page The file's weight and the time it takes Sheets a reader shows or hides A name that stands for several layers at once A drawing made once, shown by a button
Where to go next
Every key of a request, in one page The other forty-one settings of a request