938621a5cec345d021a02f7b7bf038570d7ecd93
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Breaking-43085-RenamedGraphicsProcessorSettings.rst
1 ===========================================================================
2 Breaking: #43085 - Change GFX settings prefix im\_* to generic processor\_*
3 ===========================================================================
4
5 Description
6 ===========
7
8 Graphics processor settings for Image- or GraphicsMagick have been renamed
9 in ``LocalConfiguration.php``. The former prefix ``im\_`` has been replaced with
10 the unified prefix ``processor\_``.
11
12 Negative namings like ``noScaleUp`` have been changed positive counterparts.
13 During the conversion the previous configuration values are negated to reflect
14 the changes in semantics of these options.
15
16 In addition references to specific versions of ImageMagick/GraphicsMagick
17 have been removed from settings names and values. For a detailed list of
18 changes please consult the information in the migration section.
19
20 The unused configuration option ``image\_processing`` has been removed without
21 replacement.
22
23 The processor specific configuration option ``colorspace`` has been namespaced
24 below the ``processor\_`` hierarchy.
25
26
27 Impact
28 ======
29
30 Existing settings in ``LocalConfiguration.php`` are automatically migrated
31 through a silent upgrader when entering the Install Tool. If you modify
32 the settings in ``AdditionalConfiguration.php`` or rely on them inside an
33 extension you need to update those.
34
35
36 Affected Installations
37 ======================
38
39 Installations which modify those settings directly or access them.
40
41
42 Migration
43 =========
44
45 The following table lists the changed configuration keys and the appropriate
46 values if these have changed.
47
48 ============================   ===============================================
49 Old name                       New name
50 ============================   ===============================================
51 im\_version\_5                 processor
52                                The configuration value "im6" has been replaced
53                                by "ImageMagick", "gm" by "GraphicsMagick"
54 im                             processor\_enabled
55 im\_v5effects                  processor\_effects
56 im\_noScaleUp                  processor\_allowUpscaling
57 im\_noFramePrepended           processor\_allowFrameSelection
58 im\_mask\_temp\_ext\_gif       processor\_allowTemporaryMasksAsPng
59 im\_path                       processor\_path
60 imß_path\_lzw                  processor\_path\_lzw
61 im\_stripProfileCommand        processor\_stripColorProfileCommand
62 im\_useStripProfileByDefault   processor\_stripColorProfileByDefault
63 colorspace                     processor\_colorspace
64 ============================   ===============================================