lithop 0.3.0 → 0.4.0

data/docs/config.md

@@ -33,8 +33,11 @@
   "brightness": 0.0,
   "contrast": 0.0,
   "saturation": 0.0,
-  "minimum_thickness": 1.0,
-  "maximum_thickness": 2.14689422,
+  "suppress_pale_colors": false,
+  "yellow_mix_color": "cyan",
+  "yellow_mix_percent": 0.0,
+  "minimum_thickness": 0.74,
+  "maximum_thickness": 1.94,
   "pixel_size": 0.5,
   "color_pixel_size": null,
   "grid_columns": null,
@@ -46,16 +49,16 @@
   "separate_z_parts": false,
   "color_region_parts": 3,
   "first_layer_height": 0.1,
-  "layer_height": 0.1,
-  "base_white_layers": 2,
-  "top_layer_height": 0.04,
-  "top_white_start": 1.0,
-  "minimum_top_white_layers": 0,
-  "exact_maximum_thickness": true,
+  "layer_height": 0.08,
+  "base_white_layers": 1,
+  "top_layer_height": 0.08,
+  "top_white_start": null,
+  "minimum_top_white_layers": 1,
+  "exact_maximum_thickness": false,
   "nozzle_diameter": 0.2,
   "color_model": "cmy",
   "color_layer_count": 7,
-  "pigment_order": ["cyan", "magenta", "yellow"],
+  "pigment_order": ["yellow", "magenta", "cyan"],
   "bambu_project": true
 }
 ```
@@ -96,8 +99,11 @@ lithop image.png --config presets/fine.json
 | `brightness` | `--brightness PERCENT` | `0.0` | sRGB明るさ補正。`-100`〜`100` |
 | `contrast` | `--contrast PERCENT` | `0.0` | sRGBコントラスト補正。`-100`〜`100` |
 | `saturation` | `--saturation PERCENT` | `0.0` | sRGB彩度補正。`-100`〜`100` |
-| `minimum_thickness` | `--min-thickness MM` | `1.0` | 要求最小厚さmm |
-| `maximum_thickness` | `--max-thickness MM` | `2.14689422` | 要求最大厚さmm |
+| `suppress_pale_colors` | `--suppress-pale-colors` / `--no-suppress-pale-colors` | `false` | ごく薄い色をWhiteへ落とす |
+| `yellow_mix_color` | `--yellow-mix-color COLOR` | `cyan` | Yellowへ混ぜる`cyan`または`magenta` |
+| `yellow_mix_percent` | `--yellow-mix-percent PERCENT` | `0.0` | Yellow被覆量から選択色へ置き換える割合。`0`〜`100` |
+| `minimum_thickness` | `--min-thickness MM` | `0.74` | 要求最小厚さmm。上部White 1層を含む |
+| `maximum_thickness` | `--max-thickness MM` | `1.94` | 要求最大厚さmm。ローカルUIでは0.01 mm刻み |
 | `pixel_size` | `--pixel-size MM` | `0.22` | XYセル寸法mm |
 | `color_pixel_size` | `--color-pixel-size MM` | `null` | `pixel_size`以上のCMYW色セル寸法。`null`は同じ寸法 |
 | `grid_columns` | なし | `637` | fit格子の列数。寸法または`pixel_size`指定時は未指定扱い |
@@ -106,19 +112,19 @@ lithop image.png --config presets/fine.json
 | `tile_layout` | `--tile-layout MODE` | `auto` | `auto`、`columns`、`rows`、`grid` |
 | `tile_rows` | `--tile-rows COUNT` | `null` | `grid`配置の行数 |
 | `tile_columns` | `--tile-columns COUNT` | `null` | `grid`配置の列数 |
-| `separate_z_parts` | `--separate-z-parts` | `false` | 下地White、CMYW色領域、上部WhiteをZ方向の別プレートにする |
-| `color_region_parts` | `--color-region-parts COUNT` | `3` | Z分離時のCMYW色領域の分割数 |
-| `first_layer_height` | `--first-layer-height MM` | `0.1` | 下地Whiteの層高mm |
-| `layer_height` | `--layer-height MM` | `0.1` | CMYW色領域の積層ピッチmm |
-| `base_white_layers` | なし | `2` | 色領域より下のWhite層数 |
-| `top_layer_height` | なし | `0.04` | 上部Whiteのスライス層高 |
-| `top_white_start` | なし | `1.0` | 上部Whiteの開始Z |
-| `minimum_top_white_layers` | なし | `0` | 上部Whiteに必要な最小層数 |
-| `exact_maximum_thickness` | なし | `true` | 最大厚みを正確に残すか |
+| `separate_z_parts` | `--separate-z-parts` | `false` | CMYWモデルを連続Zプレートへ分割し、強度に応じたBase Whiteを追加する |
+| `color_region_parts` | `--color-region-parts COUNT` | `3` | Zプレート数。3分割時のZプレート3はWhite合計4層、最小0.34 mm |
+| `first_layer_height` | `--first-layer-height MM` | `0.1` | 下地White第1層の層高mm |
+| `layer_height` | `--layer-height MM` | `0.08` | CMYW色領域の積層ピッチmm |
+| `base_white_layers` | なし | `1` | 色領域より下のWhite層数 |
+| `top_layer_height` | なし | `0.08` | 上部Whiteのスライス層高 |
+| `top_white_start` | なし | `null` | 上部Whiteの開始Z。`null`は色領域直後 |
+| `minimum_top_white_layers` | なし | `1` | 上部Whiteに必要な最小層数 |
+| `exact_maximum_thickness` | なし | `false` | 最大厚みを正確に残すか。既定は印刷境界へ切り下げる |
 | `nozzle_diameter` | `--nozzle-diameter MM` | `0.2` | `0.2`または`0.4` |
 | `color_model` | `--color-model MODEL` | `cmy` | 現在はCMYのみ |
-| `color_layer_count` | `--color-layer-count COUNT` | `7` | 色領域の4層、5層、7層 |
-| `pigment_order` | `--pigment-order LIST` | `["cyan", "magenta", "yellow"]` | バックライト側からのCMY順序 |
+| `color_layer_count` | `--color-layer-count COUNT` | `7` | 色領域の4層、5層、7層、8層。Z分割時は8層へ固定する |
+| `pigment_order` | `--pigment-order LIST` | `["yellow", "magenta", "cyan"]` | バックライト側からの順序。6通りのCMY順列 |
 | `bambu_project` | なし | `true` | 単一プレートのBambuプロジェクト情報を追加するか |
 | `maximum_input_pixels` | なし | `20000000` | ラスター入力、またはSVGの描画面の総画素数上限 |
 | `maximum_triangles` | なし | `5000000` | 推定STLと実際のCMYW 3MFの三角形数上限 |
@@ -127,7 +133,7 @@ lithop image.png --config presets/fine.json
 
 ## 標準構造
 
-`standard`は、外周なしの構造を使います。幅140 mm、高さ104 mm、637 × 473の均等fit格子、White下地2層、0.1 mmの色領域7層、連続高のWhite上面、Z=1.0 mm以上をスライスする0.04 mm層高、最大Z 2.14689422 mm、0.2 mmノズル、単一`lithophane`プレートを設定します。White上面は、材料表示色とチャート配合では指定された明暗値、それ以外の入力色ではRec.601輝度から求めます。Black、写真フレーム、導光板は出力しません。
+`standard`は、外周なしの構造を使います。幅140 mm、高さ104 mm、637 × 473の均等fit格子、White下地1層0.10 mm、0.08 mmの色領域7層、色領域直後から0.08 mmでスライスする連続高のWhite上面、最大Z 1.94 mm、0.2 mmノズル、単一`lithophane`プレートを設定します。最薄部の上部Whiteを1層に抑えた実効厚さは0.74–1.94 mmです。White上面は、材料表示色とチャート配合では指定された明暗値、それ以外の入力色ではRec.601輝度から求めます。Black、写真フレーム、導光板は出力しません。
 
 ```sh
 lithop path/to/image.jpeg
@@ -143,6 +149,10 @@ SVGでは、通常の厚さ格子と`color_pixel_size`を指定した色格子
 
 `brightness`、`contrast`、`saturation`はJPEG、PNG、SVGをsRGBへ正規化した後、格子へサンプリングする前にこの順で適用します。単位は百分率で、`0`は無補正です。明るさはRGB値へ加算し、コントラストは50%グレーを中心に、彩度はRec.601輝度を中心に調整します。`-100`はそれぞれ黒方向、コントラストなし、無彩色となり、`100`は既定量の2倍です。範囲外の値はクリップされます。同じ補正済み画像をWhite厚さとCMYW色選択で共有します。
 
+`suppress_pale_colors`は既定で`false`です。`true`または`--suppress-pale-colors`を指定すると、平均CMY濃度が4%以下のごく薄い色差を、色相によらずWhiteとして扱います。無効でも、7層の量子化でWhiteの方が近い色はWhiteレシピになります。特定画像の淡色調整には`brightness`、`contrast`、`saturation`を使用します。
+
+`yellow_mix_percent`はYellowの光透過を材料と光源に合わせて補正する任意設定で、既定の`0`では変更しません。`yellow_mix_color`で`cyan`または`magenta`を選び、各セルのYellow被覆量のうち指定割合をその色へ置き換えてから最寄りのCMYWレシピを選びます。たとえばCyan 20%ではY100の目標がC20/Y80になります。色領域が7層なら実際の配分は1層単位（約14.3%刻み）へ量子化されるため、20%はCyan 1層、Yellow 6層になります。White厚さは変更しません。
+
 `color_pixel_size`を指定すると、White厚さは`pixel_size`の格子で保ったまま、各色セル内の厚さセルが同じCMYWレシピを使います。色セルはモデル原点から独立して区切り、端には部分セルを残します。未指定時は従来どおり厚さと色が同じ格子です。
 
 タイル配置の選択、座標、Z分割のプレート構成、併用時の成果物は[3MFタイル分割とZ分割](tiling.md)を参照してください。
@@ -173,7 +183,9 @@ lithop images/page.png --project-dir output/book
 - `grid_columns`と`grid_rows`が同時に指定されていない、または正の整数ではない
 - `tile_count`が1以上の整数ではない、配置名が不明、`grid`の行数 × 列数が総数と一致しない
 - 行数または列数がXYセル数を超え、幅または高さが0セルになるタイルがある
-- `separate_z_parts`が真偽値ではない、または`color_region_parts`が1〜`color_layer_count`の整数ではない
+- `separate_z_parts`が真偽値ではない、または`color_region_parts`が1〜3の整数ではない
+- `suppress_pale_colors`が真偽値ではない
+- `yellow_mix_color`が`cyan`または`magenta`ではない、または`yellow_mix_percent`が0〜100の有限値ではない
 - Z分離時に上部Whiteの最小厚さが0になる
 - `color_pixel_size`が`null`でも`pixel_size`以上の正の有限値でもない
 - `image_fit`が`cover`または`contain`ではない
@@ -182,7 +194,7 @@ lithop images/page.png --project-dir output/book
 - 要求最小厚さが要求最大厚さを超える
 - ノズル径が0.2または0.4ではない
 - 色モデルが`cmy`ではない
-- 色領域が4層、5層、7層のいずれでもない
+- 色領域が4層、5層、7層、8層のいずれでもない
 - 顔料順にCyan、Magenta、Yellowが各1回含まれない
 - 余白が負、非数、または左右・上下の合計が画像領域を残さない
 - 要求厚さ内に印刷可能なレイヤー境界がない
@@ -195,21 +207,21 @@ lithop images/page.png --project-dir output/book
 要求厚さは、第1層と通常レイヤーで構成できるZ境界へ丸めます。実効最小厚さは要求値以上の最初の境界、実効最大厚さは要求値以下の最後の境界です。
 
 ```text
-requested: 1.0–2.14689422 mm
-effective: 1.0–2.14689422 mm
+requested: 0.74–1.94 mm
+effective: 0.74–1.94 mm
 ```
 
-標準構造では、0.0〜0.2 mmをWhite下地、0.2〜0.9 mmを7層の色領域、0.9〜1.0 mmをWhite、1.0 mm以上を0.04 mm刻みのWhiteとして扱います。最後の上面だけは2.14689422 mmで閉じます。
+非分割の標準構造では、0.0〜0.1 mmをWhite下地、0.1〜0.66 mmを7層の色領域、0.66 mm以上を0.08 mm刻みのTop Whiteとして扱います。Z分割では色領域を8層へ固定し、0.1〜0.74 mmを色領域、0.74 mm以上をTop Whiteとして扱います。既定の最大厚み1.94 mmは印刷可能な境界と一致します。
 
 ## 積層構造の比較
 
-`color_layer_count`と`pigment_order`は、標準の7層・Cyan、Magenta、Yellow順と、比較用の4層・5層や別順序を再現する設定です。Whiteは顔料列の後ろに固定されます。
+`color_layer_count`と`pigment_order`は、非分割の標準7層・YMC順と、比較用の4層・5層・8層や別順序を再現する設定です。`pigment_order`はCMY、CYM、MCY、MYC、YCM、YMCから選べます。Z分割時の`color_layer_count`は8層へ固定されます。Whiteは顔料列の後ろに固定されます。
 
 ## 校正片に使う設定
 
 `lithop calibrate`は、厚さ、ノズル、レイヤー高さ、色モデル、色領域の層数、顔料順、三角形数上限を設定から読みます。固定レイアウトで入力画像を使わないため、`width`、`height`、`margin_*`、画像配置、明るさ・コントラスト・彩度、`pixel_size`、`color_pixel_size`、`maximum_input_pixels`は使いません。
 
-現在の校正片は7層・`cyan,magenta,yellow`順と、White厚みを8段階取れる範囲を要求します。通常生成で使う`--calibration-profile`は入力設定キーではなくCLIオプションです。詳しくは[色校正](calibration.md)を参照してください。
+現在の校正片は7層と選択した`pigment_order`、White厚みを8段階取れる範囲を要求します。通常生成で使う`--calibration-profile`は入力設定キーではなくCLIオプションです。詳しくは[色校正](calibration.md)を参照してください。
 
 ## 出力される settings.json
 

data/docs/getting-started.md

@@ -10,20 +10,20 @@ Lithopは、画像からカラーLithophane（リトファン）の3MFとWhite
 - JPEG、PNG、SVG（librsvg）、ICCプロファイルを扱えるlibvips
 - 印刷する場合はBambu Studio、AMS対応プリンタ、必要なCMYWフィラメント
 
-標準構造は0.2 mmノズル、White下地2層、CMYW色領域7層、連続高のWhite上面を使います。Lithopはスライスや印刷開始を行いません。
+標準構造は0.2 mmノズル、White下地1層0.10 mm、0.08 mmのCMYW色領域7層、0.08 mmの連続高White上面を使います。Lithopはスライスや印刷開始を行いません。
 
 ## インストール
 
-0.3.0を使う場合は、libvips、Rust、バージョンを指定したLithopをインストールします。
+0.4.0を使う場合は、libvips、Rust、バージョンを指定したLithopをインストールします。
 
 ```sh
 brew install vips rust
-gem install lithop -v 0.3.0
+gem install lithop -v 0.4.0
 lithop --version
 lithop doctor
 ```
 
-`lithop --version`が`0.3.0`を表示することを確認します。
+`lithop --version`が`0.4.0`を表示することを確認します。
 `lithop doctor`では`backend`が`rust`、`extension_version`がLithopと同じバージョンであることを確認します。
 
 ソースチェックアウトから実行する場合は、代わりに次を実行します。
@@ -65,6 +65,12 @@ bundle exec lithop path/to/image.jpeg
 
 CLIで指定した値は`config/settings.json`より優先されます。ノズル径は生成記録に保存されますが、形状やレイヤー高さを自動変更しないため、Bambu Studioにも同じ条件を設定してください。
 
+Yellowの透過が強い材料・光源では、Yellow被覆量の一部をCyanまたはMagentaへ置き換えられます。初期値は0%で無効です。まずカラーチャートで少量から比較してください。
+
+```sh
+bundle exec lithop examples/cmy-color-chart.svg --yellow-mix-color cyan --yellow-mix-percent 20
+```
+
 ## 入力画像の扱い
 
 対応形式はJPEG、PNG、非圧縮SVGです。LithopはEXIF Orientationを適用し、透過部分をWhiteへ合成し、埋め込みICCプロファイルを使ってsRGBへ変換します。SVGは96 DPIを基準に、厚さ格子と色格子を満たす解像度へメモリ内で描画します。PNGの中間ファイルは作りません。SVGファイルの上限は15,000,000バイト（15 MB）です。既定では指定した縦横比へ中央クロップします。構図は`--crop-position-x`、`--crop-position-y`、`--crop-scale`で調整でき、`--image-fit contain`では画像全体をWhite領域内へ収められます。
@@ -75,7 +81,7 @@ SVGは正の`width`・`height`（単位なし、`px`、`mm`、`in`）または`v
 
 上部Whiteの高さは、材料表示色と同梱カラーチャートの配合色では図中の明暗値を使い、それ以外の入力色ではRec.601輝度を使います。このため、カラーチャートではYellowを含む全色列の同じ明暗行が同じWhite高さになります。
 
-入力画像はその場で読み取ります。変更、アップロード、`build/`へのコピー、削除は行いません。
+CLIは入力画像をその場で読み取り、変更、アップロード、削除を行わず、完了済みの`build/<job_id>/`へコピーしません。ローカルUIはプレビューと別プロセスでの変換に必要な間だけ`build/.previews/`と`build/.web/`へ一時保存し、処理後に回収します。詳しくは[ローカルブラウザUI](local-ui.md#一時ファイルとローカル性)を参照してください。
 
 ## 結果を確認する
 
@@ -90,7 +96,7 @@ SVGは正の`width`・`height`（単位なし、`px`、`mm`、`in`）または`v
 
 確認後、`lithop.3mf`をBambu Studioへモデルとして読み込みます。材料部品を個別に移動、整列、拡大縮小、結合しないでください。
 
-タイル分割またはZ分割を使う場合は、[3MFタイル分割とZ分割](tiling.md)に従って各3MF、組み立て位置、Bambu Studioのプレートを確認してください。
+タイル分割またはZ分割を使う場合は、[3MFタイル分割とZ分割](tiling.md)に従って各3MF、組み立て位置、Bambu Studioのプレートを確認してください。Z分割では色領域が8層、各プレートの第1層が0.10 mm、それ以降が0.08 mm積層ピッチとなり、3分割のZプレート3にはCMYを含みません。Zプレート3はBase White 3層とTop White 1層以上で、最薄部をWhite合計4層・0.34 mmにします。
 
 ## 生成物を削除する
 

data/docs/local-ui.md

@@ -26,7 +26,7 @@ lithop ui --port 4667 --project-dir /path/to/project
 
 ## 画面を移動する
 
-左の主メニューで「作成」「ジョブ」「プリセット」を切り替えます。「作成」は画像・変換設定と入力プレビュー、「ジョブ」は履歴・進捗・生成結果、「プリセット」は名前付き設定と下書きの管理を表示します。幅1439px以下では主メニューを左上のメニューボタンから開き、Escまたは背景の選択で閉じます。
+上部の主メニューで「作成」「ジョブ」「プリセット」を切り替えます。「作成」は画像・変換設定と入力プレビュー、「ジョブ」は履歴・進捗・生成結果、「プリセット」は名前付き設定と下書きの管理を表示します。主メニューは画面幅にかかわらず表示され、狭い画面では横方向に収まる簡潔な表示になります。
 
 画面を切り替えても、選択中の画像、編集値、設定区分の開閉、プレビューの倍率・位置、履歴の検索条件と選択状態を保持します。ブラウザの戻る・進むにも対応し、URLの`view`は表示画面、`job`は閲覧ジョブを表します。再読み込み後は画面とジョブを復元しますが、ブラウザの制約により入力画像は再選択が必要です。
 
@@ -38,17 +38,18 @@ JPEG、PNG、SVGを1ファイル選択します。画面では次の設定を変
 
 - 完成幅・高さ、XYセル、任意の色セル
 - `cover`／`contain`、横・縦位置、クロップ倍率
-- 明るさ、コントラスト、彩度、ノズル径
+- 明るさ、コントラスト、彩度、淡色のWhite化
+- 色の積層順、Yellowへ混ぜる色と割合、ノズル径
 - 最小・最大厚み、上下左右のWhite余白
-- XYタイル数と配置、Z方向の別プレート化、色領域の分割数
+- XYタイル数と配置、Z方向の別プレート化、色領域の分割数。Z分割の要約には8層、Base White層数、最小プレート厚を表示する。3分割時のZプレート3はBase White 3層とTop White 1層以上で最小0.34 mm
 
-画像はファイル選択欄へのドラッグ＆ドロップにも対応します。設定は「基本設定」「画像配置」「画像調整」「分割」「詳細設定」に分かれ、幅と高さの交換、縦横比の固定、区分ごとの初期値への復元ができます。画像配置と画像調整はスライダーと数値入力が同期します。grid以外の行列数と、Z分割を使用しない場合の色領域分割数は送信されません。
+画像はファイル選択欄へのドラッグ＆ドロップにも対応します。「変換を開始」と現在の準備状態は画像選択欄の直下にあり、詳細を開くと完成寸法、セル、画像調整、Yellow補正、分割方法を確認できます。設定は「基本設定」「画像配置」「画像調整」「Yellow補正」「分割」「詳細設定」に分かれます。「基本設定」には色の積層順を含み、「Yellow補正」にはYellowへ混ぜる色とYellow混色率をまとめ、初期状態では閉じています。幅と高さの交換、縦横比の固定、区分ごとの初期値への復元も利用できます。画像配置と画像調整はスライダーと数値入力が同期します。grid以外の行列数と、Z分割を使用しない場合の色領域分割数は送信されません。
 
-開始ボタンの手前に、入力名、完成寸法、セル、画像調整、分割方法の要約を表示します。変換後に設定や画像を変更すると変更項目数を示し、「表示中の変換ジョブ」には編集値と異なる設定名を表示します。編集中の入力と履歴から開いたジョブは別に管理されるため、新しい画像を選んでも過去ジョブの「補正後入力」は置き換わりません。
+画像の準備中に開始した場合は最新画像の検証を待って1回だけ送信します。入力エラー時は該当する設定区分を開きます。変換後に設定や画像を変更すると変更項目数を示し、「表示中の変換ジョブ」には編集値と異なる設定名を表示します。編集中の入力と履歴から開いたジョブは別に管理されるため、新しい画像を選んでも過去ジョブの「補正後入力」は置き換わりません。
 
 初期値は選択したプロジェクトの`config/settings.json`と組み込み既定値から読みます。画面で確定した値はCLIと同じ`Settings`で検証され、White高さとCMYWレシピを作る共通の変換エンジンへ渡されます。
 
-「プリセット」画面では、現在の変換設定を名前付きプリセットまたは1件の下書きとして保存できます。プリセットは読込、名前変更、削除ができ、過去ジョブの「この設定を編集へ読み込む」も同じ操作で現在値との差分を確認してから反映します。適用後は「作成」へ戻り、現在選択している画像は置き換えません。保存対象は画面で編集できる変換設定だけで、画像、一時入力ID、ジョブID、成果物パスは含みません。UI再起動後も設定は`config/ui-settings.json`から復元できますが、画像は再選択が必要です。このバージョン付きUI専用ファイルはGit追跡対象外で、`config/settings.json`を上書きしません。保存値は読込時にも共通`Settings`で検証し、未知の項目や非対応形式は理由を表示して適用しません。
+「プリセット」画面では、左の保存設定ペインで名前付きプリセットまたは下書きを選び、右の管理ペインで現在の変換設定を保存・名前変更・削除できます。プリセットは作成への適用ができ、過去ジョブの「作成に適用」も同じ操作で現在値との差分を確認してから反映します。適用後は「作成」を表示し、現在選択している画像は置き換えません。画面移動は上部の主メニューへ統一しています。保存対象は画面で編集できる変換設定だけで、画像、一時入力ID、ジョブID、成果物パスは含みません。UI再起動後も設定は`config/ui-settings.json`から復元できますが、画像は再選択が必要です。このバージョン付きUI専用ファイルはGit追跡対象外で、`config/settings.json`を上書きしません。保存値は読込時にも共通`Settings`で検証し、未知の項目や非対応形式は理由を表示して適用しません。
 
 JPEG／PNGは選択直後に簡易表示し、その後、共通画像処理で確定した入力プレビューへ置き換えます。SVGはサーバー側で既存の安全性検証を通してからPNGへラスター化するため、未検証のSVGをブラウザへ直接読み込みません。確定した入力プレビューにはEXIF回転、ICCからsRGBへの変換、透過部分のWhite合成、完成寸法と余白、`cover`／`contain`、クロップ、明るさ・コントラスト・彩度が反映されます。設定変更は約250 ms単位で反映し、古い処理結果は新しい表示を上書きしません。
 
@@ -56,11 +57,11 @@ JPEG／PNGは選択直後に簡易表示し、その後、共通画像処理で
 
 「大きく表示」では入力を画面内の専用表示で確認できます。「大きく比較」では補正後入力と生成結果を同じ倍率・位置で並べます。専用表示はドラッグに加えて矢印キーで移動し、`+`／`-`で拡大・縮小、`0`で全体表示へ戻せます。Escまたは「閉じる」で元の操作箇所へ戻ります。
 
-15インチ級ノートの基準画角を1440 × 900 CSS pxとします。幅1440px以上では主メニューを左に常設し、「作成」の設定と入力プレビュー、「ジョブ」の履歴と詳細をそれぞれ左右に並べます。幅1439px以下では主メニューを折りたたみ、900pxを超える間は作成・ジョブの左右配置を維持します。幅900px以下では縦配置へ切り替え、ジョブ詳細の「一覧へ戻る」で履歴へ復帰します。物理インチはブラウザから一意に判定できないため、切り替えにはCSSピクセル幅を使います。
+15インチ級ノートの基準画角を1440 × 900 CSS pxとします。幅900pxを超える場合は「作成」の設定と入力プレビュー、「ジョブ」の履歴と詳細をそれぞれ左右に並べます。入力プレビューと履歴の追従位置は、折り返しを含む上部ヘッダーの実際の高さから決めます。幅900px以下では縦配置へ切り替え、ジョブ詳細の「一覧へ戻る」で履歴へ復帰します。物理インチはブラウザから一意に判定できないため、切り替えにはCSSピクセル幅を使います。
 
 ## 変換の進捗と中止
 
-「変換を開始」を押すとページ遷移せず、選択画像、編集値、スクロール位置を保持したまま、PumaのUIプロセスとは別のRubyプロセスで変換します。開始後に設定を編集すると、実行した設定から変わったことを画面に表示します。画面は`build/.jobs/<job_id>.json`を読み、工程、進捗率、完了・失敗・中止を更新します。JavaScriptを利用できない場合は通常のフォーム送信へフォールバックします。
+「変換を開始」を押すとページを再読み込みせずジョブ画面へ切り替え、選択画像、編集値、スクロール位置を保持したまま、PumaのUIプロセスとは別のRubyプロセスで変換します。開始後に設定を編集すると、実行した設定から変わったことを画面に表示します。画面は`build/.jobs/<job_id>.json`を読み、工程、進捗率、完了・失敗・中止を更新します。JavaScriptを利用できない場合は通常のフォーム送信へフォールバックします。
 
 変換ジョブには最終更新時刻と実行中の経過時間を表示します。一時的に状態を取得できない場合は、変換失敗と区別して通信エラーを示し、自動再接続と「状態を再取得」を利用できます。再取得では変換開始や停止要求を重複送信しません。失敗・停止後も編集内容を保持し、画像の再選択、設定の確認、対象ジョブのローカルログ表示へ移動できます。
 
@@ -68,6 +69,8 @@ JPEG／PNGは選択直後に簡易表示し、その後、共通画像処理で
 
 成果物ディレクトリを原子的に公開する直前が停止と完了の境界です。公開前の停止は`cancelled`となり未完成データを回収します。公開後に停止要求が届いた場合は成果物を保持して`completed`とします。子プロセスが異常終了した場合も、UIが終了を確認して状態と一時データを再照合します。
 
+### 一時ファイルとローカル性
+
 選択後の画像はランダムIDの`build/.previews/`へ一時保存し、画像交換、画面離脱、変換開始時に回収します。異常終了で残ったものは24時間経過後のUI起動時に回収します。変換開始後は`build/.web/`へコピーし、子プロセスの終了後に回収します。完了済みの`build/<job_id>/`には入力画像をコピーしません。
 
 ## 成果物を確認する
@@ -111,4 +114,4 @@ npx playwright install chromium webkit
 npm run test:browser
 ```
 
-ChromiumとWebKitで、画像選択、プレビュー準備中を含むジョブ作成、設定保持、タイル境界、Z分割項目、成果物切り替え、Bambu Studioへ渡す3MFの選択、拡大専用表示、同期した比較、全体図からのタイル選択、通信切断からの復帰、設定再利用、2ジョブ比較、履歴検索、ZIP取得、複数削除、停止、主メニュー、画面間の状態保持、戻る・進む、共通ヘッダーの停止、ジョブ詳細のキーボード操作を確認します。試験では起動処理を差し替え、Bambu Studioを実際には起動しません。失敗時のスクリーンショット、動画、トレースは`tmp/playwright-results/`へ保存します。受入ブラウザは実機Chromeとし、WebKitはブラウザエンジン間の回帰検証に使用します。
+ChromiumとWebKitで、画像選択直下の開始操作、プレビュー準備中を含むジョブ作成、設定保持、設定区分メニュー、プリセットの2ペイン操作、タイル境界、Z分割項目、成果物切り替え、Bambu Studioへ渡す3MFの選択、拡大専用表示、同期した比較、全体図からのタイル選択、通信切断からの復帰、設定再利用、2ジョブ比較、履歴検索、ZIP取得、複数削除、停止、主メニュー、画面間の状態保持、戻る・進む、共通ヘッダーの停止、ジョブ詳細のキーボード操作を確認します。1440 × 900、1024 × 768、600 × 800、390 × 844と200%表示相当のCSS表示領域では、横方向のはみ出しとペイン配置も検査します。試験では起動処理を差し替え、Bambu Studioを実際には起動しません。失敗時のスクリーンショット、動画、トレースは`tmp/playwright-results/`へ保存します。受入ブラウザは実機Chromeとし、WebKitはブラウザエンジン間の回帰検証に使用します。

data/docs/tiling.md

@@ -1,6 +1,6 @@
 # 3MFタイル分割とZ分割
 
-Lithopは、1枚では印刷できない大きさのリトファンを、指定枚数のCMYW 3MFへXY方向に分割できます。分割後も、完成時の幅・高さ、White厚み、CMYWレシピ、画像の向きは変わりません。必要なら各タイルを、CMYW色領域と上部Whiteの4プレートにZ方向へ分けられます。
+Lithopは、1枚では印刷できない大きさのリトファンを、指定枚数のCMYW 3MFへXY方向に分割できます。XY分割後も、完成時の幅・高さ、White厚み、CMYWレシピ、画像の向きは変わりません。必要なら各タイルを連続プレートへZ方向に分けられます。分割プレートには強度を確保するBase Whiteをそれぞれ追加し、第1層を0.10 mm、以降を0.08 mm積層ピッチに統一します。3分割時のZプレート3はBase White 3層とTop White 1層のWhite合計4層となり、最小厚みは0.34 mmです。
 
 このページでは、タイルの数と配置、出力座標、Bambu Studioで確認する対象を定義します。材料、積層構造、Z境界は[CMYWの色モデルと積層構造](color-model.md)、入力値の全一覧は[生成オプションと設定ファイル](config.md)を参照してください。
 
@@ -10,10 +10,10 @@ Lithopは、1枚では印刷できない大きさのリトファンを、指定
 | --- | --- | --- |
 | 通常の1枚出力 | 既定値 | `lithop.3mf`を1つ。Bambu Studioでは1プレート |
 | XY方向の分割 | `tile_count: 2`以上 | `tiles/tile_rNN_cNN.3mf`を指定枚数。各ファイルは1プレート |
-| Z方向の分割 | `separate_z_parts: true` | 各3MFに、3つの`Color region`と`Top White`の4プレート |
-| XYとZの併用 | 両方を指定 | タイルごとに4プレートを持つ3MF |
+| Z方向の分割 | `separate_z_parts: true` | 各3MFの完成モデルを連続Z範囲へ分割。標準設定では3プレート |
+| XYとZの併用 | 両方を指定 | タイルごとに同じZプレート構成を持つ3MF |
 
-`cmyk_white.stl`、`preview.png`、`transmission.png`、`thickness.png`、材料マスクは、常に分割前の完成全体を表します。XY分割時だけカラー3MFは`tiles/`へ出力され、ルートに`lithop.3mf`は作りません。各3MFに対応する`tiles/tile_rNN_cNN-preview.png`も生成し、ローカルUIの変換ジョブでは全タイルを同時に確認できます。
+`cmyk_white.stl`、`preview.png`、`transmission.png`、`thickness.png`、材料マスクは、常に分割前の完成全体を表します。Z分割したカラー3MFでは元モデルのBase White 1層を除外し、各プレート専用のBase Whiteへ置き換えます。3分割時はZプレート1・2が1層、Zプレート3が3層です。XY分割時だけカラー3MFは`tiles/`へ出力され、ルートに`lithop.3mf`は作りません。各3MFに対応する`tiles/tile_rNN_cNN-preview.png`も生成し、ローカルUIの変換ジョブでは全タイルを同時に確認できます。
 
 ## XY方向のタイル分割
 
@@ -74,7 +74,7 @@ JSON設定ファイルでは次のように指定します。
 
 複数のタイルを1つの完成物として配置する場合は、各3MFの材料部品を動かさず、対応する`offset_mm`を使ってタイル全体を配置します。`tile-layout.svg`と`manifest.json`は、その配置を復元するための正本です。
 
-## Z方向の4プレート分割
+## Z方向のプレート分割
 
 `--separate-z-parts`を指定すると、各3MFのZ方向を複数のBambu Studioプレートへ分けます。
 
@@ -82,24 +82,23 @@ JSON設定ファイルでは次のように指定します。
 lithop image.svg --separate-z-parts
 ```
 
-標準の7層CMYW色領域と既定の`--color-region-parts 3`では、Bambu Studioで次の4プレートを開きます。
+`--color-region-parts`はZプレート数を1〜3で指定します。Z分割では色領域を8層・0.64 mmへ変更します。3を指定した場合は元モデルのBase White 1層を除外し、0.32 mmの均等な元Z範囲を各プレートへ割り当てます。CMYとTop Whiteの積層ピッチは0.08 mmです。8層のCMY領域はZプレート1・2に収まり、Zプレート2の上端Z=0.74 mmで終了します。Zプレート1・2のBase Whiteは1層・0.10 mmです。Zプレート3はCMYを含まないため、Base Whiteを3層・0.26 mmとし、最薄部をTop White 1層と合わせてWhite合計4層・0.34 mmにします。3枚を組み立てた最薄部は1.18 mm、最大厚みは2.30 mmです。
 
-| プレート | 元のZ範囲 | 内容 |
-| --- | --- | --- |
-| `Color region 1` | 0.2–0.5 mm | 3層のCMYW色領域と0.0–0.2 mmのBase Whiteキャリア |
-| `Color region 2` | 0.5–0.7 mm | 2層のCMYW色領域とBase Whiteキャリア |
-| `Color region 3` | 0.7–0.9 mm | 2層のCMYW色領域とBase Whiteキャリア |
-| `Top White` | 0.9 mm–可変上面 | 色領域より上のWhite |
+| プレート | 元のZ範囲 | 印刷時の厚み | 内容 |
+| --- | --- | ---: | --- |
+| `Z plate 1` | 0.10–0.42 mm | 0.42 mm | Base White第1層0.10 mm + CMYW色領域0.32 mm |
+| `Z plate 2` | 0.42–0.74 mm | 0.42 mm | Base White第1層0.10 mm + CMYW色領域0.32 mm |
+| `Z plate 3` | 0.74–1.06 mm（最大1.94 mm） | 0.34–1.46 mm | Base White 3層0.26 mm + Top White 0.08–1.20 mm（CMYなし） |
 
-各プレートは単独印刷できるよう、出力3MFでは底面が`Z=0`になります。Base Whiteだけのプレートは作りません。Base Whiteキャリアは各`Color region`に含まれ、使用されるCyan、Magenta、Yellowの閉じた部品と同じ領域を支えます。未使用の顔料部品は省略されますが、Extruder番号はCyan=1、Magenta=2、Yellow=3、White=4のままです。
+Base Whiteの元のZ範囲0.0–0.1 mmは、Z分割3MFへそのまま出力しません。Zプレート1・2へ専用のBase White 1層・0.10 mm、Zプレート3へ3層・0.26 mmを追加し、その上へ8層の色領域とTop Whiteを連続するZ範囲として1回だけ配置します。3枚を元の順番で重ねた厚みは`1.18–2.30 mm`です。可変厚みはTop Whiteだけへ加えます。未使用の顔料部品は省略されますが、Extruder番号はCyan=1、Magenta=2、Yellow=3、White=4のままです。
 
-`color_region_parts`は1から色層数まで指定できます。既定の3は7層を3・2・2層に分けます。値を変えると領域数と各領域のZ境界が変わるため、印刷前に生成ジョブの`manifest.json`にある`color_model.z_part_separation.plates`を確認してください。この記録には、元のZ境界、各プレートでの印刷厚み、積層順、部品名が入ります。
+`color_region_parts`は1〜3を指定でき、指定数どおりに出力します。生成ジョブの`manifest.json`には`requested_parts`、`resolved_parts`、`minimum_source_plate_thickness`、`minimum_plate_thickness`、`adjusted_minimum_total_thickness`、Base Whiteの層数と厚み、各プレートの元のZ境界、最大印刷厚み、最小印刷厚み、積層順を記録します。
 
-分離したZ部品を印刷後に組み立てる場合は、`Color region 1`から`Top White`まで、マニフェストの積層順どおりに同じXY位置で重ねます。各プレート内の部品を移動、整列、拡大縮小、結合してはいけません。
+分離したZ部品を印刷後に組み立てる場合は、`Z plate 1`から順に、マニフェストの積層順どおりに同じXY位置で重ねます。各プレート内の部品を移動、整列、拡大縮小、結合してはいけません。
 
 ## XY分割とZ分割を併用する
 
-次の例は、完成全体を横2枚へ分け、各タイルを4プレートにします。
+次の例は、完成全体を横2枚へ分け、各タイルを標準設定の3プレートにします。
 
 ```sh
 lithop image.svg --tile-count 2 --tile-layout columns --separate-z-parts
@@ -112,9 +111,9 @@ build/<job_id>/
 ├── cmyk_white.stl
 ├── tile-layout.svg
 ├── tiles/
-│   ├── tile_r01_c01.3mf  # Color region 1–3、Top Whiteの4プレート
+│   ├── tile_r01_c01.3mf  # Z plate 1–3
 │   ├── tile_r01_c01-preview.png
-│   ├── tile_r01_c02.3mf  # Color region 1–3、Top Whiteの4プレート
+│   ├── tile_r01_c02.3mf  # Z plate 1–3
 │   └── tile_r01_c02-preview.png
 ├── manifest.json
 ├── settings.json
@@ -128,7 +127,7 @@ build/<job_id>/
 1. `preview.png`、`thickness.png`、4枚の材料マスクで、分割前の色・厚みが意図どおりか確認する。
 2. XY分割時は`tile-layout.svg`と`manifest.json`で、枚数、ID、完成全体での位置、タイル寸法を確認する。
 3. 各タイル3MFをBambu Studioで開き、Cyan=1、Magenta=2、Yellow=3、White=4の材料割り当てを確認する。
-4. Z分割時は4プレートと各`Color region`・`Top White`の部品を確認し、`manifest.json`のZ境界と積層順に合わせる。
+4. Z分割時は生成された全`Z plate`を確認し、`manifest.json`の解決後プレート数、最小厚み、Z境界、積層順に合わせる。
 5. すべてのレイヤーを確認してからスライスする。Lithopはスライス、造形可否の判定、印刷開始を行わない。
 
 分割した実機での継ぎ目の位置ずれ、色差、光漏れはまだ評価対象です。小さい入力と少数タイルで、Bambu Studioのレイヤープレビューを確認してから完成寸法へ進めてください。

data/docs/troubleshooting.md

@@ -29,7 +29,7 @@ bundle exec lithop --version
 
 **対処:** macOSでは`brew install rust`を実行し、`rustc --version`と`cargo --version`を確認してからLithopを再インストールします。ソースチェックアウトでは`bundle install`に続けて`bundle exec rake compile`を実行します。`lithop doctor`で`backend: rust`と拡張バージョンを確認できます。Ruby版との比較用に`LITHOP_DISABLE_NATIVE=1`を指定できますが、インストール時の拡張ビルドを省略する設定ではありません。
 
-現在のCI対象はmacOSとRuby 4.0で、実測環境はApple siliconです。他のOS、CPU、Ruby ABI向けのビルド済みgemは配布せず、0.3.0は利用環境でRust拡張をビルドするソースgemとして扱います。
+現在のCI対象はmacOSとRuby 4.0で、実測環境はApple siliconです。他のOS、CPU、Ruby ABI向けのビルド済みgemは配布せず、0.4.0は利用環境でRust拡張をビルドするソースgemとして扱います。
 
 ## 入力画像を読めない
 
@@ -67,9 +67,9 @@ bundle exec lithop --version
 
 **最初の確認:** 色領域の層数、第1層、通常レイヤー、要求最小・最大厚さを確認します。
 
-**原因候補:** 選択した層構造に、下地White、色領域、`top_white_start`までのWhite領域、設定された最小上部White層を収容できません。メッセージ中の最小値は現在の設定から計算されます。標準設定の`minimum_top_white_layers`は`0`です。
+**原因候補:** 選択した層構造に、下地White、色領域、`top_white_start`までのWhite領域、設定された最小上部White層を収容できません。メッセージ中の最小値は現在の設定から計算されます。標準設定の`minimum_top_white_layers`は`1`です。
 
-**対処:** `--min-thickness`または`--max-thickness`を必要最小厚さ以上にします。標準の7層構造では1.0 mmです。
+**対処:** `--min-thickness`または`--max-thickness`を必要最小厚さ以上にします。標準の7層構造では0.74 mmです。
 
 **関連:** [レイヤー境界と実効厚さ](config.md#レイヤー境界と実効厚さ)
 

data/ext/lithop_native/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "lithop_native"
-version = "0.3.0"
+version = "0.4.0"
 edition = "2021"
 publish = false
 license = "MIT"

data/lib/lithop/calibration/target.rb

@@ -7,12 +7,12 @@ module Lithop
       private
 
       def validate_structure!
-        unless @settings.color_layer_count == 7 &&
-               @settings.pigment_order == Palette::PIGMENTS
-          raise ConfigurationError,
-                "calibration target requires seven layers in cyan,magenta,yellow pigment order"
-        end
+        return validate_white_levels! if @settings.color_layer_count == 7
+
+        raise ConfigurationError, "calibration target requires seven color layers"
+      end
 
+      def validate_white_levels!
         levels = @settings.layer_structure.normal_layer_count(@settings.effective_maximum_thickness) -
                  @settings.layer_structure.normal_layer_count(@settings.effective_minimum_thickness) + 1
         return if levels >= Target::WHITE_STAGE_COUNT

data/lib/lithop/cli/image_adjustment_options.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Lithop
+  # Adds sRGB, pale-color, and Yellow transmission adjustments.
+  module CLIImageAdjustmentOptions
+    module_function
+
+    def add(parser, options)
+      parser.on("--brightness PERCENT", Float, "Brightness: -100..100 (default: 0)") do |value|
+        options[:brightness] = value
+      end
+      parser.on("--contrast PERCENT", Float, "Contrast: -100..100 (default: 0)") do |value|
+        options[:contrast] = value
+      end
+      parser.on("--saturation PERCENT", Float, "Saturation: -100..100 (default: 0)") do |value|
+        options[:saturation] = value
+      end
+      parser.on("--suppress-pale-colors", "Convert very pale colors to White") do
+        options[:suppress_pale_colors] = true
+      end
+      parser.on("--no-suppress-pale-colors", "Keep very pale colors as CMY candidates (default)") do
+        options[:suppress_pale_colors] = false
+      end
+      parser.on("--yellow-mix-color COLOR", "Pigment mixed into Yellow: cyan/magenta (default: cyan)") do |value|
+        options[:yellow_mix_color] = value.downcase
+      end
+      parser.on(
+        "--yellow-mix-percent PERCENT", Float,
+        "Yellow coverage replaced by mix pigment: 0..100 (default: 0)"
+      ) { |value| options[:yellow_mix_percent] = value }
+    end
+  end
+end

data/lib/lithop/cli/image_options.rb

@@ -10,7 +10,7 @@ module Lithop
       add_tiles(parser, options)
       add_margins(parser, options)
       add_placement(parser, options)
-      add_adjustments(parser, options)
+      CLIImageAdjustmentOptions.add(parser, options)
       add_thickness(parser, options)
       add_sampling(parser, options)
     end
@@ -39,10 +39,10 @@ module Lithop
       parser.on("--tile-columns COUNT", Integer, "Tile columns for grid layout") do |value|
         options[:tile_columns] = value
       end
-      parser.on("--separate-z-parts", "Put base White, color regions, and top White on separate plates") do
+      parser.on("--separate-z-parts", "Slice the complete model into contiguous Z plates") do
         options[:separate_z_parts] = true
       end
-      parser.on("--color-region-parts COUNT", Integer, "Number of CMYW color-region Z parts (default: 3)") do |value|
+      parser.on("--color-region-parts COUNT", Integer, "Z plate count (1-3); thinnest plate is 0.34 mm") do |value|
         options[:color_region_parts] = value
       end
     end
@@ -72,24 +72,11 @@ module Lithop
     end
     private_class_method :add_placement
 
-    def add_adjustments(parser, options)
-      parser.on("--brightness PERCENT", Float, "Brightness: -100..100 (default: 0)") do |value|
-        options[:brightness] = value
-      end
-      parser.on("--contrast PERCENT", Float, "Contrast: -100..100 (default: 0)") do |value|
-        options[:contrast] = value
-      end
-      parser.on("--saturation PERCENT", Float, "Saturation: -100..100 (default: 0)") do |value|
-        options[:saturation] = value
-      end
-    end
-    private_class_method :add_adjustments
-
     def add_thickness(parser, options)
-      parser.on("--min-thickness MM", Float, "Requested minimum model thickness (default: 1.0)") do |value|
+      parser.on("--min-thickness MM", Float, "Requested minimum model thickness (default: 0.74)") do |value|
         options[:minimum_thickness] = value
       end
-      parser.on("--max-thickness MM", Float, "Requested maximum model thickness (default: 2.14689422)") do |value|
+      parser.on("--max-thickness MM", Float, "Requested maximum model thickness (default: 1.94)") do |value|
         options[:maximum_thickness] = value
       end
     end

data/lib/lithop/cli/options.rb

@@ -36,10 +36,10 @@ module Lithop
     def calibration(options, out)
       OptionParser.new do |parser|
         parser.banner = "Usage: lithop calibrate [options]"
-        parser.on("--min-thickness MM", Float, "Requested minimum thickness (default: 1.0)") do |value|
+        parser.on("--min-thickness MM", Float, "Requested minimum thickness (default: 0.74)") do |value|
           options[:minimum_thickness] = value
         end
-        parser.on("--max-thickness MM", Float, "Requested maximum thickness (default: 2.14689422)") do |value|
+        parser.on("--max-thickness MM", Float, "Requested maximum thickness (default: 1.94)") do |value|
           options[:maximum_thickness] = value
         end
         add_print_settings(parser, options)
@@ -74,10 +74,10 @@ module Lithop
       parser.on("--color-model MODEL", "Color model (default: cmy)") do |value|
         options[:color_model] = value.downcase
       end
-      parser.on("--color-layer-count COUNT", Integer, "CMY/W color layers: 4/5/7 (default: 7)") do |value|
+      parser.on("--color-layer-count COUNT", Integer, "CMY/W color layers: 4/5/7/8 (default: 7; Z split: 8)") do |value|
         options[:color_layer_count] = value
       end
-      parser.on("--pigment-order LIST", "Pigment order, e.g. cyan,magenta,yellow") do |value|
+      parser.on("--pigment-order LIST", "Pigment order, e.g. yellow,magenta,cyan (default: YMC)") do |value|
         options[:pigment_order] = value
       end
     end