SPB Git

Repository Public

icon-design.md 6.9 KB

# Icon design

The ORIX Docs icon is original artwork drawn in code with Core Graphics (design/icon/make-icon.swift). It uses no external image, font file or template, and it does not imitate the icons of Microsoft Word or Apple Pages. Five concepts were drawn on the shared ORIX plate (brand-guidelines.md) and compared at three sizes.

The five concepts at 280, 64 and 32 pixels

The contact sheet above (design/icon/concepts-sheet.png, copied to docs/assets/icon-concepts.png) shows each concept at 280 px, 64 px and 32 px on a light grey background.

# The five concepts

All five sit on the same plate: a dark ink rounded square with a blue-violet glow from the top-left corner.

# File What is drawn
1 concept-1-o-page.png O + page. The indigo gradient ring, left of centre and open on its right side; a white sheet with a folded top-right corner overlaps the opening. On the sheet: one short solid indigo bar (a heading), five pale indigo bars of uneven length (lines of text), and a small amber mark after the last, shorter line (the caret).
2 concept-2-monogram.png Monogram. A large white-to-lavender letter O with strong contrast between thick sides and thin top and bottom (an ellipse with a narrow elliptical counter), a violet pilcrow (¶, Baskerville) standing in the counter. The plate's glow is more violet.
3 concept-3-text-lines.png Text lines. The ring, centred and open on the right, crossed by five white bars of different lengths set flush left, like a ragged-right paragraph running out of the ring.
4 concept-4-open-book.png Open book. A thinner closed ring shading from light blue to indigo; inside it, an open book seen from the front: two white pages with curved top and bottom edges and an indigo spine. The glow is bluer.
5 concept-5-layers.png Layers. Three sheets fanned out: two translucent lavender sheets rotated behind a white sheet with a folded corner, which carries a small closed ring.

# Evaluation

Scores from 1 (weak) to 5 (strong). They are a design judgement made on the contact sheet, not a measurement; the small-size column was judged on the 64 px and 32 px renderings.

Criterion 1 O + page 2 Monogram 3 Text lines 4 Open book 5 Layers
Originality 4 — the ring opened by a page is specific to this app 3 — letter-in-a-tile is a common pattern 4 — unusual, abstract 2 — an open book is a stock symbol for reading 3 — stacked sheets are common for document tools
Recognisability ("a writing app") 5 — page, lines and caret say it at once 3 — the pilcrow speaks to typographers only 3 — reads as "text" or as a menu 2 — reads as a reader or a library 4 — reads as "documents", less as "writing"
Small-size legibility 4 — ring and page hold at 32 px; the lines merge and the caret disappears 5 — a single bold shape 3 — bars and ring blend at 32 px 4 — ring and book stay clear 3 — the back sheets and the small ring are lost
Geometric balance 4 — the page sits right of centre and answers the ring on the left 5 — symmetric 3 — bars overflow the ring to the right 5 — symmetric 3 — the fan leans left
Brand consistency (plate, ring, accent pair) 5 — plate, ring, indigo and the amber accent 2 — no ring; the O is a letter, not the ORIX ring 4 — plate and ring, no amber 3 — ring recoloured towards blue, no amber 3 — the ring is reduced to a detail
Dock and Finder appearance 4 — the white page gives contrast on dark and light backgrounds 4 — strong, but anonymous among letter icons 3 — low contrast between ring and bars 4 — clear silhouette 3 — busy
Total (of 30) 26 22 20 20 19

# Decision

Concept 1, "O + page", is the shipped icon. It is the only concept that keeps the whole family signature (plate, ring, both accent colours) while showing the subject of the application without needing a caption. Its weakness is the fine detail on the page at 16–32 px, which is accepted: at those sizes the icon is carried by the ring-and-page silhouette.

finalIcon(_:) in make-icon.swift calls conceptOPage(_:) directly, and design/icon/orix-docs-icon-1024.png is byte-identical to concept-1-o-page.png and to icon_1024.png in the asset catalogue.

The shipped icon

# How it is produced

sh
cd design/icon
swift make-icon.swift .

The script draws on a 1024 × 1024 canvas with a transparent background and writes, into the output directory: the five concept-*.png, orix-docs-icon-1024.png and concepts-sheet.png. Its building blocks:

Function Draws
plate(_:glow:) The 824 × 824 rounded square (corner radius 186) inset 100 px, its drop shadow, the ink gradient, the radial glow and a 3 px edge highlight.
ring(_:center:radius:width:gaps:colors:) A stroked circle, or arcs between the given gaps with round caps, filled with a diagonal gradient.
page(_:_:fold:radius:top:bottom:shadow:) A rounded sheet with a folded top-right corner, a white-to-lavender gradient and a shadow.
roundedBar(_:_:_:) The pill-shaped bars used for text lines and the caret.

The application icon set is App/Resources/Assets.xcassets/AppIcon.appiconset, with seven PNG files covering the ten macOS slots:

File Pixels Slots
icon_16.png 16 16 pt @1x
icon_32.png 32 16 pt @2x, 32 pt @1x
icon_64.png 64 32 pt @2x
icon_128.png 128 128 pt @1x
icon_256.png 256 128 pt @2x, 256 pt @1x
icon_512.png 512 256 pt @2x, 512 pt @1x
icon_1024.png 1024 512 pt @2x

make-icon.swift produces the 1024 px master only. The smaller files are reductions of it, produced by Scripts/icons.sh (sips), which also refreshes the documentation copies. docs/assets/orix-docs-icon-256.png is the 256 px version used in the documentation.

# Notes on the artwork

  • The margins around the plate (100 px of 1024) leave room for the shadow, as macOS icons of this shape do.
  • The caret is drawn with roundedBar, whose corner radius is half the bar's height; on a bar that is taller than wide this gives an elongated oval rather than a straight bar.
  • The plate's linear gradient is drawn without extending before its start point; with the radial glow on top, a slightly different tone is visible in the extreme top-left corner of the plate at full size.
Files main
Menu

Theme