Migration from DarkOne2021

Migration from DarkOne2021

Scope

This document explains the architectural relationship between the final DarkOne2021 JScript Panel 2.8.8 layout and DarkOneJSP3. For installation steps, use Installation and Upgrading. For exact current titles, use Layout and Panel Map.

Original DarkOne2021 structure

Panel Stack Splitter 01 Panel Stack Splitter 02 Panel Stack Splitter 03 six information JScript panels Panel Stack Splitter 04 Album Art Enhanced Spectrum Analyser JS Playlist Panel Stack Splitter 05 Left Controls Quick Search Toolbar Panel Stack Splitter 06 Display Waveform Minibar Right Controls

DarkOneJSP3 replaces each numbered Panel Stack Splitter with the corresponding numbered JSplitter controller.

Architectural changes

• PSS title-format scripts became ordinary JavaScript controllers.
• Numeric child indexes became stable DOJSP3.* custom-title identifiers.
• PSS global variables became persistent JSplitter/JScript Panel properties.
• $movepanel/$showpanel operations became PanelObject.Move/Show calls.
• GDI resources were migrated to JScript Panel 3 DirectWrite/Direct2D handling.
• ActiveX and WScript dependencies were removed.
• State owned by a panel remains with that panel instead of being duplicated in the root layout script.
• Deliberate compatibility mirrors have one canonical source and are checked by tools\sync_mirrors.py and the release validator.

Preserved behaviour

• Width-scaled root and bottom control strip.
• Three-column main area.
• Six-panel information stack.
• Album artwork/spectrum split.
• Quick Search frame and lower separators.
• Display/waveform split.
• DarkOne control, display, playback and volume behaviour.
• DarkOne2021 playlist, metadata and scrolling refinements.

Important migration rules

• The fourth InfoStack child is DOJSP3.AlbumNotes and loads Album Notes.txt.
• Rebuild migrated layouts against the exact current hierarchy and titles.
• Visible InfoStack labels can be customised independently from custom titles.
• Hotfixes do not update DarkOneJSP3.fcl. Verify any imported file against the current panel map and export a fresh local backup after migration.
• Existing persistent settings are generally retained. Where property names changed, DarkOneJSP3 performs targeted migration when supported.

Reference source

The original PSS source and panel map are retained at:

DarkOneJSP3\reference\Original DarkOne2021 PSS and panel map.txt

---

Back to Home · Repository