Skip to content

Commit c1c613d

Browse files
committed
animate+convert rules: change default program from convert to magick
`convert` was deprecated in ImageMagick v7
1 parent ce9007a commit c1c613d

4 files changed

Lines changed: 13 additions & 26 deletions

File tree

CHANGELOG.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,11 @@ on.
1414
1515
## [Unreleased]
1616

17+
### Changed
18+
19+
* animate+convert rules: change default program from `convert` to `magick`
20+
(`convert` was deprecated in ImageMagick v7)
21+
1722
## [7.2.0] - 2025-06-29
1823

1924
### Added

rules/arara-rule-animate.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ arguments:
4242
@{
4343
parameters.program
4444
}
45-
default: convert
45+
default: magick
4646
- identifier: options
4747
flag: >
4848
@{

rules/arara-rule-convert.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ arguments:
2020
@{
2121
parameters.program
2222
}
23-
default: convert
23+
default: magick
2424
- identifier: options
2525
flag: >
2626
@{

website/content/manual/Rules.md

Lines changed: 6 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ discuss the inclusion of your rule in forthcoming updates.
2626

2727
This rule creates an animated `gif` file from the corresponding base name of the
2828
`❖ currentFile` reference (i.e, the name without the associated
29-
extension) as a string concatenated with the `pdf` suffix, using the `convert`
29+
extension) as a string concatenated with the `pdf` suffix, using the `magick`
3030
command line utility from the ImageMagick suite.
3131

3232
- `delay` (default: `10`): This option regulates the number of ticks before the
@@ -39,23 +39,7 @@ command line utility from the ImageMagick suite.
3939
- `density` (default: `300`): This option specifies the horizontal and vertical
4040
canvas resolution while rendering vector formats into a proper raster image.
4141

42-
- `program` (default: `convert`): This option specifies the command utility path
43-
as a means to avoid potential clashes with underlying operating system
44-
commands.
45-
46-
{% messagebox(title="Microsoft Windows woes") %}
47-
According to the [ImageMagick
48-
website](https://imagemagick.org/Usage/windows/), the Windows installation
49-
routine adds the program directory to the system path, such that one can call
50-
command line tools directly from the command prompt, without providing a path
51-
name. However, `convert` is also the name of Windows system tool, located in the
52-
system directory, which converts file systems from one format to another.
53-
54-
The best solution to avoid possible future name conflicts, according to the
55-
ImageMagick team, is to call such command line tools by their full path in any
56-
script. Therefore, the `convert` rule provides the `program` option for this
57-
specific scenario.
58-
{% end %}
42+
- `program` (default: `magick`): This option specifies the command utility path.
5943

6044
- `options`: This option, as the name indicates, takes a list of raw command
6145
line options and appends it to the actual system call. An error is thrown if
@@ -461,14 +445,12 @@ Format. Please refer to the user manual for further details.
461445

462446
# `convert`
463447

464-
This rule runs the `convert` program, a member of the ImageMagick suite of
465-
tools. This program is used to convert between image formats as well as resize
466-
an image, blur, crop, despeckle, dither, draw on, flip, join, resample, and
448+
This rule runs the `magick` program, a member of the ImageMagick suite of
449+
tools. This program is used to convert between image formats as well as resize
450+
an image, blur, crop, despeckle, dither, draw on, flip, join, resample, and
467451
more.
468452

469-
- `program` (default: `convert`): This option specifies the command utility path
470-
as a means to avoid potential clashes with underlying operating system
471-
commands.
453+
- `program` (default: `magick`): This option specifies the command utility path.
472454

473455
- **[R]** `options`: This option, as the name indicates, takes a list of raw
474456
command line options and appends it to the actual script call. An error is

0 commit comments

Comments
 (0)