Fix #7944: New Document opens in the General units and keeps units chosen in its menu

New Document opened on the most recent entry in the units that entry was
made in, so with Preferences › Units › General in millimeters, File › New
and New Without Dialog still made documents in points, and the rulers and
the Measure tool, which follow the document's units, read points. The
dialog now opens in the General units on a Recent entry too. An entry
made in pixels, and an entry that is a saved preset in the units it was
saved in, keep their units. Before, the dialog opened in the entry's
own units.

Units chosen in the Units menu were also replaced by the next tab, card
or preset chosen, for example the Web tab's pixels, or a Recent or Saved
card's units on a click or on the double-click that creates the
document. A choice made in the menu, or with ui.dialog.set (also while
More Settings or Manage Profiles is open), now stays until Create.
Without such a choice, clicking another Recent or Saved card still
brings back that card's own units.

Docs: docs/mcp.md (New Document), docs/target-app-parity.md evidence.
This commit is contained in:
dotCooCoo
2026-11-15 13:41:27 -08:00
parent bb218101c9
commit 403ac6b794
5 changed files with 209 additions and 12 deletions
+3
View File
@@ -605,6 +605,9 @@ pub fn set_field(d: &mut Dialog, field: String, value: Value) {
if d.kind == "preferences" {
crate::prefs_dialog::note_set(d, &field, &value);
}
if d.kind == new_document::KIND || new_document::popup_open(d) {
new_document::note_set(d, &field);
}
let dxf = (d.kind == dxf_options::KIND).then(|| field.clone());
d.fields.insert(field, value);
if let Some(field) = dxf {
+146 -7
View File
@@ -12,7 +12,10 @@
//! `artboardLayout`, `bleed`, `backgroundContents`, `colorMode`, `rasterEffectsPpi`,
//! `previewMode`, `alignNewObjectsToPixelGrid`, `profile`), plus `category` (the tab), `advanced` (Advanced Options open), `bleedLinked` and
//! `presetName` (Save Preset's name). Setting `preset` fills the fields from that preset; changing
//! any of them afterwards makes the settings custom.
//! any of them afterwards makes the settings custom. The dialog opens in Preferences › Units ›
//! General, also on a Recent entry made in other units (one in pixels, or a saved preset in the
//! units it was saved in, keeps its units); units chosen
//! in the Units menu or set with `ui.dialog.set` stay when another tab or preset is chosen.
use serde_json::{Map, Value, json};
use vectorcraft_doc::Unit;
@@ -57,6 +60,9 @@ const SAVING: &str = "__saving";
/// Preset Details has drawn the saving top: set from the mode's second frame, so the first one fills
/// in the default name and focuses it.
const SAVING_SHOWN: &str = "__savingShown";
/// The units were chosen in the Units menu (or set with `ui.dialog.set`): presets chosen after that
/// keep the chosen units.
const UNITS_CHOSEN: &str = "__unitsChosen";
/// The units New Document offers (all ten).
const UNITS: [Unit; 10] = [
Unit::Pixels,
@@ -82,17 +88,49 @@ const HEADER: f32 = 100.0;
const MORE_WIDTH: f32 = 310.0;
/// Open New Document on the most recent settings (or Letter), named after the next untitled
/// document.
/// document, in Preferences › Units › General.
pub fn open(app: &mut VectorcraftApp) {
let category = if app.session.prefs.recent_new_docs.is_empty() { "Print" } else { "Recent" };
let first = newdoc::category(&app.session, category).and_then(|v| v.into_iter().next()).unwrap_or_default();
let mut d = Dialog::new(KIND, json!({ "category": category, "name": app.session.peek_untitled(), "advanced": false }));
apply(&mut d, &first);
if !apply_first(app, &mut d, category) {
apply(&mut d, &DocSettings { units: app.session.default_units(), ..DocSettings::default() });
}
app.ui.dialog = Some(d);
}
/// Fill the fields from a preset.
/// Fill the fields from the first preset of `category`, as opening the dialog and choosing a tab
/// do; false when the category has none. The most recent entry keeps its size and takes
/// Preferences › Units › General, as the built-in presets do, unless it is in pixels or it is a
/// saved preset in the units it was saved in. Its card stays the chosen one and shows those units;
/// choosing another card brings back that card's own units.
fn apply_first(app: &VectorcraftApp, d: &mut Dialog, category: &str) -> bool {
let Some(first) = newdoc::category(&app.session, category).and_then(|v| v.into_iter().next()) else { return false };
// `file.new` reads a named preset in its own units, and names the entry Custom in others.
let as_saved = newdoc::find(&app.session, &first.name).is_some_and(|p| p.units == first.units);
if !category.eq_ignore_ascii_case("Recent") || first.units == Unit::Pixels || as_saved {
apply(d, &first);
return true;
}
let own = first.units;
apply(d, &DocSettings { units: app.session.default_units(), ..first });
// The card is still the entry it was: its own units say which entry it is.
if let Some(Value::Object(a)) = d.fields.get_mut(APPLIED) {
a.insert("units".into(), json!(own.label()));
}
true
}
/// `field` of New Document `d` is about to be set by `ui.dialog.set`: setting the units is a choice
/// that presets chosen after it keep.
pub(super) fn note_set(d: &mut Dialog, field: &str) {
if field == "units" {
d.fields.insert(UNITS_CHOSEN.into(), json!(true));
}
}
/// Fill the fields from a preset, keeping the units when they were chosen in the Units menu.
fn apply(d: &mut Dialog, s: &DocSettings) {
let chosen = if d.bool(UNITS_CHOSEN) { d.fields.get("units").cloned() } else { None };
let Value::Object(mut v) = s.to_json() else { return };
for k in ["size", "orientation"] {
v.remove(k);
@@ -105,6 +143,9 @@ fn apply(d: &mut Dialog, s: &DocSettings) {
d.fields.insert(k.clone(), val.clone());
}
d.fields.insert(APPLIED.into(), Value::Object(v));
if let Some(u) = chosen {
d.fields.insert("units".into(), u);
}
}
/// Keep the fields and the chosen preset in step: a new `preset` (also from `ui.dialog.set`) fills
@@ -305,8 +346,8 @@ fn presets(app: &VectorcraftApp, ui: &mut egui::Ui, d: &mut Dialog) -> bool {
if let Some(i) = widgets::tab_bar(ui, &names, cat) {
d.fields.insert("category".into(), json!(names[i]));
// A tab opens on its first preset, so the details match its cards.
if let Some(first) = names.get(i).and_then(|c| newdoc::category(&app.session, c)).and_then(|v| v.into_iter().next()) {
apply(d, &first);
if let Some(c) = names.get(i) {
apply_first(app, d, c);
}
}
let list = names.get(cat).and_then(|c| newdoc::category(&app.session, c)).unwrap_or_default();
@@ -705,6 +746,7 @@ fn units_dropdown(ui: &mut egui::Ui, d: &mut Dialog, width: f32) {
let labels = UNITS.map(Unit::label);
if let Some(u) = widgets::dropdown(ui, "newdoc-units", unit(d).label(), &labels, width).and_then(|i| UNITS.get(i)) {
d.fields.insert("units".into(), json!(u.label()));
d.fields.insert(UNITS_CHOSEN.into(), json!(true));
}
}
@@ -1569,6 +1611,103 @@ mod tests {
assert!(h.state().session.active().unwrap().doc.setup.align_new_objects_to_pixel_grid);
}
/// Create, then the new document's units.
fn create(h: &mut Harness) -> vectorcraft_doc::Unit {
h.get_by_label("Create").click();
h.run_steps(3);
assert!(h.state().ui.dialog.is_none(), "{:?}", h.state().ui.status);
h.state().session.active().unwrap().doc.units
}
/// With Preferences › Units › General in millimeters, New Document opens on the most recent
/// entry in millimeters even though that entry was made in points, and New Without Dialog makes
/// the same document. An entry in pixels stays in pixels, as the screen presets do.
#[test]
fn the_dialog_opens_in_the_general_units_over_a_recent_entry() {
use vectorcraft_doc::Unit::{Millimeters as Mm, Pixels as Px};
let mut h = big();
h.state_mut().run("file.new", json!({"units": "Points"})).unwrap();
h.state_mut().run("prefs.set", json!({"key": "unitsGeneral", "value": "Millimeters", "documentUnits": false})).unwrap();
assert_eq!(h.state().session.prefs.recent_new_docs[0].units, vectorcraft_doc::Unit::Points);
h.state_mut().run("file.newDialog", json!({})).unwrap();
h.run_steps(3);
assert_eq!((field(h.state(), "category"), field(h.state(), "units")), (json!("Recent"), json!("Millimeters")));
assert_eq!(create(&mut h), Mm, "the dialog's Create");
h.state_mut().run("file.new", json!({"units": "Points"})).unwrap();
h.state_mut().run("file.newWithoutDialog", json!({})).unwrap();
assert_eq!(h.state().session.active().unwrap().doc.units, Mm, "New Without Dialog");
h.state_mut().run("file.new", json!({"preset": "Web 1920×1080"})).unwrap();
h.state_mut().run("file.newDialog", json!({})).unwrap();
h.run_steps(3);
assert_eq!(field(h.state(), "units"), json!("Pixels"));
assert_eq!(create(&mut h), Px);
}
/// A Recent entry that is a saved preset in the units it was saved in opens in those units, so
/// Create keeps the preset's name in Recent; the General unit is millimeters.
#[test]
fn a_recent_saved_preset_keeps_its_units_and_name() {
let mut h = big();
h.state_mut().run("file.newPresets.save", json!({"name": "Zine", "width": "5.5 in", "height": "8.5 in", "units": "Inches"})).unwrap();
h.state_mut().run("file.new", json!({"preset": "Zine"})).unwrap();
h.state_mut().run("prefs.set", json!({"key": "unitsGeneral", "value": "Millimeters", "documentUnits": false})).unwrap();
h.state_mut().run("file.newDialog", json!({})).unwrap();
h.run_steps(3);
assert_eq!((field(h.state(), "preset"), field(h.state(), "units")), (json!("Zine"), json!("Inches")));
assert_eq!(create(&mut h), vectorcraft_doc::Unit::Inches);
let recent = &h.state().session.prefs.recent_new_docs;
assert_eq!((recent.len(), recent[0].name.as_str()), (1, "Zine"), "{recent:?}");
}
/// Units set with `ui.dialog.set` while More Settings or Manage Profiles is open stay chosen
/// when a preset is chosen after them.
#[test]
fn units_set_over_a_popup_stay_chosen() {
for popup in [super::MORE, super::PROFILES] {
let mut app = VectorcraftApp::new(Session::new(), Default::default());
app.run("file.newDialog", json!({})).unwrap();
let d = app.ui.dialog.as_mut().unwrap();
d.kind = popup.into();
crate::dialogs::set_field(d, "units".into(), json!("Millimeters"));
crate::dialogs::set_field(d, "preset".into(), json!("A4"));
d.kind = super::KIND.into();
let ctx = egui::Context::default();
crate::theme::install_fonts(&ctx);
let mut out = ctx.run_ui(egui::RawInput::default(), |ui| crate::dialogs::show(&mut app, ui.ctx()));
out.textures_delta.clear();
assert_eq!((field(&app, "preset"), field(&app, "units")), (json!("A4"), json!("Millimeters")), "{popup}");
}
}
/// Millimeters chosen in the Units menu stay chosen when another tab or preset is chosen after
/// them, and reach the new document.
#[test]
fn units_chosen_in_the_menu_survive_tabs_and_presets() {
use vectorcraft_doc::Unit::Millimeters as Mm;
let mut h = big();
assert_eq!((field(h.state(), "category"), field(h.state(), "units")), (json!("Print"), json!("Points")));
h.get_by_role_and_label(Role::ComboBox, "Units").click();
h.run_steps(3);
h.get_by_label("Millimeters").click();
h.run_steps(3);
assert_eq!(field(h.state(), "units"), json!("Millimeters"));
// A Recent entry made in inches, which the Recent tab opens on.
h.state_mut().run("file.new", json!({"width": "8.5 in", "height": "11 in", "units": "Inches"})).unwrap();
for tab in ["Web", "Recent", "Print"] {
h.get_by_role_and_label(Role::Button, tab).click();
h.run_steps(3);
assert_eq!((field(h.state(), "category"), field(h.state(), "units")), (json!(tab), json!("Millimeters")), "the {tab} tab");
}
// A preset chosen by name, as `ui.dialog.set` chooses it.
crate::dialogs::set_field(h.state_mut().ui.dialog.as_mut().unwrap(), "preset".into(), json!("A4"));
h.run_steps(3);
assert_eq!(
(field(h.state(), "width"), field(h.state(), "units")),
(json!(vectorcraft_doc::Unit::Millimeters.to_pt(210.0)), json!("Millimeters"))
);
assert_eq!(create(&mut h), Mm);
}
/// A long translation of Align New Objects to Pixel Grid wraps inside the Preset Details column.
#[test]
fn align_new_objects_label_wraps_inside_the_details_column() {
+53 -3
View File
@@ -174,15 +174,17 @@ fn new_document_cards_follow_the_chosen_units() {
/// Choosing units in Preset Details changes the chosen document, not every recent one: each card
/// keeps the units its document was made in, so switching between inches and millimetres leaves the
/// other templates as they were; choosing another card brings its units back.
/// other templates as they were; choosing another card brings its units back while no units were
/// chosen in the Units menu.
#[test]
fn recent_cards_keep_their_own_units() {
let mut app = VectorcraftApp::new(vectorcraft_engine::Session::new(), Default::default());
// 8.5 × 11 in, then 210 × 297 mm, which Recent lists first and the dialog opens on.
// 8.5 × 11 in, then 210 × 297 mm, which Recent lists first and the dialog opens on, in
// Preferences › Units › General (points).
run(&mut app, "file.new", json!({"width": "8.5 in", "height": "11 in", "units": "Inches"}));
run(&mut app, "file.new", json!({"width": "210 mm", "height": "297 mm", "units": "Millimeters"}));
app.run("file.newDialog", json!({})).unwrap();
assert_eq!(app.ui.dialog.as_ref().unwrap().fields["units"], json!("Millimeters"));
assert_eq!(app.ui.dialog.as_ref().unwrap().fields["units"], json!("Points"));
app.ui.dialog.as_mut().unwrap().fields.insert("units".into(), json!("Points"));
let t = dialog_texts(&mut app);
assert!(shows(&t, "595.276 × 841.89 pt"), "the chosen entry in points: {t:?}");
@@ -200,6 +202,54 @@ fn recent_cards_keep_their_own_units() {
assert_eq!((d.fields["width"].clone(), d.fields["height"].clone()), (json!(612.0), json!(792.0)));
}
/// Units chosen in the Units menu (here through `ui.dialog.set`) stay chosen when a Recent card made
/// in other units is clicked, and the document is made in them.
#[test]
fn a_recent_card_keeps_the_units_chosen_in_the_menu() {
let mut app = VectorcraftApp::new(vectorcraft_engine::Session::new(), Default::default());
run(&mut app, "file.new", json!({"width": "8.5 in", "height": "11 in", "units": "Inches"}));
run(&mut app, "file.new", json!({"width": "210 mm", "height": "297 mm", "units": "Millimeters"}));
app.run("file.newDialog", json!({})).unwrap();
crate::dialogs::set_field(app.ui.dialog.as_mut().unwrap(), "units".into(), json!("Millimeters"));
let ctx = egui::Context::default();
crate::theme::install_fonts(&ctx);
let mut draw = |app: &mut VectorcraftApp, ui: &mut Ui| crate::dialogs::show(app, ui.ctx());
frame_events(&ctx, &mut app, vec![], &mut draw); // the window sizes itself here
let inches = text_rect(&frame_events(&ctx, &mut app, vec![], &mut draw), "8.5 × 11 in").center();
click(&ctx, &mut app, inches, &mut draw);
let d = app.ui.dialog.as_ref().unwrap();
assert_eq!((d.fields["width"].clone(), d.fields["units"].clone()), (json!(612.0), json!("Millimeters")));
crate::dialogs::confirm(&mut app).unwrap();
let doc = &app.session.active().unwrap().doc;
assert_eq!((doc.units, doc.artboards[0].rect.width()), (Unit::Millimeters, 612.0));
}
/// A double-click on a Recent or Saved card made in inches creates the document in the millimeters
/// chosen in the Units menu (here through `ui.dialog.set`) before it.
#[test]
fn a_double_clicked_card_keeps_the_units_chosen_in_the_menu() {
for category in ["Recent", "Saved"] {
let mut app = VectorcraftApp::new(vectorcraft_engine::Session::new(), Default::default());
run(&mut app, "file.newPresets.save", json!({"name": "Letter in", "width": "8.5 in", "height": "11 in", "units": "Inches"}));
run(&mut app, "file.new", json!({"width": "8.5 in", "height": "11 in", "units": "Inches"}));
run(&mut app, "file.new", json!({"width": "210 mm", "height": "297 mm", "units": "Millimeters"}));
app.run("file.newDialog", json!({})).unwrap();
let d = app.ui.dialog.as_mut().unwrap();
d.fields.insert("category".into(), json!(category));
crate::dialogs::set_field(d, "units".into(), json!("Millimeters"));
let ctx = egui::Context::default();
crate::theme::install_fonts(&ctx);
let mut draw = |app: &mut VectorcraftApp, ui: &mut Ui| crate::dialogs::show(app, ui.ctx());
frame_events(&ctx, &mut app, vec![], &mut draw); // the window sizes itself here
let card = text_rect(&frame_events(&ctx, &mut app, vec![], &mut draw), "8.5 × 11 in").center();
click(&ctx, &mut app, card, &mut draw);
click(&ctx, &mut app, card, &mut draw);
assert!(app.ui.dialog.is_none(), "the {category} card's double-click creates: {:?}", app.ui.status);
let doc = &app.session.active().unwrap().doc;
assert_eq!((doc.units, doc.artboards[0].rect.width()), (Unit::Millimeters, 612.0), "the {category} card");
}
}
/// A saved preset keeps the units it was saved in too, whichever units the dialog is showing.
#[test]
fn saved_cards_keep_their_own_units() {
+6 -2
View File
@@ -7011,8 +7011,12 @@ A saved or Recent preset whose size (up to 3,999,856 pt), `artboards` (1 to
1,000), spacing (0 to 100,000 pt) or bleed (0 to 72 pt a side) lies outside those ranges is read with the nearer end of
each range, and a size of 0 or less is read as 1 pt.
The desktop app's `file.newDialog` (Cmd/Ctrl+N) opens the New Document dialog on the first Recent entry, or on the
Print category's Letter while Recent is empty. `file.newWithoutDialog` (Cmd/Ctrl+Alt+N) runs `file.new` with those
settings and the next untitled name, without opening the dialog, and returns what `file.new` returns.
Print category's Letter while Recent is empty. The dialog opens in Preferences › Units › General (`unitsGeneral`),
also when the Recent entry was made in other units. An entry made in pixels, and an entry that is a saved preset in
the units it was saved in, keep their units. Clicking another Recent or Saved card brings back the units that card was
made in. Units chosen in the dialog's Units menu, or set with `ui.dialog.set` (the `units` field), stay when another
tab or preset is chosen. These are VectorCraft's own rules. `file.newWithoutDialog` (Cmd/Ctrl+Alt+N) runs `file.new`
with those settings and the next untitled name, without opening the dialog, and returns what `file.new` returns.
`window.nextDocument` (Cmd/Ctrl+F6) and `window.previousDocument` (Cmd/Ctrl+Shift+F6) make the next and the previous
open document in tab order the current one, as a click on its tab does, and return `{index}`. After the last document
comes the first, and before the first document comes the last. From the Home screen they go to the first and the last
+1
View File
@@ -770,6 +770,7 @@ Moved from the ROADMAP's "Shipped so far" on 2026-10-10. Update it when a featur
- **Out-of-gamut warning after a profile change:** the out-of-gamut warning and its closest-color correction in the Color panel and Color Picker ([the help page](https://helpx.adobe.com/illustrator/using/adjusting-colors.html)) check the color against the document's assigned CMYK profile, else the working CMYK space, and update when Edit › Assign Profile… or Edit › Color Settings… changes that space or a loaded profile changes, without a change of color. Which CMYK space the warning uses is VectorCraft's own rule. Tests: `gamut_warning_follows_a_profile_change` and `gamut_warning_follows_a_profile_loaded_again` in `dialogs/color_picker/tests.rs`.
- **Assign Profile and the working spaces:** Edit › Assign Profile… tags the document and leaves the working spaces of Edit › Color Settings… as they are, in Color Settings, the Separations panel and the settings saved for the next start. Colors show and convert through the profiles assigned; a change in Color Settings keeps the profiles the document in front is assigned in use, and removing an assigned profile in use puts the working space back in its place. The profiles in use follow the document in front: a new, opened or reverted document, a switch to another tab, a close, Undo and Redo of Assign Profile, a failed batch, each step of a batch, Export All Open and the update of placed documents put that document's profiles in use, and the working spaces where it is assigned none or no document is open. With Window › Arrange › Tile or floating document windows, each document behind the front one draws its art, paper and transparency grid through its own assigned profiles, and loading or removing a profile redraws the documents assigned it; placed documents inside it still draw through the front document's profiles. How documents behind the front one draw is VectorCraft's own rule. View › Proof Setup › Working CMYK simulates the working CMYK space of Color Settings in Proof Colors and Separations Preview, also in a document assigned another CMYK profile. Public references: [Changing the color profile for a document and About color working spaces](https://help.adobe.com/archive/en_US/illustrator/cs3/illustrator_cs3_help.pdf#page=150) and [Soft-proof presets](https://help.adobe.com/archive/en_US/illustrator/cs3/illustrator_cs3_help.pdf#page=134). Tests in `engine/tests/color_settings.rs`.
- **Color management policies:** Edit › Color Settings… (the Separations panel's Color Settings section and `edit.colorSettings`) has an RGB and a CMYK policy: Off, Preserve Embedded Profiles and Convert to Working Space, and Preserve Numbers for CMYK. When a document tagged with a profile other than the working space is opened, reverted or opened as a template, the policy keeps the profile, takes it off with the color numbers kept, or converts that model's colors into the working space, with black point compensation as Color Settings set it, and takes it off. The policies are kept in `Color Settings.json`. Preserve Embedded Profiles as the default for both, and the per-model policy for a document tagged with both an RGB and a CMYK profile, are VectorCraft's own rules; placed images and the Profile Mismatches and Missing Profiles prompts are not covered. Public reference: [Color management policy options](https://help.adobe.com/archive/en_US/illustrator/cs4/illustrator_cs4_help.pdf#page=157). Tests in `engine/tests/color_settings.rs`, `color/src/cms/tests.rs` and `color/src/cms/tests_icc.rs`.
- **New Document's units:** the dialog opens in Preferences › Units › General, also on a Recent entry made in other units (an entry in pixels, or a saved preset in the units it was saved in, keeps its units), so File › New and New Without Dialog make documents in the General unit. Units chosen in the Units menu stay when another tab or preset is chosen and when a card is clicked or double-clicked; without such a choice, clicking another Recent or Saved card brings back the units that card was made in (#7944). These are VectorCraft's own rules. Tests: `the_dialog_opens_in_the_general_units_over_a_recent_entry`, `a_recent_saved_preset_keeps_its_units_and_name`, `units_chosen_in_the_menu_survive_tabs_and_presets` and `units_set_over_a_popup_stay_chosen` in `dialogs/new_document.rs`; `a_recent_card_keeps_the_units_chosen_in_the_menu` and `a_double_clicked_card_keeps_the_units_chosen_in_the_menu` in `panels/tests_units.rs`.
- **New Document's More Settings and Save Preset:** More Settings opens a pop-up over New Document with only Number of Artboards, the artboard layout, Change to Right-to-Left Layout, Spacing and Columns; Done, Escape or a click outside closes it and keeps the values. Save Preset turns the top of Preset Details into a Save Document Preset heading with the preset's name, Cancel and Save, and hides the document's name, Close and Create until the preset is saved or canceled; nothing in that mode creates a document. Save Preset's default name is the first "Preset N" no saved preset has. VectorCraft's own layout. Harness tests in `dialogs/new_document.rs` cover both.
- **New Document profiles:** each built-in category's presets start documents from that category's profile, a native document holding the starting swatches, graphic styles, brushes, symbols and other assets, the ruler and Document Setup options and the print settings ([Create a custom new document profile](https://helpx.adobe.com/illustrator/desktop/add-and-import-files/start-a-new-file/create-a-custom-new-document-profile.html)). New Document's Manage Profiles pop-up opens a profile to edit and resets one to the shipped profile (`file.newProfiles`, `file.newProfiles.edit`, `file.newProfiles.reset`; `file.new {profile}`). The profiles live in VectorCraft's own `New Document Profiles` folder next to the preferences; a profile that cannot be read or is larger than 64 MiB leaves the defaults and is reported. Tests: `tests::newdoc::an_edited_profile_starts_the_documents_of_its_category`, `the_profile_follows_the_preset_access_and_reset`, `profile_errors_name_the_file_by_its_name_outside_the_read_roots`, `a_damaged_or_oversized_profile_leaves_the_defaults_and_is_reported`, `profile_names_are_checked_and_editing_needs_the_folder`, `dialogs::new_document::tests::manage_profiles_edits_and_resets_the_profiles`.
- **Control bar with the Artboard tool:** while the Artboard tool is in use, the Control bar shows the active artboard's controls in place of the object controls: Preset, Portrait and Landscape, New Artboard, Delete Artboard, the Name field, Artboard Options, Rearrange All Artboards, the Transform link, Move and Scale Artwork with Artboard and, while the bar has room, the reference point with X and Y, and W and H with the Constrain Width and Height Proportions link. Each runs the command its Properties or Transform panel counterpart runs (`artboard.setProps`, `artboard.new`, `artboard.delete`, `tool.options {tool: "artboard"}`), and the reference point is the one the Transform panel uses. In an 800-point window the controls up to the Transform link fit, Move and Scale Artwork with Artboard show as their boxes alone with their names in tooltips, and the link opens the Transform panel with the artboard's position and size. Pointer and key tests in `panels/artboards.rs` cover the controls, W about the reference point, the orientation and the name. Public reference: [Using multiple artboards](https://web.archive.org/web/20210925094818/https://helpx.adobe.com/illustrator/using/using-multiple-artboards.html) (archived copy).