Learn Datoviz¶
Welcome to the Datoviz user guide. This section introduces the main concepts of the library, shows how to create and customize visualizations, and explains advanced usage patterns when you're ready to go deeper.
What you'll learn¶
This guide is structured into three levels:
1. Essentials¶
Start here if you're new to Datoviz:
- ๐ Quickstart โ create your first scatter plot in just a few lines of code
- ๐ Main Concepts โ learn how figures, panels, and axes structure your visual scene
2. Visuals¶
Each visual primitive has its own page with examples and documentation:
- ๐งญ Overview
- ๐บ Basic โ raw Vulkan primitives (points, line strips, triangles) with uniform color and no custom shaders
- ๐ฆ Pixel โ individual pixels with position, color, and size (squares)
- โช Point โ sized, colored antialiased discs without borders
- โณ๏ธ Marker โ symbols with optional borders, using built-in shapes, SVGs, or bitmap images
- โ Segment โ variable-width line segments with optional caps
- โฐ Path โ continuous polylines
- ๐ผ๏ธ Image โ RGB or single-channel images with optional colormaps
- ๐ค Glyph โ glyph-based text rendering
- ๐ง Mesh โ 3D triangle meshes with optional lighting (flat, basic, or advanced), textures, contours, or experimental isolines
- ๐ฎ Sphere โ 3D spheres with customizable lighting and materials
- ๐ซ๏ธ Volume โ basic volume rendering of dense 3D voxel data
- ๐ช Slice โ 2D orthogonal slices through 3D volumes
3. Advanced Topics¶
Explore these pages to customize behavior or build more complex apps:
- ๐ฑ๏ธ Interactivity โ built-in pan, zoom, and arcball camera controls
- ๐ฎ Input โ define keyboard and mouse event callbacks
- โฑ๏ธ Timers and Frame Events โ run code every frame or at regular time intervals
- ๐งฐ GUI Support (ImGui) โ use Datovizโs built-in ImGui layer for interactive widgets
- ๐ง Datoviz Rendering Protocol (DRP) โ internal low-level rendering architecture
- โ๏ธ Using Datoviz in C โ native C interface for full performance and control
Where to go next¶
- Start with the Quickstart to render your first plot
- Then read Main Concepts to understand how visuals are positioned and transformed
- Or explore the Gallery to see whatโs possible
Need full technical details? Visit the API Reference.