Freecad Manual

Deutsch • ‎English • ‎español • ‎français • ‎italiano • ‎polski • ‎română • ‎русский

The Arch Workbench of FreeCAD implements a series of tools and facilities for BIM modeling. Although it has a different purpose, it is made to work in tight integration with the rest of FreeCAD: Anything made with any other workbench of FreeCAD can become an Arch object, or be used as a base for an Arch object. FreeCAD uses the LGPL license; you may download, install, redistribute and use FreeCAD the way you want, regardless of the type of work you'll do with it (commercial or non-commercial). You are not bound to any clause or restriction, and the files you produce with it are fully yours.

Next: Creating and manipulating geometry

A FreeCAD manual Note: The manual has been moved to the official FreeCAD wiki which is now its new home. If you wish to propose edits, please do them there, as this repository will be kept only for generating the ebook versions and will not be directly edited anymore. FreeCAD's development is always active! Do you want to check out the latest development release? For MacOS, Windows, Linux (AppImage) and source code, see the FreeCAD weekly builds page. Additional modules and macros. The FreeCAD community provides a wealth of additional modules and macros. FreeCAD is also fundamentally a social project, as it is developed and maintained by a community of developers and users united by their passion for FreeCAD. This manual is an experiment at taking the opposite way from the official FreeCAD documentation wiki. The wiki is written collaboratively by dozens of community members and, like most.

Freecad Manual Pdf Download Free

  • Discovering FreeCAD
    • Installing
    • The FreeCAD interface
    • Navigating in the 3D view
  • Working with FreeCAD
    • Preparing models for 3D printing
    • Using spreadsheets
  • Python scripting
    • A gentle introduction

Python is a popular, open source programming language, very often embedded in applications as a scripting language, as is the case with FreeCAD. It has a series of features that make it suitable for us FreeCAD users: It is very easy to learn, especially for people who had never programmed before, and it is embedded in many other applications. This make it a valuable tool to learn, as you will be able to use it in other software, such as Blender, Inkscape or GRASS.

FreeCAD makes extensive use of Python. With it, you can access and control almost any feature of FreeCAD. For example, you can create new objects, modify their geometry, analyze their contents, or even create new interface controls, tools and panels. Some FreeCAD workbenches and most of the addon workbenches are fully programmed in Python. FreeCAD has an advanced Python console, available from menu View->Panels->Python console. It is often useful to perform operations for which there is no toolbar button yet, or to check shapes for problems, or to perform repetitive tasks:

Freecad 0.19 manual pdf

But the Python console has another very important use: Every time you press a toolbar button, or perform other operations in FreeCAD, some Python code is printed in the console and executed. By leaving the Python console open, you can literally see the Python code unfold as you work, and in no time, almost without knowing it, you will learning some of the Python language.

FreeCAD also has a macros system, which allows you to record actions to be replayed later. This system also uses the Python console, by simply recording everything that is done in it.

In this chapter, we will discover very generally the Python language. If you are interested in learning more, the FreeCAD documentation wiki has an extensive section related to Python programming.

Writing Python code

There are two easy ways to write Python code in FreeCAD: From the Python console (menu View -> Panels -> Python Console), or from the Macro editor (menu Tools -> Macros -> New). In the console, you write Python commands one by one, which are executed when you press return, while the macros can contain a more complex script made of several lines, which is executed only when the macro is launched from the same Macros window.

In this chapter, you will be able to use both methods, but it is highly recommended to use the Python Console, since it will immediately inform you of any errors you make while typing.

If this is your first time using Python, consider reading this short introduction to Python programming before going any further, it will make the basic concepts of Python clearer.

Manipulating FreeCAD objects

Let's start by creating a new empty document:

If you type this in the FreeCAD Python console, you will notice that as soon as you type 'FreeCAD.' (the word FreeCAD followed by a dot), a windows pops up, allowing to quickly autocomplete the rest of your line. Even better, each entry in the autocomplete list has a tooltip explaining what it does. This makes it very easy to explore the functionality available. Before choosing 'newDocument', have a look at the other options available.

As soon as you press Enter our new document will be created. This is similar to pressing the 'new document' button on the toolbar. In Python, the dot is used to indicate something that is contained inside something else (newDocument is a function that is inside the FreeCAD module). The window that pops up therefore shows you everything that is contained inside 'FreeCAD'. If you would add a dot after newDocument, instead of the parentheses, it would show you everything that is contained inside the newDocument function. The parentheses are mandatory when you are calling a Python function, such as this one. We will illustrate that better below.

Freecad manuals

Now let's get back to our document. Let's see what we can do with it. Type the following and explore the available options:

Usually names that begin with an upper-case letter are attributes: they contain a value. Names that begin with a lower-case letter are functions (also called methods): they 'do something'. Names that begin with an underscore are usually there for the internal use of the module, and you should ignore them. Let's use one of the methods to add a new object to our document:

Our box is added in the tree view, but nothing happens in the 3D view yet, because when working from Python, the document is never recomputed automatically. We must do that manually, whenever required:

Now our box has appeared in the 3D view. Many of the toolbar buttons that add objects in FreeCAD actually do two things: add the object, and recompute. If you turned on the 'show script commands in Python console' option above, try now adding a sphere with the appropriate button in the Part Workbench, and you will see the two lines of Python code being executed one after the other.

You can get a list of all possible object types like Part::Box:

Now let's explore the contents of our box:

You'll immediately see a couple of very interesting things such as:

This will print the current height of our box. Now let's try to change that:

If you select your box with the mouse, you will see that in the properties panel, under the Data tab, our Height property appears with the new value. All properties of a FreeCAD object that appear in the Data and View tabs are directly accessible by Python too, by their names, like we did with the Height property. Data properties are accessed directly from the object itself, for example:

View properties are stored inside a ViewObject. Each FreeCAD object possesses a ViewObject, which stores the visual properties of the object. When running FreeCAD without its Graphical Interface (for example when launching it from a terminal with the -c command line option, or using it from another Python script), the ViewObject is not available, since there is no visual at all.

Try the following example to access the line color of our box:

Vectors and Placements

Vectors are a fundamental concept in any 3D application. It is a list of 3 numbers (x, y and z), describing a point or position in the 3D space. A lot of things can be done with vectors, such as additions, subtractions, projections and much more. In FreeCAD vectors work like this:

Freecad Manual 0.18


Another common feature of FreeCAD objects is their Placement. As we saw in earlier chapters, each object has a Placement property, which contains the position (Base) and orientation (Rotation) of the object. These properties are easy to manipulate from Python, for example to move our object:

Read more

Power user documentation
  • FreeCAD scripting:Python, Introduction to Python, Python scripting tutorial, FreeCAD Scripting Basics

Freecad Manual Ebook

  • Modules:Builtin modules, Units, Quantity
  • Workbenches:Workbench creation, Gui Commands, Commands, Installing more workbenches
  • Meshes and Parts:Mesh Scripting, Topological data scripting, Mesh to Part, PythonOCC
Freecad
  • Parametric objects:Scripted objects, Viewproviders(Custom icon in tree view)
  • Scenegraph:Coin (Inventor) scenegraph, Pivy
  • Graphical interface:Interface creation, Interface creation with UI files, Interface creation completely in Python(1, 2, 3, 4, 5), PySide, PySide examples beginner, intermediate, advanced
  • Macros:Macros, How to install macros
  • Embedding:Embedding FreeCAD, Embedding FreeCADGui
  • Other:Expressions, Code snippets, Line drawing function, FreeCAD vector math library(deprecated)

Freecad 0.18 Manual Pdf

  • Hubs:User hub, Power users hub, Developer hub

Freecad Manual Pdf

Manual
Retrieved from 'http://wiki.freecadweb.org/index.php?title=Manual:A_gentle_introduction&oldid=748816'