Skip to content

Scanner Calibration

rkfsociety edited this page Oct 21, 2026 · 1 revision

Revopoint camera calibration bundle

Русский · English

Русский

Этот набор калибровки конкретного устройства скопирован без изменений из %LOCALAPPDATA%\RevoScan5\cameraparam на подключённом ПК со сканером. Он позволяет продолжать работу с захватом UVC и офлайн-калибровкой маркеров из другого checkout, не разыскивая AppData исходного компьютера и не запуская Revo Scan.

Файлы получены из данных установки Revo Scan для конкретного сканера. Наличие файлов в приватном репозитории не означает, что их разрешено распространять публично. Не включайте набор в публичный выпуск до проверки происхождения и прав на распространение. Если подтвердить права нельзя, перед публикацией замените отслеживаемый набор документированным локальным процессом с калибровкой, предоставленной пользователем.

Q.bin — матрица перепроецирования float32 little-endian размером 64 байта, которую CaptureY16.exe использует для расчёта луча камеры. Сначала значение uint16 преобразуется в кандидатную глубину по depthScale, прочитанному из Revo Scan, затем луч масштабируется так, чтобы глубина по камере Z совпадала с этим значением. Прямое соответствие глубины UVC всё ещё нужно проверить по известному физическому размеру.

В каждом из Pl.bin и Prgb.bin записаны размеры 640×400, за которыми следует матрица float32 3×3. Остальные файлы сохранены как входы текущего исследования камеры и маркеров; их бинарные схемы полностью не установлены. Файлы закоммичены побайтно и не должны редактироваться или подменяться калибровкой другого сканера.

depth_scale.json содержит коэффициент глубины SDK установленной версии Revo Scan 0.005, имеющий предварительный статус для кадров прямого UVC. Храните коэффициент вместе с калибровочным набором этого сканера. Не выводите его из матрицы Q и не меняйте ради улучшения оценок перекрытия.

Локальный экспорт framesmall.mkf, намеренно исключённый из Git, является отдельным предоставленным пользователем референсом маркеров стола. Единицы его координат и полная семантика записей неизвестны; см. tools/revopoint/parse_mkf.py и руководство Revopoint.

Обычный workspace projects/ по-прежнему игнорируется Git и не входит в набор исходников для переноса между ПК. На целевой машине создавайте результаты захвата в новой папке workspace.

English

This device-specific bundle was copied as-is from %LOCALAPPDATA%\RevoScan5\cameraparam on the connected scanner PC. It lets the repository's UVC capture and offline marker-calibration work continue from another checkout without finding that PC's AppData folder or launching Revo Scan.

The files originate from scanner-specific Revo Scan installation data. Their presence in this private repository does not establish permission to redistribute them publicly. Keep the bundle out of a public release until its provenance and redistribution rights are reviewed. If those rights cannot be confirmed, replace the tracked bundle with a documented, user-supplied local calibration workflow before publication.

Q.bin is the 64-byte little-endian float32 reprojection matrix used by CaptureY16.exe to obtain a camera ray. The uint16 sample is first converted to candidate depth with the depthScale read from Revo Scan, then the ray is scaled so camera Z equals that depth. This direct UVC depth mapping still needs validation against a known physical dimension. Pl.bin and Prgb.bin each contain 640×400 dimensions followed by a 3×3 float32 matrix. The remaining files are preserved calibration inputs for ongoing camera/marker research; their binary schemas are not fully established. Files are committed byte-for-byte and should not be edited or replaced with calibration from another scanner.

depth_scale.json records the installed Revo Scan SDK's 0.005 depth scale and its provisional status for direct UVC frames. Keep the value together with this scanner's calibration bundle; do not infer it from the Q matrix or change it to improve overlap scores.

The local framesmall.mkf export, deliberately excluded from Git, is a separate user-provided table-marker reference. Its coordinate units and complete record semantics remain unknown; see tools/revopoint/parse_mkf.py and the Revopoint tools guide.

The normal projects/ workspace remains ignored and is not part of the cross-PC source bundle. Capture outputs should be regenerated into a new workspace folder on the target PC.

Clone this wiki locally