Skip to content

Commit

Permalink
release 1.0 upgrade
Browse files Browse the repository at this point in the history
  • Loading branch information
yorikvanhavre committed Jan 13, 2025
1 parent 899cf2d commit 48e2607
Show file tree
Hide file tree
Showing 15,530 changed files with 847,499 additions and 682,678 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
2 changes: 0 additions & 2 deletions _config.yml

This file was deleted.

51 changes: 2 additions & 49 deletions wiki/3D_view.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,56 +13,9 @@ Certain properties of the view, like background color, [mouse navigation](Mouse_

*The [Draft Workbench](3D_view]]_is_a_component_of_the_FreeCAD_[[interface]]. By default it shows a small widget with coordinate axes, and the navigation cube also with coordinate axes; the grid can be displayed and configured by loading the [[Draft Workbench.md).*

## Actions
## Context menu

Since the [tree view](tree_view.md) lists most objects that are visible in the 3D view, many of the actions are the same to those that can be executed from the [tree view](tree_view.md).

When the default [Start Workbench](Start_Workbench.md) is active, right clicking on the 3D view shows only one command:

- **[Navigation styles](Mouse_navigation.md)**: different button styles to use with a 3-button mouse or laptop trackpad.

However, once a [Workbench](Workbenches.md) is loaded, there are additional commands:

- **Link actions**: [Make Link](Std_LinkMake.md).

-
**Make Link group**
: [Simple group](Std_LinkMakeGroup.md), [Group with links](Std_LinkMakeGroup.md), [Group with transform links](Std_LinkMakeGroup.md).

- **[Fit all](Std_ViewFitAll.md)**: pans and zooms the view to fit all objects in the document on the screen.

- **[Fit selection](Std_ViewFitSelection.md)**: pans and zooms the view to tightly fit the currently selected object on the screen.

- **[Draw style](Std_DrawStyle.md)**: as is, flat lines, shaded, wireframe, points, hidden line, no shading.

- **[Standard views](Std_View_Menu.md)**: [isometric](Std_ViewIsometric.md), [front](Std_ViewFront.md), [top](Std_ViewTop.md), [right](Std_ViewRight.md), [rear](Std_ViewRear.md), [bottom](Std_ViewBottom.md), [left](Std_ViewLeft.md), [rotate left](Std_ViewRotateLeft.md), [rotate right](Std_ViewRotateRight.md).

- **Measure**: [toggle measurement](View_Measure_Toggle_All.md), [clear measurement](View_Measure_Clear_All.md).

- **Document window**: [docked](Std_ViewDockUndockFullscreen.md), [undocked](Std_ViewDockUndockFullscreen.md), and [fullscreen](Std_ViewDockUndockFullscreen.md).

Additionally, depending on the workbench and object that is active, other contextual commands may become available.

For example, with the [Part Workbench](Part_Workbench.md) and one object selected:

- **[Appearance](Std_SetAppearance.md)**: launches the dialog to change color and sizes of lines and vertices, and color of faces.

- **[Toggle visibility](Std_ToggleVisibility.md)**: makes the object visible or invisible in the 3D view.

- **[Toggle selectability](Std_ToggleSelectability.md)**: makes the object no longer selectable in the 3D view; use again this command to cancel its effect. It sets the object\'s `Selectable` attribute to `True` or `False`. Change the property by toggling **Selectable** in the [property editor](property_editor.md).

- **[Go to selection](Std_TreeSelection.md)**: expand the [tree view](tree_view.md) to show the selected object in the hierarchy.

- **[Random color](Std_RandomColor.md)**: assigns a random color to the object. It sets the object\'s `ShapeColor` attribute to a tuple `(r,g,b)` with tree random floats between 0 and 1. Change the property by modifying **Shape Color** in the [property editor](property_editor.md).

- **[Delete](Std_Delete.md)**: removes the object from the document, and from the 3D view, by calling the document\'s `removeObject()` method.

Another example, with the [Draft Workbench](Draft_Workbench.md) and one object selected, it shows the same commands as with the [Part Workbench](Part_Workbench.md), but also:

- **Draft**: object creation and modification commands from the [Draft Workbench](Draft_Workbench.md).

- **Utilities**: additional contextual commands provided by the [Draft Workbench](Draft_Workbench.md).
The options in the context menu of the 3D view depend on the selected object(s) and the currently active workbench. To display this menu optionally select one or more objects and then right-click in the 3D view.

## Details

Expand Down
30 changes: 17 additions & 13 deletions wiki/3Dconnexion_input_devices.md
Original file line number Diff line number Diff line change
Expand Up @@ -203,7 +203,7 @@ sudo /etc/init.d/spacenavd restart

After that restart FreeCAD. On some distros this is necessary at each boot.

### Known Issues
#### Known Issues

A user reported on the [forum](https://forum.freecadweb.org/viewtopic.php?p=341327#p341327) they saw the following:

Expand All @@ -224,29 +224,33 @@ sudo spnavd_ctl x11 start
sudo systemctl restart spacenavd
```

### macOS
### MacOS

3Dconnexion input devices are supported on macOS, provided FreeCAD is built and used on a system with the 3Dconnexion drivers installed. You may need 3DxWare 10.7.2 or greater for macOS 12 Monterey.

### Windows

As of version 0.13, 3D mouse is supported under Windows. You need to have 3Dconnexion drivers installed.
As of version 0.13, 3D mouse is supported under Windows. You need to have 3Dconnexion drivers installed. In FreeCAD version 1.0 a [new integration with 3Dconnexion devices](https://github.com/FreeCAD/FreeCAD/pull/12929) has been introduced. If compiled with that integration, only recent hardware is supported: to support older devices users will need to self-compile with the FREECAD_3DCONNEXION_SUPPORT cMake variable set to \"Raw Input\". Windows users should be aware that 3Dconnexion\'s driver (*not* the code in FreeCAD) contains a telemetry package that communicates information about your installed software back to 3Dconnexion.

#### Known Issue
#### Known Issues

There is an issue where 3Dconnexion sends duplicate scroll events to FreeCAD, which causes the view to jump. To fix it:
- In FreeCAD version 1.0 and later changing settings in the 3DX config window may not have the expected results ([issue](https://github.com/FreeCAD/FreeCAD/issues/14044)). To fix this:
1. Stop the driver (by running Stop 3DxWare).
2. Go to **..<user>\AppData\Roaming\3Dconnexion\3DxWare\Cfg** and delete the **FreeCAD.xml** file.
3. Start the driver (by running Start 3DxWare).
4. Run FreeCAD and check if you can change the [Spaceball Motion](#Spaceball_Motion.md) settings.

1. Open 3Dconnexion Properties. You can double-click its icon in the Taskbar, next to the Windows clock.
2. Click on the Advanced Settings button.
3. Open FreeCAD or switch to an already-open FreeCAD window.
4. Switch back to 3Dconnexion Advanced Settings. Confirm that it says \"FreeCAD\" in the heading.
5. Uncheck all boxes on the page.
## Setting up FreeCAD

ref: <https://freecadweb.org/tracker/view.php?id=1893>

## Setting up FreeCAD
<small>(v1.0)</small>

: The 3Dconnexion manipulator can be set up in its driver app (3DxWare software).


{{VersionMinus|0.21}}

3D mouse support was made with *spnav project* on Linux, and on a very low level on Windows. This means there was no support for any settings for a device, since on Linux there is no good support for this, and on Windows it is overridden. This is why two additional pages were added to \"Customize\" dialog.
: If a Spaceball is detected the following tabs in the [Customize dialog](Interface_Customization.md) can be used to change settings:

<img alt="" src=images/Spaceball_Motion.png style="width:450px;"> <img alt="" src=images/Spaceball_Buttons.png style="width:450px;">

Expand Down
70 changes: 0 additions & 70 deletions wiki/ANSI_templates.md

This file was deleted.

2 changes: 1 addition & 1 deletion wiki/About_FreeCAD.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# <img alt="" src=images/Freecad_default.jpg style="width:1024px;"> About FreeCAD

**FreeCAD** is a general purpose [open source](http://en.wikipedia.org/wiki/Open_source) parametric 3D [**CAD**](http://en.wikipedia.org/wiki/CAD) modeler licensed under the [LGPL License](https://www.gnu.org/licenses/lgpl-3.0.en.html). FreeCAD is aimed directly at [mechanical engineering](http://en.wikipedia.org/wiki/Mechanical_engineering) and [product design](http://en.wikipedia.org/wiki/Product_design) but, being very generic, also fits in a wider range of uses around engineering, such as architecture, finite element analysis, 3D printing, and other tasks.
**FreeCAD** is a general purpose [open source](http://en.wikipedia.org/wiki/Open_source) parametric 3D [**CAD**](http://en.wikipedia.org/wiki/CAD) modeler licensed under the [LGPL License](License.md). FreeCAD is aimed directly at [mechanical engineering](http://en.wikipedia.org/wiki/Mechanical_engineering) and [product design](http://en.wikipedia.org/wiki/Product_design) but, being very generic, also fits in a wider range of uses around engineering, such as architecture, finite element analysis, 3D printing, and other tasks.

FreeCAD features tools similar to [CATIA](https://en.wikipedia.org/wiki/CATIA), [SolidWorks](http://en.wikipedia.org/wiki/Solidworks), [Solid Edge](http://en.wikipedia.org/wiki/Solid_Edge) or [Revit](https://en.wikipedia.org/wiki/Autodesk_Revit), and therefore also falls into the category of [**CAD**](http://en.wikipedia.org/wiki/CAD), [**PLM**](http://en.wikipedia.org/wiki/Product_Lifecycle_Management), [**CAx**](http://en.wikipedia.org/wiki/CAx), [**CAE**](http://en.wikipedia.org/wiki/Computer-aided_engineering) and [**BIM**](https://en.wikipedia.org/wiki/Building_information_modeling). It is a [feature based parametric modeler](http://en.wikipedia.org/wiki/Parametric_feature_based_modeler) with a modular software architecture making it possible to provide additional functionality without modifying the core system.

Expand Down
53 changes: 0 additions & 53 deletions wiki/Adding_a_new_mouse_navigation_option_to_FreeCAD.md

This file was deleted.

4 changes: 2 additions & 2 deletions wiki/AppImage.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,9 @@ For other types of installation see [Download](Download.md).



Stable Development
Stable Development

![](images/AppImage-logo.png ) [v0.21.2](https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/0.21.2) ![](images/AppImage-logo.png ) [Weekly build](https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds)
![](images/AppImage-logo.png ) [v1.0.0](https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/1.0.0) ![](images/AppImage-logo.png ) [Weekly build](https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds)

: style=\"text-align: center; font-size: 150%; \| Available FreeCAD AppImages \|+

Expand Down
8 changes: 4 additions & 4 deletions wiki/App_DocumentObjectGroup.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@

<img alt="" src=images/Folder.svg style="width:32px;">

An [App DocumentObjectGroup](App_DocumentObjectGroup.md) object, or formally an `App::DocumentObjectGroup`, is a simple element that allows grouping any type of [App DocumentObject](App_DocumentObject.md) in the [tree view](tree_view.md) no matter its type of data.
An [App DocumentObjectGroup](App_DocumentObjectGroup.md) object, or formally an `App::DocumentObjectGroup`, is a simple element that allows grouping any type of [App DocumentObject](App_DocumentObject.md) in the [tree view](Tree_view.md) no matter its type of data.

It was developed to organize the objects in the [tree view](tree_view.md) in a way that is logical for the user.
It was developed to organize the objects in the [tree view](Tree_view.md) in a way that is logical for the user.

<img alt="" src=images/FreeCAD_core_objects.svg style="width:800px;">

Expand All @@ -16,8 +16,8 @@ It was developed to organize the objects in the [tree view](tree_view.md) in a w
## Usage

1. Press the **[<img src=images/Std_Group.svg style="width:16px"> [Std Group](Std_Group.md)** button in the structure toolbar. An empty Group is created.
2. To add objects to a Group, select them in the [tree view](tree_view.md), and then drag and drop them over the Group.
3. To remove objects from a Group, drag them out of the Group, and onto the document label at the top of the [tree view](tree_view.md).
2. To add objects to a Group, select them in the [tree view](Tree_view.md), and then drag and drop them over the Group.
3. To remove objects from a Group, drag them out of the Group, and onto the document label at the top of the [tree view](Tree_view.md).

See the [Std Group](Std_Group.md) page for the complete information, including its use in [Scripting](Std_Group#Scripting.md).

Expand Down
2 changes: 1 addition & 1 deletion wiki/App_GeoFeature.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Some of the most important derived objects are the following:
- The [Part Feature](Part_Feature.md) class, the parent of most objects with 2D and 3D [topological shapes](Part_TopoShape.md).
- The [Mesh Feature](Mesh_Feature.md) class, the parent of most objects made from [meshes](Mesh_MeshObject.md), not solids.
- The [Fem FemMeshObject](FEM_Mesh.md) class, the parent of finite element meshes created with the [FEM Workbench](FEM_Workbench.md).
- The [Path Feature](Path_Feature.md) class, the parent of paths created with the [Path Workbench](Path_Workbench.md) for use in CNC machining.
- The [CAM Feature](CAM_Feature.md) class, the parent of paths created with the [CAM Workbench](CAM_Workbench.md) for use in CNC machining.
- The [App Part](App_Part.md) class, which defines [Std Parts](Std_Part.md) that can be used as containers of bodies to perform assemblies.

When creating this object in [Python](Python.md), instead of sub-classing `App::GeoFeature`, you should sub-class `App::GeometryPython` because the latter includes a default view provider, and `Proxy` attributes for the object itself, and its view provider. See [Scripting](App_GeoFeature#Scripting.md).
Expand Down
Loading

0 comments on commit 48e2607

Please sign in to comment.