iran_plate 0.6.0

Iran's licence plates for the plate_core library — country panels, the Persian alphabets, and the Iranian plate specs.

0.6.0

The rest of Iran's plates. The package shipped two: the private car and the motorcycle. It now ships seventeen vehicle classes, read off the Wikipedia article Vehicle registration plates of Iran — the Letter series table, the section text, and the reference SVGs the coordinates and colours are measured from.

Class is a usage, and it drives two things. Iran encodes the vehicle class in the series letter (free on a private plate, fixed for everything else) and in the field colour. Both are now derived from one IranUsage and neither is chosen by hand:

PlateCanvas(
  spec: IranPlates.forUsage(IranUsage.taxi),
  theme: IranThemes.forUsage(IranUsage.taxi),
  onChooseCharacter: PlateCharacterPicker.show,
);

Fourteen classes are one blank in fourteen liveries. A taxi plate is not a different design from a private one — it is the same 520x110 geometry in yellow with ت fixed in the letter slot and the word TAXI printed above it. So the coordinates are written down once, in a private _standard builder, and what varies between the classes is data: the letter's alphabet, how wide its box has to be for the character it holds, any extra wording, and the caption in the right-hand square (ایران, or سیاسی / سرویس on the political and service plates). Three classes are genuinely their own blank and are written out in full: protocol, historic and motorcycle.

The wheelchair symbol, stored as ژ. PersianAlphabets.disabledSymbol stores ژ and renders ♿︎. That is not a workaround — it is what the article's own footnote describes: the symbol is what the plate prints, ژ is what the police database holds. Storage-vs-display is exactly what PlateAlphabet.glyphs is for, so a plate read back out of this package reads ژ and matches the registry.

Breaking

• PersianAlphabets.plateLetters is now .privateLetters, and its contents changed. It offered sixteen characters: thirteen private county letters minus ج, plus ت, ژ and گ — which are reserved to taxis, disabled drivers and temporary passage. Offering them in a private plate's picker let a user build a plate that cannot legally exist. It is now the thirteen letters the article's table assigns to private vehicles, ج included, and each reserved letter lives on its own single-character alphabet instead.
• IranPlates.bicycle is now .motorcycle. The spec was always the motorcycle format — a three-digit provincial code over a five-digit serial — and the old name described a vehicle Iran does not register. The geometry is byte-for-byte unchanged; only the name and the spec id (ir.bicycle -> ir.motorcycle) moved.

Added

• IranUsage — the seventeen classes, each carrying the letter it is fixed to, its Latin transliteration, and what it is in one phrase.
• IranColors and IranThemes — eight schemes (black on white / yellow / tan / cyan, white on red / green / forces-blue / brown), plus IranThemes.forUsage. Every colour is the modal field or ink pixel of the corresponding reference image, so they are measurements rather than guesses.
• PersianAlphabets.disabledSymbol, .taxiLetter, .publicLetter, .agriculturalLetter, .governmentLetter, .policeLetter, .irgcLetter, .armyLetter, .defenceLetter, .generalStaffLetter, .temporaryLetter, .politicalLetter, .serviceLetter, and PersianAlphabets.forUsage.
• IranPlates.disabled, .taxi, .publicTransport, .agricultural, .government, .temporary, .police, .irgc, .army, .ministryOfDefence, .generalStaff, .political, .service, .protocol, .historic, plus IranPlates.forUsage and IranPlates.all.
• Keys on IranPlates.car's text groups — district, letter, serial, province — so a validator can pull a register by name rather than by index. Visually a no-op.

Not shipped

The free trade zone plates (Anzali, Aras, Arvand, Kish, Maku, Chabahar, Qeshm) each print their zone's logo, and this package ships no such image. For the same reason IranPlates.historic draws the ordinary flag-and-caption block where the real plate prints the Bagh-e Melli photograph — everything else about that plate is drawn. The previous-format political, service and temporary-passage plates are not included either; the article shows them only as small raster images.

Note

IranPlates.protocol has five digit cells. The article says "simply a four-digit number", but the image it illustrates the section with reads ۱۳۹۰۱, and five cells measure evenly across the space left of the wording. The picture is treated as the primary source.

0.5.0

Bahrain and Azerbaijan moved out to the iranshahr_plate package. This one is Iran's plates and nothing else.

0.4.0

Azerbaijan, in src/azerbaijan/. Four specs — the civilian car plate, the motorcycle plate, the diplomatic plate and the foreign-owned-company plate — plus AzerbaijanCountry, AzerbaijanThemes, AzerbaijanColors, and the flag SVG this package now also ships.

Same terms as Bahrain: its own folder, no import across any line, no constant shared with Iran or with Bahrain. Every existing Iran* and Bahrain* symbol is untouched.

Five plates over four specs. These are the plainest designs in the workspace — no divider, no security band, no sticker, no printed wording beyond the AZ under the flag — so a class is told apart by exactly two things:

• The grouping of the serial, which is the spec. 88-BE-114 is two digits, two letters and three; the motorcycle re-lays the same groups in two rows with one letter instead of two; a diplomat's is three digits, a class letter and three; a foreign company's leads with the class letter and follows it with six digits in two threes. The last of those is two registers and two groups rather than one of six, because a register's cells are evenly pitched by construction and debugValidateSpec checks that they are.
• The colour of the field, which is the theme. So the blue bus-and-taxi plate is AzerbaijanPlates.car printed in AzerbaijanThemes.transport — a civilian number in a civilian layout, one design in two inks. Minting an az.transport spec identical to car but for its id would be putting colour on geometry, and AzerbaijanPlates.all has four entries for that reason.

Two more things worth knowing:

• Every AzerbaijanThemes value is a PlateTheme.monochrome — one ink for the serial, the hyphens and the frame. That is the exact opposite of BahrainThemes, none of which can be one.
• AzerbaijanCountry.azerbaijan is the only country block, coloured field or not: a white block with the flag over AZ in black, which is why its caption ink is fixed rather than themed — on the blue and red plates the plate's own white ink would be invisible on it. Its panel box stays clear of the frame instead of overlapping it the way an Iranian or German panel does; those are darker than their frame and hide the seam under it, and a white block run out under a black frame would rub the frame out.

The hyphens on the two civilian plates are PlateLabels at the slots' own glyph height, not PlateRules: a hyphen is a character printed in the serial's ink, and a rule would be painted in the divider colour.

Requires plate_core ^0.9.1, unchanged.

Every coordinate is sampled by eye from plate photographs.

0.3.0

Bahrain, in src/bahrain/. Five specs — the European-size and American-size civilian plates, the bicycle plate, the diplomatic corps plate and the police plate — plus BahrainCountry, BahrainThemes and BahrainColors, and the flag SVG this package now also ships.

It shares this package for reasons that are not technical and shares nothing else: no Bahraini file imports an Iranian one or the reverse, and the two sets have no constant in common. Every existing Iran* symbol is untouched.

Three things the designs have in common and one they do not:

• A grey vertical security band on every plate, as a PlateRule — which is why no Bahraini theme is a PlateTheme.monochrome: that constructor makes the divider colour the ink, and here the band is grey on plates printed in blue and on plates printed near black alike.
• PlateSpec.panel holds a flag or a coloured band, never both, and never a caption. البحرين and its Latin partner sit at opposite ends of the plate on every design, which one left-aligned column under a flag cannot express, so the wording is PlateLabels throughout.
• Labels on the diplomatic and police bands carry PlateLabel.color (core 0.9.1); the serial keeps the theme's ink.
• The band stands clear of the right frame on the two civilian sizes and runs full height hard against it on the other three. That is the difference that makes the bicycle plate its own spec rather than a shorter us.

Requires plate_core ^0.9.1 for PlateLabel.color.

Every coordinate is sampled by eye from plate photographs. The police roundel is deliberately absent; the gap it goes in is left in the head band.

0.2.0

• Both plates' digit runs are registers, not rectangles. IranPlates.car's leading pair, serial triple and province pair, and IranPlates.bicycle's two rows, are built by plateRegister (core 0.6.0). Each states its own pitch — 55, 55, 38 on the car; 30 and 33 on the bicycle — because they are separate registers with the letter cell and the province divider in the gaps between them. The geometry is unchanged to the unit; nothing on a rendered plate moves.
• The car's letter cell stays literal: it is wider than a digit and sits on its own pitch.
• IranPlates.car and .bicycle are now static final rather than static const: a const constructor cannot run a loop. PlateSpec equality is over id alone and a static final is initialised lazily once per isolate, so this changes no behaviour — but const spec = IranPlates.car; must become final spec = …, as the example now does.
• Requires plate_core: ^0.6.0 for plateRegister.

0.1.0

First pub.dev release.

• Depends on the published plate_core: ^0.1.0 (was a sibling path: dependency). The import is package:plate_core/plate_core.dart. No API of iran_plate changed.

• Extracted from plate-core (package plate_number) at commit 86a0999, core version 0.1.0 (unreleased), as phase P8 of the library split. This is a plain move — no code was rewritten in the transfer.

• Contains Iran's plate data: IranCountry.iran, PersianAlphabets.digits / .plateLetters, and IranPlates.car / .bicycle. Depends on plate_number by path and nothing else.

• Owns assets/flags/Flag_of_Iran.svg. It moved out of core's bundle in the same commit as the SvgPlateAsset(package: ...) literal that names it, so there is no revision in which the literal points at a package that does not declare the file.