A line of two glyphs that untracked type does not draw in place takes the
tracking of the nearest tracked line in the same font, size and turn, and
keeps it only when type at that tracking draws both glyphs in place. A line
of one or two glyphs that joins tracked lines in one object takes their
tracking. The Retype row in docs/type-parity.md said other lines are set
untracked.
The fill check rejects a counter whose convex hull is narrower than three times the outline tolerance in some direction, so a turned strip is caught as well as an upright one, and rejects a shape whose outline is too large to flatten. Exact parts of a split compound are checked at tolerance 0 even when near matches are allowed, so a split that only exact matching found is not accepted under the wider tolerance. The tracking sentence in docs/type-parity.md names its three-glyph condition.
Glyphs indexed only for near matching no longer take part in exact matching,
so a curve split in two is no exact match at tolerance 0. Each pose of a match
reports its own residual. A near match spends its comparison allowance from
the shared budget in one step and returns what it leaves, and does no
sampling once the budget is spent. A glyph replaces a filled shape only when
it paints the area the shape paints under the shape's fill rule. The docs
define the tolerance by the outline spread and separate the no-conversion
error from the unmatched list.
Part of #4934. type.retype set each line of outlined text as its own
point type object, even when the lines stack as one paragraph.
- Opaque, Normal lines with a solid fill or none and no stroke that
follow each other in paint order, with the same group, paint, font,
size, turn and tracking, each the same leading (0.25 to 3 times the
size) below the one before and lined up at their starts, ends or
centers, become one area type object. Its leading is Auto when Auto
puts the last baseline in place, else the mean distance between the
baselines, and its alignment is left, right or center. Its frame is
Convert To Area Type's, now shared through typemenu::point_to_area.
An untracked line of one or two glyphs takes the others' tracking.
- Every object is laid out and compared with the outlines first: when
area type would move a glyph the lines stay multi-line point type.
When that also moves a glyph, the block ends at that glyph's line and
the lines after it join again. Type whose bounds would reach past the
coordinate limit stays apart.
- Text Wrap objects above new area type are taken into account; when
checking them on the changed layers would copy more than 2,000,000
anchors, subpaths and shapes, the lines stay multi-line point type.
text::wrap_copy_units counts that work without copying the outlines,
and wrap_work no longer copies them to count.
- The result's fonts entries add leading and area, and texts join an
object's lines with line breaks.
These rules are VectorCraft's own. Docs: docs/mcp.md (Retype several
lines), docs/type-parity.md (Retype row), docs/target-app-parity.md,
docs/roadmap.md (M7 row).
Part of #4934. type.retype set a line spaced by tracking as one point
type object per glyph, since untracked type does not draw the glyphs
where the outlines are.
- A line of three or more glyphs that most gaps space evenly apart now
takes that spacing as its tracking (1/1000 em, tried rounded to a
whole number within 0.05, then as measured). The font's advances and
pair kerning are left out of the measure, and word spaces are counted
after the tracking. When untracked type also draws the line, the line
stays untracked if the tracking is under one unit or the tracked type
would drop a gap one space wide, so "a b c" stays "a b c". Negative
tracking is set only on opaque, Normal lines with a solid fill or
none and no stroke.
- Where a line splits, the glyphs after the split take the tracking
their own gaps give, and a tracked line whose type misplaces its
first glyphs is set again without tracking. The measure has a layout
budget, so long or widely spaced lines are bounded.
- The result's fonts entries add tracking.
These rules are VectorCraft's own. Docs: docs/mcp.md (Retype tracking),
docs/type-parity.md (Retype row), docs/target-app-parity.md,
docs/roadmap.md (M7 row).
type.retype takes a tolerance (0 to 0.05, default 0 for exact matches
only). Above 0, a shape of up to 8 contours that is no glyph exactly is
read at equal steps of length from any start and in either direction,
with its contours paired with the glyph's by length. It becomes the
closest glyph when the leftover distance, relative to the shape's size,
is at most the tolerance, and the glyph's outline and the shape's each
lie within three times the tolerance of the other. Simplified outlines,
curves split in two and contours in another order or direction match
this way. A near-matched glyph may differ from its line by the tolerance
in size, turn and place; an exact glyph keeps the exact limits unless
the line's first glyph is a near match. Each entry of fonts in the
result has a score from 1 (exact) to 0.
A compound path holding several glyphs (a word made into one compound
path) is split into groups of contours, a contour with the contours
inside it, and matched in runs of up to three groups, longest first
among those that leave the rest matchable, so an i's stem and dot
become one i. Exact matches of the whole shape come first, then exact
matches of its groups, then near matches. The compound becomes type
only when every glyph matches; otherwise it stays and is reported once.
Exact matching of those groups also reads contours that run the other
way round, as Make Compound Path leaves them. A compound path of more
than 256 groups or 512 contours is matched whole only, and so are the
shapes after the first 16,384 contours one command groups.
Near matching compares a shape with at most 256 glyphs, in at most 50
million point comparisons per shape and 2 billion per command, and
looks glyphs up for at most 1,024 distinct shapes and runs per command,
whole shapes first. At most 262,144 glyphs are drawn to check and
32,768 indexed for near matching, shared equally among the faces; a
face's glyphs closest to the selected shapes are indexed first.
The tolerance, the score and the splitting rules are VectorCraft's own.
Part of #4934
Find Matching Fonts compares up to 96 loaded fonts, those of the
document's live type first, so a matching font past that limit is not
listed. The Retype rows in docs/type-parity.md and
docs/target-app-parity.md now say so.
The retype.find params text said any selection without a path is an
error, but {more: true} after a search adds the cached fonts whatever
is selected. It now limits the error to a search.
The Retype panel lists every font whose glyphs exactly match at least one
selected outlined shape, ranked by how many shapes each matches. The rows
in docs/type-parity.md and docs/ui-parity.md now say so.
retype.find keeps the `truncated` flag type.retypeFonts returns, and
retype.list returns it. When shapes past the first 2,048, or more than
16 groups deep, were not compared, the panel says so under the field.
- Rows for that line and for the "Retype: select outlined text (paths
or compound paths)" error in every complete catalog. The panel shows
that error when a search finds no path to compare.
- The params text and docs/mcp.md say "the fonts whose glyphs match the
selected outlined text". docs/type-parity.md's Retype row lists the
missing Type menu, context menu and Quick Actions entry points and the
favorites filter, as the other two docs do.
- Font samples: when eight samples are rendering, finished ones join
the ready samples before a new one starts. Samples whose text changed
while they rendered were never asked for again, so after eight of them
no sample started; typing in the panel's sample field reaches that.
- The panel test that checks the first-ranked font accepts a tie with a
renamed copy that other tests load into the shared font database.
Part of #4934.
Window › Retype shows a panel that lists the fonts whose glyphs the
selected outlined text exactly matches. Find Matching Fonts lists ten,
ranked by how many shapes each matches and then by how closely, and
Find more font matches adds the next five from the same search. Each
row shows a sample in the font, at the size the panel menu sets (Small,
Medium, Large) and with the text typed in the panel. A click on a row
sets the font on the selected live type. Reset Retype Panel clears the
list.
- type.retypeFonts {count?} returns the ranked fonts without changing
the document. It compares shapes with the glyphs of up to 96 loaded
fonts, those of the document's live type first, by type.retype's
matching. A shape counts once for each font it fits. Of two loaded
versions of a font, only the version its name gives is compared.
- RetypeIndex::all_matches returns every fit of a shape, so fonts past
the first 16 fits are ranked too.
- retype.find, retype.list, retype.preview and retype.reset drive the
panel.
- Rows for the panel's labels and the commands' errors in every
complete catalog. The Retype row also translates the Type › Retype
menu item.
Docs: docs/mcp.md (Retype panel), docs/target-app-parity.md,
docs/ui-parity.md, docs/gaps.md, docs/type-parity.md.
Part of #4934. Builds on #8441.
type.retype turns selected outlined text back into live point text when
each glyph shape is exactly a glyph of a loaded font, a font the document
uses or a family named in fonts: the same up to uniform scale, rotation
and translation. Matched glyphs map back to characters through the cmap
and become point text in that font and size at the same baseline and
turn, one object per line, with the first glyph's fill and stroke, in one
undo step. Shapes that match no font stay and are reported.
Matching (vectorcraft_text::retype) samples each contour at equal steps of
arc length and fits a similarity transform; it is bounded (faces, glyphs,
path elements, contours) and panic-free. Near matches, the ranked font
list, installed fonts not yet loaded and images are phase 2.
The help page lists the characters Type > Show Hidden Characters makes
visible: paragraph returns, forced line breaks, tabs, spaces, nonbreaking
spaces, discretionary hyphens and the end of the text
(https://helpx.adobe.com/illustrator/desktop/design-with-text/special-characters-glyphs/insert-white-space-and-break-characters.html).
The canvas marked only plain spaces, paragraph ends and the story's end.
It now draws an arrow across each tab's advance to its stop, a ring over
a nonbreaking space (U+00A0) and a smaller one over a narrow nonbreaking
space (U+202F), a short tick over the spaces of a set width (U+2000 to
U+200A, U+205F, U+3000), a not sign at a discretionary hyphen (U+00AD)
whether or not the line breaks there, and a bent arrow after a line that
a forced line break (U+2028) ends, which no longer gets a pilcrow. The
mark shapes are VectorCraft's own.
The marks follow each glyph's baseline, so they sit along the column in
vertical type and along the path in type on a path, which had no marks
before. A right-to-left line gets its pilcrow at its left end.
FontLikeness::distance left out every number either face does not give,
so a family whose faces give none of them (static faces with no OS/2 or
post table) was 0 from every family, and Show Similar Fonts could list
it right after the chosen family, as an exact match. Faces that share
no number to compare are now f32::INFINITY apart, so such a family
comes after every family of its script group that shares one, and
families equally far keep their order. The order of measured families
does not change. This is VectorCraft's own rule.
Builds on #7983, which added Show Similar Fonts.
Each paragraph of type on a path now sets its glyphs at its Desired word
spacing, letter spacing and glyph scaling, as point and area type do. The
spaced glyphs feed the steps along the path, alignment, the hangs and the
overflow, so text after a wider gap starts further along and a right or
centered line is aligned by its spaced length. Minimum and Maximum are not
used, vertical type is not glyph scaled, and a list marker keeps its width.
This changes existing documents: type on a path whose paragraphs carry
non-default Desired values now spaces differently and can overflow where
it did not.
SVG export writes such type as outlines with a warning, since a
<textPath> places its characters at their own advances.
Docs: docs/mcp.md, docs/type-parity.md, docs/gaps.md,
docs/target-app-parity.md.
With text loaded from a port, the pointer adds a link badge over a closed
path, area type or type on a path that a click threads the text into, and
keeps the loaded-text cursor over empty canvas and other art. The hover
and the click use one target test, the same rules text.thread.add applies
to `to`: not the frame the text came from, not a frame already in a
thread and not a path inside a compound path. A click on such a frame or
path now makes a new frame there instead of a text.thread.add error.
Docs: type-parity.md and ui-parity.md no longer say the loaded cursor
borrows the I-beam; target-app-parity.md gets a progress line.
A run whose language is German, Polish, Portuguese or Italian (any region)
now breaks at that language's hyph-utf8 patterns from craft-proof, and a
Bulgarian, Turkish or Russian run at that language's syllable rules. The
paragraph's Hyphenation options and the Preferences exceptions apply as
before, and points that would split a grapheme are dropped.
For Bulgarian, Turkish and Russian, craft-proof hyphenates a word outside
the language's script as English. For German, Polish, Portuguese and
Italian it can also return points from its own heuristics. Those points
are refused, so a word outside its language's script stays whole.
German, Polish, Portuguese and Italian need craft-proof built with
CRAFT_I18N_DIR; without it they keep today's behavior. Other languages,
English and the eleven Indian languages are unchanged.
The links to the archived help PDFs now open the page with the Show Sample step
(#page=352 in the CS4 help, #page=348 in the CS6 reference) instead of an earlier
page. The comments and docs/mcp.md also say which part's face gives the em box and
ICF box: the part that sets the sample's first Kanji, which is a custom set when one
holds that character.
A ≈ button on a family's row in the font menus orders the listed families by
how alike they look to it: that family first, then the families that set the
same script (Japanese, Thai or neither), then the others, each group nearest
first. The Recent Fonts section is left out while the list is ordered this
way. A ≈ chip under the filters names the family and clears the order, with
that family still highlighted; closing the menu clears it too.
The measure is VectorCraft's own. Each face records its OS/2 PANOSE digits,
weight and width classes, x-height, cap height and average character width,
and its post italic angle; a named instance of a variable font takes its wght
and slnt settings. The system font scan reads the head table and the post
table's header besides the tables it read before, so installed families are
compared by the same numbers without loading them. A family is compared by its
face nearest an upright Regular, a number either face does not give is left
out, and a family of another kind counts as further away.
text.similarFonts {family, limit?} returns the same order, with errors for a
missing or non-string family, a family that is not available or not listed in
the font menus, and a limit that is not a whole number from 1 to 100000.
Show Sample (Hide Sample when it shows) in Type > Composite Fonts... draws
the font picked in a line of sample text, with the first character of
each custom set added, through the renderer, so color and bitmap glyphs
keep their colors. Buttons beside it show or hide lines for the ICF box,
em box, baseline, cap height, highest ascent and lowest descent, highest
ascender and x-height, and Zoom draws it at 25% to 800% of 36 pt. The em
box and ICF box are the Kanji part's font's; the other lines measure the
faces the glyphs are drawn in, fallback faces included. Each line takes
its part's size, baseline and vertical scale, and Kana scaled at center,
as layout sets them.
ui.dialog.set takes sample, zoom and the seven line fields, and refuses a
zoom outside the menu or a line that is not true or false. FontFace gains
cap_height(), the estimate a face without an OS/2 cap height uses, beside
x_height().
Docs: docs/mcp.md, docs/type-parity.md, docs/target-app-parity.md.
A Glyphs panel cell whose glyph has alternates shows a small triangle in
its lower right corner. A click on it opens a pop-up of that glyph and
its alternates in the font's order. Picking one inserts the character at
the Type tool's caret drawn with that glyph, or draws the selected
character with it, in one undo step; the cell's own glyph inserts the
character as a double-click does. In Entire Font a glyph no character
maps has the triangle too, and a pick goes on the selected character as
a double-click on that glyph's cell does.
A pick is tried on a copy of the document first, so one the character
cannot be drawn with (All Caps, for example) changes nothing and the
status says why. A Select All over a threaded story is replaced as
typing replaces it. The triangle's size and the pop-up's eight columns
and six rows are VectorCraft's own.
Paragraph panel menu > Kurikaeshi Moji Shori (text.setFormat
{kurikaeshiMojiShori}) is a paragraph attribute, off by default, saved
only when on and carried by paragraph styles. On, a repeat mark (々, ゝ,
ゞ, ヽ, ヾ) that starts a line of point or area type is drawn as the
character it repeats, with the mark's width, and the text keeps the
mark. Threaded type looks back into the frames before when a paragraph
continues. Live SVG text writes the drawn character and places the
text after it.
The Character panel shows Adjust Horizontal and Adjust Vertical Diacritic
Position with the Middle Eastern options. text.setFormat and
text.setRangeStyle take diacriticHorizontal and diacriticVertical, in
thousandths of an em from -1000 to 1000. Positive values move the
characters' mark glyphs (GDEF class 3) right and up, and the letters keep
their places. An Arabic harakat or a Hebrew point styled apart from its
letter takes its own values without splitting the shaping cluster.
Character styles and Character Style Options carry both values. They are
saved only when set, and SVG export writes such type as outlines.
Docs: docs/mcp.md, docs/type-parity.md, docs/target-app-parity.md.
Type > Composite Fonts... has Custom: named character sets, each setting
the characters it lists in its own font, style, size, baseline and
scales ahead of their class. The later of two sets that list a character
sets it. Characters are added by Direct Entry or by Unicode code and
deleted one at a time, and the parts table scrolls when it grows.
- type.compositeFonts.set takes `custom`; part keys left out take the
Kanji part's values. Sets are saved with the document and in
.vccomposite files, and Export refuses a file over 4 MB.
- VectorCraft's own limits: 64 sets per font, 8,192 characters per set,
each character once per set, up to U+FFFF and no control characters.
- The font database caches each font's character lookup.
Docs: docs/mcp.md, docs/type-parity.md, docs/target-app-parity.md.
- A form other than the default, set with text.setRangeStyle or
text.setFormat, takes away the characters' glyph choice, which would
otherwise keep drawing its own glyph. "default" keeps it.
- With a width form (fwid, hwid, twid, qwid), shaping leaves out palt and
turns kern and apkn off, and SVG output writes font-kerning: none and no
palt, as the OpenType feature list asks. proportionalMetrics and kerning
keep their values.
- The Glyphs panel menu counts a width form as available when a face has
the feature in GSUB or GPOS.
- At a caret, the menu's check marks and its no-op check read all the
text of the object, which is what the command formats. Choosing the
current form again is not skipped when a character has a glyph choice.
With Show East Asian Options on, the OpenType panel menu has H or V
Style and Roman Italics. H or V Style is the character feature tag
`hkna`: kana take the forms the font draws for horizontal type, and in
vertical type the shaper applies `vkna` in its place. Roman Italics is
`ital`, the font's italic half-width alphanumerics. Both are on or off
only (`hkna=2` is refused), set through `features` and
`featureChanges`, cleared by Reset OpenType Features, and are switches
in Character Style Options > OpenType Features.
Docs: docs/mcp.md, docs/type-parity.md, docs/target-app-parity.md.