diff options
-rw-r--r-- | docs/profiles/getting_a_setting_value.md | 9 | ||||
-rw-r--r-- | docs/profiles/profiles.md | 1 |
2 files changed, 10 insertions, 0 deletions
diff --git a/docs/profiles/getting_a_setting_value.md b/docs/profiles/getting_a_setting_value.md new file mode 100644 index 0000000000..d9d1dc1b8d --- /dev/null +++ b/docs/profiles/getting_a_setting_value.md @@ -0,0 +1,9 @@ +Getting a Setting Value +==== +How Cura gets a setting's value is a complex endeavour that requires some explanation. The `value` property gets special treatment for this because there are a few other properties that influence the value. In this page we explain the algorithm to getting a setting value. + +This page explains all possible cases for a setting, but not all of them may apply. For instance, a global setting will not evaluate the per-object settings to get its value. Exceptions to the rules for other types of settings will be written down. + +Per Object Settings +---- +Per-object settings, which are added to an object using the per-object settings tool, will always prevail over other setting values. They are not evaluated with the rest of the settings system because Cura's front-end doesn't need to send all setting values for all objects to CuraEngine separately. It only sends over the per-object settings that get overridden. CuraEngine then evaluates settings that can be changed per-object using the list of settings for that object but if the object doesn't have the setting attached falls back on the settings in the object's extruder. Refer to the [CuraEngine](#CuraEngine) chapter to see how this works.
\ No newline at end of file diff --git a/docs/profiles/profiles.md b/docs/profiles/profiles.md index b2c0f8960f..544184d480 100644 --- a/docs/profiles/profiles.md +++ b/docs/profiles/profiles.md @@ -7,6 +7,7 @@ Index The following pages describe the profile and setting system of Cura: * [Container Stacks](container_stacks.md): Which profiles can be swapped out and how they are ordered when evaluating a setting. * [Setting Properties](setting_properties.md): What properties can each setting have? +* [Getting a Setting Value](getting_a_setting_value.md): How Cura arrives at a value for a certain setting. Glossary ---- |