Your own libraries¶

This is the part of the app for people who want to twist SimpleDiagrams to their own machinations. If that's you, read on. If not, you can safely skip this page forever.

Making a library¶

Click the books icon at the top of the Library panel and choose New Library…. You get the Edit Library sheet on Library Settings. The Library Name field is ready for you to replace the suggested name.

Type the name, then start adding artwork.

Adding artwork¶

Add Artwork… accepts SVG files, ordinary images (PNG, JPEG), and native SimpleDiagrams vectors. Up to 32 files at a time. You can also just drag files into the sheet. An empty library shows a drop hint in the Shapes sidebar while Library Settings is open.

Each SVG asks the same question as dropping one on the canvas: Keep as SVG Artwork or Convert to Editable Shape. See Importing artwork for what each one means. When you add several SVGs at once, tick Use this choice for the other SVG files to answer once for the lot. An SVG that can't be converted still asks, so you can keep it as artwork. Cancel adds nothing from that batch.

Select a shape in the library window. Details shows its name, artwork type, keywords and size. Appearance holds its starting colours and line style. The editor shows:

Per-shape actions live in the ⋯ (Shape Actions) menu below the Shapes list: Copy Shape, Paste Shape, Replace Artwork… and Delete Shape. You can also right-click (or Control-click) a shape in the list for the same commands, press Del to delete the selected shape, and use Cmd+C and Cmd+V to copy and paste shapes while the list is selected.

To remove a shape, select it and press Del (or choose Delete Shape), then Save. Until you save, Cancel brings it back. Shapes in a library you downloaded can be copied but not deleted or replaced; use Duplicate Library… to make your own copy.

Appearance¶

Select a shape's Appearance tab. Turn on Custom Default Paint to choose how the shape starts out. Pick a Fill and Stroke colour with the chip, or type a hex value such as #4E97D2 in the field beside it. Line Width takes a number from 0 to 100. The two texture menus add a pattern to the fill or the line. The preview on the right shows the shape with your choices as you make them.

These are only starting values. Every placed shape can still be recoloured on the canvas, and changing them here doesn't recolour shapes already in your diagrams.

Connection points¶

This is the bit that turns a picture into a proper diagram shape.

The Connection Points tab lets you place the spots where connectors will attach. Drag a point to move it. Double-click the picture to add one where you clicked, or click Add Point to put one in the middle. Shift-click a point to remove it, as you would on a connector; while you hold Shift, each point shows a red ✕ to warn you. Delete Point also appears beside Add Point while a point is selected. Default Points goes back to the standard ring around the edge.

Custom points are saved in the .sdlibrary package and copied into each new shape you place. You can define up to 128 points per shape. Editing a placed shape's points changes only that instance, leaving these library defaults unchanged. See Changing a shape's connection points for the canvas editing workflow and its Undo behavior.

Standard points are fine for a box. For anything with a distinct shape — a cylinder, a person, an arrow — putting the points where the artwork actually has edges makes a real difference.

Text region¶

On the Text Region tab, turn on Custom Text Region to choose where typed text sits inside the shape. Drag a corner of the outlined area to resize it, or drag inside it to move it. Turn it off to go back to the standard position.

Only shapes with editable vector artwork can hold text. Other artwork shows a short message instead.

Turning a drawing into a library shape¶

You don't have to start in the Edit Library sheet. Draw something on the canvas with the Polyshape tool, select it, right-click, and choose Add to Library….

Give it an Item Name, pick which Library it goes in, and click Add.

This only works for a single selected closed path — the app needs a shape, not a sketch.

Editing a library later¶

Click the books icon on the library's heading and choose Edit Library…, or use books menu ▸ Edit Library ▸ pick the library. Same sheet, same controls. Nothing is saved until you click Save.

Duplicating, exporting, sharing¶

From the library's heading menu (Duplicate and Export) or the books menu:

• Duplicate Library… — your own editable copy, named “(user copy)”.
• Export Library — writes a .sdlibrary package to send to someone.

See Using libraries for importing on the other end.

Inspecting what you've got¶

Select a single shape on the canvas and choose Edit ▸ Inspect Selected Artwork… to see its size, ID, format and licence facts. If something's gone missing or is only an approximation, that dialog also offers Replace Artwork….

Right-clicking a shape in the Library panel gives you Inspect Artwork… for the same information about the library item itself.

Limits¶

If you're anywhere near these, I'd genuinely like to hear what you're building.