Repository navigation
feat: Remote rendering 5.2a - ParaView backend support - #223
Open
LKasianAnsys wants to merge 9 commits into
Open
LKasianAnsys wants to merge 9 commits into
LKasianAnsys wants to merge 9 commits into
Conversation
LKasianAnsys
changed the base branch from
main
to
fix/add-gl-context-lock-for-server-mode
November 16, 2026 19:20
Base automatically changed from
fix/add-gl-context-lock-for-server-mode
to
main
November 17, 2026 14:17
LKasianAnsys
force-pushed
the
feat/5.2a-paraview-backend-support
branch
from
November 17, 2026 14:17
4b1e165 to
e175e4f
Compare
LKasianAnsys
force-pushed
the
feat/5.2a-paraview-backend-support
branch
from
November 17, 2026 16:21
e175e4f to
263cb97
Compare
LKasianAnsys
changed the base branch from
main
to
maint/move-streamed-render-protocols
November 17, 2026 16:26
This branch has not been deployed
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.
Issue
Addresses #34
Summary
Adds initial backend support for a new server-side rendering mode, PARAVIEW, in VISOR. A PARAVIEW Visor session connects to a running pvserver, renders through ParaView proxies, and streams frames to the browser through the same trame-rca path as SERVER mode. ParaView ships its own VTK and Python versions, so PARAVIEW mode runs in ParaView's environment, not Visors (as there would be version clashes).
This PR adds initial support for single-part (non-composite) datasets such as .
vtpand .vtu.VisorVTKParaviewcan be constructed directly inpvpythonwith apvserversession you've already connected, but nothing creates it through the Visor layer yet.Visor(rendering_mode=PARAVIEW)doesn't create it, and neither does /initialize or visor-cli server init. The request model and CLI accept thePARAVIEWmode andpvserveraddress, but nothing reads them yet. PR 5.2b adds multiblock support. PR 5.2c connects PARAVIEW mode through theVisorclass, the HTTP service and the CLI.Changes
1. New PARAVIEW mode and its settings
RenderingMode.PARAVIEW(wire value "paraview")PvServerAddressholds a host and a port..visorsettings gives the default pvesrver host and port, plus thepvpythonandvenvpaths that the API launch will need later.InitPropsand the CLI (--pvserver-host,--pvserver-port) accept a pvserver address for each session. They reject one unless hte mode is PARAVIEW.PvServerConnectionError,ParaviewSessionError,ParaviewNotConfiguredErrorandUnsupportedInModeError2. Rendering through pvserver
ParaviewSession/PvSimpleSessionis the only code that importsparaview. It wraps the fewparaview.simplecalls Visor uses, and it imports ParaView only when constructed, so the rest of Visor still imports in.venv. It setsRemoteRenderThresholdto 0 so every frame renders onpvserver.ParaviewRendererimplementsIRenderer: visibility, opacity, diffuse colour, selection tint, colour by variable (a separate colour map for each part), camera, projection and edges. LikeServerRenderer, it never renders on the calling thread. It only requests frames.ParaviewCaptureis atrame-rcaarea. It renders the ParaView view so thatpvservercomposites the frame before it's captured.3. Scene and app
VisorParaviewScenereads each dataset locally for the scene graph and also opens the same file onpvserver. For each part, it checks that the point counts match, so a mismatch raises an error instead of showing the wrong geometry.ParaviewAppisServerAppreporting PARAVIEW mode.VisorVTKParaviewwires them together with a session that the caller has already connected.4. Docs
getting_started/paraview_mode.rst(marked Beta) covers setting up.pvenv, the matching pydantic versions in.venv, and launchingpvserveron Windows and Linux.Known limitations (planned for later PRs)
.vtm, multiblock) are refused withUnsupportedInModeError.pvpythonchild process comes next.update_variables. They log a warning or raiseUnsupportedInModeError.pvservercan only open files, so in-memory datasets are refused.pvserverruns without --multi-clients, so it accepts one client and exits when that client disconnects.Manual test
.pvenvthat ParaView's environment will use.pvserveron port11111as followspvpythonshell as follows:VisorVTKParaviewinstance with a single-part dataset using the code below.viewer.add_dataset()andviewer.remove_dataset()on the viewer. Note there is only support for non-composite datasets in this PR.Python code for creating a
VisorVTKParaviewinstance