2c1d23e4e5
* Sketcher: Extend InputHints infrastructure to constraint tools - Implement DrawSketchHandler::getToolHints() for constraint workflows - Add centralized hint table mapping constraint commands to step-specific InputHints - Integrate hint lookup in DrawSketchHandlerGenConstraint and dimension handler - Provide step-by-step user guidance for: - Coincident, PointOnObject, Distance (X/Y) - Horizontal, Vertical, HorVer, Lock, Block - Equal, Symmetric, Radius, Diameter, Angle - Tangent, Perpendicular, Parallel This continues the InputHints work started for drawing tools by enabling consistent, contextual guidance for constraint creation, including multi-step workflows like tangent-via-point. * Call updateHint() after selection reset to re-arm the first-step prompt when the tool stays active after apply. * Add comments to hints table structure * Sketcher: Update constraint hint text to use "pick" instead of "Select" Change constraint hint text from "Select" to "pick" to maintain consistency with existing FreeCAD UI style. This affects the DrawSketchHandlerGenConstraint hint system for various constraint operations including coincident, distance, horizontal/vertical, block, lock, symmetry, tangent, perpendicular, parallel, and distance constraints. The hints now follow the pattern: - "%1 pick first point or edge" - "%1 pick second point or edge" - "%1 pick line or two points" etc. This provides consistent terminology throughout the sketcher constraint creation workflow. * - Remove redundant 'first' from initial selection hints - Improve consistency in hint text formatting per Developer Guidelines - Add consistent spacing in comment sections" * Per PR feedback for DrawSketchHandlerDimension hints: * Change 'Click to' to "pick" * Simplify hint wording * Combine redundant else * Use direct return pattern instead of building hints list * Update lookupConstraintHints() to use C++20 std:ranges::find_if form per PR review feedback * Sketcher: Refine constraint hints per PR feedback - Use consistent 'point or edge' phrasing in Distance and DistanceX/Y tools - Reword Horizontal/Vertical step 0 to avoid misleading 'two points' - Generalize Tangent and Perpendicular hints to 'edge' with optional point - Simplify legacy Distance to 'point or edge' * Add dynamic hint handling for PointOnObject constraint - Implemented contextual hints in getToolHints() to generate an appropriate step 2 hint based on step 1 selection type - Preserved static lookupConstraintHints() for all other tools * Sketcher: Convert constraint hint table to C++20 designated initializer syntax - Refactored static constraint hint table to follow Sketcher hint development guidelines - Uses C++20 designated initializers for clarity and maintainability - No changes to hint logic or behavior; content is identical to previous version
Your own 3D parametric modeler
Website • Documentation • Forum • Bug tracker • Git repository • Blog
Overview
-
Freedom to build what you want FreeCAD is an open-source parametric 3D modeler made primarily to design real-life objects of any size. Parametric modeling allows you to easily modify your design by going back into your model history to change its parameters.
-
Create 3D from 2D and back FreeCAD lets you to sketch geometry constrained 2D shapes and use them as a base to build other objects. It contains many components to adjust dimensions or extract design details from 3D models to create high quality production-ready drawings.
-
Designed for your needs FreeCAD is designed to fit a wide range of uses including product design, mechanical engineering and architecture, whether you are a hobbyist, programmer, experienced CAD user, student or teacher.
-
Cross platform FreeCAD runs on Windows, macOS and Linux operating systems.
-
Underlying technology
- OpenCASCADE A powerful geometry kernel, the most important component of FreeCAD
- Coin3D library Open Inventor-compliant 3D scene representation model
- Python FreeCAD offers a broad Python API
- Qt Graphical user interface built with Qt
Installing
Precompiled packages for stable releases are available for Windows, macOS and Linux on the Releases page.
On most Linux distributions, FreeCAD is also directly installable from the software center application.
For development releases visit the weekly-builds page.
Other options are described on the wiki Download page.
Compiling
FreeCAD requires several dependencies to correctly compile for development and production builds. The following pages contain updated build instructions for their respective platforms:
Reporting Issues
To report an issue please:
- Consider posting to the Forum, Discord channel, or Reddit to verify the issue;
- Search the existing issues for potential duplicates;
- Use the most updated stable or development versions of FreeCAD;
- Post version info from
Help > About FreeCAD > Copy to clipboard; - Restart FreeCAD in safe mode
Help > Restart in safe modeand try to reproduce the issue again. If the issue is resolved it can be fixed by deleting the FreeCAD config files. - Start recording a macro
Macro > Macro recording...and repeat all steps. Stop recording after the issue occurs and upload the saved macro or copy the macro code in the issue; - Post a Step-By-Step explanation on how to recreate the issue;
- Upload an example file (FCStd as ZIP file) to demonstrate the problem;
For more details see:
Note
The FPA offers developers the opportunity to apply for a grant to work on projects of their choosing. Check jobs and funding to know more.
Usage & Getting Help
The FreeCAD wiki contains documentation on general FreeCAD usage, Python scripting, and development. View these pages for more information:
The FreeCAD forum is a great place to find help and solve specific problems when learning to use FreeCAD.
This project receives generous infrastructure support from
and KiCad Services Corp.