SPB Git

Repository Public

icon-design.md 9.4 KB 146 lines markdown

1# Icon design23The ORIX Sheet icon is generated by code, not drawn in an editor:4`design/icon/make-icons.swift` (212 lines, AppKit + CoreGraphics) draws five concepts, the final51024 px master, a contact sheet and the ten PNG sizes of the macOS asset catalog.67Related: [brand guidelines](brand-guidelines.md), [design system](design-system.md),8[distribution](../release/distribution.md) (the DMG background reuses the same plate).910## What is and is not recorded1112The brief for this document asks for the evaluation of the five concepts against six criteria13(originality, recognizability, balance, small-size legibility, family consistency, contrast).14**No scores, ranking or written evaluation exist in the repository.** What exists is:1516- the generator script, whose comments state the idea of each concept and the reason for the final17  choice in one sentence ("Final — refinement of concept 1: thicker ring opened by the sheet's18  row/column axes, larger cells, the active cell carries the selection handle. Reads at 16 px as19  'ring + bright square'.");20- the rendered images, including a contact sheet built for the comparison: each concept at21  300 px and, underneath, at 64, 32 and 16 px.2223The sections below therefore describe what the script draws and what the images show. The24per-criterion table is an examination of those images made for this document on 2026-11-21; it is a25qualitative reading, not a record of the original decision, and no numeric score is given.2627## The contact sheet2829![Five concepts and the final icon, each at 300 px with 64, 32 and 16 px renderings underneath](../assets/icon-concepts-sheet.png)3031Left to right: concepts 1 to 5, then the final icon. The file is a copy of32`design/icon/concepts-sheet.png` (1840 × 450 px, background `#F4F5FA`, the light `canvas` token).3334## Common construction3536Every concept sits on the same plate (`plate()` in the script):3738| Element | Value |39|---|---|40| Canvas | 1024 × 1024 px, sRGB, transparent outside the plate |41| Plate | 824 × 824 px rounded square centred in the canvas, corner radius 186 px |42| Plate fill | vertical gradient `#1B2A4A` (top) → `#0B0F1E` (bottom) over a `#0B1020` base |43| Glow | radial, centre (330, 800), radius 560 px, 75 % → 0 % opacity; colour `#1E5A78` (concepts 1, 3, 4, final), `#2A3F8A` (concept 2), `#1E6A78` (concept 5) |44| Drop shadow | offset 10 px down, blur 24 px, black at 35 % |45| Edge | 3 px white stroke at 10 % |46| Brand gradient | `#22D3EE` → `#3B9BF5` (at 55 %) → `#6366F1`, top-left to bottom-right of the shape's bounding box |4748Source: `design/icon/make-icons.swift` (`plate`, `brand`).4950`#22D3EE` is the dark-mode `accent` token of the application; the plate colours are icon-only and51are not tokens (see [design system](design-system.md)).5253## The five concepts5455| # | File | Idea (script comment) | What is drawn |56|---|---|---|---|57| 1 | `concept-1-ring-sheet.png` | ORIX "O" whose counter is a 3×3 sheet; one cell is the active cell | gradient ring 536 px across, 62 px thick; nine 78 px cells with 16 px gaps; centre cell solid white, top row at 42 % and the others at 26 % of `#EAF6FF` |58| 2 | `concept-2-data-matrix.png` | abstract data matrix: 5×5 dots with a diagonal intensity ramp | twenty-five 92 px rounded squares, opacity rising from 18 % (bottom-left) to 100 % (top-right) |59| 3 | `concept-3-precision-table.png` | precision table: header band, hairline rules and measurement ticks | translucent table with a gradient header band 96 px high, three horizontal and two vertical 6 px rules, thirteen cyan ruler ticks under the table |60| 4 | `concept-4-chart-cells.png` | chart + grid monogram: rising bars made of cells | 4×4 grid of 112 px cells; columns filled to heights 1, 2, 3, 4 with the gradient, the rest at 8 % white |61| 5 | `concept-5-layered-sheets.png` | layered sheets inside the ORIX ring | gradient ring 552 px across, 46 px thick; three stacked white sheets at 22 %, 48 % and 100 % opacity, the front one ruled into cells |6263Source: `design/icon/make-icons.swift` (`concept1` … `concept5`); files in `design/icon/`, each 512 × 512 px.6465## Reading of the images against the six criteria6667Qualitative observations from the contact sheet. "Small sizes" refers to the 64 / 32 / 16 px row.6869| Criterion | 1 Ring + sheet | 2 Data matrix | 3 Precision table | 4 Chart cells | 5 Layered sheets |70|---|---|---|---|---|---|71| Originality | ring and grid combined in one mark | a plain dot matrix; nothing ties it to this product | a literal table; the ruler ticks are the only distinctive element | a familiar "bars" chart motif built from cells | ring plus a document stack; the stack is a common motif |72| Recognizability as a spreadsheet | the 3×3 grid with one selected cell reads as a sheet | reads as a generic grid or keypad | the most literal: header, rows, columns | reads as a chart first, a sheet second | the ruled front sheet reads as a document or table |73| Balance | radially symmetric, centred | uniform texture, weight shifts to the top-right with the opacity ramp | top-heavy (bright header band), ticks close to the bottom edge | weight on the right and bottom (staircase) | stack offset down-left inside a centred ring |74| Small-size legibility | at 16 px a ring with a bright centre remains | at 16 px the dots merge into a dark square | rules and ticks disappear at 16 px; the header band remains as a line | the staircase survives at 32 px, is faint at 16 px | ring and white block remain; the ruling is lost |75| Family consistency | uses the ORIX "O" ring and the brand gradient | brand gradient only, no ring | gradient only in the header band | brand gradient only, no ring | uses the ring and gradient |76| Contrast | white active cell on navy; pale cells are low-contrast by design | lower-left dots nearly merge with the plate | 6 px half-opacity rules are faint on the translucent table | filled cells strong; empty cells at 8 % barely visible | solid white sheet has the strongest contrast of the five |7778Source: visual examination of `design/icon/concepts-sheet.png` on 2026-11-21. No measurement79(contrast ratio, legibility test with users) was made, and none is recorded in the repository.8081What the images support: the two ring concepts (1 and 5) are the only ones that keep a82recognisable silhouette in the 16 px rendering, and of those two, concept 1 keeps the spreadsheet83idea (grid plus active cell) inside the ring rather than a document stack. This agrees with the84script's own comment that the final is a refinement of concept 1 chosen to read at 16 px as "ring +85bright square". Whether the six criteria were weighed in this way when the choice was made is not86documented.8788## The final icon8990![Final ORIX Sheet icon, 1024 px master](../assets/orix-sheet-icon-1024.png)9192`finalIcon()` changes concept 1 as follows:9394| Property | Concept 1 | Final |95|---|---|---|96| Ring outer diameter | 536 px | 564 px |97| Ring thickness | 62 px | 70 px |98| Cell side / gap | 78 px / 16 px | 84 px / 15 px |99| Cell corner radius | 18 px | 19 px |100| Surrounding cells | `#EAF6FF`, top row 42 %, others 26 % | `#DDF3FF`, top row and left column 40 %, others 22 % |101| Active cell | white | white with a cyan glow (`#22D3EE` at 85 %, blur 34 px) |102| Selection handle | none | 30 px cyan square (`#22D3EE`, radius 8) on a 42 px `#101A30` backing, at the bottom-right corner of the active cell |103104Source: `design/icon/make-icons.swift` (`concept1`, `finalIcon`).105106The brighter top row and left column stand for the header row and header column of a sheet; the107handle is the fill handle of the selected cell. In the script comment the ring is described as108"opened by the sheet's row/column axes"; **the drawing code does not cut the ring** — it is a closed109annulus (two ellipses with even-odd clipping), and the rendered master shows a closed ring. The110comment and the code disagree on that point.111112## Generated files113114```115swift design/icon/make-icons.swift design/icon116```117118writes, into the directory given as argument:119120| Output | Size |121|---|---|122| `concept-1-…png` to `concept-5-…png` | 512 × 512 px (drawn at 1024, downsampled with high interpolation) |123| `orix-sheet-icon-1024.png` | 1024 × 1024 px master |124| `concepts-sheet.png` | 1840 × 450 px contact sheet |125| `AppIcon.appiconset/` | `icon_16x16.png` … `icon_512x512@2x.png` (16, 32, 128, 256, 512 pt at 1x and 2x) and `Contents.json` |126127Source: `design/icon/make-icons.swift`; pixel sizes confirmed with `sips -g pixelWidth -g pixelHeight`.128129Facts about the generated set:130131- All ten sizes are downsampled from the single 1024 px master. There is **no size-specific132  artwork**: the 16 px icon is the full drawing scaled down, not a simplified variant.133- The asset catalog used by the build is `App/Resources/Assets.xcassets/AppIcon.appiconset`. The134  script writes to `design/icon/AppIcon.appiconset`; the copy into the app's catalog is a manual135  step that the script does not perform. On 2026-11-21 the two sets are byte-identical for the136  files compared (`cmp` on `icon_16x16.png` and on the 1024 px master vs `icon_512x512@2x.png`).137- The same icon is declared as the document icon of `.orixsheet` files (`UTTypeIconFile` =138  `AppIcon` in `App/Resources/Info.plist`); there is no separate document icon.139- The script is deterministic (no random input); re-running it regenerates every file.140141## Not done142143- No dark/tinted/clear icon variants for newer macOS icon styles, no `.icon` (Icon Composer) file.144- No monochrome or template version for menus or the toolbar.145- No measured contrast for the icon and no legibility test beyond the contact sheet.146
Files main
Menu

Theme