Fine-tuning/it: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
(18 intermediate revisions by the same user not shown)
Line 3: Line 3:
{{TOCright}}
{{TOCright}}


== Introduction ==
Questa pagina contiene diversi riferimenti a impostazioni e parametri che è possibile utilizzare per ottimizzare l'installazione di FreeCAD o superare i problemi.

== Parametri di opzione ==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 17: Line 15:
<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
L'elenco seguente mostra i parametri che non sono accessibili tramite l'editor delle preferenze, ma che è anche possibile impostare manualmente:
L'elenco seguente mostra i parametri che non sono accessibili tramite l'editor delle preferenze, ma che è anche possibile impostare manualmente:
</div>
</div>

== General ==


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
Line 38: Line 38:
</div>
</div>


=== Export Default Filename ===
== Default export filename ==


<!--Please keep the settings in an A-Z order-->
<!--Please keep the settings in an A-Z order-->
* '''General/ExportDefaultFilenameMultiple''' (string): Set the default filename to use when exporting multiple objects. Defaults to "%F".
* '''General/ExportDefaultFilenameMultiple''' (string): Set the default filename to use when exporting multiple objects. Defaults to {{Value|%F}}.
* '''General/ExportDefaultFilenameSingle''' (string): Set the default filename to use when exporting a single object. Defaults to "%F-%P-".
* '''General/ExportDefaultFilenameSingle''' (string): Set the default filename to use when exporting a single object. Defaults to {{Value|%F-%P-}}.


Both of these options support the automatic insertion of various pieces of information into the filename, using the following format characters:
Both of these options support the automatic insertion of various pieces of information into the filename, using the following format characters:
Line 52: Line 52:
Any other characters are treated literally. If the resulting filename is illegal it will be changed on saving, with illegal characters replaced by the underscore (_).
Any other characters are treated literally. If the resulting filename is illegal it will be changed on saving, with illegal characters replaced by the underscore (_).


== Mouse related ==
=== Sketcher Constraint Label Colors ===

<!--Please keep the settings in an A-Z order-->
* '''General/ComboBoxWheelEventFilter''' (boolean): Set to {{TRUE}} so widgets do not catch mouse wheel event and prevent scrollable areas to be scrolled. Needs FreeCAD restart to be taken into account.
* '''View/GestureMoveThreshold''' (integer): the distance (px) mouse cursor has to move to enter rotation or pan modes of Gesture navigation style. Defaults to {{Value|5}}.
* '''View/GestureRollFwdCommand''', '''View/GestureRollBackCommand''' (string): commands to be executed by mouse button roll gestures of Gesture navigation style.
* '''View/GestureTapHoldTimeout''' (integer): sets for how long to wait (in milliseconds) to enter pan mode in Gesture navigation style. It can be helpful to increase it if dragging geometry in sketcher is difficult. Defaults to {{Value|700}}.

== Keyboard shortcuts ==

=== Escape key ===

<!--Please keep the settings in an A-Z order-->
* '''General/TasksKeyEsc''' (boolean): Create and set to {{FALSE}} to disable the {{KEY|ESC}} key exiting the [[Task_panel|Task panel]] in all workbenches (that is if the task panel has focus).

== Navigation Cube ==

See [[Navigation_Cube#Advanced_parameters|Navigation Cube]].

== Specific workbenches ==

=== [[Image:Workbench_BIM.svg|24px|link=BIM_Workbench]] [[BIM_Workbench|BIM Workbench]] ===

* '''Mod/BIM/DefaultPageScale''' (float): Default scaling for new TechDraw pages created from the BIM Workbench, in case the template doesn't contain any "Scale" or "Scaling" (case insensitive) editable text field.

=== [[Image:Workbench_CAM.svg|24px|link=CAM_Workbench]] [[CAM_Workbench|CAM Workbench]] ===

* The [[CAM_Workbench|CAM Workbench]] has two switches to enable experimental features documented on the [[CAM_experimental|CAM experimental]] page.

=== [[Image:Workbench_Draft.svg|24px|link=Draft_Workbench]] [[Draft_Workbench|Draft Workbench]] ===

* '''Mod/Draft/DefaultAnnoDisplayMode''' (integer): Set to {{Value|1}} to create Draft annotations ([[Draft_Text|texts]], [[Draft Dimension|dimensions]] and [[Draft Label|labels]]) with their {{PropertyView|Display Mode}} set to {{Value|Screen}}. Set to {{Value|0}} for new annotations with this property set to {{Value|World}}. Defaults to {{Value|0}}. {{Version|1.0}}
* '''Mod/Draft/GridHideInOtherWorkbenches''' (boolean): Set to {{FALSE}} to keep the [[Draft_ToggleGrid|Draft grid]] when switching to workbenches other than [[Arch Workbench|Arch]], [[BIM Workbench|BIM]] or [[Draft Workbench|Draft]]. Defaults to {{TRUE}}. {{Version|1.0}}
* '''Mod/Draft/useSupport''' (boolean): Set to {{TRUE}} to set the {{PropertyData|Support}} property of Draft objects created on a face of an exiting base object to that base object. This was standard behavior before FreeCAD version 0.19. Note that this parameter may not be supported in future versions. Defaults to {{FALSE}}.

=== [[Image:Workbench_Part.svg|24px|link=Part_Workbench]] [[Part_Workbench|Part Workbench]] ===

* '''Mod/Part/ParametricRefine''' (boolean): Set to {{FALSE}} so [[Part_RefineShape|Part RefineShape]] creates an independent copy rather than a linked one. Defaults to {{TRUE}}.

=== [[Image:Workbench_PartDesign.svg|24px|link=PartDesign_Workbench]] [[PartDesign_Workbench|PartDesign Workbench]] ===

* '''Mod/PartDesign/AdditiveHelixPreview''' (boolean): Set to {{TRUE}} to ensure an additive helix that does not intersect the body is visible in the preview. Defaults to {{FALSE}}.
* '''Mod/PartDesign/SubtractiveHelixPreview''' (boolean): Set to {{TRUE}} to ensure a subtractive helix that does not intersect the body is visible in the preview. Defaults to {{TRUE}}.
* '''Mod/PartDesign/SwitchToTask''' (boolean): Set to {{FALSE}} to prevent the [[PartDesign_Workbench|PartDesign Workbench]] from switching to the Task panel when starting. Defaults to {{TRUE}}.
* '''Mod/PartDesign/SwitchToWB''' (boolean): Set to {{FALSE}} to prevent the [[PartDesign_Workbench|PartDesign Workbench]] to be automatically called when a [[PartDesign_Body|PartDesign Body]] is activated. Defaults to {{TRUE}}.

=== [[Image:Workbench_Sketcher.svg|24px|link=Sketcher_Workbench]] [[Sketcher_Workbench|Sketcher Workbench]] ===

* '''Mod/Sketcher/RadiusDiameterConstraintDisplayAngleRandomness''' (float): Set an angle randomness on the above value. Value is the range of the random angle, centered on base angle. Defaults to {{Value|0}}.
* '''Mod/Sketcher/RadiusDiameterConstraintDisplayBaseAngle''' (float): Set the angle (from horizontal) used to display radius/diameter constraints in Sketcher at creation time. Defaults to {{Value|15}}.
* '''Mod/Sketcher/RoundRectangleSuggConstraints''' (boolean): Set to {{FALSE}} to disable the addition of two extra construction points when creating a rounded rectangle. {{Version|0.21}}

==== Constraint label colors ====


The label in Sketcher that displays the current status of the constraints (e.g. "Underconstrained," "Overconstrained," "Fully Constrained," etc.) is styleable on a per-state basis either using the Qt stylesheet, or via user preferences. User preferences take precedence if they have been set (in '''Mod/Sketcher/General'''):
The label in Sketcher that displays the current status of the constraints (e.g. "Underconstrained," "Fully Constrained," etc.) is styleable on a per-state basis either using the Qt stylesheet, or via user preferences. User preferences take precedence if they have been set (in '''Mod/Sketcher/General'''):
<!-- These are listed in "priority"/"severity" order, rather than alphabetical -->
<!-- These are listed in "priority"/"severity" order, rather than alphabetical -->
* '''EmptySketchMessageColor''' - Defaults to 50% opacity black
* '''EmptySketchMessageColor''' - Defaults to 50% opacity black
Line 65: Line 117:
* '''FullyConstrainedMessageColor''' - Defaults to green
* '''FullyConstrainedMessageColor''' - Defaults to green


=== [[Image:Workbench_Start.svg|24px|link=Start_Workbench]] [[Start_Workbench|Start Workbench]] ===
== Mouse related ==

<!--Please keep the settings in an A-Z order-->
* '''General/ComboBoxWheelEventFilter''' (boolean): Set to {{TRUE}} so widgets do not catch mouse wheel event and prevent scrollable areas to be scrolled. Needs FreeCAD restart to be taken into account.
* '''View/GestureMoveThreshold''' (integer): the distance (px) mouse cursor has to move to enter rotation or pan modes of Gesture navigation style. Default is 5.
* '''View/GestureRollFwdCommand''', '''View/GestureRollBackCommand''' (string): commands to be executed by mouse button roll gestures of Gesture navigation style.
* '''View/GestureTapHoldTimeout''' (integer): sets for how long to wait (in milliseconds) to enter pan mode in Gesture navigation style. It can be helpful to increase it if dragging geometry in sketcher is difficult. Default is 700.

== Keyboard Shortcuts ==

=== Escape Key ===

<!--Please keep the settings in an A-Z order-->
* '''General/TasksKeyEsc''' (boolean): Create and set to {{FALSE}} to disable the {{KEY|ESC}} key exiting the [[Task_panel|Task panel]] in all workbenches (that is if the task panel has focus). '''Note:''' Superceded by [[Sketcher_Preferences#General|Sketcher Preferences]].
* '''Mod/Sketcher/ViewKeyEsc''' (boolean): Create and set to {{FALSE}} to disable {{KEY|ESC}} key issues with pressing one to many times, when escaping sketcher geometry/constraints creation continue mode (see [https://forum.freecadweb.org/viewtopic.php?f=3&t=42207&start=60#p367584 forum thread])

== Specific Workbenches ==


* '''Mod/Start/DefaultImportXXX''' (string): Where XXX is a lowercase file extension. For example DefaultImportifc for .IFC files. Allows to set a default import module to be used when clicking an icon on the start page, when several importers are available. For example, setting DefaultImportifc = ifc_import will use the NativeIFC importer if available. {{Version|0.21}}
* [[Image:Workbench_TechDraw.svg|16px|link=TechDraw_Workbench]] [[TechDraw_Workbench|TechDraw Workbench]] has several hidden switches documented in [[TechDraw_Preferences#Hidden_Settings|TechDraw Preferences]].
* '''Mod/Start/TimeFormat''' (string): A time format string such as {{Value|%m/%d/%Y %H:%M:%S}} used for the date in the tooltip that is shown when an item on the start page is hovered.
* [[Image:Workbench_Path.svg|16px|link=Path_Workbench]] [[Path_Workbench|Path Workbench]] has a switch to enable experimental features documented in [[Path_experimental|Path experimental]].
* [[Image:Workbench_BIM.svg|16px|link=BIM_Workbench]] [[BIM_Workbench|BIM Workbench]]:
** '''Mod/BIM/DefaultPageScale''' (float): Default scaling for new TechDraw pages created from the BIM Workbench, in case the template doesn't contain any "Scale" or "Scaling" (text insensitive) editable text field.


=== [[Help_Module|Help Module]] ===
== Related ==


* '''Mod/Help/UseWebModule''' (boolean): Allows to force the use of the Web module to open MDI tabs. This can be useful to work around QWebEngine issues in some versions of Qt5. Defaults to {{FALSE}}. {{Version|1.0}}
* [[Std_DlgParameter|Parameter editor]]
* [[Preferences_editor|Preferences editor]]





Revision as of 10:23, 21 April 2024

Introduction

Per impostare e manipolare la tabella dei parametri di FreeCAD normalmente si usa l'editor delle preferenze nel menu Modifica → Preferenze.

Tuttavia, è anche possibile accedere, modificare e creare i parametri manualmente, usando l'editore dei parametri che si trova nel menu Strumenti → Modifica parametri.

L'elenco seguente mostra i parametri che non sono accessibili tramite l'editor delle preferenze, ma che è anche possibile impostare manualmente:

General

  • Mod/Part/ParametricRefine (boolean) : impostare su false in modo che Affina una forma crei una copia indipendente anziché una copia collegata. L'impostazione predefinita è true se il valore non esiste.
  • Mod/PartDesign/SwitchToTask (boolean): impostare su false per impedire a PartDesign di passare al pannello Azioni all'avvio. L'impostazione predefinita è true se il valore non esiste.
  • Mod/PartDesign/SwitchToWB (boolean): impostare su false per impedire che PartDesign venga chiamato automaticamente quando viene attivato un Corpo di PartDesign. L'impostazione predefinita è true se il valore non esiste.
  • Document/SaveThumbnailFix (boolean): impostare su true per risolvere un problema con Qt5 che impedisce la generazione delle miniature dei file .FCStd.
  • TechDraw ha diverse opzioni nascost e documentate nelle preferenze di TechDraw.
  • View/SavePicture (string): impostare su FramebufferObject, PixelBuffer o CoinOffscreenRenderer per i metodi diversi per produrre immagini dalla vista 3D
  • View/NaviStepByTurn (integer) : Definisce il numero di passaggi incrementali (tacche) per completare un giro quando si utilizzano le frecce di NaviCube. Se il valore non è definito, il valore predefinito è 8, il che significa che ogni incremento ruota di 360/8 = 45 gradi.
  • View/NavigationDebug (boolean) : abilita l'output di debug degli stili di navigazione (a partire dalla v0.19, riguarda solo lo stile di navigazione gestuale).
  • View/GestureRollFwdCommand, View/GestureRollBackCommand (string) : comandi da eseguire con i gesti di scorrimento del pulsante del mouse nello stile di navigazione gestuale.
  • View/GestureMoveThreshold (integer) : la distanza (px) che il cursore del mouse deve spostarsi per passare alle modalità di rotazione o panoramica nello stile di navigazione gestuale. L'impostazione predefinita è 5.
  • View/GestureTapHoldTimeout (integer) : imposta il tempo di attesa (in millisecondi) per entrare in modalità panoramica nello stile di navigazione gestuale. Può essere utile aumentarlo se il trascinamento della geometria nello sketcher è difficile. L'impostazione predefinita è 700.
  • Mod/Draft/defaultCameraHeight (int) : imposta l'altezza della videocamera all'avvio di Draft in un documento vuoto. 0 disabilita, l'impostazione di default è 5, buona quando si lavora in millimetri, una buona altezza per il lavoro per Arch è 4500
  • DockWindows/TreeView/Enabled (boolean): impostare su true per abilitare un widget agganciabile Struttura del documento indipendente dalla Vista combinata. Dopo aver modificato il valore del parametro, è necessario riavviare FreeCAD in modo che il widget sia disponibile nell'elenco Visualizza → Pannelli.
  • DockWindows/PropertyView/Enabled (boolean): impostare su true per abilitare un widget agganciabile Visualizza proprietà indipendente dalla Vista combinata. Dopo aver modificato il valore del parametro, è necessario riavviare FreeCAD in modo che il widget sia disponibile nell'elenco Visualizza → Pannelli.
  • DockWindows/DAGView/Enabled (boolean): Impostare su true per abilitare un widget agganciabile beta Vista DAG. Dopo aver modificato il valore del parametro, è necessario riavvire FreeCAD in modo che il widget sia disponibile nell'elenco Visualizza → Pannelli.
  • General/ComboBoxWheelEventFilter (boolean) : Impostare su true in modo che i widget non catturino gli eventi della rotellina del mouse e impediscano lo scorrimento delle aree scorrevoli.

Default export filename

  • General/ExportDefaultFilenameMultiple (string): Set the default filename to use when exporting multiple objects. Defaults to %F.
  • General/ExportDefaultFilenameSingle (string): Set the default filename to use when exporting a single object. Defaults to %F-%P-.

Both of these options support the automatic insertion of various pieces of information into the filename, using the following format characters:

  • %F - the name of the .FCStd file (or the label, if it is not saved yet)
  • %Lx - the label of the selected object(s), separated by character 'x'
  • %Px - the label of the selected object(s) and their first parent, separated by character 'x'
  • %U - the date and time, in UTC, ISO 8601
  • %D - the date and time, in local timezone, ISO 8601

Any other characters are treated literally. If the resulting filename is illegal it will be changed on saving, with illegal characters replaced by the underscore (_).

Mouse related

  • General/ComboBoxWheelEventFilter (boolean): Set to true so widgets do not catch mouse wheel event and prevent scrollable areas to be scrolled. Needs FreeCAD restart to be taken into account.
  • View/GestureMoveThreshold (integer): the distance (px) mouse cursor has to move to enter rotation or pan modes of Gesture navigation style. Defaults to 5.
  • View/GestureRollFwdCommand, View/GestureRollBackCommand (string): commands to be executed by mouse button roll gestures of Gesture navigation style.
  • View/GestureTapHoldTimeout (integer): sets for how long to wait (in milliseconds) to enter pan mode in Gesture navigation style. It can be helpful to increase it if dragging geometry in sketcher is difficult. Defaults to 700.

Keyboard shortcuts

Escape key

  • General/TasksKeyEsc (boolean): Create and set to false to disable the ESC key exiting the Task panel in all workbenches (that is if the task panel has focus).

Navigation Cube

See Navigation Cube.

Specific workbenches

BIM Workbench

  • Mod/BIM/DefaultPageScale (float): Default scaling for new TechDraw pages created from the BIM Workbench, in case the template doesn't contain any "Scale" or "Scaling" (case insensitive) editable text field.

CAM Workbench

Draft Workbench

  • Mod/Draft/DefaultAnnoDisplayMode (integer): Set to 1 to create Draft annotations (texts, dimensions and labels) with their VistaDisplay Mode set to Screen. Set to 0 for new annotations with this property set to World. Defaults to 0. introduced in version 1.0
  • Mod/Draft/GridHideInOtherWorkbenches (boolean): Set to false to keep the Draft grid when switching to workbenches other than Arch, BIM or Draft. Defaults to true. introduced in version 1.0
  • Mod/Draft/useSupport (boolean): Set to true to set the DatiSupport property of Draft objects created on a face of an exiting base object to that base object. This was standard behavior before FreeCAD version 0.19. Note that this parameter may not be supported in future versions. Defaults to false.

Part Workbench

  • Mod/Part/ParametricRefine (boolean): Set to false so Part RefineShape creates an independent copy rather than a linked one. Defaults to true.

PartDesign Workbench

  • Mod/PartDesign/AdditiveHelixPreview (boolean): Set to true to ensure an additive helix that does not intersect the body is visible in the preview. Defaults to false.
  • Mod/PartDesign/SubtractiveHelixPreview (boolean): Set to true to ensure a subtractive helix that does not intersect the body is visible in the preview. Defaults to true.
  • Mod/PartDesign/SwitchToTask (boolean): Set to false to prevent the PartDesign Workbench from switching to the Task panel when starting. Defaults to true.
  • Mod/PartDesign/SwitchToWB (boolean): Set to false to prevent the PartDesign Workbench to be automatically called when a PartDesign Body is activated. Defaults to true.

Sketcher Workbench

  • Mod/Sketcher/RadiusDiameterConstraintDisplayAngleRandomness (float): Set an angle randomness on the above value. Value is the range of the random angle, centered on base angle. Defaults to 0.
  • Mod/Sketcher/RadiusDiameterConstraintDisplayBaseAngle (float): Set the angle (from horizontal) used to display radius/diameter constraints in Sketcher at creation time. Defaults to 15.
  • Mod/Sketcher/RoundRectangleSuggConstraints (boolean): Set to false to disable the addition of two extra construction points when creating a rounded rectangle. introduced in version 0.21

Constraint label colors

The label in Sketcher that displays the current status of the constraints (e.g. "Underconstrained," "Fully Constrained," etc.) is styleable on a per-state basis either using the Qt stylesheet, or via user preferences. User preferences take precedence if they have been set (in Mod/Sketcher/General):

  • EmptySketchMessageColor - Defaults to 50% opacity black
  • UnderconstrainedMessageColor - Defaults to black
  • MalformedConstraintMessageColor - Defaults to red
  • ConflictingConstraintMessageColor - Defaults to red
  • RedundantConstraintMessageColor - Defaults to orange red
  • PartiallyRedundantConstraintMessageColor - Defaults to royal blue
  • SolverFailedMessageColor - Defaults to red
  • FullyConstrainedMessageColor - Defaults to green

Start Workbench

  • Mod/Start/DefaultImportXXX (string): Where XXX is a lowercase file extension. For example DefaultImportifc for .IFC files. Allows to set a default import module to be used when clicking an icon on the start page, when several importers are available. For example, setting DefaultImportifc = ifc_import will use the NativeIFC importer if available. introduced in version 0.21
  • Mod/Start/TimeFormat (string): A time format string such as %m/%d/%Y %H:%M:%S used for the date in the tooltip that is shown when an item on the start page is hovered.

Help Module

  • Mod/Help/UseWebModule (boolean): Allows to force the use of the Web module to open MDI tabs. This can be useful to work around QWebEngine issues in some versions of Qt5. Defaults to false. introduced in version 1.0