From 66609fc78756210a24fd9c0b2e644c96f073d902 Mon Sep 17 00:00:00 2001 From: Ghostkeeper Date: Sun, 26 Apr 2020 23:50:00 +0200 Subject: Add beginnings of a page on how to arrive at a setting value --- docs/profiles/getting_a_setting_value.md | 9 +++++++++ docs/profiles/profiles.md | 1 + 2 files changed, 10 insertions(+) create mode 100644 docs/profiles/getting_a_setting_value.md (limited to 'docs') 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 ---- -- cgit v1.2.3