Skip to content

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.