List the built-in page/mat presets (name -> width/height in mm). These are page sizes, not the exact cutting area of the machine; keep a safety margin.

Create an empty design (the working canvas). Use a preset (see silhouette_list_page_presets) or give custom width_mm AND height_mm (they override the preset). cut_margin_mm is a safety margin used only for warnings. Fails if the design exists unless overwrite=true.

List the designs saved in the output folder along with exported files if any.

Get the full raw JSON data of a design, including all shapes and canvas properties.

Delete a design file. If delete_files=true, also removes any exported .dxf, .svg and .png files.

Remove all shapes from a design without resetting page dimensions.

Add a rectangle whose top-left corner is at (x_mm, y_mm). corner_radius_mm > 0 rounds the corners (clamped to half of the smaller side). rotation_deg rotates clockwise around the rectangle center. layer defaults to 'CUT' (or 'SCORE', 'PERF').

Add a circle centred at (cx_mm, cy_mm). Exported as a true DXF CIRCLE.

Add an ellipse centred at (cx_mm, cy_mm) with radii rx_mm (horizontal) and ry_mm (vertical), rotated clockwise by rotation_deg.

Add a regular polygon (3-64 sides) inscribed in a circle of radius_mm, centred at (cx_mm, cy_mm). With rotation_deg=0 one vertex points up.

Add a star with the given number of points (3-64). inner_radius_mm must be smaller than outer_radius_mm (about 40% gives a classic star). With rotation_deg=0 one tip points up.

Add a straight line between (x1_mm, y1_mm) and (x2_mm, y2_mm). If dashed=true, creates perforated segments ideal for folding cardstock/papercraft. dash_len_mm: cut segment length (default 3mm); gap_len_mm: un-cut gap length (default 2mm). layer: 'CUT', 'SCORE', 'PERF', etc.

Add a custom path through the given [x, y] points (in mm, Y down). closed=true makes a closed shape (>= 3 points); closed=false makes an open line (>= 2 points).

Convert text into vector cut/score outlines using a system/custom TTF/OTF font (or built-in geometric vector fallback) and add the glyph contours to the design. x_mm, y_mm mark the top edge anchored horizontally by align ('left', 'center', 'right').

Move (dx_mm, dy_mm), scale, rotate, and optionally mirror (flip_x, flip_y) an existing shape by its id. Scaling, flipping and rotation are centred at the shape's bbox center.

Create a new inward (< 0) or outward (> 0) offset contour from an existing circle or closed polygon (ideal for print-and-cut bleed borders, shaker frames and layered mats). join: 'round', 'miter', or 'bevel'.

Duplicate an existing shape count times, offsetting each consecutive copy by (dx_mm, dy_mm).

Arrange copies of an existing shape in a 2D cols x rows matrix (sheet nesting). The original shape occupies cell (0, 0) and (cols * rows - 1) copies fill the remaining cells.

Optimise 2D rectangular sheet nesting (MaxRects Best Short Side Fit) to pack shapes inside the usable cutting area with zero overlap and guaranteed spacing_mm clearance. Automatically skips and avoids any REGMARK registration marks on the page. Set dry_run=true to compute placement metrics without modifying shape coordinates.

Add standard Silhouette Print & Cut 3-corner registration marks (top-left square, top-right L-bracket, bottom-left L-bracket) on layer 'REGMARK'.

Generate a ready-to-cut parametric packaging / papercraft template with CUT and SCORE layers. Supported templates: 'milk-box-luxo', 'milk-box', 'cube-box', 'pillow-box', 'gift-tag'.

Read an SVG file from disk, convert outlines (curves flattened to mm segments) and add them to the design for DXF export. This bridges SVG artwork into Silhouette Studio Standard Edition (which cannot open SVG natively). target_width_mm / target_height_mm > 0 scale artwork (uniformly if only one is given); artwork's top-left corner is placed at (x_mm, y_mm). Text and embedded images are skipped (convert text to outlines or use silhouette_add_text).

Summarise a design: page size, every shape with its bounding box, overall bounds and any warnings (outside the page, inside the safety margin, tiny details).

Remove one shape (by the id shown in silhouette_describe_design).

Export the design to cut/preview files in the output folder. formats is a comma-separated list of 'dxf', 'svg', and/or 'png'. DXF is required for the free Standard Edition. filename (optional) overrides the base file name. Returns file paths, bounds and warnings.

Render a colour-coded PNG preview of the design (with 10 mm grid and safety margin) for visual inspection before cutting. Returns the PNG path, pixel dimensions and warnings.

Create and export a calibration DXF: a 100 x 100 mm square with a 50 mm circle, a 40 x 20 mm rounded rectangle, and a 100 mm perforated score line. Open it in Studio and measure it: if the square is not 100 mm (3.937 in), set Studio Preferences > Import Options > DXF to 'As-is'.

Open a cut file previously exported (.dxf or .svg) directly in Silhouette Studio. Accepts full paths, paths relative to the output folder, or just design/file names. Set reveal_in_explorer=true to also select the file in Windows Explorer.