How vsoptomech/vkquicklook works
VKQuickLook is a native macOS viewer for Keyence VK4/VK6 measurement files. Its main workflow begins in Finder: the thumbnail provider or Quick Look preview controller requests a render, and the shared renderer returns an image and metadata for display. VK4 rendering selects embedded RGB layers according to thumbnail or preview priorities; VK6 rendering uses the container’s wrapper BMP preview. A command-line renderer invokes the same native implementation for diagnostics. The renderer excerpt is partial, so finer parsing and image-processing links are omitted where not evidenced.
Main entry points: NativeVKRenderer.swift Native renderer · RendererService.swift Renderer service · ThumbnailProvider.swift Thumbnail provider · PreviewViewController.swift Preview controller
Components 13
User entry points
- Thumbnail provider
macos/QuickLook/Sources/ThumbnailExtension/ThumbnailProvider.swift - Preview controller
macos/QuickLook/Sources/PreviewExtension/PreviewViewController.swift - Render CLI
macos/QuickLook/Sources/CLI/VKQuickLookRender.swift
Shared rendering
- Renderer service
macos/QuickLook/Sources/Shared/RendererService.swift - Native renderer
macos/QuickLook/Sources/Shared/NativeVKRenderer.swift - VK4 RGB layers
macos/QuickLook/Sources/Shared/NativeVKRenderer.swift - VK6 BMP preview
macos/QuickLook/Sources/Shared/NativeVKRenderer.swift - PNG and metadata
macos/QuickLook/Sources/Shared/RendererService.swift
macOS host
- App host
macos/QuickLook/Sources/App/VKQuickLookApp.swift
Other components
- Finder
- Quick Look
- CLI user
- VK4/VK6 file
Connections 14
- Finder → Thumbnail provider: requests thumbnail
- Quick Look → Preview controller: requests preview
- Thumbnail provider → Renderer service: requests render
- Preview controller → Renderer service: requests render
- Renderer service → Native renderer: dispatches render
- CLI user → Render CLI: invokes mode
- Render CLI → Native renderer: calls render
- Native renderer → VK4/VK6 file: reads file
- Native renderer → VK4 RGB layers: selects VK4 layers
- Native renderer → VK6 BMP preview: loads VK6 preview
- Native renderer → PNG and metadata: writes image and metadata
- Renderer service → PNG and metadata: returns asset
- Thumbnail provider → PNG and metadata: uses image URL
- Preview controller → PNG and metadata: displays image and summary