Sidecar Files - Processing Profiles - Revision history

DrSlony at 11:48, 9 March 2023

2023-03-09T11:48:34Z

← Older revision		Revision as of 11:48, 9 March 2023
Line 1:		Line 1:
	~~<div class="pagetitle">Sidecar Files / Processing Profiles</div>~~

	== Introduction ==		== Introduction ==

DrSlony at 21:58, 4 August 2021

2021-08-04T21:58:07Z

← Older revision		Revision as of 21:58, 4 August 2021
Line 16:		Line 16:

	== Sources ==		== Sources ==

	Processing profiles come from three quite different sources, though they work in exactly the same way:		Processing profiles come from three quite different sources, though they work in exactly the same way:
	* "Bundled profiles".		* "Bundled profiles".
Line 25:		Line 26:

	== Saving ==		== Saving ==

	As simply viewing the image requires processing, RawTherapee stores the settings it used to show you the image in a sidecar processing profile. That processing profile also stores all the tool tweaks you made in the Editor tab.		As simply viewing the image requires processing, RawTherapee stores the settings it used to show you the image in a sidecar processing profile. That processing profile also stores all the tool tweaks you made in the Editor tab.

Line 40:		Line 42:

	== Storage ==		== Storage ==

	Where the processing profile is stored can be configured in [[Preferences#Processing_Profile_Handling\|Preferences > Processing Profile Handling]].		Where the processing profile is stored can be configured in [[Preferences#Processing_Profile_Handling\|Preferences > Processing Profile Handling]].

Line 47:		Line 50:

	== Defaults ==		== Defaults ==

	The default processing profile used when opening '''non-raw''' images is called "[[Neutral]]". This profile has all tool settings at their neutral values, so they have no effect. Since non-raw images usually have already been processed and are ready for viewing, having RawTherapee not introduce any tweaks by default is the desirable behavior.		The default processing profile used when opening '''non-raw''' images is called "[[Neutral]]". This profile has all tool settings at their neutral values, so they have no effect. Since non-raw images usually have already been processed and are ready for viewing, having RawTherapee not introduce any tweaks by default is the desirable behavior.

Line 56:		Line 60:

	== Partial Processing Profiles and Fill Modes ==		== Partial Processing Profiles and Fill Modes ==
	~~Application and storage of processing profiles is controlled by the buttons in the top right corner of the editor.~~

	~~<div class="image-sample">~~[[File:Processing-profiles-selector.png\|~~left~~\|frame]]~~Clicking the four right-hand buttons handles opening,~~ saving, copying and pasting the ~~profiles~~ in full, while ~~Ctrl~~+clicking ~~handles them in partially~~. When ~~using the latter~~, a ~~window~~ pops up ~~to let~~ you choose which parameters to include. This allows you to~~, for example,~~ copy only the noise reduction parameters from one image to another, ~~or only the white balance, or any~~ other ~~selection of~~ parameters. ~~Note that~~ when ~~loading~~ or ~~saving~~ a profile~~, the parameter window appears after the file selection dialog~~.~~</div>~~		[[File:Processing-profiles-selector.png\|center\|frame\|The processing profile buttons.]]

			Processing profile storage (saving to a file or copying to memory) and application (loading from a file or pasting from memory) can be partial, where only a subset of the parameters are involved, or full, involving all parameters. These operations are performed using the buttons in the [[Editor#Processing_Profile_Selector\|Processing Profile Selector]] located in the top-right corner of the [[Editor]] tab. Clicking these buttons invokes an operation on the full profile, while {{k\|ctrl}}+clicking invokes an operation only on a subset of parameters. When a partial operation is invoked, a windows pops up letting you choose which parameters to include. This feature, for instance, allows you to copy only the white balance and noise reduction parameters from one image to another, while omitting all other parameters.

			The processing profile fill mode allows you to decide what happens when you apply (load or paste) a partial processing profile.

	The processing profile fill mode lets you decide what happens when you use the drop-down list to apply a processing profile to an image when that profile does not contain information about all of the tool settings.		* [[image:Profile-filled.png]] "Fill" mode takes missing values from RawTherapee's hard-coded defaults. For instance, if you apply a partial profile containing only sharpening settings, all of the remaining tools will be set to their default parameters, overwriting any edits you have made.
	* ~~"Fill" mode~~ [[image:Profile-filled.png]] takes ~~any~~ missing values from RawTherapee's hard-coded defaults. For instance if you apply a partial profile containing only sharpening settings, all of the remaining tools will ~~pop into~~ their default ~~positions~~ overwriting any ~~edit~~ you have made ~~up to that point~~.		* [[image:Profile-partial.png]] "Preserve" mode applies only those parameters that are available in the partial profile and leaves missing values unchanged. Using the previous example, only the sharpening settings would be applied and all other parameters would be left intact.
	* ~~"Preserve" mode~~ [[image:Profile-partial.png]] applies only those ~~values~~ that are available in the profile and ~~leave~~ missing values unchanged.

	Most of the profiles that come bundled with RawTherapee are partial profiles. The ~~article on~~ [[File Paths]] explains where ~~on your system you can find~~ the ~~available~~ processing profiles shown in the drop-down list.		Most of the profiles that come bundled with RawTherapee are partial profiles. The [[File Paths]] article explains where the processing profiles shown in the drop-down list can be found on your file system.

	== Creating Your Own Processing Profiles ==		== Creating Your Own Processing Profiles ==

	Using certain tools in certain ways may make your processing profile only usable with that specific image. For example if you set a white balance, cropping and rotation, you won't get good results if you apply that profile to an image taken under different lighting with the camera rotated any other way. See the article [[Creating processing profiles for general use]] for advice on how to make processing profiles which can be used on many images.		Using certain tools in certain ways may make your processing profile only usable with that specific image. For example if you set a white balance, cropping and rotation, you won't get good results if you apply that profile to an image taken under different lighting with the camera rotated any other way. See the article [[Creating processing profiles for general use]] for advice on how to make processing profiles which can be used on many images.

	== Compatibility ==		== Compatibility ==

	Processing profiles evolve from one version of RawTherapee to the next. We strive to ensure backward compatibility (e.g. a profile created in 5.3 and opened in 5.4 should look the same), but this is not always possible.		Processing profiles evolve from one version of RawTherapee to the next. We strive to ensure backward compatibility (e.g. a profile created in 5.3 and opened in 5.4 should look the same), but this is not always possible.

Thanatomanic: Extended description on profile toolbar, including image and clarification of operation order (first file selection, then parameter selection)

2021-03-22T06:00:06Z

Extended description on profile toolbar, including image and clarification of operation order (first file selection, then parameter selection)

← Older revision		Revision as of 06:00, 22 March 2021
Line 56:		Line 56:

	== Partial Processing Profiles and Fill Modes ==		== Partial Processing Profiles and Fill Modes ==
	~~Processing~~ profiles ~~can be copied, pasted, loaded, saved and applied in full or partially. Clicking~~ the buttons in the [[The_Image_Editor_Tab#Processing_Profile_Selector\|Processing Profile Selector]] handles them in full, while ctrl+clicking those buttons handles them partially - a windows pops up letting you choose which parameters to include. This feature lets you, for example, copy only the noise reduction parameters from one image to another, or only the ~~white balance, or only both~~.		Application and storage of processing profiles is controlled by the buttons in the top right corner of the editor.

	The processing profile fill mode lets you decide what happens when you apply a processing profile to an image when that profile does not contain information about all of the tool settings.		<div class="image-sample">[[File:Processing-profiles-selector.png\|left\|frame]]Clicking the four right-hand buttons handles opening, saving, copying and pasting the profiles in full, while Ctrl+clicking handles them in partially. When using the latter, a window pops up to let you choose which parameters to include. This allows you to, for example, copy only the noise reduction parameters from one image to another, or only the white balance, or any other selection of parameters. Note that when loading or saving a profile, the parameter window appears after the file selection dialog.</div>
	* "Fill" mode [[image:Profile-filled.png]]
	*: When in "Fill mode", the missing values ~~will be taken~~ from RawTherapee's hard-coded ~~default values (typically neutral)~~. For instance if you apply a partial profile ~~which contains~~ only sharpening settings, all of the remaining tools ~~(such as Exposure, Tone Mapping, Noise Reduction, Resize, etc)~~ will pop into their default positions.		The processing profile fill mode lets you decide what happens when you use the drop-down list to apply a processing profile to an image when that profile does not contain information about all of the tool settings.
	* "Preserve" mode [[image:Profile-partial.png]]		* "Fill" mode [[image:Profile-filled.png]] takes any missing values from RawTherapee's hard-coded defaults. For instance if you apply a partial profile containing only sharpening settings, all of the remaining tools will pop into their default positions overwriting any edit you have made up to that point.
	*: When in "Preserve mode", only those values in the profile ~~will be applied,~~ and ~~the~~ missing ~~ones remain~~ unchanged.		* "Preserve" mode [[image:Profile-partial.png]] applies only those values that are available in the profile and leave missing values unchanged.

			Most of the profiles that come bundled with RawTherapee are partial profiles. The article on [[File Paths]] explains where on your system you can find the available processing profiles shown in the drop-down list.

	== Creating Your Own Processing Profiles ==		== Creating Your Own Processing Profiles ==

DrSlony at 21:36, 9 December 2019

2019-12-09T21:36:04Z

← Older revision		Revision as of 21:36, 9 December 2019
Line 1:		Line 1:
			<div class="pagetitle">Sidecar Files / Processing Profiles</div>

	== Introduction ==		== Introduction ==

DrSlony: /* Creating your own processing profiles */ Title-case for section

2018-04-03T15:36:02Z

Creating your own processing profiles: Title-case for section

← Older revision		Revision as of 15:36, 3 April 2018
Line 62:		Line 62:
	*: When in "Preserve mode", only those values in the profile will be applied, and the missing ones remain unchanged.		*: When in "Preserve mode", only those values in the profile will be applied, and the missing ones remain unchanged.

	== Creating ~~your own processing profiles~~ ==		== Creating Your Own Processing Profiles ==
	Using certain tools in certain ways may make your processing profile only usable with that specific image. For example if you set a white balance, cropping and rotation, you won't get good results if you apply that profile to an image taken under different lighting with the camera rotated any other way. See the article [[Creating processing profiles for general use]] for advice on how to make processing profiles which can be used on many images.		Using certain tools in certain ways may make your processing profile only usable with that specific image. For example if you set a white balance, cropping and rotation, you won't get good results if you apply that profile to an image taken under different lighting with the camera rotated any other way. See the article [[Creating processing profiles for general use]] for advice on how to make processing profiles which can be used on many images.

DrSlony: Updated

2018-04-03T15:04:54Z

Updated

DrSlony: fixed typo

2017-12-28T21:05:54Z

fixed typo

← Older revision		Revision as of 21:05, 28 December 2017
Line 1:		Line 1:
	== Introduction ==		== Introduction ==

	Processing profiles (with a PP3 extension for version 3 or PP2 for the older version 2) are text files which contain all of the tool settings which RawTherapee applies to the associated photo. If you are familiar with other raw processors, you may know their equivalent as "presets". They are stored alongside their associated photos, which is why they are also called ([https://en.wikipedia.org/wiki/Sidecar_file sidecar files].		Processing profiles (with a PP3 extension for version 3 or PP2 for the older version 2) are text files which contain all of the tool settings which RawTherapee applies to the associated photo. If you are familiar with other raw processors, you may know their equivalent as "presets". They are stored alongside their associated photos, which is why they are also called [https://en.wikipedia.org/wiki/Sidecar_file sidecar files].

	When you open a folder with photos in RawTherapee's File Browser for the first time, none of the images will have PP3 sidecar files. The thumbnails shown for images which have no processing profile assigned (images which have never been opened or edited) are created from the embedded JPEG image each raw file contains. A processing profile is assigned to the image the moment one of these actions are taken:		When you open a folder with photos in RawTherapee's File Browser for the first time, none of the images will have PP3 sidecar files. The thumbnails shown for images which have no processing profile assigned (images which have never been opened or edited) are created from the embedded JPEG image each raw file contains. A processing profile is assigned to the image the moment one of these actions are taken:

DrSlony: /* Storage */

2017-12-27T10:32:01Z

Storage

← Older revision		Revision as of 10:32, 27 December 2017
Line 38:		Line 38:
	Where the processing profile is stored can be configured in [[Preferences#Processing_Profile_Handling\|Preferences > Processing Profile Handling]].		Where the processing profile is stored can be configured in [[Preferences#Processing_Profile_Handling\|Preferences > Processing Profile Handling]].

	By default, the processing profile for an image is stored alongside the input image (if you open ~~"''~~kitty.raw~~''"~~, a new file ~~"''~~kitty.raw.pp3~~''"~~ will be created next to it), but they can also be stored in a [[File_Paths\|central cache]]. You can choose whether RawTherapee should use the cache, write the processing profile alongside the image, or both, from "''Preferences > Image Processing''". We suggest you store these files alongside your input image files so that if you decide to move the images you can move the processing profiles easily along with them.		By default, the processing profile for an image is stored alongside the input image (if you open <code>kitty.raw</code>, a new file <code>kitty.raw.pp3</code> will be created next to it), but they can also be stored in a [[File_Paths\|central cache]]. You can choose whether RawTherapee should use the cache, write the processing profile alongside the image, or both, from "''Preferences > Image Processing''". We suggest you store these files alongside your input image files so that if you decide to move the images you can move the processing profiles easily along with them.

			When saving an image you have the option of ticking the "Save processing parameters with image" checkbox. If it is ticked, and if you are working on <code>kitty.raw</code> and saving to a JPG file, then the processing profile used to develop that image will be stored in a file called <code>kitty.jpg.out.pp3</code>. The ".out" part if there so that conflicts do not occur if you are working on a non-raw file.

	== Defaults ==		== Defaults ==

DrSlony: /* Saving */

2017-12-27T10:23:50Z

Saving

← Older revision		Revision as of 10:23, 27 December 2017
Line 26:		Line 26:
	The processing profile is written to disk:		The processing profile is written to disk:
	* When you close RawTherapee.		* When you close RawTherapee.
	* When you close an Editor tab if using [[The_Image_Editor_Tab#Editor_Tab_Modes\|Multiple Editor Tabs Mode]].		* When you close an Editor tab if using [[The_Image_Editor_Tab#Editor_Tab_Modes\|Multiple Editor Tabs Mode]] (METM).
			* When you open a different image if using [[The_Image_Editor_Tab#Editor_Tab_Modes\|Single Editor Tab Mode]] (SETM).
	* When you manually save it using the [[The_Image_Editor_Tab#Processing_Profile_Selector\|Processing Profile Selector]] panel in the Editor tab.		* When you manually save it using the [[The_Image_Editor_Tab#Processing_Profile_Selector\|Processing Profile Selector]] panel in the Editor tab.
	* When you use the "force saving current settings to the processing profile" [[Keyboard_Shortcuts\|keyboard shortcut]] from the Editor tab.		* When you use the "force saving current settings to the processing profile" [[Keyboard_Shortcuts\|keyboard shortcut]] from the Editor tab.

DrSlony: Major update, #4104

2017-12-26T14:28:34Z

Major update, #4104

@@ Line 1: / Line 1: @@
-Processing profiles ([https://en.wikipedia.org/wiki/Sidecar_file sidecar files] with a PP3 extension for version 3, or PP2 for the older version 2) are text files which contain all of the tools and their settings that RawTherapee will apply to an image. If you are familiar with other raw processors, you may know their equivalent as "presets". Processing profiles come from three quite different sources, though they work in exactly the same way:
+== Introduction ==
 * "Bundled profiles".
 *: RawTherapee comes with a bundle of profiles. Their purpose is to give you a good starting point, to demonstrate how the tools can be used together. They are the ones you see in the [[The Image Editor Tab#Processing Profile Selector|Processing Profile Selector]] drop-down list's "Bundled profiles" section, in the [[The_Image_Editor_Tab|Image Editor]].
@@ Line 5: / Line 19: @@
 *: When you make a processing profile which you want to re-use, for example one which works well with your camera and your style, you can save it so that it also appears in the Processing Profile Selector drop-down list, in the "My profiles" section. To have it appear there, save it to the "profiles" folder within the "config" folder - see the [[File Paths]] article to find it.
 * Automatically generated profiles.
-*: Whenever you edit an image, the tool settings you want applied to that image are stored in a processing profile that is particular to that image (ranking information, the history panel contents and snapshots are not stored in these files yet, see [https://code.google.com/p/rawtherapee/issues/detail?id=473 issue 473]). The rest of this section deals with this type of processing profile though many of the comments also apply to the first.
+*: Whenever you edit an image, the tool settings you want applied to that image are stored in a processing profile that is particular to that image (ranking information, the history panel contents and snapshots are not stored in these files yet, see [https://code.google.com/p/rawtherapee/issues/detail?id=473 issue 473]).
-By default, the processing profile for an image is stored alongside the input image (if you open "''kitty.raw''", a new file "''kitty.raw.pp3''" will be created next to it), but they can also be stored in a [[File_Paths | central cache]]. You can choose whether RawTherapee should use the cache, write the processing profile alongside the image, or both, from "''Preferences > Image Processing''". We suggest you store these files alongside your input image files so that if you decide to move the images you can move the processing profiles easily along with them.
+== Compatibility ==
-Processing profiles evolve from one version of RawTherapee to the next. We strive to ensure backward compatibility, but this is not always possible. Processing profiles can gain new parameters or lose the ones that became obsolete. Tool behavior can also evolve, wherein default values change or in extreme cases the meaning of a value is interpreted differently; an example of this is the noise reduction tool, where a luminance noise reduction value of 10 in RawTherapee-3.0 would lead to a different result in RawTherapee-4.0.10 where the whole noise reduction engine has been greatly improved.
+Processing profiles can gain new parameters or lose ones which became obsolete. Tool behavior can also evolve, wherein default values change or in extreme cases the meaning of a value is interpreted differently; an example of this is the noise reduction tool, where a luminance noise reduction value of 10 in RawTherapee-3.0 would lead to a different result in RawTherapee-4.0.10 as the whole noise reduction engine has been greatly improved.
-Consolidating processing profiles into a cache allows one to store isolated copies of the processing profiles per specific version of RawTherapee. In such a case, the cache can be used to re-process photos in order to get the same output as originally intended (but e.g. with a new size or output color space) using the same version of RawTherapee in which the image was originally edited. Whether this is desirable is debatable. Consider that you want to squeeze as much out of your raw files as possible. If a year later you want to go back to an old raw file, perhaps getting the same result as you did a year ago is not the best idea, because RawTherapee's capabilities would have greatly improved in that year, and your taste and skill would also have evolved. Nevertheless, by backing up whole cache directories when installing a new version of RawTherapee you retain the option of going back to an older version of RawTherapee in order to get the exact same result.
+Consolidating processing profiles into a cache allows one to store isolated copies of the processing profiles per specific version of RawTherapee. In such a case, the cache can be used to re-process photos in order to get the same output as originally intended (but e.g. with a new size or output color space) using the same version of RawTherapee in which the image was originally edited. Whether this is desirable is debatable. Consider that you want to squeeze as much out of your raw files as possible. If two years later you want to go back to an old raw file, perhaps getting the same result as you did two years ago is not the best idea, because RawTherapee's capabilities would have greatly improved in that time, you may have acquired a better monitor, and your taste and skill would also have evolved. Nevertheless, by backing up the whole cache folder, when installing a new version of RawTherapee you retain the option of going back to an older version of RawTherapee in order to get the exact same result.
 The [[File Paths]] article describes where you can find the "''cache''" and "''config''" folders on your system.

← Older revision		Revision as of 15:04, 3 April 2018
Line 3:		Line 3:
	Processing profiles (with a PP3 extension for version 3 or PP2 for the older version 2) are text files which contain all of the tool settings which RawTherapee applies to the associated photo. If you are familiar with other raw processors, you may know their equivalent as "presets". They are stored alongside their associated photos, which is why they are also called [https://en.wikipedia.org/wiki/Sidecar_file sidecar files].		Processing profiles (with a PP3 extension for version 3 or PP2 for the older version 2) are text files which contain all of the tool settings which RawTherapee applies to the associated photo. If you are familiar with other raw processors, you may know their equivalent as "presets". They are stored alongside their associated photos, which is why they are also called [https://en.wikipedia.org/wiki/Sidecar_file sidecar files].

	When you open a folder with photos in RawTherapee's File Browser for the first time, none of the images will have PP3 sidecar files. The thumbnails shown for images which have no processing profile assigned (images which have never been opened or edited) are created from the ~~embedded~~ JPEG image each raw file ~~contains~~. A processing profile is assigned to the image the moment one of these actions are taken:		When you open a folder with photos in RawTherapee's File Browser for the first time, none of the images will have PP3 sidecar files. The thumbnails shown for images which have no processing profile assigned (images which have never been opened or edited) are created from the JPEG image embedded in each raw file. A processing profile is assigned to the image the moment one of these actions are taken:
	* You open the photo for [[The Image Editor Tab\|editing]].		* You open the photo for [[The Image Editor Tab\|editing]].
	* You apply a processing profile by using the right-click context menu in the [[The File Browser Tab\|File Browser]] or [[The_Image_Editor_Tab#The_Filmstrip\|Filmstrip]].		* You apply a processing profile manually, by using the right-click context menu in the [[The File Browser Tab\|File Browser]] or [[The_Image_Editor_Tab#The_Filmstrip\|Filmstrip]].
			* You apply a [[Dynamic processing profiles\|dynamic processing profile]].

	When you open an image for editing, or when ~~you apply~~ a processing profile ~~by right-clicking on a thumbnail~~, RawTherapee will convert the real raw data into a viewable image. In order to do this, there are many settings which need to be set to ''something'', and what these specific values are depends on:		When you open an image for editing, or when a processing profile is assigned, RawTherapee will convert the real raw data into a viewable image. In order to do this, there are many settings which need to be set to ''something'', and what these specific values are depends on:
	* Your [[Preferences#Default_Processing_Profile\|default processing profile]].		* Your [[Preferences#Default_Processing_Profile\|default processing profile]].
	* Your [[Dynamic processing profiles\|~~Dynamic Profile Rules~~]], if any.		* Your [[Dynamic processing profiles\|dynamic processing profile rules]], if any.
	* Or on the processing profile you selected from the right-click context menu if you right-clicked on a thumbnail.		* Or on the processing profile you selected from the right-click context menu if you right-clicked on a thumbnail.

Line 19:		Line 20:
	*: When you make a processing profile which you want to re-use, for example one which works well with your camera and your style, you can save it so that it also appears in the Processing Profile Selector drop-down list, in the "My profiles" section. To have it appear there, save it to the "profiles" folder within the "config" folder - see the [[File Paths]] article to find it.		*: When you make a processing profile which you want to re-use, for example one which works well with your camera and your style, you can save it so that it also appears in the Processing Profile Selector drop-down list, in the "My profiles" section. To have it appear there, save it to the "profiles" folder within the "config" folder - see the [[File Paths]] article to find it.
	* Automatically generated profiles.		* Automatically generated profiles.
	*: Whenever you edit an image, the tool settings you want applied to that image are stored in a processing profile that is particular to that image (ranking information, the history panel contents and snapshots are not stored in these files yet, see [https://code.google.com/p/rawtherapee/issues/detail?id=473 issue 473]).		*: Whenever you edit an image, the tool settings you want applied to that image are stored in a processing profile that is particular to that image (ranking information, the history panel contents and snapshots are not stored in these files yet, see [https://code.google.com/p/rawtherapee/issues/detail?id=473 issue #473]).

	== Saving ==		== Saving ==
	As simply viewing the image requires processing, RawTherapee stores the settings it used to show you the image in a sidecar processing profile. It also stores all the tool tweaks you made in the Editor tab.		As simply viewing the image requires processing, RawTherapee stores the settings it used to show you the image in a sidecar processing profile. That processing profile also stores all the tool tweaks you made in the Editor tab.

	The processing profile is written to disk:		The processing profile is written to disk:
	* When you ~~close RawTherapee~~.		* When you apply a processing profile manually or using a dynamic profile.
	* When you close an Editor tab if using [[The_Image_Editor_Tab#Editor_Tab_Modes\|Multiple Editor Tabs Mode]] (METM).		* When you close the current image (the Editor tab) if using [[The_Image_Editor_Tab#Editor_Tab_Modes\|Multiple Editor Tabs Mode]] (METM).
	* When you ~~open~~ a different image if using [[The_Image_Editor_Tab#Editor_Tab_Modes\|Single Editor Tab Mode]] (SETM).		* When you close the current image by opening a different image if using [[The_Image_Editor_Tab#Editor_Tab_Modes\|Single Editor Tab Mode]] (SETM).
	* When you manually save it using the [[The_Image_Editor_Tab#Processing_Profile_Selector\|Processing Profile Selector]] panel in the Editor tab.		* When you close the current image by closing RawTherapee.
			* When you manually save the processing profile using the [[The_Image_Editor_Tab#Processing_Profile_Selector\|Processing Profile Selector]] panel in the Editor tab.
	* When you use the "force saving current settings to the processing profile" [[Keyboard_Shortcuts\|keyboard shortcut]] from the Editor tab.		* When you use the "force saving current settings to the processing profile" [[Keyboard_Shortcuts\|keyboard shortcut]] from the Editor tab.

	If a photo has an associated processing profile, a green check mark will appear on its thumbnail.		If a photo has an associated processing profile, a green check mark will appear over its thumbnail.

	If you have a photo opened in an Editor tab and you make changes to it from the File Browser, the changes are reflected immediately in the Editor tab.		If you have a photo opened in an Editor tab and you make changes to it from the File Browser, the changes are reflected immediately in the Editor tab.
Line 43:		Line 45:

	== Defaults ==		== Defaults ==
	The default processing profile used when opening non-raw images is called "[[Neutral]]". This profile has all tool settings at their neutral values, so they have no effect. Since non-raw images usually have already been processed and are ready for viewing, having RawTherapee not introduce any tweaks by default is the desirable behavior.		The default processing profile used when opening '''non-raw''' images is called "[[Neutral]]". This profile has all tool settings at their neutral values, so they have no effect. Since non-raw images usually have already been processed and are ready for viewing, having RawTherapee not introduce any tweaks by default is the desirable behavior.

	The default profile for raw photos is called "[[~~Default~~]]". ~~All but~~ the ~~most basic tools are at their neutral settings. The few tools which are activated (such as Exposure Auto~~-~~Levels~~, ~~Sharpening and Raw Chromatic Aberration Correction) serve only to give you~~ a ~~good~~ starting point ~~in processing your image~~.		The default profile for '''raw''' photos is called "[[Auto-Matched Curve]]" (from RawTherapee 5.4 onward). This profile makes your raw image look like the out-of-camera JPEG, which is usually a desirable starting point.

	Furthermore, most tools in the Editor tab have a reset button.		Furthermore, most tools in the Editor tab have a reset button.
Line 52:		Line 54:

	== Partial Processing Profiles and Fill Modes ==		== Partial Processing Profiles and Fill Modes ==
	Processing profiles can be copied, pasted, loaded, saved and applied in full or partially. Clicking the buttons in the [[The_Image_Editor_Tab#Processing_Profile_Selector\|Processing Profile Selector]] handles them in full, while ctrl+clicking those buttons handles them partially - a windows pops up letting you choose which parameters to ~~use~~. This feature lets you, for example, copy only the noise reduction parameters from one image to another, or only the white balance, or only both.		Processing profiles can be copied, pasted, loaded, saved and applied in full or partially. Clicking the buttons in the [[The_Image_Editor_Tab#Processing_Profile_Selector\|Processing Profile Selector]] handles them in full, while ctrl+clicking those buttons handles them partially - a windows pops up letting you choose which parameters to include. This feature lets you, for example, copy only the noise reduction parameters from one image to another, or only the white balance, or only both.

	The processing profile fill mode lets you decide what happens when you apply a processing profile to an image when that profile does not contain information about all of the tool settings.		The processing profile fill mode lets you decide what happens when you apply a processing profile to an image when that profile does not contain information about all of the tool settings.
Line 64:		Line 66:

	== Compatibility ==		== Compatibility ==
	Processing profiles evolve from one version of RawTherapee to the next. We strive to ensure backward compatibility, but this is not always possible.		Processing profiles evolve from one version of RawTherapee to the next. We strive to ensure backward compatibility (e.g. a profile created in 5.3 and opened in 5.4 should look the same), but this is not always possible.

	Processing profiles can gain new parameters or lose ones which became obsolete. Tool behavior can also evolve, wherein default values change or in extreme cases the meaning of a value is interpreted differently; an example of this is the noise reduction tool, where a luminance noise reduction value of 10 in RawTherapee-3.0 would lead to a different result in RawTherapee-4.0.10 as the whole noise reduction engine has been greatly improved.		Processing profiles can gain new parameters or lose ones which became obsolete. Tool behavior can also evolve, wherein default values change or in extreme cases the meaning of a value is interpreted differently; an example of this is the noise reduction tool, where a luminance noise reduction value of 10 in RawTherapee-3.0 would lead to a different result in RawTherapee-4.0.10 as the whole noise reduction engine has been greatly improved.
Line 73:		Line 75:

	When releasing a major new version of RawTherapee, it may happen that we use a new suffix for the "''cache''" and "''config''" folders. This means that the new version of RawTherapee will not see your old configuration or processing profiles. Though this sounds undesirable, there are good reasons we may (rarely) choose to do that.		When releasing a major new version of RawTherapee, it may happen that we use a new suffix for the "''cache''" and "''config''" folders. This means that the new version of RawTherapee will not see your old configuration or processing profiles. Though this sounds undesirable, there are good reasons we may (rarely) choose to do that.
	* Backward-compatibility. There may be changes in behavior between old and new versions of a specific tool. For instance, the effects of the Auto Levels tool have changed (for the better) between versions 4.0.11 and 4.0.12, so if your old processing profiles had it enabled, the results in 4.0.12 will be a little different and may require tuning your old profiles. We tried to preserve backwards-compatibility where possible, but it was not possible to do that everywhere. This should not be a problem, because should you require an identical result you can simply keep using the old version of RawTherapee and use the new one for future work, and, more importantly, your skills and taste have evolved over time, so why would you want the exact same results you had years ago when you can do better now?		* Backward compatibility. There may be changes in behavior between old and new versions of a specific tool. For instance, the effects of the Auto Levels tool have changed (for the better) between versions 4.0.11 and 4.0.12, so if your old processing profiles had it enabled, the results in 4.0.12 will be a little different and may require tuning your old profiles.
	* Some users have not checked "[[Preferences]]" in a long time, and their program is tuned for what worked best long ago, not for what works best now. Our defaults are good ~~ones~~, we keep them up to date to make RawTherapee look and function well out-of-the-box, so sometimes having RawTherapee start with fresh defaults is a good thing, and it will motivate users to look into "[[Preferences]]" again.		* Some users have not checked "[[Preferences]]" in a long time, and their program is tuned for what worked best long ago, not for what works best now. Our defaults are good defaults, we keep them up to date to make RawTherapee look and function well out-of-the-box, so sometimes having RawTherapee start with fresh defaults is a good thing, and it will motivate users to look into "[[Preferences]]" again.
	* Some users have never looked inside "[[Preferences]]" in the first place, and are unaware of some of the features that can be unlocked there. As above, fresh defaults will activate these things.		* Some users have never looked inside "[[Preferences]]" in the first place, and are unaware of some of the features that can be unlocked there. As above, fresh defaults will activate these things.
	* Some old cache and config files can cause RawTherapee to crash. While we patch the specific cases made known to us, it is safe to assume there will always be cases unknown to us which will still cause instability. Starting with clean cache and config folders mitigates this problem.		* Some old cache and config files can cause RawTherapee to crash. While we patch the specific cases made known to us, it is safe to assume there will always be cases unknown to us which will still cause instability. Starting with clean cache and config folders mitigates this problem.