nx10 / niivue-vscode

NiiVue VSCode README

WebGL 2.0 medical image viewer
This extension uses NiiVue to display images selected in VSCode.

List of Hotkeys

• Right Mouse: Draw a rectangle to window the intensity range
• Mouse Scroll: Scroll currently hovered image
• ← →: change volume in 4D image
• V: Cycle through viewmodes
• C: Cycle through clip plane orientations in 3D render
• shift: Changes mouse behaviour to 2D dragging and 3D viewplane rotation
• H: Move the cross to R
• L: Move the cross to L
• J: Move the cross to P
• K: Move the cross to A
• ctrl+U: Move the cross to S
• ctrl+D: Move the cross to I

Features

• Open local files by selecting them in the VSCode explorer
• Selecting multiple files -> right click -> NiiVue: Compare
• Open web links to files with the command "NiiVue: Open Image" (Ctr+Shift+P)
• Open local or remote files when hovering over the link in an open editor
• Add overlays
• Works in web-based VSCode

Supported Formats

NiiVue can open several formats popular with brain imaging:

• Voxel-based formats: NIfTI, NRRD, MRtrix MIF, AFNI HEAD/BRIK, MGH/MGZ, ITK MHD, ECAT7.
• Mesh-based formats: GIfTI, ASC, BYU/GEO/G, BrainSuite DFS, ICO/TRI, PLY, BrainNet NV, BrainVoyager SRF, FreeSurfer, MZ3, OFF, Wavefront OBJ, STL, Legacy VTK, X3D.
• Mesh overlay formats: GIfTI, CIfTI-2, MZ3, SMP, STC, FreeSurfer (CURV/ANNOT)
• Tractography formats: TCK, TRK, TRX, VTK, AFNI .niml.tract
• DICOM: DICOM and DICOM Manifests

If niivue-vscode fails to open any of these files, please create an issue.

Developing this extension in VSCode

• Clone this repository and open in VSCode
• Run inside the vscode-niivue folder

    npm install
    npm run watch

• Press F5 (a new VSCode window opens)
• Test the extension in the new window by opening an image file
• Press Ctrl+R for reload after a code change