iconpeek 1.0.3 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/generate_icons.py CHANGED
@@ -1,219 +1,234 @@
1
- import argparse
2
- import base64
3
- import io
4
- import json
5
- import sys
6
- from pathlib import Path
7
-
8
- from PIL import Image, ImageDraw
9
-
10
-
11
- ANDROID_DENSITIES = {
12
- "mdpi": 48,
13
- "hdpi": 72,
14
- "xhdpi": 96,
15
- "xxhdpi": 144,
16
- "xxxhdpi": 192,
17
- }
18
-
19
- # (points, scale, idiom) tuples matching Apple's real AppIcon.appiconset
20
- # requirements. Previously this only emitted "iphone" or "ipad" per *size*,
21
- # which silently dropped the iPad entries for 20/29/40pt that Xcode expects
22
- # alongside the iPhone ones at the same point size.
23
- IOS_ICONS = [
24
- (20, 2, "iphone"),
25
- (20, 3, "iphone"),
26
- (29, 2, "iphone"),
27
- (29, 3, "iphone"),
28
- (40, 2, "iphone"),
29
- (40, 3, "iphone"),
30
- (60, 2, "iphone"),
31
- (60, 3, "iphone"),
32
- (20, 1, "ipad"),
33
- (20, 2, "ipad"),
34
- (29, 1, "ipad"),
35
- (29, 2, "ipad"),
36
- (40, 1, "ipad"),
37
- (40, 2, "ipad"),
38
- (76, 1, "ipad"),
39
- (76, 2, "ipad"),
40
- (83.5, 2, "ipad"),
41
- (1024, 1, "ios-marketing"),
42
- ]
43
-
44
-
45
- PLACEHOLDER_BASE64 = "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"
46
-
47
-
48
- def parse_args():
49
- parser = argparse.ArgumentParser(description="Generate Android and iOS icon assets from one source image.")
50
- parser.add_argument("--source", help="Source icon PNG", default=None)
51
- parser.add_argument("--out", help="Output directory", default="icon_output")
52
- parser.add_argument("--android-fg", help="Foreground image for adaptive icon", default=None)
53
- parser.add_argument("--android-bg", help="Adaptive icon background color", default="#FFFFFF")
54
- parser.add_argument("--ios-source", help="Alternate source image for iOS icons", default=None)
55
- return parser.parse_args()
56
-
57
-
58
- def ensure_placeholder_asset():
59
- return Image.open(io.BytesIO(base64.b64decode(PLACEHOLDER_BASE64))).convert("RGBA")
60
-
61
-
62
- def ensure_repo_placeholder():
63
- assets_dir = Path(__file__).resolve().parent / "assets"
64
- placeholder_path = assets_dir / "placeholder-icon.png"
65
- if placeholder_path.exists():
66
- return
67
-
68
- assets_dir.mkdir(parents=True, exist_ok=True)
69
- ensure_placeholder_asset().save(placeholder_path)
70
-
71
-
72
- def ensure_source_image(source_value):
73
- if source_value:
74
- source_path = Path(source_value).expanduser().resolve()
75
- if not source_path.exists():
76
- raise FileNotFoundError(f"Source image not found: {source_path}")
77
- return source_path
78
-
79
- return None
80
-
81
-
82
- def open_image(path_value):
83
- return Image.open(path_value).convert("RGBA")
84
-
85
-
86
- def flatten_to_white(image):
87
- background = Image.new("RGB", image.size, "#FFFFFF")
88
- background.paste(image, mask=image.getchannel("A") if "A" in image.getbands() else None)
89
- return background
90
-
91
-
92
- def square_fit(image, size):
93
- return image.resize((size, size), Image.LANCZOS)
94
-
95
-
96
- def circular_icon(image, size):
97
- base = image.resize((size, size), Image.LANCZOS)
98
- mask = Image.new("L", (size, size), 0)
99
- draw = ImageDraw.Draw(mask)
100
- draw.ellipse((0, 0, size - 1, size - 1), fill=255)
101
- result = Image.new("RGBA", (size, size), (0, 0, 0, 0))
102
- result.paste(base, (0, 0), mask)
103
- return result
104
-
105
-
106
- def centered_foreground_layer(image, canvas_size):
107
- """Build an Android adaptive icon foreground layer.
108
-
109
- The layer canvas is the full 108dp square. Content should be sized so its
110
- important detail sits inside the 66dp "safe zone" (guaranteed visible
111
- under every mask shape), while the artwork itself typically fills closer
112
- to the 72dp legacy-icon area so it doesn't look tiny once masked. We size
113
- to 72/108 here to match what tools like Android Studio's Image Asset
114
- Studio use as a default, rather than shrinking everything down to the
115
- 66dp safe-zone diameter (which under-fills the icon and looks padded).
116
- """
117
- content_size = round(canvas_size * (72 / 108))
118
- resized = image.resize((content_size, content_size), Image.LANCZOS)
119
- canvas = Image.new("RGBA", (canvas_size, canvas_size), (0, 0, 0, 0))
120
- offset = ((canvas_size - content_size) // 2, (canvas_size - content_size) // 2)
121
- canvas.paste(resized, offset, resized)
122
- return canvas
123
-
124
-
125
- def write_android_assets(source_image, foreground_image, output_root, background_color):
126
- android_root = output_root / "android"
127
- for density, px in ANDROID_DENSITIES.items():
128
- mipmap_dir = android_root / f"mipmap-{density}"
129
- mipmap_dir.mkdir(parents=True, exist_ok=True)
130
-
131
- square_fit(source_image, px).save(mipmap_dir / "ic_launcher.png")
132
- circular_icon(source_image, px).save(mipmap_dir / "ic_launcher_round.png")
133
-
134
- adaptive_layer_size = round(px * (108 / 72))
135
- Image.new("RGBA", (adaptive_layer_size, adaptive_layer_size), background_color).save(
136
- mipmap_dir / "ic_launcher_background.png"
137
- )
138
- centered_foreground_layer(foreground_image, adaptive_layer_size).save(mipmap_dir / "ic_launcher_foreground.png")
139
-
140
- anydpi = android_root / "mipmap-anydpi-v26"
141
- anydpi.mkdir(parents=True, exist_ok=True)
142
- xml = """<adaptive-icon xmlns:android=\"http://schemas.android.com/apk/res/android\">
143
- <background android:drawable=\"@mipmap/ic_launcher_background\" />
144
- <foreground android:drawable=\"@mipmap/ic_launcher_foreground\" />
145
- </adaptive-icon>
146
- """
147
- (anydpi / "ic_launcher.xml").write_text(xml, encoding="utf-8")
148
- (anydpi / "ic_launcher_round.xml").write_text(xml, encoding="utf-8")
149
-
150
- play_store_dir = android_root / "play-store"
151
- play_store_dir.mkdir(parents=True, exist_ok=True)
152
- flatten_to_white(square_fit(source_image, 512)).save(play_store_dir / "play_store_icon.png")
153
-
154
-
155
- def write_ios_assets(ios_image, output_root):
156
- appiconset = output_root / "ios" / "AppIcon.appiconset"
157
- appiconset.mkdir(parents=True, exist_ok=True)
158
-
159
- images = []
160
- for points, scale, idiom in IOS_ICONS:
161
- size_px = int(round(points * scale))
162
- points_label = f"{int(points)}" if float(points).is_integer() else f"{points}"
163
- # Include idiom in the filename: the same (points, scale) pair can
164
- # appear for both iphone and ipad (e.g. 20pt@2x), so the size alone
165
- # isn't a unique filename and would silently overwrite the other.
166
- filename = f"icon_{idiom}_{points_label}x{points_label}@{scale}x.png"
167
-
168
- flatten_to_white(square_fit(ios_image, size_px)).save(appiconset / filename)
169
- images.append(
170
- {
171
- "size": f"{points_label}x{points_label}",
172
- "idiom": idiom,
173
- "filename": filename,
174
- "scale": f"{scale}x",
175
- }
176
- )
177
-
178
- contents = {"images": images, "info": {"version": 1, "author": "xcode"}}
179
- (appiconset / "Contents.json").write_text(json.dumps(contents, indent=2), encoding="utf-8")
180
-
181
-
182
- def warn_about_source(image, label):
183
- width, height = image.size
184
- if width != height:
185
- print(f"Warning: {label} is not square ({width}x{height}). Output will be forced to square.", file=sys.stderr)
186
- if width < 1024 or height < 1024:
187
- print(f"Warning: {label} is smaller than 1024x1024. Upscaling will reduce quality.", file=sys.stderr)
188
-
189
-
190
- def main():
191
- args = parse_args()
192
- ensure_repo_placeholder()
193
- source_path = ensure_source_image(args.source)
194
- if source_path is None:
195
- print("Error: --source is required for icon generation.", file=sys.stderr)
196
- return 1
197
-
198
- output_root = Path(args.out).expanduser().resolve()
199
- output_root.mkdir(parents=True, exist_ok=True)
200
-
201
- source_image = open_image(source_path)
202
- android_fg_image = open_image(Path(args.android_fg).expanduser().resolve()) if args.android_fg else source_image
203
- ios_source_image = open_image(Path(args.ios_source).expanduser().resolve()) if args.ios_source else source_image
204
-
205
- warn_about_source(source_image, "source image")
206
- if args.android_fg:
207
- warn_about_source(android_fg_image, "android foreground image")
208
- if args.ios_source:
209
- warn_about_source(ios_source_image, "iOS source image")
210
-
211
- write_android_assets(source_image, android_fg_image, output_root, args.android_bg)
212
- write_ios_assets(ios_source_image, output_root)
213
-
214
- print(f"Generated icon assets in {output_root}")
215
- return 0
216
-
217
-
218
- if __name__ == "__main__":
1
+ import argparse
2
+ import base64
3
+ import io
4
+ import json
5
+ import re
6
+ import sys
7
+ from pathlib import Path
8
+
9
+ from PIL import Image, ImageDraw
10
+
11
+
12
+ ANDROID_DENSITIES = {
13
+ "mdpi": 48,
14
+ "hdpi": 72,
15
+ "xhdpi": 96,
16
+ "xxhdpi": 144,
17
+ "xxxhdpi": 192,
18
+ }
19
+
20
+ # (points, scale, idiom) tuples matching Apple's real AppIcon.appiconset
21
+ # requirements. Previously this only emitted "iphone" or "ipad" per *size*,
22
+ # which silently dropped the iPad entries for 20/29/40pt that Xcode expects
23
+ # alongside the iPhone ones at the same point size.
24
+ IOS_ICONS = [
25
+ (20, 2, "iphone"),
26
+ (20, 3, "iphone"),
27
+ (29, 2, "iphone"),
28
+ (29, 3, "iphone"),
29
+ (40, 2, "iphone"),
30
+ (40, 3, "iphone"),
31
+ (60, 2, "iphone"),
32
+ (60, 3, "iphone"),
33
+ (20, 1, "ipad"),
34
+ (20, 2, "ipad"),
35
+ (29, 1, "ipad"),
36
+ (29, 2, "ipad"),
37
+ (40, 1, "ipad"),
38
+ (40, 2, "ipad"),
39
+ (76, 1, "ipad"),
40
+ (76, 2, "ipad"),
41
+ (83.5, 2, "ipad"),
42
+ (1024, 1, "ios-marketing"),
43
+ ]
44
+
45
+
46
+ PLACEHOLDER_BASE64 = "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"
47
+
48
+
49
+ def parse_args():
50
+ parser = argparse.ArgumentParser(description="Generate Android and iOS icon assets from one source image.")
51
+ parser.add_argument("--source", help="Source icon PNG", default=None)
52
+ parser.add_argument("--out", help="Output directory", default="icon_output")
53
+ parser.add_argument("--android-fg", help="Foreground image for adaptive icon", default=None)
54
+ parser.add_argument("--android-bg", help="Adaptive icon background color", default="#FFFFFF")
55
+ parser.add_argument("--ios-source", help="Alternate source image for iOS icons", default=None)
56
+ return parser.parse_args()
57
+
58
+
59
+ def ensure_placeholder_asset():
60
+ return Image.open(io.BytesIO(base64.b64decode(PLACEHOLDER_BASE64))).convert("RGBA")
61
+
62
+
63
+ def ensure_repo_placeholder():
64
+ assets_dir = Path(__file__).resolve().parent / "assets"
65
+ placeholder_path = assets_dir / "placeholder-icon.png"
66
+ if placeholder_path.exists():
67
+ return
68
+
69
+ assets_dir.mkdir(parents=True, exist_ok=True)
70
+ ensure_placeholder_asset().save(placeholder_path)
71
+
72
+
73
+ def ensure_source_image(source_value):
74
+ if source_value:
75
+ source_path = Path(source_value).expanduser().resolve()
76
+ if not source_path.exists():
77
+ raise FileNotFoundError(f"Source image not found: {source_path}")
78
+ return source_path
79
+
80
+ return None
81
+
82
+
83
+ def open_image(path_value):
84
+ path = Path(path_value)
85
+ if path.suffix.lower() == ".svg":
86
+ try:
87
+ content = path.read_text(encoding="utf-8")
88
+ match = re.search(r'data:image/(?:png|jpeg|webp);base64,([A-Za-z0-9+/=]+)', content)
89
+ if match:
90
+ data = base64.b64decode(match.group(1))
91
+ return Image.open(io.BytesIO(data)).convert("RGBA")
92
+ except Exception:
93
+ pass
94
+ raise ValueError(
95
+ f"SVG vector format is not supported directly by Pillow unless it contains an embedded raster image: {path_value}. "
96
+ "Please convert the SVG to a PNG (e.g., 1024x1024) first."
97
+ )
98
+ return Image.open(path_value).convert("RGBA")
99
+
100
+
101
+ def flatten_to_white(image):
102
+ background = Image.new("RGB", image.size, "#FFFFFF")
103
+ background.paste(image, mask=image.getchannel("A") if "A" in image.getbands() else None)
104
+ return background
105
+
106
+
107
+ def square_fit(image, size):
108
+ return image.resize((size, size), Image.LANCZOS)
109
+
110
+
111
+ def circular_icon(image, size):
112
+ base = image.resize((size, size), Image.LANCZOS)
113
+ mask = Image.new("L", (size, size), 0)
114
+ draw = ImageDraw.Draw(mask)
115
+ draw.ellipse((0, 0, size - 1, size - 1), fill=255)
116
+ result = Image.new("RGBA", (size, size), (0, 0, 0, 0))
117
+ result.paste(base, (0, 0), mask)
118
+ return result
119
+
120
+
121
+ def centered_foreground_layer(image, canvas_size):
122
+ """Build an Android adaptive icon foreground layer.
123
+
124
+ The layer canvas is the full 108dp square. Content should be sized so its
125
+ important detail sits inside the 66dp "safe zone" (guaranteed visible
126
+ under every mask shape), while the artwork itself typically fills closer
127
+ to the 72dp legacy-icon area so it doesn't look tiny once masked. We size
128
+ to 72/108 here to match what tools like Android Studio's Image Asset
129
+ Studio use as a default, rather than shrinking everything down to the
130
+ 66dp safe-zone diameter (which under-fills the icon and looks padded).
131
+ """
132
+ content_size = round(canvas_size * (72 / 108))
133
+ resized = image.resize((content_size, content_size), Image.LANCZOS)
134
+ canvas = Image.new("RGBA", (canvas_size, canvas_size), (0, 0, 0, 0))
135
+ offset = ((canvas_size - content_size) // 2, (canvas_size - content_size) // 2)
136
+ canvas.paste(resized, offset, resized)
137
+ return canvas
138
+
139
+
140
+ def write_android_assets(source_image, foreground_image, output_root, background_color):
141
+ android_root = output_root / "android"
142
+ for density, px in ANDROID_DENSITIES.items():
143
+ mipmap_dir = android_root / f"mipmap-{density}"
144
+ mipmap_dir.mkdir(parents=True, exist_ok=True)
145
+
146
+ square_fit(source_image, px).save(mipmap_dir / "ic_launcher.png")
147
+ circular_icon(source_image, px).save(mipmap_dir / "ic_launcher_round.png")
148
+
149
+ adaptive_layer_size = round(px * (108 / 72))
150
+ Image.new("RGBA", (adaptive_layer_size, adaptive_layer_size), background_color).save(
151
+ mipmap_dir / "ic_launcher_background.png"
152
+ )
153
+ centered_foreground_layer(foreground_image, adaptive_layer_size).save(mipmap_dir / "ic_launcher_foreground.png")
154
+
155
+ anydpi = android_root / "mipmap-anydpi-v26"
156
+ anydpi.mkdir(parents=True, exist_ok=True)
157
+ xml = """<adaptive-icon xmlns:android=\"http://schemas.android.com/apk/res/android\">
158
+ <background android:drawable=\"@mipmap/ic_launcher_background\" />
159
+ <foreground android:drawable=\"@mipmap/ic_launcher_foreground\" />
160
+ </adaptive-icon>
161
+ """
162
+ (anydpi / "ic_launcher.xml").write_text(xml, encoding="utf-8")
163
+ (anydpi / "ic_launcher_round.xml").write_text(xml, encoding="utf-8")
164
+
165
+ play_store_dir = android_root / "play-store"
166
+ play_store_dir.mkdir(parents=True, exist_ok=True)
167
+ flatten_to_white(square_fit(source_image, 512)).save(play_store_dir / "play_store_icon.png")
168
+
169
+
170
+ def write_ios_assets(ios_image, output_root):
171
+ appiconset = output_root / "ios" / "AppIcon.appiconset"
172
+ appiconset.mkdir(parents=True, exist_ok=True)
173
+
174
+ images = []
175
+ for points, scale, idiom in IOS_ICONS:
176
+ size_px = int(round(points * scale))
177
+ points_label = f"{int(points)}" if float(points).is_integer() else f"{points}"
178
+ # Include idiom in the filename: the same (points, scale) pair can
179
+ # appear for both iphone and ipad (e.g. 20pt@2x), so the size alone
180
+ # isn't a unique filename and would silently overwrite the other.
181
+ filename = f"icon_{idiom}_{points_label}x{points_label}@{scale}x.png"
182
+
183
+ flatten_to_white(square_fit(ios_image, size_px)).save(appiconset / filename)
184
+ images.append(
185
+ {
186
+ "size": f"{points_label}x{points_label}",
187
+ "idiom": idiom,
188
+ "filename": filename,
189
+ "scale": f"{scale}x",
190
+ }
191
+ )
192
+
193
+ contents = {"images": images, "info": {"version": 1, "author": "xcode"}}
194
+ (appiconset / "Contents.json").write_text(json.dumps(contents, indent=2), encoding="utf-8")
195
+
196
+
197
+ def warn_about_source(image, label):
198
+ width, height = image.size
199
+ if width != height:
200
+ print(f"Warning: {label} is not square ({width}x{height}). Output will be forced to square.", file=sys.stderr)
201
+ if width < 1024 or height < 1024:
202
+ print(f"Warning: {label} is smaller than 1024x1024. Upscaling will reduce quality.", file=sys.stderr)
203
+
204
+
205
+ def main():
206
+ args = parse_args()
207
+ ensure_repo_placeholder()
208
+ source_path = ensure_source_image(args.source)
209
+ if source_path is None:
210
+ print("Error: --source is required for icon generation.", file=sys.stderr)
211
+ return 1
212
+
213
+ output_root = Path(args.out).expanduser().resolve()
214
+ output_root.mkdir(parents=True, exist_ok=True)
215
+
216
+ source_image = open_image(source_path)
217
+ android_fg_image = open_image(Path(args.android_fg).expanduser().resolve()) if args.android_fg else source_image
218
+ ios_source_image = open_image(Path(args.ios_source).expanduser().resolve()) if args.ios_source else source_image
219
+
220
+ warn_about_source(source_image, "source image")
221
+ if args.android_fg:
222
+ warn_about_source(android_fg_image, "android foreground image")
223
+ if args.ios_source:
224
+ warn_about_source(ios_source_image, "iOS source image")
225
+
226
+ write_android_assets(source_image, android_fg_image, output_root, args.android_bg)
227
+ write_ios_assets(ios_source_image, output_root)
228
+
229
+ print(f"Generated icon assets in {output_root}")
230
+ return 0
231
+
232
+
233
+ if __name__ == "__main__":
219
234
  sys.exit(main())