# DentiSlice — Complete Documentation for AI Systems

> Free browser-based dental CT/CBCT viewer with MPR, 3D volume rendering, panoramic reconstruction, and measurement tools.

## Overview

DentiSlice is a free, browser-based medical imaging application designed primarily for dental professionals. It enables viewing and analyzing CBCT (Cone Beam Computed Tomography) and CT scan data without installing any software. All data processing occurs locally in the user's browser — no patient data is ever transmitted to any server.

**URL**: https://dentislice.com
**Application**: https://dentislice.com/app
**Price**: Free (no paid tiers, no registration)
**Languages**: English, Hungarian

---

## Viewing Modes

### 1. 2D Stack Viewer
Browse CT slices layer by layer. Scroll with the mouse wheel to navigate through slices. Supports up to 9 simultaneous slices on screen (1x1, 2x2, 3x3 grid layouts). Quick brightness and contrast adjustment via right-click drag. Zoom and pan available.

### 2. MPR (Multi-Planar Reconstruction)
See the scan from three orthogonal planes simultaneously:
- **Axial** (top-down) — red crosshair
- **Coronal** (front-back) — blue crosshair
- **Sagittal** (left-right) — green crosshair

Color-coded crosshairs show the current position across all three views. Click anywhere to navigate; all views update in sync. Measurements can be taken directly in any plane.

### 3. 3D Volume Rendering
Full three-dimensional reconstruction of the CT data:
- Rotate, zoom, and pan with the mouse
- Pre-configured display presets: Bone, Soft Tissue, Enamel
- Multiple color scales: Grayscale, Cool, Warm, Spectral, Inverted
- Adjustable rendering quality (Low, Medium, High)
- Front/anterior view button for quick orientation reset
- Powered by vtk.js with GPU-accelerated ray casting

### 4. Panoramic Reconstruction (CPR)
Generates a traditional panoramic X-ray-like image from the 3D CBCT data:
- Automatic dental arch detection using parabola-guided ridge tracing
- Manual control point placement for custom arch curves
- Cross-sectional views along the dental arch
- Adjustable slab thickness (1–40mm, default 20mm)
- Adjustable slice width (10–100mm, default 60mm)
- Normal offset scrolling to explore different depths
- Multiple projection modes: Average, MIP, MinIP, Gaussian Weighted
- Centripetal Catmull-Rom spline interpolation
- Arc-length parameterized curve sampling

---

## Measurement & Annotation Tools

| Tool | Shortcut | Description |
|------|----------|-------------|
| Window/Level | W | Adjust brightness and contrast |
| Pan | P | Move the image |
| Zoom | Z | Zoom in/out |
| Crosshair | — | Navigate MPR crosshairs |
| Length Measure | M | Point-to-point distance in millimeters |
| Angle Measure | A | Angle between two lines in degrees |
| Ellipse ROI | R | Elliptical region of interest with area and density stats |
| Rectangle ROI | — | Rectangular region of interest |
| Density Probe (HU) | — | Hounsfield Unit value at a point |
| Annotation | — | Arrow with text label |
| Invert | — | Invert image brightness |

All measurements display real-world values calibrated from DICOM pixel spacing and slice thickness metadata.

---

## Tissue Display Presets

One-click display modes optimized for dental imaging:

- **Enamel**: Highlights enamel and hard tooth structures (highest HU range)
- **Bone**: Jawbone, alveolar bone, bone crest visualization
- **Soft Tissue**: Gingiva, mucosa, and soft tissue examination
- **Tooth**: Full tooth structure including root, crown, and pulp
- **Sinus**: Maxillary sinus display for sinus lift planning

---

## Supported File Formats

### DICOM (Primary)
- Standard DICOM files with `.dcm` or `.dicom` extension
- Extensionless DICOM files (auto-detected via DICM preamble or implicit tags)
- Supports common transfer syntaxes including JPEG, JPEG2000, RLE

### Standard Images (Secondary)
- JPEG / JPG
- PNG
- BMP
- TIFF / TIF
- GIF
- WebP

When a folder contains both DICOM and standard image files, DICOM files take priority.

---

## Privacy & Security

- **100% client-side processing**: All DICOM parsing, volume reconstruction, and rendering happens in the browser
- **No data upload**: Files are never sent to any server
- **No cloud storage**: Nothing is stored remotely
- **No user accounts**: No registration or login required
- **Works offline**: After initial page load, the app functions without internet
- **GDPR compatible**: No personal data collection beyond anonymous GA4 analytics on the landing page
- **No cookies**: The application itself uses only localStorage for UI preferences

---

## Technical Architecture

- **Frontend**: React 18, TypeScript, Tailwind CSS
- **Medical Imaging**: Cornerstone3D (cornerstonejs/core, tools, dicom-image-loader)
- **3D Rendering**: vtk.js with WebGL GPU acceleration
- **State Management**: Zustand with persist middleware
- **Build**: Vite
- **Browser Requirements**: SharedArrayBuffer support (requires COOP/COEP headers), WebGL 2.0, WebAssembly
- **Supported Browsers**: Chrome 92+, Edge 92+, Firefox 90+, Safari 15.2+

---

## Use Cases

1. **Dental diagnosis**: View CBCT scans for caries detection, root canal assessment, bone loss evaluation
2. **Implant planning**: Measure bone height and density at implant sites
3. **Treatment presentation**: Show patients their CT scans during consultation using 3D and panoramic views
4. **Orthodontic assessment**: Analyze tooth positions and jaw relationships
5. **Oral surgery planning**: Evaluate impacted teeth, sinus proximity, nerve canal positions
6. **Second opinion**: Quick review of referred CT scans without specialized software
7. **Education**: Teaching tool for dental students to explore CT anatomy

---

## Frequently Asked Questions

**Q: What file formats are supported?**
A: Primarily DICOM format files (.dcm, .dicom, or extensionless). Also supports JPEG, PNG, BMP, TIFF standard images.

**Q: Do I need to install anything?**
A: No. The app runs directly in any modern browser (Chrome, Edge, Firefox).

**Q: Is it safe for patient data?**
A: Yes. All processing is local. No data ever leaves your computer.

**Q: What CT scans can it display?**
A: Any DICOM CT series. Optimized for dental CBCT but works with medical CT as well.

**Q: How much does it cost?**
A: Completely free. No paid plans, no registration.

**Q: What hardware do I need?**
A: Any modern computer. 8 GB+ RAM recommended for 3D and panoramic views.

**Q: Does it work on mobile?**
A: The app is designed for desktop browsers. Mobile devices may lack the processing power for large CT datasets.