diff --git a/perler-lab/src/App.tsx b/perler-lab/src/App.tsx index 17bf13d..2b60b9e 100644 --- a/perler-lab/src/App.tsx +++ b/perler-lab/src/App.tsx @@ -12,6 +12,7 @@ import PrivacyPolicyPage from './pages/legal/PrivacyPolicyPage'; import TermsOfServicePage from './pages/legal/TermsOfServicePage'; import AboutPage from './pages/legal/AboutPage'; import ContactPage from './pages/legal/ContactPage'; +import PerfectPixelPage from './pages/PerfectPixelPage'; import Nav from './components/Nav'; import Hero from './components/Hero'; import PassSection, { type Plan } from './components/PassSection'; @@ -576,6 +577,9 @@ export default function App() { if (path === '/announcements' || path.startsWith('/announcements/')) { return ; } + if (path === '/tools/perfect-pixel' || path.startsWith('/tools/perfect-pixel/')) { + return ; + } if (path === '/privacy-policy' || path.startsWith('/privacy-policy/')) { return ; } diff --git a/perler-lab/src/i18n/messages/en.ts b/perler-lab/src/i18n/messages/en.ts index 42a41f8..829dff3 100644 --- a/perler-lab/src/i18n/messages/en.ts +++ b/perler-lab/src/i18n/messages/en.ts @@ -622,4 +622,28 @@ export const en: Messages = { 'announcements.empty': 'No announcements yet', 'announcements.back': '← Back to Home', 'announcements.version': 'v{version}', + + /* ── PerfectPixel pseudo-pixel fix ── */ + 'perfectPixel.pageTitle': 'Perfect Pixel', + 'perfectPixel.pageDesc': 'Upload an AI-generated pseudo-pixel image (with anti-aliased edges) and reconstruct it into clean true pixel art. Compare side-by-side and export.', + 'perfectPixel.upload.aria': 'Upload a pseudo-pixel image', + 'perfectPixel.upload.title': 'Upload an image', + 'perfectPixel.upload.sub': 'Supports JPG, PNG, WEBP · up to 2048px', + 'perfectPixel.reset': 'Reset', + 'perfectPixel.sampling': 'Sampling', + 'perfectPixel.sampling.mode': 'Mode (recommended)', + 'perfectPixel.sampling.average': 'Average', + 'perfectPixel.sampling.center': 'Center', + 'perfectPixel.pitch': 'Grid Pitch', + 'perfectPixel.pitch.auto': 'Auto-detect', + 'perfectPixel.pitch.manual': 'Manual', + 'perfectPixel.pitch.placeholder': 'Pitch in px', + 'perfectPixel.upscale': 'Upscale', + 'perfectPixel.run': 'Fix', + 'perfectPixel.processing': 'Fixing…', + 'perfectPixel.original': 'Original', + 'perfectPixel.result': 'Result', + 'perfectPixel.export': 'Export PNG', + 'perfectPixel.detectedPitch': 'Detected grid pitch: {pitch} px', + 'perfectPixel.back': '← Back to Home', }; diff --git a/perler-lab/src/i18n/messages/zh-CN.ts b/perler-lab/src/i18n/messages/zh-CN.ts index 5022eb9..73b4b9b 100644 --- a/perler-lab/src/i18n/messages/zh-CN.ts +++ b/perler-lab/src/i18n/messages/zh-CN.ts @@ -610,6 +610,30 @@ export const zhCN = { 'announcements.empty': '暂无公告', 'announcements.back': '← 返回首页', 'announcements.version': 'v{version}', + + /* ── PerfectPixel 伪像素修复 ── */ + 'perfectPixel.pageTitle': '伪像素修复', + 'perfectPixel.pageDesc': '上传 AI 生成的伪像素图(有抗锯齿边缘),自动重建为干净的真像素图,支持对比查看与导出。', + 'perfectPixel.upload.aria': '上传一张伪像素图', + 'perfectPixel.upload.title': '上传一张图片', + 'perfectPixel.upload.sub': '支持 JPG、PNG、WEBP · 宽高不超过 2048px', + 'perfectPixel.reset': '重置', + 'perfectPixel.sampling': '采样方法', + 'perfectPixel.sampling.mode': '众数(推荐)', + 'perfectPixel.sampling.average': '平均值', + 'perfectPixel.sampling.center': '中心点', + 'perfectPixel.pitch': '网格间距', + 'perfectPixel.pitch.auto': '自动检测', + 'perfectPixel.pitch.manual': '手动输入', + 'perfectPixel.pitch.placeholder': '输入间距 px', + 'perfectPixel.upscale': '放大倍数', + 'perfectPixel.run': '运行修复', + 'perfectPixel.processing': '修复中…', + 'perfectPixel.original': '原图', + 'perfectPixel.result': '修复结果', + 'perfectPixel.export': '导出 PNG', + 'perfectPixel.detectedPitch': '检测到网格间距:{pitch} px', + 'perfectPixel.back': '← 返回首页', } as const; export type Messages = { [K in keyof typeof zhCN]: string }; diff --git a/perler-lab/src/i18n/messages/zh-TW.ts b/perler-lab/src/i18n/messages/zh-TW.ts index 50897ab..eea2075 100644 --- a/perler-lab/src/i18n/messages/zh-TW.ts +++ b/perler-lab/src/i18n/messages/zh-TW.ts @@ -610,4 +610,28 @@ export const zhTW: Messages = { 'announcements.empty': '暫無公告', 'announcements.back': '← 返回首頁', 'announcements.version': 'v{version}', + + /* ── PerfectPixel 偽像素修復 ── */ + 'perfectPixel.pageTitle': '偽像素修復', + 'perfectPixel.pageDesc': '上傳 AI 生成的偽像素圖(有抗鋸齒邊緣),自動重建為乾淨的真像素圖,支援對比查看與匯出。', + 'perfectPixel.upload.aria': '上傳一張偽像素圖', + 'perfectPixel.upload.title': '上傳一張圖片', + 'perfectPixel.upload.sub': '支援 JPG、PNG、WEBP · 寬高不超過 2048px', + 'perfectPixel.reset': '重置', + 'perfectPixel.sampling': '取樣方法', + 'perfectPixel.sampling.mode': '眾數(推薦)', + 'perfectPixel.sampling.average': '平均值', + 'perfectPixel.sampling.center': '中心點', + 'perfectPixel.pitch': '網格間距', + 'perfectPixel.pitch.auto': '自動偵測', + 'perfectPixel.pitch.manual': '手動輸入', + 'perfectPixel.pitch.placeholder': '輸入間距 px', + 'perfectPixel.upscale': '放大倍數', + 'perfectPixel.run': '執行修復', + 'perfectPixel.processing': '修復中…', + 'perfectPixel.original': '原圖', + 'perfectPixel.result': '修復結果', + 'perfectPixel.export': '匯出 PNG', + 'perfectPixel.detectedPitch': '偵測到網格間距:{pitch} px', + 'perfectPixel.back': '← 返回首頁', }; \ No newline at end of file diff --git a/perler-lab/src/lib/perfect-pixel.ts b/perler-lab/src/lib/perfect-pixel.ts new file mode 100644 index 0000000..2869cc1 --- /dev/null +++ b/perler-lab/src/lib/perfect-pixel.ts @@ -0,0 +1,371 @@ +/** + * perfect-pixel.ts — 伪像素修复算法(纯函数,无 DOM 依赖)。 + * + * 输入「AI 生成的伪像素图」(抗锯齿边缘、像素块大小不一),重建为干净的真像素图。 + * + * 思路对齐 github.com/theamusing/perfectPixel: + * 1. 网格间距检测:像素块的边界处颜色突变、块内相对一致,因此在 + * 边缘能量剖面(逐列/逐行的相邻像素差之和)上呈周期性 —— 用 + * 归一化自相关定位真实周期(fundamental period),比"多点距离求和" + * 更抗棋盘格等同色相邻块场景。 + * 2. 单元格重采样:按 pitch×pitch 网格对格内像素取样(mode/average/center)。 + * 3. 重建:每格 1px 输出;放大导出用最近邻(保持硬边像素感)。 + */ + +export type SamplingMethod = 'mode' | 'average' | 'center'; + +export interface FixOptions { + /** 网格间距(px)。缺省时自动检测。 */ + pitch?: number; + sampling: SamplingMethod; + /** 放大倍数(最近邻),默认 1。 */ + upscale?: number; +} + +/** 优先尝试的候选 pitch(常见拼豆/像素块尺寸)。 */ +const PREFERRED_PITCHES = [8, 10, 16, 20, 32, 50, 52, 78, 104] as const; + +/** 兜底候选:4~64 按 2px 步进扫描,覆盖非标准块尺寸。 */ +const FALLBACK_PITCHES = [ + 4, 6, 12, 14, 18, 22, 24, 26, 28, 30, 34, 36, 38, 40, 42, 44, 46, 48, 54, 56, 58, 60, 62, 64, +] as const; + +/** 判定存在网格的最低打分(0~1)。低于此值认为图片无规则网格。 */ +const GRID_CONFIDENCE_THRESHOLD = 0.18; + +/** 最大 pitch 限制(不超过图像短边的 1/2,且 ≤ 128)。 */ +const MAX_PITCH_LIMIT = 128; + +// ─── 工具 ───────────────────────────────────────────────────────────────── + +/** 把 RGBA 像素转为亮度(加权感知亮度),用于边缘能量剖面。 */ +function luminance(data: Uint8ClampedArray, offset: number): number { + return 0.299 * data[offset]! + 0.587 * data[offset + 1]! + 0.114 * data[offset + 2]!; +} + +/** + * 计算列 / 行边缘能量剖面。 + * colEdge[x] = 第 x 列与第 x+1 列的相邻像素亮度差之和(按行抽样); + * rowEdge[y] 同理(按列抽样)。 + */ +function buildEdgeProfiles(imageData: ImageData): { colEdge: Float64Array; rowEdge: Float64Array } { + const { width, height, data } = imageData; + const colEdge = new Float64Array(Math.max(width - 1, 0)); + const rowEdge = new Float64Array(Math.max(height - 1, 0)); + + // 行/列抽样步长:大图降采样加速,小图全量。 + const rowStep = Math.max(1, Math.floor(height / 256)); + const colStep = Math.max(1, Math.floor(width / 256)); + + for (let y = 0; y < height; y += rowStep) { + const rowBase = y * width; + for (let x = 0; x < width - 1; x++) { + colEdge[x]! += Math.abs(luminance(data, (rowBase + x) * 4) - luminance(data, (rowBase + x + 1) * 4)); + } + } + for (let x = 0; x < width; x += colStep) { + for (let y = 0; y < height - 1; y++) { + rowEdge[y]! += Math.abs(luminance(data, (y * width + x) * 4) - luminance(data, ((y + 1) * width + x) * 4)); + } + } + + return { colEdge, rowEdge }; +} + +/** + * 对一维剖面计算"滞后 lag 的自相关"(均值去除后,用全局方差归一化)。 + * 全局方差归一化确保不同 lag 的分数可比较,且自然偏好真实周期 + * (更多对齐对 = 更大值,整数倍滞后因窗口缩短而对齐减少)。 + * 返回 [0,1];1 表示完美周期。 + */ +function autocorrAtLag(profile: Float64Array, lag: number, totalVar: number): number { + const n = profile.length; + if (n <= lag || totalVar <= 0) return 0; + let sum = 0; + for (let i = 0; i < n; i++) sum += profile[i]!; + const mean = sum / n; + let num = 0; + const window = n - lag; + for (let i = 0; i < window; i++) { + const a = profile[i]! - mean; + const b = profile[i + lag]! - mean; + num += a * b; + } + return Math.max(0, num / totalVar); +} + +/** + * 在候选 pitch 列表中找到最优匹配。 + * 返回 { pitch, score },score ∈ [0,1],1 表示剖面完美的 pitch 周期。 + */ +function scoreCandidatePitches( + colEdge: Float64Array, + rowEdge: Float64Array, + pitches: readonly number[], +): { pitch: number; score: number } { + // 预计算全局方差(统一分母,使不同 lag 的分数可比较)。 + const colVar = profileVariance(colEdge); + const rowVar = profileVariance(rowEdge); + if (colVar <= 0 && rowVar <= 0) return { pitch: 0, score: 0 }; + + let bestPitch = 0; + let bestScore = 0; + + for (const pitch of pitches) { + const colScore = colVar > 0 ? autocorrAtLag(colEdge, pitch, colVar) : 0; + const rowScore = rowVar > 0 ? autocorrAtLag(rowEdge, pitch, rowVar) : 0; + const score = (colScore + rowScore) / 2; + if (score > bestScore) { + bestScore = score; + bestPitch = pitch; + } + } + + return { pitch: bestPitch, score: bestScore }; +} + +function profileVariance(profile: Float64Array): number { + if (profile.length === 0) return 0; + let sum = 0; + for (let i = 0; i < profile.length; i++) sum += profile[i]!; + const mean = sum / profile.length; + let varSum = 0; + for (let i = 0; i < profile.length; i++) { + const d = profile[i]! - mean; + varSum += d * d; + } + return varSum; +} + +// ─── 网格间距检测 ───────────────────────────────────────────────────────── + +/** + * 自动检测伪像素图的网格间距(px)。 + * @returns 检测到的 pitch;找不到规则网格时返回 0。 + */ +export function detectPitch(imageData: ImageData): number { + const { width, height } = imageData; + const shortSide = Math.min(width, height); + if (shortSide < 8) return 0; + + const { colEdge, rowEdge } = buildEdgeProfiles(imageData); + + // 优先常用值,再兜底扫描,最后取最大 pitch 上限过滤。 + const candidates: number[] = []; + for (const p of PREFERRED_PITCHES) { + if (p <= shortSide / 2) candidates.push(p); + } + for (const p of FALLBACK_PITCHES) { + if (p <= shortSide / 2 && !candidates.includes(p)) candidates.push(p); + } + const maxPitch = Math.min(MAX_PITCH_LIMIT, Math.floor(shortSide / 2)); + const finalCandidates = candidates.filter((p) => p <= maxPitch); + if (finalCandidates.length === 0) return 0; + + const { pitch, score } = scoreCandidatePitches(colEdge, rowEdge, finalCandidates); + if (pitch === 0 || score < GRID_CONFIDENCE_THRESHOLD) return 0; + return pitch; +} + +// ─── 单元格重采样 ───────────────────────────────────────────────────────── + +const MODE_QUANT = 8; // mode 取样前的通道量化粒度(降噪)。 + +function quantizeChannel(v: number): number { + const q = ((v + MODE_QUANT / 2) >> 3) << 3; // 就近量化到 MODE_QUANT 的倍数 + return q > 255 ? 255 : q; +} + +/** mode:统计格内出现最多的(量化后)颜色;平手取先出现者。 */ +function sampleMode( + data: Uint8ClampedArray, + imgWidth: number, + imgHeight: number, + cellX: number, + cellY: number, + pitch: number, +): [number, number, number, number] { + const counts = new Map(); + let bestKey = -1; + let bestCount = 0; + + const yEnd = Math.min(cellY + pitch, imgHeight); + const xEnd = Math.min(cellX + pitch, imgWidth); + + for (let y = cellY; y < yEnd; y++) { + for (let x = cellX; x < xEnd; x++) { + const o = (y * imgWidth + x) * 4; + const key = + (quantizeChannel(data[o]!) << 24) | + (quantizeChannel(data[o + 1]!) << 16) | + (quantizeChannel(data[o + 2]!) << 8) | + quantizeChannel(data[o + 3]!); + const c = (counts.get(key) ?? 0) + 1; + counts.set(key, c); + if (c > bestCount) { + bestCount = c; + bestKey = key; + } + } + } + + if (bestKey < 0) { + const o = (cellY * imgWidth + cellX) * 4; + return [data[o]!, data[o + 1]!, data[o + 2]!, data[o + 3]!]; + } + return [ + (bestKey >>> 24) & 0xff, + (bestKey >>> 16) & 0xff, + (bestKey >>> 8) & 0xff, + bestKey & 0xff, + ]; +} + +/** average:格内平均色。 */ +function sampleAverage( + data: Uint8ClampedArray, + imgWidth: number, + imgHeight: number, + cellX: number, + cellY: number, + pitch: number, +): [number, number, number, number] { + let r = 0, g = 0, b = 0, a = 0, n = 0; + const yEnd = Math.min(cellY + pitch, imgHeight); + const xEnd = Math.min(cellX + pitch, imgWidth); + for (let y = cellY; y < yEnd; y++) { + for (let x = cellX; x < xEnd; x++) { + const o = (y * imgWidth + x) * 4; + r += data[o]!; + g += data[o + 1]!; + b += data[o + 2]!; + a += data[o + 3]!; + n++; + } + } + if (n === 0) return [0, 0, 0, 255]; + return [Math.round(r / n), Math.round(g / n), Math.round(b / n), Math.round(a / n)]; +} + +/** center:取格中心像素。 */ +function sampleCenter( + data: Uint8ClampedArray, + imgWidth: number, + _imgHeight: number, + cellX: number, + cellY: number, + pitch: number, +): [number, number, number, number] { + const cx = Math.min(cellX + Math.floor(pitch / 2), imgWidth - 1); + const cy = cellY + Math.floor(pitch / 2); + const o = (cy * imgWidth + cx) * 4; + return [data[o]!, data[o + 1]!, data[o + 2]!, data[o + 3]!]; +} + +// ─── 主流程 ─────────────────────────────────────────────────────────────── + +/** + * 核心修复流程:伪像素 ImageData → 每格 1px 的干净真像素 ImageData。 + * + * @param imageData 输入图(RGBA)。 + * @param options 修复参数(pitch 缺省时自动检测)。 + */ +export function fixPseudoPixel(imageData: ImageData, options: FixOptions): ImageData { + const { width, height, data } = imageData; + if (width <= 0 || height <= 0) { + throw new Error('图片尺寸无效'); + } + + const pitch = options.pitch ?? 0; + if (pitch <= 0) { + throw new Error('网格间距无效,请手动指定或让系统自动检测'); + } + const p = Math.floor(pitch); + if (p <= 0 || p > Math.min(width, height)) { + throw new Error(`网格间距超出范围:${pitch}px`); + } + + const cellW = Math.floor(width / p); + const cellH = Math.floor(height / p); + if (cellW <= 0 || cellH <= 0) { + throw new Error('网格间距过大,无法重建'); + } + + const out = new ImageData(cellW, cellH); + const outData = out.data; + + for (let cy = 0; cy < cellH; cy++) { + for (let cx = 0; cx < cellW; cx++) { + const cellX = cx * p; + const cellY = cy * p; + const [r, g, b, a] = resampleCell(data, width, height, cellX, cellY, p, options.sampling); + const o = (cy * cellW + cx) * 4; + outData[o] = r; + outData[o + 1] = g; + outData[o + 2] = b; + outData[o + 3] = a; + } + } + + return out; +} + +function resampleCell( + data: Uint8ClampedArray, + imgWidth: number, + imgHeight: number, + cellX: number, + cellY: number, + pitch: number, + sampling: SamplingMethod, +): [number, number, number, number] { + switch (sampling) { + case 'mode': + return sampleMode(data, imgWidth, imgHeight, cellX, cellY, pitch); + case 'average': + return sampleAverage(data, imgWidth, imgHeight, cellX, cellY, pitch); + case 'center': + return sampleCenter(data, imgWidth, imgHeight, cellX, cellY, pitch); + } +} + +// ─── 导出辅助 ───────────────────────────────────────────────────────────── + +/** 把 ImageData 拷贝到同尺寸 canvas 上。 */ +export function imageDataToCanvas(data: ImageData): HTMLCanvasElement { + const canvas = document.createElement('canvas'); + canvas.width = data.width; + canvas.height = data.height; + const ctx = canvas.getContext('2d'); + if (!ctx) { + throw new Error('无法创建画布上下文'); + } + ctx.putImageData(data, 0, 0); + return canvas; +} + +/** 最近邻放大(保持像素硬边)。factor 必须为 >=1 的整数。 */ +export function upscaleNearest(data: ImageData, factor: number): ImageData { + if (!Number.isInteger(factor) || factor < 1) { + throw new Error(`放大倍数无效:${factor}`); + } + if (factor === 1) return data; + const out = new ImageData(data.width * factor, data.height * factor); + const src = data.data; + const dst = out.data; + for (let y = 0; y < out.height; y++) { + const sy = Math.floor(y / factor); + const srcRow = sy * data.width; + const dstRow = y * out.width; + for (let x = 0; x < out.width; x++) { + const sx = Math.floor(x / factor); + const si = (srcRow + sx) * 4; + const di = (dstRow + x) * 4; + dst[di] = src[si]!; + dst[di + 1] = src[si + 1]!; + dst[di + 2] = src[si + 2]!; + dst[di + 3] = src[si + 3]!; + } + } + return out; +} \ No newline at end of file diff --git a/perler-lab/src/pages/PerfectPixelPage.tsx b/perler-lab/src/pages/PerfectPixelPage.tsx new file mode 100644 index 0000000..d17632f --- /dev/null +++ b/perler-lab/src/pages/PerfectPixelPage.tsx @@ -0,0 +1,499 @@ +/** + * PerfectPixelPage — 伪像素修复工具 (/tools/perfect-pixel) + * + * 上传 AI 生成的伪像素图 → 算法重建为真像素图 → 前后对比 + 导出。 + * 纯前端 Canvas 实现,零新依赖。 + */ + +import { useCallback, useEffect, useRef, useState } from 'react'; +import './pages.css'; +import { useT } from '../i18n'; +import { + detectPitch, + fixPseudoPixel, + upscaleNearest, + imageDataToCanvas, + type SamplingMethod, +} from '../lib/perfect-pixel'; + +// ─── 常量 ───────────────────────────────────────────────────────────────── + +const MAX_IMAGE_DIMENSION = 2048; +const ALLOWED_TYPES = ['image/jpeg', 'image/png', 'image/webp']; + +const UPSCALE_OPTIONS = [1, 4, 8, 10] as const; + +const SAMPLING_OPTIONS: { value: SamplingMethod; labelKey: string }[] = [ + { value: 'mode', labelKey: 'perfectPixel.sampling.mode' }, + { value: 'average', labelKey: 'perfectPixel.sampling.average' }, + { value: 'center', labelKey: 'perfectPixel.sampling.center' }, +]; + +// ─── 帮助函数 ───────────────────────────────────────────────────────────── + +/** 加载图片到 canvas 并提取 ImageData(限制尺寸 2048px)。 */ +function loadImageData( + file: File, +): Promise<{ imageData: ImageData; width: number; height: number }> { + return new Promise((resolve, reject) => { + if (!ALLOWED_TYPES.includes(file.type)) { + reject(new Error('不支持的文件格式,请上传 JPG/PNG/WebP 图片')); + return; + } + + const img = new Image(); + const url = URL.createObjectURL(file); + + img.onload = () => { + const w = img.naturalWidth; + const h = img.naturalHeight; + if (w > MAX_IMAGE_DIMENSION || h > MAX_IMAGE_DIMENSION) { + URL.revokeObjectURL(url); + reject(new Error('图片过大,宽或高不能超过 2048px')); + return; + } + + const canvas = document.createElement('canvas'); + canvas.width = w; + canvas.height = h; + const ctx = canvas.getContext('2d'); + if (!ctx) { + URL.revokeObjectURL(url); + reject(new Error('无法创建画布上下文')); + return; + } + ctx.drawImage(img, 0, 0); + URL.revokeObjectURL(url); + const imageData = ctx.getImageData(0, 0, w, h); + resolve({ imageData, width: w, height: h }); + }; + + img.onerror = () => { + URL.revokeObjectURL(url); + reject(new Error('图片读取失败,请换一张重试')); + }; + + img.src = url; + }); +} + +/** 下载 canvas 为 PNG。 */ +function downloadCanvas(canvas: HTMLCanvasElement, filename: string): void { + canvas.toBlob((blob) => { + if (!blob) return; + const url = URL.createObjectURL(blob); + const a = document.createElement('a'); + a.href = url; + a.download = filename; + a.click(); + URL.revokeObjectURL(url); + }, 'image/png'); +} + +// ─── 页面组件 ───────────────────────────────────────────────────────────── + +export default function PerfectPixelPage() { + const { t } = useT(); + const fileInputRef = useRef(null); + + // 上传状态 + const [sourceUrl, setSourceUrl] = useState(null); + const [sourceFile, setSourceFile] = useState(null); + const [imageData, setImageData] = useState(null); + const [uploadError, setUploadError] = useState(null); + const [processing, setProcessing] = useState(false); + + // 参数 + const [sampling, setSampling] = useState('mode'); + const [pitchAuto, setPitchAuto] = useState(true); + const [manualPitch, setManualPitch] = useState(''); + const [upscale, setUpscale] = useState(1); + + // 结果 + const [resultImageData, setResultImageData] = useState(null); + const [detectedPitch, setDetectedPitch] = useState(0); + const [resultError, setResultError] = useState(null); + + // 释放旧 URL + useEffect(() => { + return () => { + if (sourceUrl) URL.revokeObjectURL(sourceUrl); + }; + }, [sourceUrl]); + + const handleFiles = useCallback( + (files: FileList | null) => { + const file = files?.[0]; + if (!file) return; + setSourceFile(file); + setUploadError(null); + setResultImageData(null); + setResultError(null); + setDetectedPitch(0); + + // 创建预览 URL + if (sourceUrl) URL.revokeObjectURL(sourceUrl); + const url = URL.createObjectURL(file); + setSourceUrl(url); + + // 加载 ImageData + loadImageData(file) + .then(({ imageData }) => { + setImageData(imageData); + }) + .catch((err: unknown) => { + setUploadError(err instanceof Error ? err.message : '图片加载失败'); + setImageData(null); + if (sourceUrl) URL.revokeObjectURL(sourceUrl); + setSourceUrl(null); + setSourceFile(null); + }); + }, + [sourceUrl], + ); + + const handleDrop = useCallback( + (e: React.DragEvent) => { + e.preventDefault(); + handleFiles(e.dataTransfer.files); + }, + [handleFiles], + ); + + const handleDragOver = useCallback((e: React.DragEvent) => { + e.preventDefault(); + }, []); + + const handleReset = useCallback(() => { + if (sourceUrl) URL.revokeObjectURL(sourceUrl); + setSourceUrl(null); + setSourceFile(null); + setImageData(null); + setUploadError(null); + setResultImageData(null); + setResultError(null); + setDetectedPitch(0); + }, [sourceUrl]); + + /** 运行修复。 */ + const handleRun = useCallback(() => { + if (!imageData) return; + + setProcessing(true); + setResultError(null); + + // 使用 setTimeout 让 UI 保持响应(大图同步处理不可分割,但限制 2048px 内可接受)。 + setTimeout(() => { + try { + // 自动检测 pitch + const autoPitch = detectPitch(imageData); + const pitch = pitchAuto ? autoPitch : Math.floor(Number(manualPitch) || 0); + + if (pitch <= 0) { + if (pitchAuto) { + throw new Error('未能自动检测到网格间距,请手动输入或换一张图重试'); + } else { + throw new Error('请输入有效的网格间距(正整数)'); + } + } + + setDetectedPitch(pitch); + + const result = fixPseudoPixel(imageData, { pitch, sampling }); + + // 应用放大 + const finalResult = upscale > 1 ? upscaleNearest(result, upscale) : result; + setResultImageData(finalResult); + } catch (err: unknown) { + setResultError(err instanceof Error ? err.message : '修复失败'); + setResultImageData(null); + } finally { + setProcessing(false); + } + }, 0); + }, [imageData, pitchAuto, manualPitch, sampling, upscale]); + + /** 导出修复结果。 */ + const handleExport = useCallback(() => { + if (!resultImageData) return; + try { + const canvas = imageDataToCanvas(resultImageData); + const filename = sourceFile + ? sourceFile.name.replace(/\.[^.]+$/, '') + '_perfect-pixel.png' + : 'perfect-pixel.png'; + downloadCanvas(canvas, filename); + } catch { + setResultError('导出失败'); + } + }, [resultImageData, sourceFile]); + + const hasImage = imageData !== null; + + return ( +
+
+ {/* 标题区 */} +
+

{t('perfectPixel.pageTitle')}

+

{t('perfectPixel.pageDesc')}

+
+ + {/* 上传区 */} + {!sourceUrl ? ( +
fileInputRef.current?.click()} + onKeyDown={(e) => { + if (e.key === 'Enter' || e.key === ' ') { + fileInputRef.current?.click(); + } + }} + onDrop={handleDrop} + onDragOver={handleDragOver} + > + + {t('perfectPixel.upload.title')} + {t('perfectPixel.upload.sub')} + {uploadError && {uploadError}} +
+ ) : ( +
+ {sourceUrl && ( + {sourceFile?.name + )} +
+
+ {sourceFile?.name ?? ''} +
+
+ {imageData?.width ?? 0} × {imageData?.height ?? 0} +
+
+ +
+ )} + + { + handleFiles(e.target.files); + e.target.value = ''; + }} + /> + + {/* 参数区 */} + {hasImage && ( +
+ {/* 采样方法 */} +
+ {t('perfectPixel.sampling')} +
+ {SAMPLING_OPTIONS.map((opt) => ( + + ))} +
+
+ + {/* 网格间距 */} +
+ {t('perfectPixel.pitch')} +
+ + +
+ {!pitchAuto && ( + setManualPitch(e.target.value)} + placeholder={t('perfectPixel.pitch.placeholder')} + style={{ width: 120, marginTop: 'var(--space-2)' }} + /> + )} +
+ + {/* 放大倍数 */} +
+ {t('perfectPixel.upscale')} +
+ {UPSCALE_OPTIONS.map((opt) => ( + + ))} +
+
+ + {/* 运行按钮 */} + + + {/* 错误消息 */} + {resultError && ( +

+ {resultError} +

+ )} + + {/* 检测到间距 */} + {detectedPitch > 0 && ( +

+ {t('perfectPixel.detectedPitch', { pitch: String(detectedPitch) })} +

+ )} + + {/* 前后对比 */} + {resultImageData && ( + <> +
+ {/* 原图 */} +
+ + {t('perfectPixel.original')} + + { + if (el && imageData) { + el.width = imageData.width; + el.height = imageData.height; + el.getContext('2d')?.putImageData(imageData, 0, 0); + } + }} + style={{ + maxWidth: '100%', + height: 'auto', + imageRendering: 'pixelated', + borderRadius: 'var(--radius-sm)', + }} + /> +
+ + {/* 修复结果 */} +
+ + {t('perfectPixel.result')} + + { + if (el && resultImageData) { + el.width = resultImageData.width; + el.height = resultImageData.height; + el.getContext('2d')?.putImageData(resultImageData, 0, 0); + } + }} + style={{ + maxWidth: '100%', + height: 'auto', + imageRendering: 'pixelated', + borderRadius: 'var(--radius-sm)', + }} + /> +
+
+ + {/* 导出按钮 */} + + + )} +
+ )} +
+ + +
+ ); +} \ No newline at end of file