Files
perler-lab/perler-lab/src/lib/__tests__/exclusion.test.ts
T

154 lines
5.3 KiB
TypeScript

/**
* exclusion.ts 测试 — 颜色排除与重映射(含 processImage 集成)。
*/
import { describe, it, expect } from 'vitest';
import { excludeAndRemap, restoreExcluded } from '../exclusion.js';
import { MARD_PALETTE, nearestColorFromRgb, type MardColor } from '../mard-palette.js';
import { processImage } from '../image-processor.js';
import type { Lab3, Rgb3 } from '../lab.js';
// 迷你色板:红色与蓝色相距极远
const redEntry: MardColor = {
code: 'R1',
hex: '#E00000',
rgb: [224, 0, 0],
lab: [53.24, 80.09, 67.2],
};
const blueEntry: MardColor = {
code: 'B1',
hex: '#0000E0',
rgb: [0, 0, 224],
lab: [30, 68, -112],
};
const miniPalette: MardColor[] = [redEntry, blueEntry];
const redLab: Lab3 = [53.24, 80.09, 67.2]; // 与 redEntry 完全一致
describe('excludeAndRemap', () => {
it('最近色号未被排除时直接返回', () => {
const result = excludeAndRemap(redLab, miniPalette, new Set(['X9']));
expect(result.code).toBe('R1');
expect(result.lab).toEqual(redEntry.lab);
});
it('最近色号被排除时返回最近的未排除色号', () => {
const result = excludeAndRemap(redLab, miniPalette, new Set(['R1']));
expect(result.code).toBe('B1');
});
it('全部色号被排除时兜底返回最近的色号', () => {
const result = excludeAndRemap(redLab, miniPalette, new Set(['R1', 'B1']));
expect(result.code).toBe('R1');
});
it('空排除集合等价于普通最近邻', () => {
const result = excludeAndRemap(redLab, miniPalette, new Set());
expect(result.code).toBe('R1');
});
});
describe('restoreExcluded', () => {
it('把使用被排除色号的格子恢复为最近的未排除色号,其余格子不动', () => {
const excluded = new Set([MARD_PALETTE[0]!.code, MARD_PALETTE[1]!.code]);
const cells: { code: string; lab: Lab3; rgb?: Rgb3 }[] = [
{
code: MARD_PALETTE[0]!.code,
lab: MARD_PALETTE[0]!.lab,
rgb: MARD_PALETTE[0]!.rgb,
},
{ code: 'X9', lab: [90, 0, 0] }, // 未排除色号 → 不应被改动
];
const restored = restoreExcluded(cells, excluded);
expect(restored).toEqual([0]);
// 被恢复的格子不再使用被排除的色号,且结果与 excludeAndRemap 一致
expect(excluded.has(cells[0]!.code)).toBe(false);
expect(cells[0]!.code).not.toBe(MARD_PALETTE[0]!.code);
expect(cells[0]!.code).toBe(
excludeAndRemap(MARD_PALETTE[0]!.lab, MARD_PALETTE, excluded).code,
);
// 未排除的格子完全不受影响
expect(cells[1]!.code).toBe('X9');
});
it('空排除集合不修改任何格子', () => {
const cells: { code: string; lab: Lab3 }[] = [{ code: 'A1', lab: [90, 0, 0] }];
expect(restoreExcluded(cells, new Set())).toEqual([]);
expect(cells[0]!.code).toBe('A1');
});
});
// ---------------------------------------------------------------------------
// processImage 集成
// ---------------------------------------------------------------------------
function buildTestImageData(
size: number,
paint: (x: number, y: number) => [number, number, number],
): ImageData {
const data = new Uint8ClampedArray(size * size * 4);
for (let y = 0; y < size; y++) {
for (let x = 0; x < size; x++) {
const [r, g, b] = paint(x, y);
const i = (y * size + x) * 4;
data[i] = r;
data[i + 1] = g;
data[i + 2] = b;
data[i + 3] = 255;
}
}
return { data, width: size, height: size } as ImageData;
}
/** 16×16 图像:白底 + 左上角 4×4 纯红块。 */
function redOnWhiteImage(): ImageData {
return buildTestImageData(16, (x, y) => (x < 4 && y < 4 ? [255, 0, 0] : [255, 255, 255]));
}
describe('processImage 集成', () => {
const baseOptions = {
gridSize: 4,
maxColors: 8,
removeBg: false,
bgThreshold: 20,
};
it('excludedCodes 排除目标色号后,色板与格子中不再出现该色号', () => {
const baseline = processImage(redOnWhiteImage(), baseOptions);
const redTarget = nearestColorFromRgb([255, 0, 0]).code;
// 基线确实使用了该色号
expect(baseline.palette.some((e) => e.code === redTarget)).toBe(true);
const result = processImage(redOnWhiteImage(), {
...baseOptions,
excludedCodes: [redTarget],
});
// 排除生效:色板与所有非空格子均无该色号
expect(result.palette.some((e) => e.code === redTarget)).toBe(false);
expect(result.grid.every((c) => c.empty || c.code !== redTarget)).toBe(true);
// 输出色板不增长,珠子总数不变
expect(result.palette.length).toBeLessThanOrEqual(baseline.palette.length);
expect(result.totalBeads).toBe(baseline.totalBeads);
});
it('空排除列表与默认行为完全一致(向后兼容)', () => {
const plain = processImage(redOnWhiteImage(), baseOptions);
const empty = processImage(redOnWhiteImage(), { ...baseOptions, excludedCodes: [] });
expect(empty.palette).toEqual(plain.palette);
expect(empty.grid).toEqual(plain.grid);
});
it('cleanup 参数不破坏管线(合并正常执行且网格大小不变)', () => {
const result = processImage(redOnWhiteImage(), {
...baseOptions,
cleanup: { mergeThreshold: 24, maxMergeDistance: 24 },
});
expect(result.grid).toHaveLength(16);
expect(result.totalBeads).toBe(16);
expect(result.grid.every((c) => !c.empty)).toBe(true);
});
});