Skip to content

Commit febd8ba

Browse files
committed
Docs: Complete website overhaul and README updates
- Website (v3.0.4 Quantum Flow): - Redesigned theme (Deep Space Geek), real Logo/Favicon, SEG Meta. - Added Dynamic Version Fetching & Multi-language (7 langs). - Improved Language Dropdown UX. - README (En/Zh): - Added Roadmap (Animation, CMS). - Added Geek Features (Auto-fix, RAW, Color Analysis).
1 parent 8e8c9a5 commit febd8ba

File tree

5 files changed

+1015
-964
lines changed

5 files changed

+1015
-964
lines changed

README.md

Lines changed: 67 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,18 @@
1010
**Built for Speed. Engineered for Geeks.**
1111

1212
<p>
13-
<strong>Direct2D Rendering</strong> •
13+
<strong>Direct2D Native</strong> •
1414
<strong>Modern C++23</strong> •
15-
<strong>SIMD Accelerated</strong> •
15+
<strong>Quantum Stream Architecture</strong> •
1616
<strong>Portable</strong>
1717
</p>
1818

19+
<p align="center">
20+
<a href="README_zh-CN.md">
21+
<img src="https://img.shields.io/badge/Language-%E4%B8%AD%E6%96%87-blue?style=for-the-badge" alt="Chinese README">
22+
</a>
23+
</p>
24+
1925
<p>
2026
<a href="LICENSE">
2127
<img src="https://img.shields.io/badge/license-GPL--3.0-blue.svg?style=flat-square&logo=github" alt="License">
@@ -43,26 +49,61 @@
4349

4450
---
4551

46-
## 🧐 Why QuickView?
52+
## 🚀 Introduction
4753

48-
Most image viewers today are either **bloated** (slow startup, huge size) or **outdated** (GDI rendering, poor high-DPI support).
54+
**QuickView** is currently one of the fastest image viewers available on the Windows platform. We focus purely on delivering the ultimate **viewing experience**—leave the heavy editing to professional tools like Photoshop.
4955

50-
**QuickView is different.** It is a ground-up rewrite using **Direct2D** and **Modern C++**, discarding legacy baggage. We integrate the industry's fastest decoding engines—**Google Wuffs, libjpeg-turbo, dav1d, libjxl**to deliver:
56+
Rewritten from scratch using **Direct2D** and **C++23**, QuickView abandons legacy GDI rendering for a game-grade visual architecture. With a startup speed and rendering performance that rivals or exceeds closed-source commercial software, it is designed to handle everything from tiny icons to massive 8K RAW photos with zero latency.
5157

52-
* **Instant Start:** Opens in milliseconds.
53-
* **60 FPS Rendering:** Silky smooth zooming and panning on 4K/8K monitors.
54-
* **Technical Transparency:** See the *real* data behind your images (Subsampling, Q-Factor).
58+
### 📂 Supported Formats
59+
QuickView supports almost all modern and professional image formats:
60+
61+
* **Classic:** `JPG`, `JPEG`, `PNG`, `BMP`, `GIF`, `TIF`, `TIFF`, `ICO`
62+
* **Web/Modern:** `WEBP`, `AVIF`, `HEIC`, `HEIF`, `SVG`, `SVGZ`, `JXL`
63+
* **Pro/HDR:** `EXR`, `HDR`, `PIC`, `PSD`, `TGA`, `PCX`, `QOI`, `WBMP`, `PAM`, `PBM`, `PGM`, `PPM`, `WDP`, `HDP`
64+
* **RAW (LibRaw):** `ARW`, `CR2`, `CR3`, `DNG`, `NEF`, `ORF`, `RAF`, `RW2`, `SRW`, `X3F`, `MRW`, `MOS`, `KDC`, `DCR`, `SR2`, `PEF`, `ERF`, `3FR`, `MEF`, `NRW`, `RAW`
5565

5666
---
5767

58-
## ✨ Features Showcase
68+
# QuickView v3.0.4 - The Quantum Flow Update
69+
**Release Date**: 2026-01-16
70+
71+
### ⚡ Core Architecture: "Quantum Flow"
72+
- **Unified Scheduling & Decoding (Quantum Flow)**: Introduced a "Fast/Slow Dual-Channel" architecture (`FastLane` + `HeavyLanePool`) that isolates instant interactions from heavy decoding tasks.
73+
- **N+1 Hot-Spare Architecture**: Implemented a "Capped N+1" threading model where standby threads are kept warm for immediate response, maximizing CPU throughput without over-subscription.
74+
- **Deep Cancellation**: Granular "On-Demand" cancellation logic allowed for heavy formats (JXL/RAW/WebP), ensuring stale tasks (e.g., during rapid scrolling) are instantly terminated to save power.
75+
- **Direct D2D Passthrough**: Established a "Zero-Copy" pipeline where decoded `RawImageFrame` buffers are uploaded directly to GPU memory, bypassing GDI/GDI+ entirely.
76+
77+
### 🎨 Visual & Rendering Refactor
78+
- **DirectComposition (Game-Grade Rendering)**: Completely abandoned the legacy SwapChain/GDI model in favor of a `DirectComposition` Visual tree.
79+
- **Visual Ping-Pong**: Implemented a double-buffered Visual architecture for tear-free, artifact-free crossfades.
80+
- **IDCompositionScaleTransform**: Hardware-accelerated high-precision zooming and panning.
81+
- **Native SVG Engine**: Replaced `nanosvg` with **Direct2D Native SVG** rendering.
82+
- **Capabilities**: Supports complex SVG filters, gradients, and CSS transparency.
83+
- **2-Stage Lossless Scaling**: Vector-based re-rasterization during deep zoom for infinite sharpness.
84+
- *(Requirement: Windows 10 Creators Update 1703 or later)*.
85+
86+
### 💾 Memory & Resource Management
87+
- **Arena Dynamic Allocation**: Switched to a **TripleArena** strategy using Polymorphic Memory Resources (PMR). Memory is pre-allocated and recycled (Bucket Strategy) to eliminate heap fragmentation.
88+
- **Smart Directional Prefetch**:
89+
- **Auto-Tuning**: Automatically selects `Eco`, `Balanced`, or `Performance` prefetch strategies based on detected system RAM.
90+
- **Manual Override**: Full user control over cache behavior.
91+
- **Smart Skip**: Prevents "OOM" in Eco mode by intelligently skipping tasks that exceed the cache budget.
92+
93+
### 🧩 Infrastructure & Metadata
94+
- **Metadata Architecture Refactor**: Decoupled "Fast Header Peeking" (for instant layout) from "Async Rich Metadata" parsing (Exif/IPTC/XMP), solving UI blocking issues.
95+
- **Debug HUD**: Added a real-time "Matrix" overlay (`F12`) visualizing the topology of the cache, worker lane status, and frame timings.
96+
97+
---
98+
99+
## ✨ Key Features
59100

60101
### 1. 🏎️ Extreme Performance
61102
> *"Speed is a feature."*
62103
63104
QuickView leverages **Multi-Threaded Decoding** for modern formats like **JXL** and **AVIF**, delivering up to **6x faster** load times on 8-core CPUs compared to standard viewers.
64105
* **Zero-Latency Preview:** Smart extraction for massive RAW (ARW, CR2) and PSD files.
65-
* **Dual-Lane Scheduling:** Background loading never freezes the UI.
106+
* **Debug HUD:** Press `F12` to see real-time performance metrics (Decode time, Render time, Memory usage).
66107

67108
### 2. 🎛️ Visual Control Center
68109
> *No more manual .ini editing.*
@@ -83,12 +124,11 @@ A fully hardware-accelerated **Settings Dashboard**.
83124
</div>
84125

85126
* **Real-time RGB Histogram:** Translucent waveform overlay.
86-
* **Reverse Q-Factor:** Algorithmically estimates original JPEG quality (e.g., `Q~98`).
127+
* **Refactored Metadata Architecture:** Faster and more accurate EXIF/Metadata parsing.
87128
* **HUD Photo Wall:** Press `T` to summon a high-performance gallery overlay capable of virtualizing 10,000+ images.
88-
89-
### 4. 📡 Native Auto-Update
90-
* **Silent OTA:** Updates are detected and downloaded quietly in the background.
91-
* **Zero Interruption:** Installs instantly when you exit the app.
129+
* **Smart Extension Fix:** Automatically detect and repair incorrect file headers (e.g., PNG saved as JPG).
130+
* **Instant RAW Dev:** One-click toggle between "Fast Preview" and "Full Quality" decoding for RAW files.
131+
* **Deep Color Analysis:** Real-time display of **Color Space** (sRGB/P3/Rec.2020), **Color Mode** (YCC/RGB), and **Quality Factor**.
92132

93133
---
94134

@@ -102,12 +142,10 @@ We don't use generic codecs. We use the **State-of-the-Art** libraries for each
102142
| **PNG / QOI** | **Google Wuffs** | **Memory-safe**. Outperforms libpng, handles massive dimensions. |
103143
| **JXL** | **libjxl + threads** | **Parallelized**. Instant decoding for high-res JPEG XL. |
104144
| **AVIF** | **dav1d + threads** | **Assembly-optimized** AV1 decoding. |
105-
| **WebP** | **libwebp** | Google's official library. Supports Lossless & Alpha. |
145+
| **SVG** | **Direct2D Native** | **Hardware Accelerated**. Infinite lossless scaling. |
106146
| **RAW** | **LibRaw** | Optimized for "Instant Preview" extraction. |
107147
| **EXR** | **TinyEXR** | Lightweight, industrial-grade OpenEXR support. |
108-
| **SVG** | **NanoSVG** | Vector rasterization for infinite scaling. |
109148
| **HEIC / TIFF**| **Windows WIC** | Hardware accelerated (Requires system extensions). |
110-
| **Other**| **Windows WIC** | Hardware accelerated (Requires system extensions). |
111149

112150
---
113151

@@ -124,34 +162,33 @@ Master these to navigate at the speed of thought:
124162
| | `0` / `F` | Fit to Screen |
125163
| | `Enter` | Fullscreen |
126164
| **Info** | `I` | **Toggle Info/Histogram** |
127-
| | `Tab` | Lite OSD Info |
165+
| | `D` | **Toggle Debug HUD** |
128166
| **Control** | `Ctrl + P` | **Settings Panel** |
129167
| | `Ctrl + T` | Toggle "Always on Top" |
130168
| **Edit** | `R` | Rotate |
131169
| | `Del` | Delete File |
132170

133171
---
134172

135-
## 🗺️ Roadmap
136-
173+
🗺️ Roadmap
137174
We are constantly evolving. Here is what's currently in development:
138175

139-
* [ ] **Animation Support**: Full playback for GIF/WebP/APNG.
140-
* [ ] **Frame Inspector**: Pause and analyze animations frame-by-frame.
141-
* [ ] **Color Management (CMS)**: ICC Profile support.
142-
* [ ] **Dual-View Compare**: Side-by-side image comparison.
143-
* [ ] **Smart Background**: Auto-dimming / Acrylic effect.
176+
- **Animation Support:** Full playback for GIF/WebP/APNG.
177+
- **Frame Inspector:** Pause and analyze animations frame-by-frame.
178+
- **Color Management (CMS):** ICC Profile support.
179+
- **Dual-View Compare:** Side-by-side image comparison.
180+
- **Smart Background:** Auto-dimming / Acrylic effect.
144181

145182
---
146183

147184
## 📥 Installation
148185

149186
**QuickView is 100% Portable.**
150187

151-
1. Go to [**Releases**](https://github.com/justnullname/QuickView/releases).
152-
2. Download `QuickView.zip`.
153-
3. Unzip anywhere and run `QuickView.exe`.
154-
4. *(Optional)* Use the in-app Settings to register as default viewer.
188+
1. Go to [**Releases**](https://github.com/justnullname/QuickView/releases).
189+
2. Download `QuickView.zip`.
190+
3. Unzip anywhere and run `QuickView.exe`.
191+
4. *(Optional)* Use the in-app Settings to register as default viewer.
155192

156193
---
157194

README_zh-CN.md

Lines changed: 193 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,193 @@
1+
<div align="center">
2+
3+
<img src="ScreenShot/main_ui.png" alt="QuickView Hero" width="100%" style="border-radius: 10px; box-shadow: 0 0 20px rgba(0,0,0,0.5);">
4+
5+
<br><br>
6+
7+
# ⚡ QuickView
8+
9+
### Windows 平台的高性能图像查看器。
10+
**为速度而生。为极客打造。**
11+
12+
<p>
13+
<strong>Direct2D Native</strong> •
14+
<strong>Modern C++23</strong> •
15+
<strong>量子流架构 (Quantum Stream)</strong> •
16+
<strong>绿色便携</strong>
17+
</p>
18+
19+
<p>
20+
<a href="LICENSE">
21+
<img src="https://img.shields.io/badge/license-GPL--3.0-blue.svg?style=flat-square&logo=github" alt="License">
22+
</a>
23+
<a href="#">
24+
<img src="https://img.shields.io/badge/platform-Windows%2010%20%7C%2011%20(x64)-0078D6.svg?style=flat-square&logo=windows" alt="Platform">
25+
</a>
26+
<a href="https://github.com/justnullname/QuickView/releases/latest">
27+
<img src="https://img.shields.io/github/v/release/justnullname/QuickView?style=flat-square&label=latest&color=2ea44f&logo=rocket" alt="Latest Release">
28+
</a>
29+
<a href="#">
30+
<img src="https://img.shields.io/badge/arch-AVX2%20Optimized-critical?style=flat-square&logo=intel" alt="AVX2">
31+
</a>
32+
</p>
33+
34+
<h3>
35+
<a href="https://github.com/justnullname/QuickView/releases/latest">📥 下载最新版</a>
36+
<span> • </span>
37+
<a href="https://github.com/justnullname/QuickView/tree/main/ScreenShot">📸 截图预览</a>
38+
<span> • </span>
39+
<a href="https://github.com/justnullname/QuickView/issues">🐛 报告 Bug</a>
40+
</h3>
41+
42+
</div>
43+
44+
---
45+
46+
## 🚀 简介
47+
48+
**QuickView** 是目前 Windows 平台上最快的图像查看器之一。我们专注于提供极致的 **浏览体验**——把繁重的编辑工作留给 Photoshop 这样的专业工具。
49+
50+
使用 **Direct2D****C++23** 从头重写,QuickView 摒弃了传统的 GDI 渲染,采用了游戏级的视觉架构。它的启动速度和渲染性能足以媲美甚至超越闭源商业软件,旨在以零延迟处理从微小图标到巨型 8K RAW 照片的所有内容。
51+
52+
### 📂 支持格式
53+
QuickView 支持几乎所有现代和专业图像格式:
54+
55+
* **经典格式:** `JPG`, `JPEG`, `PNG`, `BMP`, `GIF`, `TIF`, `TIFF`, `ICO`
56+
* **现代/Web格式:** `WEBP`, `AVIF`, `HEIC`, `HEIF`, `SVG`, `SVGZ`, `JXL`
57+
* **专业/HDR:** `EXR`, `HDR`, `PIC`, `PSD`, `TGA`, `PCX`, `QOI`, `WBMP`, `PAM`, `PBM`, `PGM`, `PPM`, `WDP`, `HDP`
58+
* **RAW (LibRaw):** `ARW`, `CR2`, `CR3`, `DNG`, `NEF`, `ORF`, `RAF`, `RW2`, `SRW`, `X3F`, `MRW`, `MOS`, `KDC`, `DCR`, `SR2`, `PEF`, `ERF`, `3FR`, `MEF`, `NRW`, `RAW`
59+
60+
---
61+
62+
# QuickView v3.0.4 - 量子流更新 (The Quantum Flow Update)
63+
**发布日期**: 2026-01-16
64+
65+
### ⚡ 核心架构:"Quantum Flow"
66+
- **统一调度与解码 (Quantum Flow)**:引入了“快/慢双通道”架构 (`FastLane` + `HeavyLanePool`),将即时交互与繁重的解码任务隔离。
67+
- **N+1 热备架构**:实现了“上限 N+1”线程模型,备用线程保持预热状态以立即响应,在不过度订阅的情况下最大化 CPU 吞吐量。
68+
- **深度取消 (Deep Cancellation)**:为重型格式 (JXL/RAW/WebP) 提供了细粒度的“按需”取消逻辑,确保过时的任务(例如在快速滚动期间)被立即终止以节省功耗。
69+
- **Direct D2D 直通**:建立了“零拷贝”管道,解码后的 `RawImageFrame` 缓冲区直接上传到 GPU 显存,完全绕过 GDI/GDI+。
70+
71+
### 🎨 视觉与渲染重构
72+
- **DirectComposition (游戏级渲染)**:彻底放弃了传统的 SwapChain/GDI 模型,转而使用 `DirectComposition` 视觉树。
73+
- **Visual Ping-Pong**:实现了双缓冲 Visual 架构,实现无撕裂、无伪影的交叉淡入淡出。
74+
- **IDCompositionScaleTransform**:硬件加速的高精度缩放和平移。
75+
- **原生 SVG 引擎**:用 **Direct2D Native SVG** 渲染取代了 `nanosvg`
76+
- **能力**:支持复杂的 SVG 滤镜、渐变和 CSS 透明度。
77+
- **2级无损缩放**:深度缩放期间进行基于矢量的重新光栅化,实现无限清晰度。
78+
- *(要求:Windows 10 Creators Update 1703 或更高版本)*
79+
80+
### 💾 内存与资源管理
81+
- **Arena 动态分配 (智能内存)**:切换到使用多态内存资源 (PMR) 的 **TripleArena** 策略。内存被预先分配并循环使用 (Bucket Strategy),彻底消除堆碎片。
82+
- **智能定向预读 (Smart Prefetch)**
83+
- **自动调优**:根据检测到的系统 RAM 自动选择 `Eco` (节能), `Balanced` (平衡), 或 `Performance` (性能) 预读策略。
84+
- **手动覆盖**:用户可完全控制缓存行为。
85+
- **智能跳过 (Smart Skip)**:在节能模式下,通过智能跳过超过缓存预算的任务来防止 "OOM" (内存溢出) 。
86+
87+
### 🧩 基础设施与元数据
88+
- **元数据架构重构**:将“快速文件头窥视 (Fast Header Peeking)”(用于即时布局)与“异步富元数据 (Async Rich Metadata)”解析 (Exif/IPTC/XMP) 解耦,解决了 UI 阻塞问题。
89+
- **调试 HUD**:添加了实时“矩阵”叠加层 (`F12`),可视化缓存拓扑、工作通道状态和帧时序。
90+
91+
---
92+
93+
## ✨ 核心功能
94+
95+
### 1. 🏎️ 极致性能
96+
> *"速度即功能。"*
97+
98+
QuickView 利用 **多线程解码** 技术处理 **JXL****AVIF** 等现代格式,在 8 核 CPU 上相比标准查看器加载速度提升高达 **6倍**
99+
* **零延迟预览:** 针对巨型 RAW (ARW, CR2) 和 PSD 文件的智能提取技术。
100+
* **调试 HUD:**`F12` 查看实时性能指标(解码时间、渲染时间、内存使用)。
101+
102+
### 2. 🎛️ 可视化控制中心
103+
> *告别手动编辑 .ini 文件。*
104+
105+
<img src="ScreenShot/settings_ui.png" alt="Settings UI" width="100%" style="border-radius: 6px;">
106+
107+
完全硬件加速的 **设置仪表板**
108+
* **精细控制:** 调整鼠标行为(平移 vs 拖拽)、缩放灵敏度和循环规则。
109+
* **视觉个性化:** 实时调整 UI 透明度和背景网格。
110+
* **便携模式:** 一键切换配置存储位置(AppData/系统 还是 程序文件夹/USB)。
111+
112+
### 3. 📊 极客可视化
113+
> *不只是看图;更要洞察数据。*
114+
115+
<div align="center">
116+
<img src="ScreenShot/geek_info.png" alt="Geek Info" width="48%">
117+
<img src="ScreenShot/photo_wall.png" alt="Photo Wall" width="48%">
118+
</div>
119+
120+
* **实时 RGB 直方图:** 半透明波形叠加。
121+
* **重构的元数据架构:** 更快、更准确的 EXIF/元数据解析。
122+
* **HUD 照片墙:**`T` 召唤高性能画廊叠加层,能够以 60fps 虚拟化滚动 10,000+ 张图片。
123+
* **智能后缀修正:** 自动检测并修复错误的扩展名(如将 PNG 误存为 JPG)。
124+
* **一键 RAW 渲染:** 极速切换 RAW 文件的“内嵌预览”与“完整解码”模式。
125+
* **专业色彩分析:** 实时显示 **色彩空间** (sRGB/P3/Rec.2020)、**色彩模式** (YCC/RGB/CMYK) 和 **压缩质量** (Q-Factor)。
126+
127+
---
128+
129+
## ⚙️ 引擎室
130+
131+
我们不使用通用编解码器。我们为每种格式选用 **最先进 (State-of-the-Art)** 的库。
132+
133+
| 格式 | 后端引擎 | 为什么它很棒 (架构) |
134+
| :--- | :--- | :--- |
135+
| **JPEG** | **libjpeg-turbo v3** | **AVX2 SIMD**。解压速度之王。 |
136+
| **PNG / QOI** | **Google Wuffs** | **内存安全**。超越 libpng,轻松处理超大尺寸。 |
137+
| **JXL** | **libjxl + threads** | **并行化**。高分辨率 JPEG XL 即时解码。 |
138+
| **AVIF** | **dav1d + threads** | **汇编优化** 的 AV1 解码。 |
139+
| **SVG** | **Direct2D Native** | **硬件加速**。无限无损缩放。 |
140+
| **RAW** | **LibRaw** | 针对“即时预览”提取进行了优化。 |
141+
| **EXR** | **TinyEXR** | 轻量级、工业级 OpenEXR 支持。 |
142+
| **HEIC / TIFF**| **Windows WIC** | 硬件加速(需要系统扩展)。 |
143+
144+
---
145+
146+
## ⌨️ 快捷键
147+
148+
掌握这些即可随心所欲地浏览:
149+
150+
| 分类 | 按键 | 动作 |
151+
| :--- | :--- | :--- |
152+
| **导航** | `Space` / `PgDn` | 下一张图片 |
153+
| | `Bksp` / `PgUp` | 上一张图片 |
154+
| | `T` | **照片墙 (HUD)** |
155+
| **视图** | `1` / `Z` | **100% 原始尺寸** |
156+
| | `0` / `F` | 适应屏幕 |
157+
| | `Enter` | 全屏 |
158+
| **信息** | `I` | **切换 信息/直方图** |
159+
| | `D` | **切换 调试 HUD** |
160+
| **控制** | `Ctrl + P` | **设置面板** |
161+
| | `Ctrl + T` | 切换 "总在最前" |
162+
| **编辑** | `R` | 旋转 |
163+
| | `Del` | 删除文件 |
164+
165+
---
166+
167+
🗺️ 开发计划 (Roadmap)
168+
我们因为持续进化而卓越。以下是当前正在开发的功能:
169+
170+
- **动画支持 (Animation Support):** GIF/WebP/APNG 完整播放支持。
171+
- **帧查看器 (Frame Inspector):** 暂停并逐帧分析动画。
172+
- **色彩管理 (CMS):** 完整的 ICC 配置文件支持。
173+
- **双图比对 (Dual-View Compare):** 并排比较两张图片。
174+
- **智能背景 (Smart Background):** 自动变暗 / 亚克力模糊效果。
175+
176+
---
177+
178+
## 📥 安装
179+
180+
**QuickView 是 100% 绿色便携的。**
181+
182+
1. 前往 [**Releases**](https://github.com/justnullname/QuickView/releases).
183+
2. 下载 `QuickView.zip`.
184+
3. 解压到任意位置并运行 `QuickView.exe`.
185+
4. *(可选)* 使用应用内设置将其注册为默认查看器。
186+
187+
---
188+
189+
## ⚖️ 致谢
190+
191+
**QuickView** 站在巨人的肩膀上。
192+
基于 **GPL-3.0** 许可。
193+
特别感谢 **David Kleiner** (JPEGView 原作者) 以及 **LibRaw, Google Wuffs, dav1d, 和 libjxl** 的维护者们。

0 commit comments

Comments
 (0)