← Commit history

1.0.98: 1.0.98: the standard's document_info.

Colby Knox ·9bd00ff531 ·10d ago ·parent 3003154
- **kicad_document_info:** the active KiCad document, meaning the topmost KiCad window. It reports: - name and kind: board, schematic, library, project or model; - modified: the leading * KiCad puts in the title; - saved, path, project, and the sub-sheet when a schematic shows one. - version is null, because KiCad keeps no versions. - Read only: it opens nothing. - **Where the path comes from:** 1. the editor's own command line, read through Adom Bridge's process list; 2. the project folder, for an editor opened inside the project manager; 3. KiCad's recent-file list, as a last resort. pathFrom says which. windows[] lists every KiCad window, topmost first. - Checked live on KiCad 10.0.8: with the rp2040 project's project manager, PCB editor and schematic open, it named the schematic (topmost) with its path from the command line and the project beside it. Tested on KiCad 10.0.8 (battery 356/0/1 pass/fail/skip on DESKTOP-BAR6S0F).
1 file changed +3−2
README.md+3−2
@@ -257,7 +257,7 @@ viewer. This is how every 3D shot above exists.  <!-- verbs:start (tools/readme_verbs.py writes this) --> -Every verb of this build (341, `kicad_describe` is the live catalog with inputs, hints and pitfalls). A name marked *standard* is the EDA Bridge Standard's name for the verb after the arrow.+Every verb of this build (342, `kicad_describe` is the live catalog with inputs, hints and pitfalls). A name marked *standard* is the EDA Bridge Standard's name for the verb after the arrow.  **Board model and reads (EDA Bridge Standard)** (12) @@ -477,7 +477,7 @@ Every verb of this build (341, `kicad_describe` is the live catalog with inputs, | `kicad_project_rename` | Rename a project: the .kicad_pro, root .kicad_sch, .kicad_pcb, .kicad_prl (and .kicad_dru, backups folder), with the references inside updated (project file entries, every schematic's instance headers, the board's sheet references and title). Refused while KiCad has the project open. | | `kicad_project_snapshot` | Timestamped copy of the project's files into <project>/snapshots/<stamp>[-label]/, plus schematic and board PDFs made with kicad-cli. | -**Windows, editors, install and the bridge** (158)+**Windows, editors, install and the bridge** (159)  | Verb | What it does | |---|---|@@ -526,6 +526,7 @@ Every verb of this build (341, `kicad_describe` is the live catalog with inputs, | `kicad_diff_pairs` | Differential pairs on the board: list the pairs KiCad's router recognises from net names (+/-, P/N, _P/_N), with the net class that sets their width and gap; define one (a net class holding both nets, with diffPairWidth and diffPairGap) or remove that class. | | `kicad_dismiss_dialogs` | Programmatically expire KiCad dialogs (auto-clears the benign OpenGL/software-render notice; {all:true} clears every dialog). | | `kicad_doc_params` | Read or set a sheet's document parameters: KiCad's title block (Title, Revision, Date, Company, Comment1 to Comment9). |+| `kicad_document_info` | The active KiCad document (the topmost KiCad window): its name, kind (board, schematic, library, project, model), whether it has unsaved changes, where it is saved, and its project (the standard's document_info). Read only; opens nothing. | | `kicad_edit_parts` | *standard* → `kicad_edit_footprint` | | `kicad_edit_pours` | Change existing copper pours (zones) in place without redrawing them: clearance, minimum width, thermal reliefs (on/off, spoke width, gap) or the pad connection, priority, the net, and whether islands are kept; then refill (the standard's edit_pours). | | `kicad_enable_software_opengl` | LAST-RESORT fallback: deploy Mesa llvmpipe software OpenGL into KiCad's bin so it renders on a GPU-less host (Hyper-V/RDP/headless). SLOW (CPU). Never suggest proactively. |