SPB Git

Repository Public License

icon-design.md 10.1 KB 159 lines markdown

1<!--2ORIX Scan3File: docs/design/icon-design.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->78# ORIX Scan — Icon Design910<p align="center"><img src="../assets/icon-256.png" width="160" height="160" alt="ORIX Scan icon"></p>1112The ORIX Scan icon is the **ORIX "O" split into four viewfinder arcs and crossed by a cyan optical beam**. One shape says both things the product is: an ORIX app (the ring) and a scanner (the frame corners and the scan line).1314## 1. Brief1516The icon had to be original, geometric, legible at 29 px, free of text, and extensible: future ORIX apps must be able to keep the same construction and change only the accent pair and the inner glyph.1718Family rule adopted here: **every ORIX icon is a ring on a full-bleed tile.** The ring is the constant; what happens to the ring (split, sliced, filled, rotated) and the accent pair identify the app. ORIX Scan uses indigo → cyan.1920## 2. Exploration — five concepts2122All five were drawn as hand-written SVG on a 1024 grid and rendered with `rsvg-convert`. The sheet below shows each at 180, 60 and 29 px under an iOS-style rounded mask, on a light and a dark wallpaper.2324![Five icon concepts at three sizes on light and dark wallpapers](../assets/concepts.png)2526| # | Concept | Source |27|---|---|---|28| 01 | Abstract ORIX O inside a scanning frame | [`01-orix-o-scan-frame.svg`](../../design/icon/concepts/01-orix-o-scan-frame.svg) |29| 02 | Document geometry crossed by an optical beam | [`02-document-optical-beam.svg`](../../design/icon/concepts/02-document-optical-beam.svg) |30| 03 | Minimal document with a circular aperture | [`03-document-aperture.svg`](../../design/icon/concepts/03-document-aperture.svg) |31| 04 | Folded document carrying the ORIX ring | [`04-folded-document-orix.svg`](../../design/icon/concepts/04-folded-document-orix.svg) |32| 05 | Scanning monogram: the O as four viewfinder arcs plus a beam | [`05-scanning-monogram.svg`](../../design/icon/concepts/05-scanning-monogram.svg) |3334## 3. Evaluation3536Scores are 1 (weak) to 5 (strong), judged from the rendered sheet above, not from the vector at full size.3738| Criterion | 01 O + frame | 02 Document + beam | 03 Aperture | 04 Folded document | 05 Monogram |39|---|:-:|:-:|:-:|:-:|:-:|40| Recognizability (reads as "scan") | 4 | 5 | 2 | 3 | 4 |41| Simplicity | 4 | 2 | 5 | 4 | 5 |42| Originality | 2 | 2 | 3 | 2 | 4 |43| Small-size legibility (29 px) | 3 | 2 | 4 | 3 | 4 |44| Contrast | 4 | 4 | 4 | 3 | 5 |45| Brand consistency (ORIX ring, reusable) | 4 | 1 | 3 | 3 | 5 |46| Memorability | 3 | 2 | 3 | 2 | 4 |47| **Total / 35** | **24** | **18** | **24** | **20** | **31** |4849What the renders showed:5051- **01** is clear, but a ring inside four corner brackets is the generic "viewfinder" pictogram many camera and scanner apps already use; at 29 px the brackets thin out before the ring does.52- **02** is the most literal and the least durable: six text lines and a two-tone beam turn to noise at 29 px, and nothing in it is ORIX.53- **03** is clean and bold, but it reads as a speaker or a music player rather than a scanner.54- **04** is a file-type icon. It says "document", not "scan", and the light tile disappears on light wallpapers.55- **05** keeps a single bold shape at every size. The four arcs are simultaneously the letter O and the four corners of a capture frame, so the brand and the function are the same drawing.5657**Selected: concept 05.** It has the highest total and wins the two criteria that matter most for an ecosystem mark, brand consistency and originality, without giving up small-size legibility. Its one weakness is that it is less literal than 02 (there is no page in it); the beam carries the "scan" meaning.5859## 4. Refinement of the winner6061Changes between the concept and the production master:6263- Ring radius and stroke retuned (270/92 → 264/96) so the arcs hold their weight at 29 px.64- The beam gained a narrow light core, which keeps it readable as a light source rather than a strike-through.65- A cyan wash fades downward from the beam inside the ring: the area "already scanned". It is confined to the inner disc so the arc edges stay crisp.66- The arcs shift from pure white above the beam to a faint cyan-white below it, the same idea expressed on the glyph.67- The tile gradient runs from a lighter indigo (top left) to a deep indigo (bottom right) instead of a flat fill.6869## 5. Construction7071All values are in the 1024 × 1024 master grid. The geometry lives in one place, [`design/icon/build.py`](../../design/icon/build.py), and every variant is generated from it.7273| Element | Value | Ratio to tile |74|---|---|---|75| Tile | 1024 × 1024, full bleed, square corners (the system applies the mask) | 1 |76| Ring centre | (512, 512) | centred |77| Ring radius (centre line) | 264 | outer diameter 624 = 61 % |78| Ring stroke | 96, round caps | 9.4 % |79| Arcs | 4, centred on the diagonals (45°, 135°, 225°, 315°), each spanning ±26° | — |80| Gaps | at the four cardinal points, about 76 px clear between caps | — |81| Beam | 728 × 44, fully rounded, centred on y = 512, x from 148 to 876 | 71 % wide |82| Beam core | 676 × 10, fully rounded | — |83| Scan wash | lower half of the inner disc (radius 216), cyan 42 % → 0 % over 218 px | — |8485The beam passes through the left and right gaps with 16 px of clearance above and below, and overshoots the ring by 52 px per side so it reads as a line of light sweeping across, not a diameter.8687### Colour8889| Token | Hex | Use |90|---|---|---|91| Indigo (primary accent) | `#5B5BF0` | tile mid-tone, dark-appearance ring |92| Indigo light / deep | `#7673FA` / `#3731C4` | tile gradient ends |93| Cyan (optical beam) | `#22D3EE` | beam, scan wash |94| Paper white | `#F7F8FC` | ring |95| Beam core | `#ECFDFF` | beam highlight |96| Ink | `#0A0D18` | dark surfaces in the app (not used in the default icon) |9798## 6. Appearance variants99100![Default, dark and tinted appearances](../assets/icon-appearances.png)101102| Appearance | Master | Treatment |103|---|---|---|104| Default | [`orix-scan-icon.svg`](../../design/icon/master/orix-scan-icon.svg) | Indigo gradient tile, white ring, cyan beam. Opaque, no alpha. |105| Dark | [`orix-scan-icon-dark.svg`](../../design/icon/master/orix-scan-icon-dark.svg) | Transparent background so the system's dark backdrop shows through; indigo ring, cyan beam. |106| Tinted | [`orix-scan-icon-tinted.svg`](../../design/icon/master/orix-scan-icon-tinted.svg) | Grayscale on black: ring white → mid-grey, beam white, no wash. The system applies the user's tint. |107| Mark | [`orix-scan-mark.svg`](../../design/icon/master/orix-scan-mark.svg) | Glyph only, single colour, template rendering, for in-app use. |108109The preview above is a simulation built with Pillow: the dark backdrop and the cyan tint are approximations of what iOS draws. The icon has not yet been seen on a physical iPhone Home Screen.110111## 7. Requirements verified112113Checked on 2026-11-20 against two Apple pages, fetched and read that day:114115- [Human Interface Guidelines — App icons](https://developer.apple.com/design/human-interface-guidelines/app-icons)116- [Configuring your app icon using an asset catalog](https://developer.apple.com/documentation/xcode/configuring-your-app-icon)117118| Requirement found | How it is met |119|---|---|120| iOS and iPadOS icons are square, 1024 × 1024 px; the system applies the rounded mask | Full-bleed square artwork, no baked corners |121| A single 1024 × 1024 image is enough; Xcode generates the other sizes | One image per appearance in `AppIcon.appiconset` |122| iOS and iPadOS support additional dark and tinted styles | Three entries: default, `luminosity: dark`, `luminosity: tinted` |123| "Provide your dark app icon with a transparent background" | `AppIcon-Dark.png` has an alpha channel and no background |124| "Provide your tinted app icon as a grayscale image" | `AppIcon-Tinted.png` is built from an 8-bit grayscale render |125| Supported colour spaces: sRGB, Gray Gamma 2.2, Display P3 | All three PNGs are sRGB with an embedded sRGB profile |126| Prefer clearly defined edges in foreground shapes | Ring and beam are hard-edged; the only soft element is the wash, inside the ring |127128Not done: the HIG now presents **layered icons built in Icon Composer** as the preferred format for iOS, iPadOS and macOS (default, dark, clear and tinted appearances with system glass effects). This project ships the flat asset-catalog format, which the same documentation still describes. A layered `.icon` file is a possible follow-up; the ring, beam and tile are already separate shapes in the master.129130Also not verified here: compilation of the asset catalog by `actool`. No Xcode build was run as part of the icon work.131132## 8. Asset inventory133134| File | Purpose |135|---|---|136| `design/icon/concepts/*.svg` | The five concept sources |137| `design/icon/master/orix-scan-icon.svg`, `-dark.svg`, `-tinted.svg`, `orix-scan-mark.svg` | Production masters (generated) |138| `design/icon/build.py` | Geometry, master generation and every PNG export |139| `design/icon/contact.py` | Contact sheets and the rounded-mask helper |140| `App/Resources/Assets.xcassets/AppIcon.appiconset/AppIcon.png` | Default, 1024 × 1024, opaque, sRGB |141| `App/Resources/Assets.xcassets/AppIcon.appiconset/AppIcon-Dark.png` | Dark, 1024 × 1024, transparent background |142| `App/Resources/Assets.xcassets/AppIcon.appiconset/AppIcon-Tinted.png` | Tinted, 1024 × 1024, grayscale artwork |143| `App/Resources/Assets.xcassets/Mark.imageset/Mark.svg` | In-app template mark, vector preserved |144| `docs/assets/icon-1024.png` | Full-size default icon |145| `docs/assets/icon-256.png` | Rounded-mask icon with transparent corners, for the README |146| `docs/assets/logo.svg` | Lockup: icon, "ORIX Scan" wordmark, tagline |147| `docs/assets/concepts.png` | Concept contact sheet |148| `docs/assets/icon-appearances.png` | Default, dark and tinted preview |149150Regenerate everything:151152```bash153cd design/icon154python3 build.py                                            # masters, asset catalog, docs/assets icons155python3 contact.py ../../docs/assets/concepts.png render/0*-1024.png   # concept sheet (needs the concept renders in render/)156```157158Requires `rsvg-convert` and Pillow. `docs/assets/logo.svg` is not produced by `build.py`: it embeds the default master's shapes next to the wordmark, and sets its wordmark in the system font stack, so the letterforms follow the viewer's platform.159
Files main
Menu

Theme