termpic 0.2.0 → 0.2.1

package/README.md

@@ -39,6 +39,8 @@ toAnsi(grid); // そのままターミナルに貼れる
 | `quadrant`  | 2x2         | 明暗2色     | 横の解像度がほしいとき         |
 | `braille`   | 2x4         | 点と地の2色 | 最も細かい。輪郭がはっきり出る |
 
+`quadrant` は、4つの小マスの明度差が小さいマスを単色で塗ります。差が無いのに明暗2色に分けると、平坦な面に無意味な模様が出るためです（実写真で測ると閾値 0.03 でちょうど無くなります）。
+
 `braille` は 1 マスに 2x4 の点を持てるので `halfblock` の4倍の解像度になります。点の有無は**画像全体の平均の明度**で決めます。マスごとの中間値で切ると、一様なマスが必ず全点灯になって図地が反転するためです。点の色に加えて点が付かない側の平均も背景色として持たせているので、写真でも図地が反転しません。
 
 ## 画像から色を抽出する
@@ -52,7 +54,7 @@ const palette = extractPalette(bitmap, 16);
 convert(bitmap, { palette });
 ```
 
-中央値分割法です。色空間の直方体を最も幅の広い軸の中央値で切る操作を、箱が指定数になるまで繰り返します。
+中央値分割法です。色空間の直方体を最も幅の広い軸の中央値で切る操作を、箱が指定数になるまで繰り返します。画像の色数が要求より少ない場合は、重複を除いた色数だけを返します。
 
 ## 輪郭を拾う
 

package/dist/index.mjs

@@ -156,10 +156,29 @@ function convert(bitmap, options = {}) {
 		cells
 	};
 }
+/**
+* ほぼ一様なマスとみなす明度の幅。
+*
+* これ未満のマスを明暗に二分しても、前景色と背景色がほぼ同じなので
+* 描き分けの意味がなく、平坦な面に無意味な模様が出るだけになる。
+* 実写真で測ると 0.03 で無意味な分割がちょうど無くなり、
+* それ以上に上げると実際の描き分けまで潰れる。
+*/
+const FLAT_CELL_RANGE = .03;
 /** 明るい側と暗い側に二分し、どの小マスが明るい側かをビットで返す */
 function splitByLightness(colors) {
 	const levels = colors.map((color) => toOklab(color).L);
-	const middle = (Math.min(...levels) + Math.max(...levels)) / 2;
+	const lowest = Math.min(...levels);
+	const highest = Math.max(...levels);
+	if (highest - lowest < FLAT_CELL_RANGE) {
+		const flat = averageHex(colors);
+		return {
+			bits: (1 << colors.length) - 1,
+			light: flat,
+			dark: flat
+		};
+	}
+	const middle = (lowest + highest) / 2;
 	let bits = 0;
 	const lightGroup = [];
 	const darkGroup = [];
@@ -326,7 +345,7 @@ function extractPalette(bitmap, count = 16, sampleLimit = 2e4) {
 			...boxes.slice(target + 1)
 		];
 	}
-	return boxes.filter((box) => box.length > 0).map((box) => {
+	const colors = boxes.filter((box) => box.length > 0).map((box) => {
 		const sum = box.reduce((total2, pixel) => ({
 			r: total2.r + pixel.r,
 			g: total2.g + pixel.g,
@@ -342,6 +361,7 @@ function extractPalette(bitmap, count = 16, sampleLimit = 2e4) {
 			b: Math.round(sum.b / box.length)
 		});
 	});
+	return [...new Set(colors)];
 }
 /** 輪郭の向きに割り当てる文字。添字は 0=横 / 1=右下がり / 2=縦 / 3=右上がり */
 const EDGE_CHARS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termpic",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Convert images into terminal art: ASCII ramps, half-block color cells, and palette quantization.",
   "keywords": [
     "ansi",