Events (EventTarget)
Events
Code
import NiiVue from '@niivue/niivue'
const clearBtn = document.getElementById('clearBtn')const dragMode = document.getElementById('dragMode')const drawCheck = document.getElementById('drawCheck')const gl1 = document.getElementById('gl1')const sliceType = document.getElementById('sliceType')const webgpuCheck = document.getElementById('webgpuCheck')
const MAX_LOG_ENTRIES = 200
const CATEGORY = { locationChange: 'interaction', frameChange: 'interaction', dragRelease: 'interaction', pointerUp: 'interaction', measurementCompleted: 'interaction', angleCompleted: 'interaction', volumeLoaded: 'loading', meshLoaded: 'loading', volumeRemoved: 'loading', meshRemoved: 'loading', documentLoaded: 'loading', viewAttached: 'lifecycle', viewDestroyed: 'lifecycle', canvasResize: 'lifecycle', azimuthElevationChange: 'control', clipPlaneChange: 'control', sliceTypeChange: 'control', volumeUpdated: 'control', meshUpdated: 'control', penValueChanged: 'drawing', drawingChanged: 'drawing', drawingEnabled: 'drawing', change: 'change',}
const EVENT_NAMES = Object.keys(CATEGORY)
const activeFilters = new Set([ 'interaction', 'loading', 'lifecycle', 'control', 'drawing',])
const log = document.getElementById('event-log')let entryCount = 0
function formatDetail(name, detail) { if (detail === undefined || detail === null) return '' switch (name) { case 'locationChange': return detail.string || '' case 'frameChange': return `frame ${detail.frame}` case 'pointerUp': return `(${detail.x}, ${detail.y}) btn=${detail.button}` case 'dragRelease': return `${detail.mmLength.toFixed(1)}mm` case 'measurementCompleted': return `${detail.distance.toFixed(1)}mm` case 'angleCompleted': return `${detail.angle.toFixed(1)}\u00B0` case 'volumeLoaded': case 'volumeRemoved': return detail.volume?.name || '' case 'meshLoaded': case 'meshRemoved': return detail.mesh?.name || '' case 'viewAttached': return detail.backend case 'canvasResize': return `${detail.width}\u00D7${detail.height}` case 'azimuthElevationChange': return `az=${detail.azimuth} el=${detail.elevation}` case 'clipPlaneChange': return detail.clipPlane.map((v) => v.toFixed(1)).join(', ') case 'sliceTypeChange': return `type=${detail.sliceType}` case 'volumeUpdated': { const parts = Object.entries(detail.changes).map( ([k, v]) => `${k}=${typeof v === 'number' ? v.toFixed(2) : v}`, ) return `[${detail.volumeIndex}] ${parts.join(', ')}` } case 'meshUpdated': { const mparts = Object.entries(detail.changes).map( ([k, v]) => `${k}=${typeof v === 'number' ? v.toFixed(2) : v}`, ) return `[${detail.meshIndex}] ${mparts.join(', ')}` } case 'drawingChanged': return detail.action case 'drawingEnabled': return detail.isEnabled ? 'on' : 'off' case 'penValueChanged': return `pen=${detail.penValue}` case 'change': return `${detail.property} = ${JSON.stringify(detail.value)}` default: return JSON.stringify(detail) }}
function logEvent(name, detail) { const cat = CATEGORY[name] if (!activeFilters.has(cat)) return
const el = document.createElement('div') el.className = `log-entry cat-${cat}` el.dataset.cat = cat
const now = new Date() const ts = `${String(now.getMinutes()).padStart(2, '0')}:${String(now.getSeconds()).padStart(2, '0')}.${String(now.getMilliseconds()).padStart(3, '0')}`
const detailStr = formatDetail(name, detail) el.innerHTML = `<span class="log-badge">${name}</span>` + `<span class="log-detail">${detailStr}</span>` + `<span class="log-time">${ts}</span>`
log.prepend(el) entryCount++ if (entryCount > MAX_LOG_ENTRIES) { log.lastElementChild?.remove() entryCount-- }}
// Filter checkboxesfor (const cb of document.querySelectorAll( '#filter-bar input[type=checkbox]',)) { cb.addEventListener('change', function () { const cat = this.dataset.cat if (this.checked) { activeFilters.add(cat) } else { activeFilters.delete(cat) } for (const entry of log.querySelectorAll('.log-entry')) { entry.style.display = activeFilters.has(entry.dataset.cat) ? '' : 'none' } })}
clearBtn.onclick = () => { log.innerHTML = '' entryCount = 0}
sliceType.onchange = () => { nv1.sliceType = parseInt(sliceType.value, 10)}
dragMode.onchange = () => { nv1.primaryDragMode = parseInt(dragMode.value, 10)}
drawCheck.onclick = function () { if (this.checked) { nv1.createEmptyDrawing() nv1.drawIsEnabled = true nv1.drawPenValue = 1 } else { nv1.drawIsEnabled = false nv1.closeDrawing() }}
webgpuCheck.onclick = function () { nv1.reinitializeView({ backend: this.checked ? 'webgpu' : 'webgl2' })}
function handleLocationChange(data) { document.getElementById('location').innerHTML = ` ${data.string}`}
// WebKit (Safari, and every iOS browser) runs WebGPU about 4x slower with// anti-aliasing on (#381), so it is off there and on elsewhere (as slides.js).const isWebKit = /AppleWebKit/.test(navigator.userAgent) && !/Chrome|Chromium|Edg\//.test(navigator.userAgent) // iOS Edge (EdgiOS) is WebKit// Optional `?backend=webgl2` (or webgpu) picks the initial backend; the// WebGPU checkbox mirrors it and can still switch at runtime.const initialBackend = new URLSearchParams(window.location.search).get('backend') === 'webgl2' ? 'webgl2' : 'webgpu'webgpuCheck.checked = initialBackend === 'webgpu'
const nv1 = new NiiVue({ backgroundColor: [0.2, 0.2, 0.2, 1], isColorbarVisible: true, backend: initialBackend, isAntiAlias: !isWebKit,})
// Debounce canvasResize to avoid feedback loopslet resizeTimer = 0function debouncedResizeLog(detail) { clearTimeout(resizeTimer) resizeTimer = window.setTimeout(() => logEvent('canvasResize', detail), 300)}
// Register listeners for every eventfor (const name of EVENT_NAMES) { nv1.addEventListener(name, (e) => { const detail = e instanceof CustomEvent ? e.detail : undefined if (name === 'locationChange') handleLocationChange(detail) if (name === 'canvasResize') { debouncedResizeLog(detail) return } logEvent(name, detail) })}
await nv1.attachToCanvas(gl1)sliceType.onchange()await nv1.loadVolumes({ url: '/volumes/mni152.nii.gz' })