1 files changed, 76 insertions, 0 deletions
diff --git a/util/recolordocsicons/recolordocsicons.py b/util/recolordocsicons/recolordocsicons.py
new file mode 100644
index 000000000..70dee2699
--- /dev/null
+++ b/util/recolordocsicons/recolordocsicons.py
@@ -0,0 +1,76 @@
+#!/usr/bin/env python
+
+# Copyright (C) 2022 The Qt Company Ltd.
+# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0
+
+import argparse
+import os
+import pathlib
+import subprocess
+import sys
+
+from distutils import spawn
+
+def recolorizePng(pngPath, color, magick):
+    print("Recolorizing: {}".format(pngPath))
+    try:
+        subprocess.check_call([magick,
+                               pngPath,
+                               "-depth", "24",
+                               "-colorspace", "rgb",
+                               "(", "+clone", "-background", "white", "-flatten", ")",
+                               "(", "+clone", "-negate", "-alpha", "copy", ")",
+                               "(", "+clone", "-fuzz", "100%", "-fill", color, "-opaque", color, ")",
+                               "(", "-clone", "-1,-2", "-compose", "dst_in", "-composite", ")",
+                               "-delete", "0--2",
+                               pngPath])
+    except subprocess.CalledProcessError:
+        sys.exit("Failed to recolorize {}.".format(pngPath))
+
+
+def optimizePng(pngPath, optipng):
+    print("Optimizing: {}".format(pngPath))
+    try:
+        subprocess.check_call([optipng,
+                               "-o7",
+                               "-strip", "all",
+                               pngPath],
+                              stderr=subprocess.DEVNULL)
+    except subprocess.CalledProcessError:
+        sys.exit("Failed to optimize {}.".format(pngPath))
+
+
+def processDocsPath(docsPath, color, magick, optipng):
+    pngPaths = docsPath.glob('**/*.png')
+    for pngPath in pngPaths:
+        recolorizePng(pngPath, color, magick)
+        optimizePng(pngPath, optipng)
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Recolor icon .png files in the '
+                                     'Documentation. '
+                                     'Requires ImageMagick and Optipng in Path.')
+    parser.add_argument('-docspath',
+                        help='The path to process (recursively).',
+                        type=pathlib.Path)
+    parser.add_argument('-color',
+                        help='The icon foreground color.',
+                        default="#808080")
+    args = parser.parse_args()
+
+    magick = spawn.find_executable("magick")
+    if magick is None:
+        sys.exit("ImageMagick was not found in Path.")
+
+    optipng = spawn.find_executable("optipng")
+    if optipng is None:
+        sys.exit("Optipng was not found in Path.")
+
+    processDocsPath(args.docspath, args.color, magick, optipng)
+
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())