Repository navigation
The ring shows ZBrush's state: lit toggles, current slider values, dimmed slots - #217
Merged
Merged
Conversation
…items in zstate.json, sent again after each pick
…shot, the cache, the marks and the conversation with the plugin, with tests
…tline on lit toggles, a value chip on Set slots, and dimmed slots (phase 3 of #188)
…stop when the app removes its question, and only the first ten answers and odd ones are logged
…h has one pick record, and the cache also gets stop(), a listener-wise question in flight and a capped path walk
…is on screen, redraws an open ring when the answer comes, records each pick handed to a ZBrush and takes back each one it drops, and bridge.show_state (on by default) turns it off
…ring (on by default, off writes bridge.show_state false), that the save summary and the Full-only note name, and a bad value in the file reads as a sentence
…tures of a full ring are kept, and a failing mark is logged once per ring and fan
… ring switches' start position and writes, that the show-state switch sits on the ZBrush bridge card after the bridge key field, and a bridge section that is not an object is dropped by loading first
…d Toggle slot shows, how the state travels and how to turn it off, the two new files and log lines, what to check when slots are dimmed or show no state, and a picture of the marks
…n file goes only when the setting is off or the app quits
…rush; the subtools fan is next
…ow_state off takes the question away when the config loads, a pick is taken back only when the app removed its request, the plugin retries publishing listener.json, and a ring over a ZBrush that cannot answer leaves the other one's question alone
… is still to try by hand
…d DynaMesh included
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #188.
The ring shows ZBrush's state in ZBrush 2026 and newer: a Toggle slot has a dot, filled with the slot outlined while the switch is on and hollow while it is off; a Set slot shows its slider's current value and lights when that is its own value; a slot ZBrush would ignore right now is dimmed but can still be picked. Fans show the marks too.
How it works, per the design on #188:
bridge/zorbit_bridge.py(phase 1): the listener answersWM_APP_STATEwith a snapshot of the asked paths inzstate.jsonand postsWM_APP_STATE_READYback, only to aZOrbitControlwindow. It answers again after each pick.listener.jsongets"state": 1, so an old plugin is never asked. The Status box has a State channel line.zorbit/zstate.py(phase 2): the query, the snapshot parser, the cache (per ZBrush pid and session, dropped by a pick until the plugin has seen it),paths_for,marks_for,format_valueand theChannel(one question in flight, lost after 2 s).zorbit/ring.py(phase 3):marks=andrefresh_marks(). Marked copies of slot pictures; the shared sprite and slot caches and their keys are untouched.marks=Nonedraws exactly as before.zorbit/radiald.pyandconfig.py(phase 4): the app asks afterring.show(), never waits, and redraws an open ring when the answer comes.bridge.show_state(on by default) turns it off.bridge.md,menus.md,appearance.mdwith a newstate.png,studio.mdwith a retakensettings-bridge.png,files.md,troubleshooting.md, the README feature list,CHANGELOG.md.Checked in ZBrush 2026.2.1
Measured on 17 Nov 2026; the numbers are on #188.
--open; the marks were in about 19 ms after the ring showed, early in the 120 ms fade of the smooth animation. 24 paths: 14 ms median; 128 paths (the cap): 33 ms, with the plugin at its 20 ms limit.Not checked by hand: two ZBrush instances (two of the same version cannot run at once), and ZBrush 2022 left unchanged (covered by tests: nothing is asked without
"state": 1).Found on the way:
Edit:UndoandEdit:Redoalways read as disabled through ZBrush's Python API, and pressingEdit:Undothrough it does nothing, so an Undo slot would always be dimmed. No starter menu has one.pytest: 3194 passed.Merge by hand: this touches the ring, the daemon and the bridge.