← Visualization

QMap

3D network traffic visualization built on Three.js. Renders actors, data flows, and boundary crossings in an explorable isometric scene.

@qpoint-io/qmap · v0.1.0

Live Demo

Loading 3D scene...

18 actors · 17 connections

QMap Component

import { QMap } from '@qpoint-io/qmap'
PropTypeDefaultDescription
widthString | Number'100%'Container width. Numbers are treated as pixels.
heightString | Number'400px'Container height. Numbers are treated as pixels.
actorsArray[]Actor data array. Changes trigger animated transitions.
connectionsArray[]Connection data array. { id, origin, destination }
groupByObject{}Grouping config. e.g. { level1: "Cloud", level2: "Region" }
backgroundColorString | Number0xffffffScene background color (hex).
frustumSizeNumber30Orthographic camera frustum size.
selectableBooleantrueEnable click-to-select actors.
autoStartBooleantrueStart the animation loop on mount.
faviconProxyString'/api/favicon'URL prefix for vendor favicon proxy.

Events

EventDescription
readyEmitted when the Three.js scene is initialized
actor-selectEmitted when an actor is clicked. Payload: { actorId, actor }
actor-deselectEmitted when selection is cleared
transition-startEmitted when an animated transition begins
transition-endEmitted when an animated transition completes

SSR: Three.js requires browser globals. Always wrap in <ClientOnly> when used in Nuxt/SSR apps.