Whet pixel markWhet

Whet user guide, chapter 6, 2026-10-09

Drawings and measuring

Every figure comes from the kernel's own measurement of the solid. Where it cannot measure something, it says so and leaves the number out. It never shows a zero in place of a missing figure.

Measure

With no part open on the kernel, the Measure menu is greyed and says "Open a part on the kernel before measuring."

By picking

  1. Pick a face: the info line gives its area. A 20 by 20 mm face reads 400 mm2.
  2. Pick a second face: the shortest distance between the two. Parallel faces 15 mm apart read 15 mm.
  3. Hold Alt and pick the second one for an angle.
  4. Pick one cylindrical face for its radius. A 10 mm bore reads 5 mm.

From the Measure menu

The Measure menu arms a measurement, and the info line says what to pick.

  • Distance: pick A and B.
  • Minimum Distance Between Bodies: pick two bodies.
  • Angle: pick two straight edges.
  • Radius and Diameter: pick a circular edge. If one is already picked, the answer comes at once.
  • Copy Measurement puts the last result on the clipboard.

Press 1 to pick vertices: one shows its coordinates in Properties, two give the distance between them. See Modelling for the other pick keys.

The kernel renumbers Face1, Face2 and so on when a part is rebuilt. Whet stores a longer token beside the number, so a measurement finds its face again after an edit.

Faces and Edges, Measure and Compare pages

Open the settings window (Edit menu, Settings) and go to Part; the exact wording is (to be checked). Three pages print a full sheet in a scrolling box.

  • Faces and Edges lists every face and edge of a file: a 60 by 40 by 10 mm box shows 6 faces and 12 edges.
  • Measure takes two faces by name or token and gives the distance, angle, radius, area or length.
  • Compare takes two solids and says how they relate, for example "they share 4000 mm3, b is inside a".

Drawing sheet

Open the part, then choose Drawing > Drawing Sheet.... Whet first lists the part's edges, so the dimension list can offer them. The form has these parts.

  • Name and Sheet: A4, A3, A2, A1 or A0.
  • Scale: Fit to sheet, or Custom with a factor where 1 means 1:1. Fit chooses the largest preferred scale at which every view fits: 10, 5, 2, 1, 0.5, 0.2, 0.1, 0.05, 0.02, 0.01, 0.005, 0.002 and 0.001. A custom scale that does not fit is refused; the message names the view and the overrun.
  • Views: front, back, top, bottom, left, right and iso. Front, top and right are ticked by default. One sheet holds up to six views.
  • Hidden Lines and Center Marks: tick to draw them.
  • Section View A-A: a plane by a point and a normal, and its place on the page.
  • Detail View B: the parent view, the centre, a radius (10 mm by default), a magnification (2 by default), and its place.
  • Dimensions: a view, an edge, and the kind: length, radius, diameter or angle (an angle needs a second edge). Up to 24 per sheet. Hole and Thread Note takes a thread callout you type, such as M8 x 1.25; Whet does not guess a thread from a circle. Place at page coordinates puts a dimension where you say; otherwise Whet places it.
  • Title Block: Title, Document type, Identification no., Part/Version, Revision, Date of issue, Sheet (as 1/2) and Projection. Document type starts as DRW, the SAP DMS type for an engineering drawing. Part/Version follows the SAP document info record, for example 000-00. Date of issue starts as today. Projection is First angle (ISO E) by default, or Third angle (ISO A).
  • Manufacturing: Material, Finish and General tolerances, for example ISO 2768-m.
  • Approval: Legal owner, Created by, Checked by and Approved by.
  • Revisions: one row per revision with Rev, Date (YYYY-MM-DD), Description and By. Add Row adds a row, up to eight. The table is drawn above the title block. If Revision is left empty, the sheet shows the last row's Rev.

An empty field is left off the sheet. Fields take up to 64 characters, accented letters included.

Company template

Fill Legal owner, Created by, Checked by, Approved by, Document type, General tolerances and, if you like, Material and Finish, then press Save as Company Template. The form fills these fields from the template each time it opens; Load Company Template fills them again. The template is drawing-template.json in the Whet folder on this computer. Nothing is sent anywhere.

The template can also hold a number scheme for identification numbers: whet cad sheet --template --set numberScheme=######## in a terminal, where # means a digit, A a letter, * either, and any other character itself. A number that does not fit is refused before anything is drawn. whet cad sheet --template prints the template.

The title block

The block follows ISO 7200: 180 mm wide, in the lower right corner, the fields above in rows, and at the bottom Scale, the Projection symbol (the ISO 5456-2 truncated cone), Size, Units and the source file. With first angle, the top view is drawn below the front view and the right view to its left; with third angle these swap. The principal views carry no name labels.

Section View, Detail View, Hidden Lines and Center Marks on the Drawing menu open the same form. Projected Views... opens the view settings.

The sheet page

The page opens in the middle. It shows "Technical drawing" when the real drawing is available, and "Layout preview" with only the view positions when it is not. A layout preview is not a drawing.

Fit Page, Zoom In and Zoom Out change the view. Dimensions can be moved on the page. Export PDF..., Export SVG... and Export DXF... write the sheet out with any dimension you moved; File > Export has a Drawing as PDF item too.

Drawing the sheet also writes <name>.sheet.pdf, .sheet.svg, .sheet.FCStd (the FreeCAD page) and .sheet.dxf beside the part. That DXF holds the views only; for the title block and dimensions, use Export DXF... on the page. The page also lists the views with their bounds, every dimension and its position, the title block, the paper and the scale.

Two numbers for every dimension

Every dimension is measured twice: by the kernel on the edge, which is the figure printed on the sheet, and by the drawing engine on its own projection. The page shows both and the difference; on a 60 by 40 by 20 mm block at 1:1 on A4 it is 0 for every dimension.

A dimension that cannot be measured is not on the sheet and is not shown as zero. It appears under Not Placed with the reason, for example a radius asked of a straight edge.

Limits of a sheet

  • Tolerances and Parts List are on the Drawing menu and greyed. A sheet carries one general tolerance note in the title block: no tolerance on a single dimension, no geometric tolerance frame, no parts list block. The parts list of an assembly is separate; see Assemblies.
  • A diameter is labelled DIA 12, not with the diameter sign.
  • A radius or diameter needs a round edge. An angle needs two edges.

Draft layout

A flat 2D drawing made from shapes you type, with no part behind it: Drawing > New Draft Layout....

The form takes Rectangle, Circle, Polygon, Line, Wire and Arc 3 Points, length, radius and diameter dimensions, and text. Each closed shape gets its area and perimeter: an 80 by 40 outline reads 3200 mm2 and 240 mm round. A field a shape does not take is refused with the reason, such as "a polygon takes atMm, radiusMm, sides and no widthMm".

What to expect

  • Measurements come from the solid, not from the screen.
  • When a measurement does not come back, read the info line. It carries the engine's sentence unchanged.