Files, saving and sharing

Where your designs live, how to back them up, which formats layerling imports and exports, and what is possible on a shared server.

Ten rozdział nie jest jeszcze przetłumaczony na polski. Poniżej tekst angielski.

Where your designs live

layerling saves everything in the browser on your computer. There is no account and nothing is uploaded. Every change saves itself. The preview picture on the start page shows the view you last had in front of you when you went back with „Ekran startowy”. If you open layerling in the same browser days later, everything is there.

If you go back to the start page from a design with nothing in it, layerling asks whether to keep it. „Tak” or Enter keeps it, „Nie” removes it, so empty designs do not pile up. Designs in a shared folder on a server are not asked about.

That has a downside: whoever clears the browser storage or switches to another computer loses the designs. So back up important work into a file.

Backing up and passing on

On the start page every design has a menu with the options to rename, duplicate and delete. With „Kopia zapasowa wszystkiego” you pack all designs into one single file. Through „Otwórz projekt lub zaimportuj geometrię” they come back, also in another browser or on another computer. The „Własne kształty” of this browser travel in the same file, in the folder Custom shapes, see Shapes.

You back up a single design in the editor: „Eksportuj”, choose the format LYL and click „Zapisz projekt layerling”. The LYL file is layerling's own design format and contains everything: shapes, groups, sketches, CAD data, imported sources and the history, meaning the undo steps. Under „Zapisana historia czynności” you choose how many of the last steps travel along; it starts at what the settings (the cogwheel in the ribbon) keep under „Historia”. The last stop, „Brak”, saves the design with its current state only - the way to share a file without its undo steps. The export is a copy under the „Nazwa pliku” you give it; the design in your browser keeps its history. Older .skf files from earlier versions can still be opened; they are then saved as .lyl.

Saving into your own folder (Chrome and Edge). There the button opens your system's save dialog, so you pick the folder and the name yourself, and an existing file can be replaced. Afterwards Ctrl+S saves the design into that same file again, without a dialog. A design opened from a .lyl file with „Otwórz projekt lub zaimportuj geometrię” or the open button of the export window saves back into that file, too. The browser may ask once for permission to change the file. After the page is reloaded the design forgets its file, and the next Ctrl+S asks for it again; the dialog starts in the folder you used last. Firefox and Safari do not allow a page to write into files like this. There the file is downloaded to the Downloads folder as before, and Ctrl+S downloads it again; Firefox can be set to ask for the folder each time under Settings, General, Downloads.

Exporting

Click „Eksportuj” or press Ctrl+E.

At the top is the file name, below it you choose the format. With something selected, only the selection is exported, otherwise the whole design. If the selection leaves out visible parts, a note in the window says so plainly, and „Zaznacz wszystko” selects everything visible in one click. Once the file is written, the window closes by itself; if the export fails, it stays open with the message.

STL into your own folder (Chrome and Edge). There the first STL export of a design opens your system's save dialog, so you pick the folder and the name yourself and can replace an existing file. After that every STL export of the design writes into that same file without a dialog; the export window shows which file, and Save as… next to the export button picks another. The dialog remembers its own folder, apart from the one for designs, so the slicer files can stay with the slicer. After the page is reloaded the design forgets its STL file and the next export asks again. Firefox and Safari download the file as before.

A hole you have not grouped is taken out of every body it reaches when you export, as the view shows it. So there is no need to group before each export. With a selection, only the selected holes count. A hole cannot be exported on its own; layerling points that out.

STEP only carries exact CAD bodies. What cannot be written exactly, such as a mesh imported as STL, is left out. The message after the export names those bodies and says why. For the printer, use STL or 3MF, which carry everything.

A drawing for the workshop

Choose the format 2D (hover over it and it says Drawing) and, below the file name, PDF or SVG. With something selected, only the selection is drawn, otherwise the whole visible design; holes you have not grouped still cut the parts they reach.

layerling draws the front, top and right-side views in first-angle layout (the right side to the left of the front view, the top view below it) on the smallest ISO sheet that fits, from A4 to A0, or a larger one if the part needs it. It is always at 1:1. Each view carries its overall width and height, and edges you cannot see are dashed. Round bores that run parallel to a view direction get a centre cross and a label (F1, T1, R1), and a table at the bottom lists their diameter and position, measured from the lower-left corner of the view. The title block in the lower-right corner holds the name, scale, units, date and sheet number. The words on the sheet follow the interface language.

Print at 100 % or "actual size", or the lengths will not match. What the drawing does not do: threads, depths, tolerances and bores at an angle are not dimensioned, and the sizes come from the model as a mesh, so they are nominal. A very detailed part (over 100,000 triangles) or more than 200 bores is refused with a message; choose fewer objects then.

The projection is based on the drawing work of Cadverix-3D by WC3D.

How much filament does it take?

For STL, 3MF, OBJ and STEP the „Materiał” box shows the volume, weight and length of 1.75 mm filament of what is exported. It counts like the file: visible bodies only, holes taken off, overlaps only once. On the right you pick the filament - PLA, PETG, ABS, ASA, TPU or PA (nylon) - and the weight follows its density. The volume is the body's own. Weight and filament are a rough estimate for a print with walls and infill: you set the „Wypełnienie” (15 % to begin with) and the „Ścianki” (2) under the heading, and the box says what it counted and what the same part would weigh solid. Your slicer's own settings decide the real number, so take it as a guide: good for comparing designs and for whether the spool will last. At 100 % infill the box counts the part as solid, the upper bound.

Importing

With „Importuj” or Ctrl+I you bring foreign files into the design.

• „Otwórz projekt layerling”: A layerling design (.lyl, or an older .skf) comes back as a new design.
• „Wstaw do tego projektu”: The bodies of a layerling design are added to the open one. Handy for basic shapes you need again and again: build them once, save them and bring them in every time.
• Add geometry: Drop STL, OBJ, 3MF, STEP or SVG files in the window or click to choose a file. Imported meshes can be turned, moved, cut with holes and built upon. An SVG comes in as a sketch body, one from a tracer such as picsvg.com or Inkscape's "Trace Bitmap" as well: its outlines become the lines and curves of a sketch, 4 mm high and reading from above as in the drawing. In the properties you set its „Wypełnienie”, an area or a stroke outside, inside or centred, and „Sylwetka (bez otworów)” leaves the holes out, see Sketches, "Fill and silhouette". You change the points themselves in sketch mode. Only a very intricate SVG with more than 2500 lines and curves comes in as a fixed mesh. A shape that cannot be built into a solid, such as an outline that crosses itself or touches itself at a point, is left out, and after the import layerling says how many there were. Then it helps to join overlapping pieces in the drawing program, close the outlines and save the file again. Drawings made on one page, such as the layers of one document exported as separate files, line up again when you switch on „SVG: zachowaj miejsce na stronie rysunku” in the import window before you import them: each keeps its place on the page, where otherwise each is centred on itself. A coloured OBJ or 3MF comes in as one body per colour, each in its place. In an OBJ the colours sit either in the file itself, as in an OBJ from layerling, or in an .mtl beside it. Select that one too, or import the whole ZIP the way Tinkercad hands out its OBJ. A 3MF carries its colours itself, and in a project from Bambu Studio, OrcaSlicer or PrusaSlicer each part takes the colour of its filament. A 3MF with several objects, such as a project with one object per plate, comes in as one body per object; modifiers, negative volumes and support blockers from the slicer are left out. Colour painted onto faces in the slicer is not read.

A design saved with a newer layerling may hold things your version does not know yet, such as a new shape, a new setting or fonts of one's own. If layerling cannot open it for that reason, the message names both versions. If it opens, the notice says that newer things may look different here. Either way, reloading the page helps: layerling.com always serves the newest version. The installed app picks it up the next time it starts; on your own server you install the update.

Template pictures are added in sketch mode, see Sketches.

Simplifying an imported mesh

A scanned or sculpted mesh often has far more triangles than its shape needs, and every one of them is carried along while you move, cut and save. „Uprość siatkę” in the Modify group (or in the right-click menu of the body) shows the mesh as it is next to what a chosen share of its triangles would leave of it; both views turn and zoom together with the mouse buttons of the workplane. Set how much to keep as a percentage or a number of triangles, and „Uprość” takes the lighter mesh. The result is a plain mesh: for the result of a cut or merge, „Edytuj grupę” and its original parts are given up.

Cutting, merging and intersecting an imported mesh is calculated in your browser, so the workspace settings limit how many triangles such a mesh may have („Tnij zaimportowane siatki do”). A mesh above the limit is not processed, and the message names its triangle count; simplify the mesh first, or raise the limit if your computer can take it.

Reporting a bug

If layerling does something unexpected, save a „Zgłoś błąd”: the link sits in the footer at the bottom, next to the forum. It is a ZIP file, because GitHub and many forums refuse a bare .lyl: inside are your design as a .lyl and a short text file with the version, browser, screen size, the last messages and any errors. The start page opens the ZIP like a backup, or you unpack it and open the .lyl. Nothing personal is in it. Attach the file to your post in the forum or on GitHub, so the problem can be followed with exactly your design.

If layerling stops with an error, a window with the error message shows instead of a blank page. From it you can save the state of the design last stored in the browser as a .lyl file, go back to the overview, or start a new design. The error message from the window and the saved file help when you report it.

Shared designs on a server

When layerling runs on your own computer or web server, it can offer a shared folder in which all users keep designs. On the start page it then appears as „Na serwerze”. You create folders there, move designs by dragging and search across the whole folder. A design that lives there saves itself back to it. A design from this browser goes onto the server by dragging its card onto the server tile, or with „Wyślij na serwer” in the card's menu. A backup you open lands in this browser first, like any design you open; put the designs on the server from there. The start page shows a design by its file name, so renaming a design, on its card or at the top of the editor, renames the file on the server too. Deleting a design or a folder removes it for good, together with its working copy in this browser. Custom shapes kept on the server sit in its folder Custom shapes, see Shapes.

Two things make that quicker: „Przenieś wszystkie na serwer” on the start page puts every design of this browser on the server in one go, and ticking „Nowe projekty na serwerze” makes every new design start in the server folder, so it is saved there from the first change on. The tick is kept in this browser. A design that cannot go - its name is taken on the server, say - stays in the browser, and the message says how many.

That is not simultaneous editing: whoever opens a file works on a copy of their own. If somebody else has changed the file in the meantime, layerling refuses to overwrite it.

On layerling.com this function is not switched on. How to set it up on your own server is described in the README on GitHub.