* Sketch: an ellipse comes with its axes, and D measures its half-axes An ellipse could only be sized by its minor radius, drawn like a circle's radius, and there was no way to give its full axes. sketch.ellipse now also adds the major and minor axes as construction lines through the centre. The major axis runs from the major end to the point opposite it; the minor one is perpendicular to it, ends on the ellipse, and both are bisected by the centre. That adds six coordinates and six equations, so the ellipse keeps its five degrees of freedom, and it needs no new constraint kind and no format change. With the axes in place every ellipse size is an ordinary dimension. D on an axis line gives its length, the whole axis. D on the outline gives a half- axis, the distance from the centre to an axis end, chosen the way a line chooses horizontal or vertical but in the ellipse's own frame: text pulled across the major axis measures along it (the major half-axis), text pulled out past an end of it measures across it (the minor one). The end on the text's side is used. Near the boundary between the two, a dimension being placed keeps the half-axis it had (sketch.dimension's previous_axis, which the Dimension tool sends), so the preview does not flip. A half-axis and its whole axis determine each other, so the second becomes a driven dimension through the existing redundancy path. Deleting the ellipse leaves its axes, as deleting a Center Rectangle's edges leaves its construction diagonals. Ellipses without axes, from existing designs, keep the minor radius as before, and type radius still gives it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Guide: an ellipse's axes and half-axis dimensions Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: test that an ellipse's half-axis preview keeps its axis near the boundary The Dimension tool sends the half-axis its last preview chose, so near the boundary between the major and the minor half-axis the preview keeps it. This covers that path from the tool, from both sides of the boundary. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: an ellipse's axes select and drag with it, as a rectangle's diagonals do A double-click on a Center Rectangle's edge or diagonal selects its edges and both diagonals, and dragging a diagonal moves the rectangle without changing it, because its lines share corner points. An ellipse's axes are held by constraints instead, so a double-click selected only the ellipse (and Delete then left the axes behind), and dragging the major axis moved the ellipse but stretched its minor half-axis. Sketch::ellipse_axes now finds an ellipse's construction axes (the detection sketch.dimension already used, moved into the sketch crate). Sketch::chain treats an ellipse and its two axes as joined, so a double-click on any of them selects all three. Dragging either axis moves the ellipse and both axes as one, keeping both half-axes. Dragging the outline still sets the minor half-axis. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: a corner test reads its line's id instead of assuming l1 sketch.ellipse now adds two axis lines, which take the first line ids, so the extend test reads the id of the line it draws from the reply. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: an ellipse's axes cut a trim, as a Center Rectangle's diagonals do Trim, extend and break take every other curve as a cutter, construction lines included, so an ellipse's construction axes stop them as a Center Rectangle's diagonals do. A test now states it for both shapes, and the guide says it. The freeform cutter test keeps the axes it used to delete and asserts the piece a trim removes: from where the major axis crosses the circle to where the ellipse does. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: test dragging an ellipse's outline with its axes present Dragging the outline sets the minor half-axis, and the minor axis line, held on the ellipse at one end, follows it; the centre and the major half-axis stay. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: other dimension types on an ellipse with axes keep the minor radius Only auto, major and minor give a half-axis on an ellipse drawn with its axes. Any other type (radius, diameter, horizontal and the rest) gives what it gives on an ellipse without axes, as the parameter doc says, instead of quietly becoming a half-axis chosen by the text. The arm for a missing text_at is dropped: with no text the rule already picks the minor half-axis. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: test an ellipse's half-axis dead zone from the major side too The tests only showed a previous minor half-axis being kept near the boundary; the point they used on the major side is major by geometry alone. A point inside the band where geometry says minor now shows a previous major half-axis kept, in the engine and in the Dimension tool's preview. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: a placed ellipse half-axis is the one its preview showed On an ellipse already sized, a half-axis is added as a driven dimension on the click, and that command left out the half-axis the preview kept near the boundary, so the click could place the other one. It now passes it as the preview does. The remembered half-axis also comes only from a draft whose text was placed (one without text is the minor half-axis by default and biased the first placement), is kept per sketch as well as per picks, and is forgotten once a dimension is placed or the picks are cleared. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: say how an ellipse's axes are recognised and what that costs The axes are read from the constraints, with no mark in the design, so the doc comment says which lines count, that deleting the midpoint or point-on-curve constraint leaves an ellipse without axes, and that each lookup scans curves times constraints. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: an ellipse with one axis deleted still picks its half-axis by the text With one construction axis deleted, D on the ellipse fell back to the minor radius wherever the text was pulled, because the half-axis choice needed both axes. It now reads what is left of them and chooses as before: the major half-axis goes to the major end (also from the far side, when the point opposite is gone with its line), the minor one to its axis end, or as the minor radius when the minor axis is the one deleted. An ellipse with neither axis keeps the minor radius. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: the one-axis half-axis test checks what is measured to The test for an ellipse with one axis deleted checked only the reply's axis and value, which both ends of an axis give alike. It now checks the dimension's kind and end: the axis end on the text's side, the major end from either side once the point opposite is gone, a radius once the minor axis is. With the major axis deleted and no text the reply names the minor axis and measures to its end, where it used to be a radius with no axis named. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: an ellipse's minor radius is drawn as its half-axis, without R A radius on an ellipse is the minor half-axis, and it was drawn as a circle's radius: one leader from the centre towards the text, marked R, which measures nothing a reader can see. It is now drawn as the distance from the centre to the minor axis end on the text's side, the way the half-axis is drawn while the ellipse has its axes, and labelled with the length alone. This is what D gives once the minor axis line is deleted, and on an ellipse with no axes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: an ellipse's half-axis keeps a radius's stored text The half-axis frame read the stored text from the middle of the half-axis, so a radius placed on an ellipse in an existing design would show its text somewhere else. The text is stored from the centre again, as a radius's always was, and the side drawn to follows it. An unplaced one sits where a linear dimension to the minor axis end puts its text, and stacked texts step out from the centre as a radius's do. A view test reads the painted label, so the drawing cannot go back to R unnoticed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: an ellipse moved, turned or scaled takes its axes along Move, Sketch Transform and Scale moved only the curves picked, so an ellipse moved without its axes left them where they were: its centre no longer halved them, the minor end left the ellipse, and the sketch stayed unsolved. A Center Rectangle's diagonals share its corners and always go along; an ellipse's axes share only the major end. The axes now go with the ellipse, as they do when it is dragged. Copy is unchanged: it copies no constraints, for a rectangle either. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: a preference draws ellipses without their axes, as before Drawing an ellipse with its construction axes changes what the Ellipse tool makes out of the box, so the old ellipse stays one setting away: Preferences › Sketch › Draw ellipses with their axes, on by default. Off, the tool draws the ellipse alone. sketch.ellipse takes axes: false for the same, and keeps drawing the axes when it is not given. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: sketch.ellipse refuses an axes value that is not true or false A string such as "false" was read as not given, so the axes were drawn; it is now refused as the text commands refuse a non-boolean bold or italic. The move test also covers an ellipse whose minor axis was deleted: the major axis left goes along. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: D picks a half-axis on an ellipse without axes too An ellipse with no axis lines (both deleted, a mirrored copy, one from an older design) gave the minor radius wherever the text was pulled, so its major half-axis could not be dimensioned on it. The half-axis is now chosen by where the text is on every ellipse: the major one to the ellipse's own major end, the minor one as its minor radius. With no text it is the minor radius, as before. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: with one half-axis dimensioned, D on the ellipse gives the other D on an ellipse chose the half-axis by where the text was pulled even when that half-axis was already held by a dimension, so the second D usually guessed the one already there and was refused as over-constrained. With a driving dimension already on one half-axis (to an axis end, the minor radius, or the whole axis along its line or between its ends), D with no type now gives the other, in either order and with or without the axis lines. With both held it chooses as before; an explicit major or minor is kept. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: the held half-axis rule is documented and its cases tested The Dimension command's parameters and the guide now say that with one half-axis held, D on the ellipse gives the other. Tests cover the whole axis held as a distance between its ends and as its line's length with the other axis deleted, and check that a mirrored ellipse has no axes. The placement test undoes its first dimension, so its second half still tests where the text is rather than the held half-axis. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: Transform previews an ellipse with its axes OK in Sketch Transform moves, turns and scales an ellipse's axes with it, but the window drew where OK would leave only the picked curves, so the axes stayed put in the preview until OK. An ellipse picked alone is now drawn with the axis lines it has. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: the typed-radius ellipse test counts the ellipse's axes Main's #10282 test drew an ellipse with typed radii and expected one curve; with the ellipse_axes preference on by default the tool also draws the two axes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: an ellipse's remaining axis still drags and selects it With one axis deleted, dragging the other axis did not hold the ellipse (with the minor axis left, the drag squashed it), and a double-click on the ellipse or that axis selected only the one curve. The drag and Sketch::chain now read whichever axes are left through ellipse_axis_lines, as Transform and Move already do. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: drop the unreachable third arm of the held half-axis check A distance from the centre to the major end or the point opposite it is already matched by the first arm, so the third arm and its major_end closure never ran. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: D on an ellipse's axis line is the whole axis wherever the value is pulled An axis line took the free line's rule, so on a turned ellipse a value pulled beside or above the box the axis spans gave its horizontal or vertical distance. An ellipse's axis is a construction axis, so auto now always gives its length, which the held half-axis check already counts. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: an ellipse's axis is never a side of a Fillet or Chamfer corner A line drawn from an ellipse's major end shares that point with the major axis, so Fillet or Chamfer there took the two as a corner (two lines skip the construction filter) and rounded the line into the axis. The axes are left out of a corner, picked by its point or as a and b. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: test the move reply, extend and the one-axis Transform preview for ellipse axes The reply of sketch.move, sketch.transform and sketch.scale lists the axis lines, Extend stops at an axis, and Sketch Transform previews an ellipse with the one axis left after the other was deleted. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: with Draw ellipses with their axes off, D on an ellipse is its minor radius as before The preference brought back the old drawing only; D on an ellipse had changed with no way back. sketch.dimension takes half_axes (default true, refused when not true or false); false makes auto on an ellipse the minor radius wherever the text is. The Dimension tool and the context menu's Sketch Dimension pass it from the preference, and with it off a radius on an ellipse is drawn and labelled R as before. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: read an ellipse's axes in one pass over the constraints ellipse_axis_lines scanned every constraint for every curve, so 500 ellipses with their axes (1500 curves, 2000 constraints) took 1.6 s to read and Move on all of them 2.0 s. It now collects the lines the centre bisects first: 3 ms and 0.36 s. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: the dimension and corner parameters say how an ellipse's axis lines take part Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Preferences: Draw ellipses with their axes says D gives the minor radius when off Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: ask only the ellipses centred on a line's midpoint whether it is their axis is_ellipse_axis read every ellipse's axes to answer for one line. An axis is bisected by its ellipse's centre, so it now asks only the ellipses centred on a point that bisects the line. The answer is the same. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: a horizontal or vertical dimension across a level major axis holds it for D on the ellipse half_axes_held counted a distance, a length and a radius, but not a horizontal or vertical dimension across the major axis, which is its length when the axis lies that way. D on the outline could then take the held major half-axis and be refused as determined; it now gives the minor one. Across a slanted axis such a dimension is only a projection and does not count. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Dimension: a draft on an ellipse is drawn with the axes preference it was made with The frame read the preference as it is now, while the dimension added is the draft's. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: a horizontal or vertical dimension across an upright minor axis holds it too Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: drop the unused Sketch::ellipse_axes; ellipse_axis_lines says how the axes are read Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: an ellipse's own axes do not cut it, so Trim takes a lone ellipse whole and stops at real crossings Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: Fillet and Chamfer offer no corner at an ellipse's axis end, as the engine takes none Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: a deleted ellipse leaves its centre on its axes, as a Center Rectangle's centre stays Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: ellipse axis docs say what they do, and the corner picker tests a curve's ends before its axis role Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: the trim-at-a-crossing test checks that part of the ellipse is left Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: an ellipse axis moved, turned or scaled on its own takes its ellipse along, as a drag does Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: a selection dragged by an ellipse axis takes the ellipse along, as the axis alone does Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Docs: the Sketch preferences page lists Draw ellipses with their axes Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * Sketch: the ellipse axes help text says D gives the minor radius, drawn and labelled R as before, wherever the value is pulled Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
38 KiB
Sketching and constraints
A sketch lies on a plane: an origin plane, a construction plane or a planar face. Start one with
Create Sketch (sketch.create) and click a plane, or pick a face first. Right-clicking a
plane, in the view or on its browser row, offers Create Sketch on that plane too.
While Create Sketch waits for its plane, the origin planes are shown, and the plane under the
pointer (in the view, or its row in the browser) lights up and takes the grid, so you see which
plane the sketch will lie on before you click.
Finish Sketch returns to the model. Cancel Sketch (sketch.cancel) returns without
keeping what changed since the sketch was created or opened for editing: a new sketch is removed,
an edited one goes back to how it was, as one step that Undo brings back.
Opening a sketch turns the view to face it; to keep the view as it is and face the sketch only with Look At, turn off Preferences › Sketch › Turn to face a sketch when it opens. When the sketch ends, the view stays where it is by default. Preferences › Sketch › When a sketch ends changes that: Return to the previous view goes back to the view from before the sketch, and Return unless rotated goes back only when you panned or zoomed the sketch view but didn't turn it.
In an assembly a new sketch belongs to the active component and is listed in its Sketches
folder. Turn on Preferences › Sketch › Sketching on a part's face makes that part active to
keep sketches with the part they are drawn on: a sketch started on a face of another component's
body first activates that component, at the placement you picked, and is made there, as if you had
activated the part yourself. The part stays active afterwards, so an extrude or cut made from the
sketch lands in the same part; activate the design or another part again as usual. Off (the
default), the sketch belongs to the active component. In scripts the same is
sketch.create {"plane": {"face": …}, "activate_part": true}; the reply's activated names the
component and placement it activated.
In scripts, XY, XZ, YZ and their Top, Front, Right aliases name origin planes.
Preferences › Interface › Origin plane names shows them as Top, Front and Right in the
browser, dialogs and lists; scripts and saved designs keep XY, XZ and YZ.
These names are reserved: a construction plane cannot be created with or renamed to one
(case-insensitive). If an older design already has a construction plane with such a name, a
string argument naming it is ambiguous and is rejected; use the other alias (XY for Top)
for the origin plane, the construction feature's numeric ID to select it, or an explicit
{origin: [x,y,z], normal: [x,y,z]} plane. Existing saved references retain their meaning;
opening a design does not reinterpret old sketches.
Plane Through Axis And Point (Model > Construct) creates a plane containing an
origin or construction axis, straight model edge or sketch line, and a point off that
line. Pick the axis first, then a vertex, sketch point or construction point. A point
on the axis leaves infinitely many possible planes, so choose an off-axis point.
The plane follows its references when they change and can support a new sketch.
Scripts use construct.plane.axis_point, for example:
{"axis":{"axis":"Z"},"point":{"point":[10,20,30]},"name":"Fence"}
Curves adapt to the current zoom and display scale. Picking and highlighting use the same visible boundary, including small circles at Fit and sketches in rotated components. Profile shading follows those curves while preserving holes. Zooming changes the display without changing sketch geometry, dimensions, or undo history. On short windows or enlarged displays, the Sketch Palette's options scroll while its constraint status and Finish Sketch button remain visible.
Hover over a circle or arc centre, or the midpoint of a straight sketch edge, then move horizontally or vertically to see a dotted alignment guide. The guide connects that reference to the cursor's projection on the sketch axis, within the viewport; it disappears when you move away from the axis. SolidCraft keeps the two most recent of these references and can draw both guides. One guide on its own does not move the cursor. While a drawing tool (Line, Rectangle, Circle, Arc, Polygon, Slot, Point…) waits for a point, any sketch point is a reference too: the end of a line or arc, a rectangle's corner, or a free point. Preferences › Sketch › Alignment guides from end points and corners while drawing turns that off and keeps only centres and midpoints. Preferences › Sketch › Auto snap to recent centers and midpoints is off until you turn it on. With it on, a drawing tool snaps the cursor where the horizontal through one reference meets the vertical through the other. On a rectangle, the top midpoint and a side midpoint then meet at the rectangle's centre, so that point can be placed without a construction line. Holding Shift for midpoint-only snapping skips the crossing. This works while editing and before a drawing tool's first click. Placing the point adds no geometry or constraint of its own. Esc, leaving the viewport, or ending the sketch clears the references. Center and midpoint alignment guides turns the guides off, which also leaves the cursor unmoved; the configured snap-suppression modifier does the same for that gesture.
Geometry
Point is available directly on the default Sketch CREATE toolbar. Click it, then click in the sketch to place a point. Existing toolbar customizations are kept; use Reset Toolbar from the toolbar's context menu to restore the default buttons.
Lines and polylines (L), rectangles (two-point R, three-point, centre), circles (centre C,
two-point, three-point, tangent), arcs (three-point, centre, tangent), polygons, slots, ellipses,
fit-point and control-point splines, conics, points and text. Construction (X) turns curves
into reference geometry that doesn't form profiles. Modify tools include trim (T), extend, break,
fillet, chamfer, offset (O), mirror, patterns, move/copy and scale. With trim on, click a
piece to remove it, or press and drag a path across several pieces: the ones it crosses light up
and all go when you let go, in one undo step (sketch.trim.path). Fillet and chamfer take
several corners at once: pick the corners, set the size once, and every corner is rounded or
cut alike in one undo step.
Line draws a chain: each click adds a segment from the last point, and a right-click or Esc ends the chain. To draw one separate line with a press, a drag and the release instead, turn on Preferences › Sketch › Press and drag draws one line: the line runs from where you press to where you let go, snapping and lining up as clicks do, and ends there; clicks still draw a chain, and a drag shorter than about 24 points is still a click.
To round corners without changing tool, turn on Preferences › Sketch › Rest on a line's last point to switch to a tangent arc. With a segment drawn, move the pointer away from the chain's last point, bring it back and hold it still for about a third of a second: a label next to the pointer says Tangent Arc, and the next click ends an arc tangent to the last segment. The same gesture goes back to lines. Arcs and lines join into one chain, each click is one undo step, and a right-click or Esc ends the chain as usual.
Tools with several variants (line and midpoint line; two-point, three-point, centre and rounded rectangle; the circle, arc, slot, polygon and spline variants) share one toolbar button with a drop-down. The button and the family's shortcut start the variant you picked last, so a shortcut such as L can start a Midpoint Line; pick the variant you want from the drop-down to change it (Keyboard shortcuts).
Once a shape's first point is down, value boxes (a line's length and angle, a rectangle's width
and height, a circle's diameter, an ellipse's major and minor radius…) follow the cursor. Typing goes into the first box, Tab moves to
the next and Enter places the shape; each typed value becomes a dimension. A value is an
expression (25, 1 in, d1 * 2), or width = 20 (also #width = 20), which also adds the
user parameter width and dimensions with it, as when placing a dimension. A
box that does not become a dimension (a polygon's sides, a rounded rectangle's corner radius)
takes a value only.
The Sketch Palette's Construction Geometries option hides construction curves while you work. A hidden construction curve cannot be picked by a click or by a box. Nothing invisible is selectable. The option belongs to one sketch and is saved with the design. Centerlines are a line type of their own and keep showing. Projected geometry that carries the construction line type, such as the trace of a plane, answers to Projected Geometries instead. The option changes display only. Construction curves were already outside every profile.
The Construction Line drop-down in Sketch CREATE draws infinite reference lines directly. It contains two-point, horizontal, vertical, angle, parallel, perpendicular, tangent through an external point, tangent at a curve point, common tangent, and angle-bisector tools. These lines remain construction geometry regardless of the Sketch Palette's drawing line type. Turn off Extended construction line tools in Preferences > Sketch to restore the earlier menu.
For horizontal or vertical lines, click the point to pass through. For a line at an angle, click its point, then type the angle from sketch X in the inline box and press Enter, or click the direction. Angle expressions can refer to parameters and follow their later changes. Parallel and perpendicular lines ask for a straight sketch line, then a point; the reference stays picked so you can place several lines. Right-click clears the current points and references; Escape ends the tool.
The horizontal, vertical, parallel and perpendicular tools show a Length box beside the pointer, which stays empty (infinite) until you type a digit: letters still start other tools. With a length, the first click sets the start and a second click the side the segment runs to; the angle tool has the Length box beside its Angle box. The segment gets a length dimension that follows the typed expression. An empty box keeps the infinite line. The Construction | Normal switch under the Length box makes such a segment a normal sketch line, ready to close a profile; it starts at Construction, is greyed out while the line is infinite (an infinite line is always construction), and leaves the Sketch Palette's line type alone.
A command call can cut a horizontal, vertical, angle, parallel or perpendicular construction
line to a length instead: length makes a segment from the point at, running towards near,
and adds a length dimension that follows its expression (#10258). With construction: false that
segment is a normal sketch line, ready to close a profile.
Tangents through an external point take a circle or circular arc, the external point, and a click choosing the desired preview. A common tangent takes two circles/arcs and a click choosing the solution. Contacts outside an arc's drawn sweep are excluded. A tangent at a curve point takes a circle/arc and a contact point, or an endpoint of an open spline or conic. Interior free-form contacts and ellipse tangents are not supported by these tools yet. A bisector takes two intersecting straight lines; click near the desired one of the two preview lines. Parallel or coincident references have no unique angle bisector and are refused.
Each placement is one undo step. Direction, parallel, perpendicular, tangency and bisector
relations are kept as ordinary sketch constraints; the reference geometry follows later edits
within those constraints. Programmatic callers can use sketch.construction_line with mode,
or one of its named variants. near chooses the closest solution; solution chooses its
zero-based index. For example:
{"command":"sketch.construction_line.parallel","params":{"curve":"l1","at":[20,10]}}
Polygon tools show their edge outline while positioning the second point, so the orientation can be checked before placement. Inscribed and circumscribed polygons retain their support circle and update the outline when the inline Sides value changes.
Text is set in the built-in font (Liberation Sans) unless it is given another: sketch.text and
sketch.edit_text take a font, the family or full name of an installed font ("DejaVu Sans") or the path
of a .ttf / .otf file, and the Edit Text dialog has a Font field for it. An unknown font is an
error, and the font is kept with the text in the design, so the text stays editable in it. SOLIDCRAFT_FONT_DIRS
adds folders to the ones searched for installed fonts. A text's height, its angle and each coordinate of
its at can be expressions of the design's parameters, given as strings ("height": "plate_height / 10",
"at": ["plate_width / 2", 5]): the text keeps the expression and follows the parameters when they change, and
saves it with the design. A number takes the place of an expression, and so does moving the text or dragging its
handles (what moves becomes a number; turning a text leaves its height as it was). A string that names no
parameter is the number it comes to. The same two commands refuse a text that is not a string, an at that is
not two numbers or expressions, a height or angle that is neither (or a height that is not positive) and an
expression that cannot be worked out with a message, instead of drawing the text with a default; left out, they
keep their defaults.
Right-click a letter's filled interior or outline and choose Edit Text. You can also
start Edit Text first and click the letter. All outlines belonging to that text are
highlighted while the dialog is open. A profile bounded by multiple text sources or other
geometry cannot identify one text: use Select Other to choose its outline instead.
Change the text, font, baseline X/Y, height or angle, then confirm with OK; Cancel
keeps the original text. Position and height use the document's units. The four fields take
expressions: one that names a parameter (plate_width / 2) stays an expression, is shown as typed
when the dialog is opened again, and keeps the text following the parameter.
To work on the letters' shapes themselves, right-click the text and choose Explode Text
(sketch.break_link with the text's link). Its outlines stay where they are as ordinary
lines, arcs and curves that can be picked, trimmed, dimensioned and extruded one by one; the
text itself is gone, so it can no longer be edited as text or follow parameters. Undo brings it back.
A text can follow a curve of its sketch (its Path). That curve becomes construction: the letters stand on it and their descenders cross it, so as a normal curve it would cut them into pieces, and picking the text would pick those pieces. Taking the text off the curve leaves it construction; Normal/Construction turns it back.
Drag a text outline to move all its letters together. Let go to finish in one undo step,
or press Esc during the drag to restore the original text. The text stays editable.
For an exact displacement, select an outline and choose Move/Copy from its context menu.
Enter Distance X, Distance Y and an optional Angle about the text's baseline;
lengths accept document units or explicit units such as 1 in. Enable Create Copy to
leave the original in place and create a separately editable text. Cancel leaves the
design unchanged. Projected geometry remains protected from ordinary dragging.
Project (P) and Intersect bring model edges into the sketch as linked geometry that follows later changes. Sketching on a face projects its edges automatically. A projected edge stays the edge that was picked, wherever a later change moves it; when that edge no longer exists, the projection keeps its last shape and the sketch says it was lost. For Project, select visible source curves or points from another sketch, model edges, faces, vertices or bodies, or axes and planes, then press P. The entire supported selection is projected in one undo step. A rejected projection keeps the selection for correction; an empty or mixed selection starts the ordinary picking tool. External sketch selections retain their source sketch, even when the active sketch uses the same point or curve names.
A sketch on a construction plane built from the model (through a sketch line, through three points, midway between two faces…) projects, intersects, includes and holds text like a sketch on any other plane, and its links follow when a parameter moves that plane.
Run from a script or the control channel, every command that adds sketch geometry returns the
ids of what it added (created: {points, curves, constraints, dimensions}). Ids are stable and
never reused within a sketch, even after a delete, so a script can dimension or constrain the new
geometry right away.
Extend finds intersections with exact ellipses, rational conics and spline spans. It keeps the original line or circular support and extends only beyond the selected endpoint; conflicting constraints or an ambiguous overlap leave the sketch unchanged. To extend two lines or arcs until they meet, hold Shift and click the first curve, then Shift-click the second: both grow to where they cross and are joined there, in one undo step.
Closed convex chains of tangent lines and circular arcs support inward offsets that consume a rounded corner. When the offset passes the corner radius, the neighbouring straight supports meet at a sharp corner. The surviving lines and endpoint IDs stay stable; the retired arcs return under their original IDs if a later edit restores their radius. Whole-boundary profile selections follow this transition through save and reopen, so an extruded lip can remain associative. Existing eligible closed analytic offsets upgrade without changing their saved geometry or IDs.
This transition requires a closed convex boundary with tangent junctions and a certified nonempty region. An extinguished arc referenced individually by a constraint or another offset cannot retire. Creating another offset from an already sharp retired boundary also requires breaking its association first. Open, nonconvex and mixed free-form chains keep their existing behavior. Break Offset Association freezes the current boundary, including private arc centres and construction flags, for independent editing.
Offsets of smooth ellipses, conics and splines follow their source after dimension changes,
dragging and reopening a design. Their stored cubic spline has a whole-span normal-distance
error bound of 0.002 mm. Singular tangents, curvature cusps, possible self-intersections and
excessive subdivisions are refused. Offset these curves individually: mixed chain junctions
currently require separate geometry. sketch.offset.break releases an offset for independent
editing, and undo restores its association. Older independently sampled offsets remain independent.
The fit points of such an offset stay hidden, except the two ends of an open one: lines and
arcs snap to them and stay coincident with them as the offset follows its source, so the gap
between a spline and its offset can be closed into a profile.
Smooth open and newly created smooth closed offsets can be offset again, including bounded
refinement after a source edit. New closed outputs use a periodic cubic fit with continuous
tangent and curvature at the seam. Break Offset Association preserves that interpolation,
and its closing point remains joined when dragged. Deleting an output also removes its
unused private fit points; deleting a source with a retained dependent is refused.
For explicit closed fit splines, sketch.spline.fit_point accepts periodic: true and at
least three distinct cyclic samples. It closes the loop automatically. Existing calls and
older saved closed splines retain natural interpolation; older associative closed offsets
also retain their saved natural fit. A legacy seam without a unique normal still refuses
another offset. Periodic intent is stored on each curve and survives save, reopen and Break.
While drawing a fit spline, click its starting point after three distinct samples to close
it smoothly. Right-click finishes an ordinary natural fit. Offset accepts both ellipse
handles and dense fitted curves; the second click sets the side and distance from the curve.
Equation Curve draws a curve from formulas instead of clicks: x(t) and y(t) over a range of
t, or y = f(x) over a range of x, using the design's parameters. Equation curves
walks through it step by step, with pictures and examples (a line, a parabola, a wave, a circle,
a spiral, a gear tooth's involute). Right-click the curve and choose Edit Equation Curve to
change the formulas (sketch.equation_curve and sketch.equation_curve.edit from scripts and agents).
While drawing in a planar sketch, Construction (X) changes the line type without ending the tool or losing picked points and inline values. The preview and hover feedback keep construction dashes and centerline dash-dot patterns visible. With curves selected, Construction changes those curves as before.
The pointer snaps to existing sketch points, to a line's midpoint, and to where two
curves cross (two lines, a line and a circle or arc, or two circles or arcs). The snap
hint shows X. The new point stays on both curves when either one moves. Hold Shift
to prefer a line midpoint instead; hold Ctrl/Cmd or Alt/Option (the default suppress chord)
to stop snapping for that gesture. Scripts pass "x:<curve>+<curve>:x,y" as a point
argument, the same way "mid:<line>" and "on:<curve>:x,y" work.
With Preferences › Sketch › Line up with other sketch points while drawing turned on (it's off by default), the pointer also lines up while drawing with the sketch's points on screen: line ends, centres, standalone points and the origin, and the shape's own earlier points. It lines up on both axes at once, level with one point and plumb with another, so a rectangle drawn beside another can take its height from one and its width from a point below. A line kept horizontal or vertical from its start can still end under or beside another point. A dotted guide runs from each point it lines up with, and the snap hint shows H, V or H+V. The click keeps the alignment: the new point gets a Horizontal or Vertical constraint with each sketch point it lined up with, in the shape's undo step, unless the sketch already sets it. With the preference off, drawing lines up only with the previous point, one axis at a time.
Enable 3D Sketch in the Sketch Palette to draw lines, fit splines and points off the plane.
While placing these points, you can snap to points on other visible sketches. For a bridge
line, start Line and click an endpoint on each source sketch; each endpoint uses its source
plane, even when that plane differs from the active sketch. These snaps capture positions;
they do not create associative links to the source points.
New 3D geometry follows its sketch's component placement, including the selected occurrence
and pending position changes. Click a drawn fit point to show its move triad; its arrows move
along world X, Y and Z. Scripts also supply world coordinates to sketch.line3d,
sketch.spline3d, sketch.point3d and sketch.move3d. Activate the desired occurrence before
editing an explicit sketch belonging to a component with multiple placements.
Older drawn or detached 3D wires keep their saved world positions. Included and surface-linked wires with an explicit component marker keep that meaning after the link is broken. Old files whose links became lost after an incorrectly scoped cross-component refresh may require a fresh link once the source is available; their stored point values are preserved on opening.
Constraints and dimensions
Horizontal/Vertical accepts a click on a line or clicks on two distinct sketch points, including the origin, endpoints and circle centres. For two points, it chooses horizontal or vertical alignment from their current positions. Hold Shift near a line's midpoint to highlight and select it as either point. The midpoint follows both endpoints as the line moves, resizes or rotates. Two line midpoints can also be aligned. Hovering and the first pick are only previews; Esc cancels them without changing the sketch. Accepting the second pick reuses or creates a sketch point with an ordinary Midpoint constraint, then adds the H/V constraint in one undo step. Both constraints can be selected and deleted independently; deleting either keeps the point. After a fillet or chamfer, its Midpoint constraint refers to the original full side, retained as construction geometry, just like a manually constrained midpoint.
Scripts use the same command, with a midpoint reference in the points array:
{"command":"sketch.constraint.horizontal_vertical","params":{"points":[{"midpoint":"l1"},"c1.center"],"mode":"vertical"}}
mode can be horizontal or vertical; omitting it chooses from the current positions.
The solver is SolidCraft's own (damped Gauss–Newton with degree-of-freedom analysis). Constraints:
coincident, horizontal/vertical, parallel, perpendicular, tangent, equal, concentric, collinear,
midpoint, symmetry, fix, curvature (G2) and polygon. Sketch Dimension (D) adds linear,
aligned, horizontal, vertical, point-to-line, line-to-circle, point-to-circle, circle-to-circle,
radius, diameter, arc length and angle dimensions. For an arc's length, click the arc and then one of its end points.
An ellipse is drawn with its major and minor axes as construction lines through its centre
(Preferences › Sketch › Draw ellipses with their axes; turned off, the ellipse is drawn alone,
and D on an ellipse gives its minor radius wherever the value is pulled, as before).
As with a Center Rectangle's diagonals, trim, extend and break stop at them, and they stay when the
ellipse is deleted.
Click the ellipse and pull the value across its major axis for the major half-axis, or out past an
end of the major axis for the minor half-axis, also on an ellipse whose axis lines were deleted;
once one half-axis has a dimension, the next click on the ellipse gives the other;
click an axis line for the whole axis. Each is a parameter
(d1, d2, …), so it can hold an expression.
Concentric accepts two circles or arcs, or a circle or arc and a sketch point (including the origin). Preselect the pair and choose Concentric, or start the tool and pick both, in either order.
Press D, click what you want to measure and type the value: as soon as the click settles the
dimension (one line, circle or arc, or the second point or line of a distance or angle), its
value box takes the keyboard with the measured value selected, so typing replaces it. Numbers,
units (1 in), expressions (2*width) and parameter names all work; letters go into the box,
not to tool shortcuts. width = 40 (or #width = 40) defines the user parameter width and dimensions with it,
in one step. While you type, the dimension text follows the cursor, and Enter places
it there (or in its default place if you haven't moved the cursor) as one undo step. Esc
cancels the dimension.
You can still place the text first. Before you type, a click on empty sketch space puts the text there and keeps the value box focused; a click on another point or line makes the dimension a distance or angle instead; Tab leaves the picks waiting for a click to place the text.
To change a dimension you already have, double-click it, or, with Sketch Dimension on and nothing picked yet, click it once: its value box opens with the value selected, Enter applies, and the tool stays on for the next dimension. The dimension's text always takes the click; its lines take it only away from sketch points and curves, which still start a new dimension.
To type values in a small window instead, set Preferences › Sketch › Dimension values to In a window. The Dimension tool then places the text first: click what you want to measure, then where the text goes, and the window opens there (double-clicking a dimension opens it too). Its field takes the same numbers, units, expressions and parameter names as the box, and the sketch shows the value as you type. The arrows beside the field, Up and Down, and the mouse wheel over the field step a number by Window steps (1 mm and 1° unless you change them; Shift steps ten times as far, Alt a tenth), keeping the unit it is written in. The check (or Enter) applies the value as one undo step and the tool stays on for the next dimension; the cross (or Esc) drops this dimension only, and Esc with no window open puts the tool down.
To have shapes dimensioned as you draw them, turn on Dimension new shapes in Preferences ›
Sketch (it is off by default). Each line, rectangle, circle, arc, slot, polygon or ellipse you draw
then gets all its dimensions at the sizes you drew: a line its length and angle, a rectangle its
width and height, a circle its diameter, an ellipse its major and minor radius, and so on. Values you type in the drawing boxes win, and a size
the sketch already sets (the angle of a line that snapped horizontal) is left out. The shape and
its dimensions are one undo step. In scripts, sketch.draw.dimensioned takes "as_drawn": true.
Tick Also place them from the origin (fully constrained) as well, and each new shape is also
dimensioned from the sketch origin until nothing of it is left free: a horizontal and a vertical
distance to its centre or first point, and one more where the shape could still turn (a polygon,
a rectangle drawn at an angle). A shape already attached to the origin or to geometry that is
placed gets none, and a point on an axis is put on that axis rather than given a 0 distance.
In scripts: "locate": true.
Between two points, or on a line, that don't line up with an axis, where you place the dimension picks what it measures: across from them, the distance between them; above or below them, the horizontal distance; beside them, the vertical distance.
A line and a circle or arc (click the line, then the circle's edge, or the other way round)
measure from the line to the circle's edge, square to the line: the gap between them, 0 when
the circle touches the line. When the line cuts through the circle, the dimension measures how
far the edge reaches past the line instead. An arc is measured to the circle it lies on. For
the distance to the centre, click the centre point instead of the edge. In scripts:
{"command": "sketch.dimension", "params": {"entities": ["l1", "c1"], "value": 5}}.
A point and a circle or arc measure from the point to the circle's edge, along the radius through the point: 0 puts the point on the circle, and a point inside the circle measures how far within the edge it lies. Two circles or arcs measure between their edges, along the line through their centres: the gap between them (0 when they touch), how far they overlap when they cross, or, when one lies inside the other, the narrowest gap between them (the thinnest part of the wall). For the distance between the centres, click the two centre points instead.
A dimension the sketch can't take, because the geometry is already fixed by other constraints and dimensions, is added as a driven (reference) dimension instead: it is shown in parentheses, measures the sketch, and has no value to edit.
For Coincident, pick two points, a point and a curve (in either order), or two distinct straight lines. Two lines join their closest pair of endpoints; the first picked line stays in place when the existing constraints allow it. Pick endpoints explicitly when you want to connect a different pair.
Horizontal/Vertical also applies immediately to one selected line or two distinct selected points. Shift-click to add the second point before choosing the constraint.
For Parallel, Perpendicular, Equal, Tangent, Concentric and Collinear, select exactly two sketch curves (Shift-click to add the second) and choose the constraint to apply it immediately. You can also start the constraint first and then pick its curves. An incomplete or mixed selection leaves the tool ready for ordinary picking.
Coincident accepts an exact selection of two points or a point and a curve. Midpoint accepts one point and one line, in either selection order, or two lines: the second line moves (keeping its length) until its midpoint sits on the first line's midpoint, and stays centred there as either line changes. Symmetry accepts two distinct points and one symmetry line, regardless of where the line occurs in the selection. Successful constraints clear the selection; rejected constraints preserve it.
Under-constrained geometry is blue and fully constrained geometry turns dark, and the status shows the remaining degrees of freedom. A constraint or dimension that would over-constrain the sketch is refused rather than applied. Drag a point to move it; the solver keeps every constraint while you drag.
A sketch's constraints can still come to conflict through a change elsewhere: a parameter, or an
earlier sketch that projected geometry follows. While they do, the curves and points a failing
constraint holds, and that constraint's glyph or dimension, are drawn in the conflict colour (red;
the theme key sketch_conflict, which follows a theme's error colour unless the theme sets it),
so the constraint to change or remove is easy to find. Constraints that are only redundant (implied
by others, still holding) keep their usual look. Preferences › Sketch › Conflicting geometry in
the conflict colour (on by default) turns this off: then only the glyphs and dimensions of the
failing constraints are red, as in earlier versions.
Profiles
Closed loops become profiles automatically, including regions split by crossing lines and islands inside outlines. Extrude, revolve, sweep and loft pick profiles.
A feature remembers a picked profile by the curves around it, not by where it was clicked:
"profiles": [{"curves": ["l1", "l2", "a1", "l3"]}] (or [{"curves": ["c1"]}] for a circle)
picks the region whose outer loop is made of exactly those curves, or the pieces of them that
other curves cut off. It is found again on every recompute, so the feature keeps the same region
when a parameter moves the geometry. Islands inside the region are its holes. When no region, or
more than one (both halves of a circle cut by a line), is bounded by exactly those curves, the
feature reports an error rather than taking another region. Profiles picked by index or by point
([{"point": [x, y]}]) are stored the same way when the feature is made.
Measurement units
Change the current design through Document Settings > Units in the browser.
The units preference applies to new designs. Existing sketch annotations, live drawing
lengths and Measure follow the current design units without resizing geometry.
Inches display at least three decimal places and retain a meaningful fourth digit;
a higher display precision can be selected in Preferences. Bare length values typed
in the dimension tool use the current design units. Explicit units such as 25.4 mm
remain valid in an inch design. Angular dimensions keep their angular units. Deliberately typed four-place inch literals
retain trailing zeros. Component/canvas distance controls and inspection, parts-library
and flat-pattern measurements follow design units too; parameter expressions and metric
standard names retain their explicit authored units.
Measure shows the currently selected distance (centre, minimum or maximum) and separate X, Y and Z distances on the canvas. The component dimensions follow the world axes and remain visible until the Measure dialog closes. To hide these extra lines and labels, turn off Preferences > Graphics > Show X/Y/Z distances. The choice is saved between runs. Drag the distance or an X, Y or Z label to move it away from the part; a moved label keeps a line to what it measures. Double-click a label to put it back. Measuring other items starts the labels in their own places again.
Reviewing mirror, pattern, and offset results
Mirror, rectangular/circular Pattern, and Offset show the active selection step in their shared tool window. Click an input to change it; click a selected object again or Ctrl/Cmd-click it to remove it. Each input has its own Clear button. Source inputs show a count, and single references identify the chosen mirror line, direction, or centre. Box selection also works while the window is open. Sketch modify tools take geometry from the sketch being edited.
Proposed sketch geometry appears green before confirmation. Change the inputs or values to update the preview, then press OK. Cancel discards the preview. A circular pattern centre can be an existing point or a position clicked in empty sketch space.
Sketch patterns keep each instance related to the seed geometry: moving the seed updates the copies, and a copy cannot deform independently. Circle and ellipse radii follow the seed too. Choose a circle's centre point to keep a circular pattern centred on that circle. A centre placed in empty space becomes a sketch point that can be dimensioned or made coincident. Double-click the pattern badge (at the circular centre or beside the rectangular seed), or right-click a seed or copy and choose Edit Sketch Pattern, to change quantity, spacing, direction or total angle. Confirmed edits preserve surviving instance ids; Cancel discards the preview. Pattern settings survive save/reopen and undo/redo. Deleting a seed, copy or pattern relation breaks that association and leaves the remaining geometry independent. Patterns saved by older versions remain independent copies; recreate them to add associations.
Offset distances are editable driving dimensions: double-click a dimension or change its model parameter to resize the offset without moving its source curves. The selected side, distance, and association survive save/reopen and undo/redo. Symmetric offsets share one driving distance; Two Sides has an independent distance for each side. Disconnected selected curves or chains are all offset. Breaking an association retains its current geometry and removes that association's driver. Older offsets retain their saved fixed distances.