lithop 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +7 -0
  3. data/Cargo.lock +1 -1
  4. data/README.md +14 -11
  5. data/RELEASING.md +3 -3
  6. data/docs/README.md +4 -3
  7. data/docs/artifacts.md +27 -15
  8. data/docs/bambu-studio.md +12 -10
  9. data/docs/calibration.md +4 -4
  10. data/docs/color-model.md +20 -18
  11. data/docs/command.md +28 -12
  12. data/docs/config.md +42 -30
  13. data/docs/getting-started.md +12 -6
  14. data/docs/local-ui.md +12 -9
  15. data/docs/tiling.md +18 -19
  16. data/docs/troubleshooting.md +3 -3
  17. data/ext/lithop_native/Cargo.toml +1 -1
  18. data/lib/lithop/calibration/target.rb +5 -5
  19. data/lib/lithop/cli/image_adjustment_options.rb +33 -0
  20. data/lib/lithop/cli/image_options.rb +5 -18
  21. data/lib/lithop/cli/options.rb +4 -4
  22. data/lib/lithop/export/color_metadata.rb +46 -23
  23. data/lib/lithop/export/generation.rb +8 -10
  24. data/lib/lithop/export/planning.rb +82 -45
  25. data/lib/lithop/export/print_readme.rb +20 -4
  26. data/lib/lithop/formats/three_mf/bambu_metadata.rb +11 -8
  27. data/lib/lithop/formats/three_mf/model_writer.rb +2 -5
  28. data/lib/lithop/image/pipeline.rb +40 -26
  29. data/lib/lithop/image/svg_loader.rb +11 -2
  30. data/lib/lithop/layer_structure.rb +0 -9
  31. data/lib/lithop/model/filament_profile.rb +3 -3
  32. data/lib/lithop/model/material_display_map.rb +2 -1
  33. data/lib/lithop/model/z_region_model.rb +44 -0
  34. data/lib/lithop/settings.rb +147 -15
  35. data/lib/lithop/settings_file.rb +1 -0
  36. data/lib/lithop/version.rb +1 -1
  37. data/lib/lithop/web/app.rb +9 -5
  38. data/lib/lithop/web/public/app.css +48 -37
  39. data/lib/lithop/web/public/app.js +149 -47
  40. data/lib/lithop/web/settings_form.rb +8 -5
  41. data/lib/lithop/web/views/index.erb +129 -75
  42. data/lib/lithop.rb +2 -1
  43. data/sig/lithop.rbs +16 -0
  44. metadata +3 -2
  45. data/lib/lithop/model/layer_region_model.rb +0 -24
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6d976da7f11815d7bb666e57fc4fa9f3154b535f1482814974804c642c988d11
4
- data.tar.gz: cbb54acb9074271d1813398f98b6e2353eb8fa545ccb8f4ac256c73fdebde0b5
3
+ metadata.gz: 167c581e6f5dbf12a3aff1fe0c0d9ad8bdd3b7da94a88553e4e170f9c6b30566
4
+ data.tar.gz: 516366ae988c3c59be4316d900f3eca7bdbd37099753feb4ee2b78e311d02056
5
5
  SHA512:
6
- metadata.gz: 24c42f6590c20ff0dd02c301569b4935559f160be4f79361f252e10fb027beedd7692a4ed2f1689753bbe23321c1b646a59e4e2d6f4e6c29f9e5b8da1e8ca3f3
7
- data.tar.gz: 2c0e65025d88cb73e3266ed1b2d7325aa0c0ebdc845ac819e31ae40d38b24bab79a5e7557a3c1ab78470690638f04bcbb058cf7a9fc1fbc09b221fc2773799c6
6
+ metadata.gz: f1f60f8b051d8dc885acef8f7d0dd135bcce5bc27c43c977b27b74d6377df4ad8c47f2f2bedbf98d39c50b59451b5b3cd713d69b3d13f910bd5984560853826a
7
+ data.tar.gz: d5fbdd4805690c0935b8196dc6980fa643f803e5bd30b509dfe60d4eebccc92312fbd0a34c19568a4d420b7889d4cc0c42e41af56718822fac503380a3df30d1
data/CHANGELOG.md CHANGED
@@ -1,5 +1,12 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.4.0 - 2026-10-30
4
+
5
+ - Changes Z separation to 1–3 contiguous plates with a 0.10 mm first-layer Base White support on each; three-plate output uses eight 0.08 mm CMYW layers, equal source slices, a CMY-free third plate, and only one 0.08 mm Top White layer at the brightest thickness.
6
+ - Adds print color controls for all six CMY stacking orders with YMC as the default, optional Cyan or Magenta mixing into Yellow, and opt-in pale-color suppression.
7
+ - Moves Create, Jobs, and Presets into a GitHub-style top navigation, places the conversion action beside image selection, organizes settings into responsive panes, and adds bulk selection and deletion for recent jobs.
8
+ - Sets the standard maximum thickness to the printable 1.94 mm boundary with 0.01 mm UI increments and updates generated models, calibration stages, documentation, and artifact contracts accordingly.
9
+
3
10
  ## 0.3.0 - 2026-10-20
4
11
 
5
12
  - Adds a loopback-only Sinatra/ERB/Puma UI with responsive Create, Jobs, and Presets panes, faster immediate JPEG/PNG/SVG input previews, reusable settings, drafts, and engine-rendered result views.
data/Cargo.lock CHANGED
@@ -106,7 +106,7 @@ dependencies = [
106
106
 
107
107
  [[package]]
108
108
  name = "lithop_native"
109
- version = "0.3.0"
109
+ version = "0.4.0"
110
110
  dependencies = [
111
111
  "libc",
112
112
  "magnus",
data/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Create backlit color lithophanes locally.
4
4
 
5
- Lithop is a local CMYW color lithophane generator with a CLI and browser UI. It turns a JPEG, PNG, or validated self-contained SVG image into a single-plate multipart CMYW 3MF and a White reference STL without uploading the source image or copying it into the output job.
5
+ Lithop is a local CMYW color lithophane generator with a CLI and browser UI. By default, it turns a JPEG, PNG, or validated self-contained SVG image into a single-plate multipart CMYW 3MF and a White reference STL; optional XY tiling and Z-separated plates are also available. The source image is processed without uploading it or copying it into the completed output job.
6
6
 
7
7
  ![CMYW lithophane color-chart preview generated by Lithop](docs/images/cmyw-lithophane-preview.png)
8
8
 
@@ -17,12 +17,12 @@ The standard profile uses:
17
17
  | Model size | 140 × 104 mm |
18
18
  | Thickness grid | 637 × 473 cells, approximately 0.22 mm per cell |
19
19
  | Nozzle | 0.2 mm |
20
- | White base | Two 0.1 mm layers |
21
- | Color region | Seven 0.1 mm CMYW layers in `Cyan -> Magenta -> Yellow -> White` order |
22
- | Upper White | Continuous height field from 1.0 to 2.14689422 mm, sliced at 0.04 mm |
20
+ | White base | One 0.10 mm first layer |
21
+ | Color region | Seven 0.08 mm CMYW layers; default `Yellow -> Magenta -> Cyan -> White` order |
22
+ | Upper White | Continuous White from 0.66 mm, sliced at 0.08 mm; one layer at the 0.74 mm brightest thickness |
23
23
  | Extruders | Cyan=1, Magenta=2, Yellow=3, White=4 |
24
24
 
25
- Bambu Studio restores the generated single `lithophane` plate and its White/Cyan/Magenta/Yellow assignments. The bundled fine-line target has been printed successfully with the current 0.2 mm, seven-layer standard. The current 140 × 104 mm color chart has been sliced and inspected in Bambu Studio, but it has not been physically printed with the 0.2 mm standard; its 120 recipes and eight White thickness stages have not been measured numerically. Colorimetric accuracy is not guaranteed.
25
+ Bambu Studio restores the generated single `lithophane` plate and its White/Cyan/Magenta/Yellow assignments. The bundled fine-line target and 140 × 104 mm color chart have been physically printed with the current 0.2 mm, seven-layer standard. LED transmission was visually checked on the chart and showed stronger transmission at Y100; the recipes and White thickness stages have not been measured numerically. Colorimetric accuracy is not guaranteed.
26
26
 
27
27
  Before printing, inspect every layer and confirm the Cyan, Magenta, Yellow, and White assignments. Do not move, align, scale, or merge individual material parts. Lithop does not slice models, send print jobs, or control a printer or AMS.
28
28
 
@@ -34,16 +34,16 @@ Before printing, inspect every layer and confirm the Cyan, Magenta, Yellow, and
34
34
 
35
35
  ## Install
36
36
 
37
- To install Lithop 0.3.0 from RubyGems, install libvips, Rust for the native palette extension, and the matching Lithop version:
37
+ To install Lithop 0.4.0 from RubyGems, install libvips, Rust for the native palette extension, and the matching Lithop version:
38
38
 
39
39
  ```sh
40
40
  brew install vips rust
41
- gem install lithop -v 0.3.0
41
+ gem install lithop -v 0.4.0
42
42
  lithop --version
43
43
  lithop doctor
44
44
  ```
45
45
 
46
- The version command must print `0.3.0`.
46
+ The version command must print `0.4.0`.
47
47
  The doctor command reports `"backend": "rust"` and the loaded native-extension version. Set
48
48
  `LITHOP_DISABLE_NATIVE=1` only when comparing the Ruby fallback.
49
49
 
@@ -74,9 +74,9 @@ To use the local browser UI, start its loopback-only server and open the display
74
74
  lithop ui
75
75
  ```
76
76
 
77
- The UI separates creation, jobs, and reusable presets into responsive panes, with drag-and-drop image selection, grouped settings, an engine-rendered input preview, persistent job progress and cancellation, side-by-side result views, and per-job artifact management. Sinatra, ERB, Puma, CSS, and JavaScript are included in the gem, so the workflow remains local and works offline after installation. Playwright is used only for source-checkout browser tests. See [local browser UI](docs/local-ui.md).
77
+ The UI keeps Create, Jobs, and Presets in a persistent top navigation. The Create view places the conversion action next to drag-and-drop image selection and provides section navigation for grouped settings; the Presets view separates saved-setting selection from save and management operations. Responsive panes, an engine-rendered input preview, persistent job progress and cancellation, side-by-side result views, and per-job artifact management remain available. Sinatra, ERB, Puma, CSS, and JavaScript are included in the gem, so the workflow remains local and works offline after installation. Playwright is used only for source-checkout browser tests. See [local browser UI](docs/local-ui.md).
78
78
 
79
- The standard command generates the 140 × 104 × 2.14689422 mm, 0.2 mm-nozzle layout:
79
+ The standard command generates the 140 × 104 × 1.94 mm, 0.2 mm-nozzle layout:
80
80
 
81
81
  ```sh
82
82
  bundle exec lithop path/to/image.jpeg
@@ -86,9 +86,11 @@ It writes `lithop.3mf` with a single `lithophane` plate and White/Cyan/Magenta/Y
86
86
 
87
87
  Use `--brightness`, `--contrast`, and `--saturation` with percentages from `-100` to `100` to adjust the shared sRGB input before White thickness and CMYW recipes are sampled. The resolved values are recorded in each job's `settings.json`.
88
88
 
89
+ Use `--yellow-mix-color cyan|magenta` with `--yellow-mix-percent 0..100` to replace that percentage of Yellow coverage before the nearest layered recipe is selected. The default is 0%, so existing output is unchanged. Seven-layer output quantizes the requested ratio to whole layers.
90
+
89
91
  Use `--tile-count N` with `--tile-layout auto`, `columns`, `rows`, or `grid` to emit exactly N local-origin 3MF tiles. Tiled jobs include assembled offsets and bounds in `manifest.json` plus a physical-size `tile-layout.svg` placement guide.
90
92
 
91
- Add `--separate-z-parts` to place three closed CMYW color-region bands and Top White on four Bambu Studio plates inside every generated 3MF. Each color-region plate includes its own Base White carrier, and every plate is translated to start at Z=0 for independent printing; `manifest.json` retains the original assembly order and Z bounds.
93
+ Add `--separate-z-parts` to slice the CMYW model into 1–3 contiguous Bambu Studio plates. Every plate receives Base White support beneath its source Z slice so Cyan and Yellow regions remain connected after printing. Z separation uses eight 0.08 mm CMY/W color layers. `--color-region-parts 3` uses equal source ranges beginning at 0.10, 0.42, and 0.74 mm. The second plate ends with the color region, while the third contains no CMY. To prevent its brightest area from becoming a fragile two-layer sheet, Z plate 3 uses three Base White layers (0.26 mm) plus at least one 0.08 mm Top White layer. Its printed minimum is 0.34 mm, and the assembled range is 1.18–2.30 mm. See [3MF tiling and Z separation](docs/tiling.md).
92
94
 
93
95
  The command reports estimated and final triangle counts and creates a new `build/<job_id>/` directory. Completed jobs are never overwritten. Inspect `preview.png`, `transmission.png`, `thickness.png`, and the four material masks, then import `lithop.3mf` into Bambu Studio as a model. The 3MF contains geometry, fixed extruder numbers, and layer-height metadata. It does not select a printer, physical build plate, AMS slot, or complete slicing preset.
94
96
 
@@ -128,6 +130,7 @@ The command-line options can override individual profile values. Use `--color-pi
128
130
  - [Bambu Studio verification and printing](docs/bambu-studio.md)
129
131
  - [Options and settings](docs/config.md)
130
132
  - [Artifacts and generation records](docs/artifacts.md)
133
+ - [3MF tiling and Z separation](docs/tiling.md)
131
134
  - [CMYW color model and layer structure](docs/color-model.md)
132
135
  - [Optional measured calibration](docs/calibration.md)
133
136
  - [Command reference](docs/command.md)
data/RELEASING.md CHANGED
@@ -67,15 +67,15 @@ Alternatively, configure a RubyGems.org trusted publisher for this repository an
67
67
  bundle exec rake release
68
68
  ```
69
69
 
70
- After the tag exists on GitHub, create a GitHub Release and attach the exact gem that passed validation. Replace `0.3.0` for later versions:
70
+ After the tag exists on GitHub, create a GitHub Release and attach the exact gem that passed validation. Replace `0.4.0` for later versions:
71
71
 
72
72
  ```sh
73
- gh release create v0.3.0 --verify-tag --generate-notes
73
+ gh release create v0.4.0 --verify-tag --generate-notes
74
74
  ```
75
75
 
76
76
  Finally, install the published version in a clean environment and verify the CLI:
77
77
 
78
78
  ```sh
79
- gem install lithop -v 0.3.0
79
+ gem install lithop -v 0.4.0
80
80
  lithop --version
81
81
  ```
data/docs/README.md CHANGED
@@ -1,10 +1,11 @@
1
1
  # Lithopドキュメント
2
2
 
3
- Lithopは、JPEG、PNG、SVGからCMYW材料のカラーLithophane（リトファン）3MFと、White参照STLを生成するローカルCLI／ブラウザUIです。画像を外部へ送信せず、入力画像自体を生成ジョブへコピーしません。
3
+ Lithopは、JPEG、PNG、SVGからCMYW材料のカラーLithophane（リトファン）3MFと、White参照STLを生成するローカルCLI／ブラウザUIです。既定では単一プレートの3MFを生成し、必要に応じてXYタイル分割とZプレート分割を利用できます。画像を外部へ送信せず、入力画像自体を完了済みジョブへコピーしません。
4
4
 
5
5
  ## 安全と現在の検証範囲
6
6
 
7
- - 標準は0.2 mmノズル、White下地2層、CMYW色領域7層、連続高のWhite上面を使います。
7
+ - 標準は0.2 mmノズル、White下地1層0.10 mm、0.08 mmのCMYW色領域7層、0.08 mmの連続高White上面を使います。
8
+ - Z分割時は各プレートの第1層をBase White 0.10 mm、CMYW色領域8層とTop Whiteを0.08 mm積層ピッチにします。3分割時のZプレート3はBase White 3層とTop White 1層以上で、最薄部をWhite合計4層・0.34 mmにします。
8
9
  - Bambu Studioで単一プレートとWhite/Cyan/Magenta/Yellowの割り当て復元を確認済みです。0.2 mmノズルで実機印刷済みなのは細線評価片です。現行140 × 104 mmカラーチャートはBambu Studioで形状を確認済みですが、実機印刷は未実施です。
9
10
  - 現行カラーチャートの120レシピとWhite厚み8段階は数値測色していません。
10
11
  - 数値測色は必須にしておらず、入力画像やプレビューとの測色的一致は保証しません。
@@ -24,7 +25,7 @@ Lithopは、JPEG、PNG、SVGからCMYW材料のカラーLithophane（リトフ
24
25
  ## 仕様を調べる
25
26
 
26
27
  - [生成物と記録](artifacts.md) — ジョブ、全成果物、プレビュー、`settings.json`、`manifest.json`
27
- - [3MFタイル分割とZ分割](tiling.md) — 指定枚数のXY分割、組み立て座標、4プレートのZ分割
28
+ - [3MFタイル分割とZ分割](tiling.md) — 指定枚数のXY分割、組み立て座標、強度調整したBase White付きの連続Z分割
28
29
  - [生成オプションと設定ファイル](config.md) — 設定の優先順位、入力JSON、既定値、検証規則
29
30
  - [コマンドリファレンス](command.md) — 構文、全オプション、終了ステータス
30
31
  - [CMYWの色モデルと積層構造](color-model.md) — 材料、減法混色、White厚み、3MF構造
data/docs/artifacts.md CHANGED
@@ -37,7 +37,7 @@ Lithopは生成中のファイルを一時ディレクトリへ書き、すべ
37
37
 
38
38
  標準ジョブは単一プレートと非一様レイヤー情報を持つ`lithop.3mf`を出力します。未使用のCyan、Magenta、Yellowは3MFのメッシュから省略されるため、材料部品は1〜4個です。Whiteは必ず含まれます。`cmyk_white.stl`は比較用で、CMYWの材料分離情報を持ちません。
39
39
 
40
- XYタイルとZ分割のファイル構成、座標、`tile-layout.svg`、マニフェスト記録、4プレート構成は[3MFタイル分割とZ分割](tiling.md)を参照してください。
40
+ XYタイルとZ分割のファイル構成、座標、`tile-layout.svg`、マニフェスト記録、Base White第1層0.10 mm、以降0.08 mmピッチ、3分割時のZプレート3がWhite合計4層・最小0.34 mmという構成は[3MFタイル分割とZ分割](tiling.md)を参照してください。
41
41
 
42
42
  XY分割時は各`tiles/tile_rNN_cNN.3mf`に対応する`tiles/tile_rNN_cNN-preview.png`を追加します。画像の1画素はそのタイルの1セルで、分割3MFと同じ範囲を表します。`manifest.json`の各`tiles`要素は`file`と`preview_file`で対応を記録します。
43
43
 
@@ -53,7 +53,7 @@ XY分割時は各`tiles/tile_rNN_cNN.3mf`に対応する`tiles/tile_rNN_cNN-prev
53
53
 
54
54
  ## 出力される settings.json
55
55
 
56
- `settings.json`は入力用設定ファイルではなく、そのジョブで確定した値の記録です。代表的な構造は次のとおりです。
56
+ `settings.json`は入力用設定ファイルではなく、そのジョブで確定した値の記録です。次の例は`separate_z_parts: false`の非分割設定です。Z分割時は`color_layer_count: 8`、`first_layer_height: 0.1`、`layer_height: 0.08`、`top_layer_height: 0.08`となり、3分割時のZプレート3はWhite合計4層・最小0.34 mmになります。プレート別のBase White層数と厚みは`manifest.json`へ記録します。代表的な構造は次のとおりです。
57
57
 
58
58
  ```json
59
59
  {
@@ -71,8 +71,11 @@ XY分割時は各`tiles/tile_rNN_cNN.3mf`に対応する`tiles/tile_rNN_cNN-prev
71
71
  "brightness": 0.0,
72
72
  "contrast": 0.0,
73
73
  "saturation": 0.0,
74
- "minimum_thickness": 1.0,
75
- "maximum_thickness": 2.14689422,
74
+ "suppress_pale_colors": false,
75
+ "yellow_mix_color": "cyan",
76
+ "yellow_mix_percent": 0.0,
77
+ "minimum_thickness": 0.74,
78
+ "maximum_thickness": 1.94,
76
79
  "pixel_size": 0.22,
77
80
  "color_pixel_size": null,
78
81
  "grid_columns": null,
@@ -84,22 +87,31 @@ XY分割時は各`tiles/tile_rNN_cNN.3mf`に対応する`tiles/tile_rNN_cNN-prev
84
87
  "separate_z_parts": false,
85
88
  "color_region_parts": 3,
86
89
  "first_layer_height": 0.1,
87
- "layer_height": 0.1,
88
- "base_white_layers": 2,
89
- "top_layer_height": 0.04,
90
- "top_white_start": 1.0,
91
- "minimum_top_white_layers": 0,
92
- "exact_maximum_thickness": true,
90
+ "layer_height": 0.08,
91
+ "base_white_layers": 1,
92
+ "top_layer_height": 0.08,
93
+ "top_white_start": null,
94
+ "minimum_top_white_layers": 1,
95
+ "exact_maximum_thickness": false,
93
96
  "nozzle_diameter": 0.2,
94
97
  "color_model": "cmy",
95
98
  "color_layer_count": 7,
96
- "pigment_order": ["cyan", "magenta", "yellow"],
99
+ "pigment_order": ["yellow", "magenta", "cyan"],
97
100
  "bambu_project": true,
98
101
  "maximum_input_pixels": 20000000,
99
102
  "maximum_triangles": 5000000,
100
103
  "effective_color_pixel_size": 0.22,
101
- "effective_minimum_thickness": 1.0,
102
- "effective_maximum_thickness": 2.14689422,
104
+ "effective_minimum_thickness": 0.74,
105
+ "effective_maximum_thickness": 1.94,
106
+ "minimum_z_part_thickness": 0.32,
107
+ "z_part_base_white_layers": 1,
108
+ "z_part_base_white_thickness": 0.1,
109
+ "z_part_minimum_build_thickness": 0.1,
110
+ "resolved_z_part_count": 3,
111
+ "z_separated_minimum_thickness": 0.96,
112
+ "z_separated_output_minimum_thickness": 0.94,
113
+ "z_separated_output_maximum_thickness": 2.14,
114
+ "z_separated_source_end": 1.06,
103
115
  "resolved_tile_rows": 1,
104
116
  "resolved_tile_columns": 1,
105
117
  "columns": 637,
@@ -107,7 +119,7 @@ XY分割時は各`tiles/tile_rNN_cNN.3mf`に対応する`tiles/tile_rNN_cNN-prev
107
119
  "pixel_size_x": 0.21978021978021978,
108
120
  "pixel_size_y": 0.21987315010570824,
109
121
  "schema_version": 1,
110
- "generator_version": "0.3.0",
122
+ "generator_version": "0.4.0",
111
123
  "input_path": "/absolute/path/to/image.png",
112
124
  "input_settings_path": "/absolute/path/to/config/settings.json",
113
125
  "calibration_profile_id": null,
@@ -141,6 +153,6 @@ XY分割時は各`tiles/tile_rNN_cNN.3mf`に対応する`tiles/tile_rNN_cNN-prev
141
153
 
142
154
  ## ローカルパスと共有時の注意
143
155
 
144
- 入力画像自体はジョブへコピーされません。ただし、`settings.json`の`input_path`、`input_settings_path`、`calibration_profile_path`にはローカルのディレクトリ名やファイル名が含まれます。Issueや第三者へ共有する前に機密情報がないか確認してください。
156
+ 入力画像自体は完了済みジョブへコピーされません。ただし、`settings.json`の`input_path`、`input_settings_path`、`calibration_profile_path`にはローカルのディレクトリ名やファイル名が含まれます。Issueや第三者へ共有する前に機密情報がないか確認してください。
145
157
 
146
158
  `manifest.json`には入力画像のSHA-256が含まれます。公開してよい識別情報か判断してから共有してください。
data/docs/bambu-studio.md CHANGED
@@ -2,13 +2,14 @@
2
2
 
3
3
  標準の`lithop.3mf`は、単一`lithophane`プレート、CMYW割り当て、上部Whiteのレイヤー範囲を持ちます。単一プレートとWhite/Cyan/Magenta/Yellow割り当ての復元に加え、分割なし・分割ありの3MFが正常に開くことをBambu Studioで確認済みです。G-code、温度、速度、AMS実スロット、機種固有の開始・終了コードを含まないため、その他の印刷条件はBambu Studio側で確認します。
4
4
 
5
- 標準構造は0.2 mmノズル、White下地2層、7層の`Cyan -> Magenta -> Yellow -> White`、連続高のWhite上面を使います。以下の確認をすべて終えるまで印刷を開始しないでください。
5
+ 標準構造は0.2 mmノズル、White下地1層0.10 mm、既定YMC順の0.08 mm色領域7層、0.08 mmの連続高White上面を使います。以下の確認をすべて終えるまで印刷を開始しないでください。
6
6
 
7
7
  ## 現在の確認範囲
8
8
 
9
9
  - 単一プレートとWhite/Cyan/Magenta/Yellow割り当ての復元は確認済み
10
10
  - 0.2 mmノズル、7層構造の細線評価片は問題なく印刷完了
11
- - 現行カラーチャートを0.2 mmノズル・0.1 mm積層ピッチで再スライスし、第1・8・15・30・39層の外形、グリッド、ラベル、各セルに形状欠落がないことを確認済み
11
+ - カラーチャートは旧0.1 mm積層ピッチで形状欠落がないことを確認済み
12
+ - 現行0.10 mm第1層・0.08 mm積層ピッチでの再スライスと実機確認は未実施
12
13
  - 現行140 × 104 mmカラーチャートの0.2 mmノズルによる実機印刷は未実施
13
14
  - 120レシピの数値測色は未実施で、測色的一致は保証しない
14
15
 
@@ -24,7 +25,7 @@ bundle exec lithop examples/cmy-fine-line.svg --width 20 --height 15 --pixel-siz
24
25
 
25
26
  表示された`build/<job_id>/`で、`preview.png`、`PRINT_README.md`、`settings.json`、`manifest.json`を確認してから`lithop.3mf`を開きます。自分のジョブIDと印刷条件は`manifest.json`に記録されています。
26
27
 
27
- タイルまたはZ分割ジョブを開く場合は、[3MFタイル分割とZ分割](tiling.md)に従い、対象3MF、組み立て座標、4プレート、材料割り当てを確認します。
28
+ タイルまたはZ分割ジョブを開く場合は、[3MFタイル分割とZ分割](tiling.md)に従い、対象3MF、組み立て座標、生成されたプレート数、材料割り当てを確認します。標準設定の3分割では、色領域を8層に変更し、各プレートの1層目をBase White 0.10 mm、それ以降を0.08 mm積層ピッチにします。Zプレート2は色領域まで、Zプレート3はCMYなしです。Zプレート3はBase White 3層・0.26 mmとTop White 1層以上で、最薄部をWhite合計4層・0.34 mmにします。
28
29
 
29
30
  ## 3MFを読み込む
30
31
 
@@ -54,10 +55,10 @@ macOSで`lithop ui`を使用している場合は、完了ジョブの「成果
54
55
  | 項目 | 確認内容 |
55
56
  | --- | --- |
56
57
  | ノズル | 生成時の0.2 mmまたは0.4 mm。既定は0.2 mm |
57
- | 下地White | 既定は0.1 mmを2層 |
58
- | 色レイヤー | 既定は0.1 mm |
59
- | 色領域 | 既定は7層、Cyan -> Magenta -> Yellow -> White |
60
- | 上部White | Z=1.0 mm以上を0.04 mmでスライス |
58
+ | 下地White | 既定は第1層0.10 mmを1層 |
59
+ | 色レイヤー | 既定は0.08 mm |
60
+ | 色領域 | 非分割は7層。Z分割は8層。既定はYellow -> Magenta -> Cyan -> White |
61
+ | 上部White | 色領域直後から0.08 mmでスライス |
61
62
  | 充填 | 100 % rectilinear |
62
63
  | 向き | 平らな背面をZ=0、完成後は+Z側から見る |
63
64
 
@@ -69,9 +70,10 @@ macOSで`lithop ui`を使用している場合は、完了ジョブの「成果
69
70
 
70
71
  レイヤープレビューを下から上まで動かし、すべて確認します。
71
72
 
72
- - 最初の2層が連続したWhiteである
73
+ - 非分割とZ分割の各プレートで、最初の1層が0.10 mmの連続したWhiteである
73
74
  - 色領域の層数と材料順が`settings.json`、`manifest.json`と一致する
74
- - 0.9〜1.0 mmがWhiteで、1.0 mm以上に連続高のWhite上面がある
75
+ - 非分割はZ=0.66 mm以上に0.08 mmピッチの連続高White上面がある
76
+ - 3プレートZ分割はZプレート1・2が8層の色領域、Zプレート3がBase White 3層＋Top Whiteだけである
75
77
  - Cyan、Magenta、Yellowの必要な領域が消えていない
76
78
  - 材料同士の重複、穴、孤立領域、浮遊形状がない
77
79
  - 画像の上下左右が正しい
@@ -79,7 +81,7 @@ macOSで`lithop ui`を使用している場合は、完了ジョブの「成果
79
81
 
80
82
  一つでも確認できない場合は印刷を開始しないでください。材料が分かれない場合は[3MFの材料が期待した色に分かれない](troubleshooting.md#3mfの材料が期待した色に分かれない)を参照してください。
81
83
 
82
- 標準ジョブではWhite下地2層、元画像のsRGBから選ぶCMY/W色領域7層、0.9〜1.0 mmのWhite、その上の0.04 mmレイヤーを確認します。外周、Black部品、写真フレーム、導光板は含みません。
84
+ 非分割の標準ジョブではWhite下地1層0.10 mm、元画像のsRGBから選ぶ0.08 mmのCMY/W色領域7層、その上の0.08 mm Whiteレイヤーを確認します。Z分割では各プレートのBase White第1層0.10 mm、色領域8層、それ以降の共通0.08 mmピッチを確認します。外周、Black部品、写真フレーム、導光板は含みません。
83
85
 
84
86
  ## 初回印刷を記録する
85
87
 
data/docs/calibration.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # 色校正
2
2
 
3
- Lithopの標準構造は、2層のWhite下地、7層のCMYW色領域、連続した上部Whiteで構成されます。未校正出力は材料の表示色を基準にレシピを選ぶため、実際のフィラメント、プリンタ、バックライトを含む測色的一致は保証しません。
3
+ Lithopの標準構造は、0.10 mmのWhite下地1層、0.08 mmピッチの7層CMYW色領域、0.08 mmピッチの連続した上部Whiteで構成されます。未校正出力は材料の表示色を基準にレシピを選ぶため、実際のフィラメント、プリンタ、バックライトを含む測色的一致は保証しません。
4
4
 
5
5
  目視結果で用途を満たす場合、数値校正は不要です。使用する材料と観察条件で透過色を測り、入力色に近いレシピと明るさに対応する厚みを選びたい場合に、任意の実測プロファイルを使用します。
6
6
 
@@ -16,11 +16,11 @@ Lithopの標準構造は、2層のWhite下地、7層のCMYW色領域、連続し
16
16
  | White厚み | `W00`〜`W07`の8段階 |
17
17
  | 標準ノズル | 0.2 mm |
18
18
  | 第1層／通常レイヤー | 0.1 mm／0.1 mm |
19
- | 色領域 | 7層、`Cyan -> Magenta -> Yellow -> White` |
19
+ | 色領域 | 7層、既定は`Yellow -> Magenta -> Cyan -> White` |
20
20
 
21
21
  120レシピは、7層をCyan、Magenta、Yellow、Whiteへ配分できる全組み合わせです。レシピは先頭8行の15列を使い、鑑賞面から見て上段左の`R000`から行優先で並びます。各セルは横8.125 mm、縦約11.111 mmです。
22
22
 
23
- 下段の`W00`から`W07`は、全7色層をWhiteに固定して上部Whiteの厚みだけを変えます。現在の標準設定では、総厚は順に1.0、1.16、1.32、1.48、1.64、1.8、2.0、2.14689422 mmです。値は最小・最大厚さと印刷可能なZ境界から算出されるため、厚さ設定を変更した場合は生成された`calibration-profile.json`の`total_thickness_mm`を正本とします。
23
+ 下段の`W00`から`W07`は、全7色層をWhiteに固定して上部Whiteの厚みだけを変えます。現在の標準設定では、総厚は順に0.74、0.90、1.06、1.22、1.46、1.62、1.78、1.94 mmです。最薄段は上部White 1層0.08 mmで、明るい色の透過を優先します。値は最小・最大厚さと印刷可能なZ境界から算出されるため、厚さ設定を変更した場合は生成された`calibration-profile.json`の`total_thickness_mm`を正本とします。
24
24
 
25
25
  右端は向き判別用のWhite列で、上端に`TOP`を表示します。下段の未使用セルもWhiteです。`calibration.svg`はパッチID、色、向きを確認する編集可能な配置図です。材料の積層と厚みを持つ印刷データは、同時に生成される`calibration.3mf`です。
26
26
 
@@ -32,7 +32,7 @@ Lithopの標準構造は、2層のWhite下地、7層のCMYW色領域、連続し
32
32
  bundle exec lithop calibrate
33
33
  ```
34
34
 
35
- 別の設定ファイルを使う場合は`--config`、別のプロジェクトへ出力する場合は`--project-dir`を指定します。校正片は7層・`cyan,magenta,yellow`順と、相異なるWhite厚みを8段階生成できる厚さ範囲を要求します。画像用の幅、高さ、余白、配置、ピクセルサイズは使用しません。
35
+ 別の設定ファイルを使う場合は`--config`、別のプロジェクトへ出力する場合は`--project-dir`を指定します。校正片は7層、選択した積層順、相異なるWhite厚みを8段階生成できる厚さ範囲を要求します。積層順を変えた場合は、その順序専用の校正プロファイルを作成してください。画像用の幅、高さ、余白、配置、ピクセルサイズは使用しません。
36
36
 
37
37
  `build/<job_id>-calibration/`へ次の5ファイルを生成します。
38
38
 
data/docs/color-model.md CHANGED
@@ -11,9 +11,11 @@ Lithopは、Cyan、Magenta、Yellow、Whiteの4材料を積み重ね、カラー
11
11
  | Yellow | PLA Basic Yellow | 10400 | `#FCE300` | C: 3%, M: 9%, Y: 95%, K: 0% | 3 |
12
12
  | White | PLA Basic White | 10100 | `#FFFFFF` | C: 0%, M: 0%, Y: 0%, K: 0% | 4 |
13
13
 
14
- 材料表の表示色はRGB系のHEX（16進カラーコード）であり、隣の列にJapan Color 2001 CoatedでのCMYK変換値を併記しています。いずれも画面や印刷物で材料を識別するための色値で、フィラメントの透過色や光学特性を表すものではありません。入力sRGBが表示色と完全に一致する場合は材料チャンネルの指定値としても扱い、`#0086D6`はCyan 7層、`#EC008C`はMagenta 7層、`#FCE300`はYellow 7層へ割り当てます。未使用の顔料を省略してもExtruder番号は詰めません。
14
+ 材料表の表示色はRGB系のHEX（16進カラーコード）であり、隣の列にJapan Color 2001 CoatedでのCMYK変換値を併記しています。いずれも画面や印刷物で材料を識別するための色値で、フィラメントの透過色や光学特性を表すものではありません。通常のJPEG、PNG、SVG入力はsRGBからCMYへ変換します。ただし、入力sRGBが表示色と完全に一致する場合は材料チャンネルの指定値として扱い、`#0086D6`はCyan 7層、`#EC008C`はMagenta 7層、`#FCE300`はYellow 7層へ割り当てます。表示色をWhiteで薄めたチャート色の特殊変換は、`data-lithop-color-encoding="material-display"`をルート要素に持つSVGに限ります。未使用の顔料を省略してもExtruder番号は詰めません。
15
15
 
16
- 140 mm × 104 mmの`examples/cmy-color-chart.svg`では、横方向の表示色を図中のCMY配合へ割り当て、縦方向の0〜100%を明暗値として扱います。Yellowを含む列だけでなく、Cyan、Magentaおよび混色の列も5%からCMY配合を保持します。5%未満のごく薄い非Yellow色差はWhiteのノイズとして除去します。暗い無彩色と茶色い細線はCyan 1層、Magenta 1層、Yellow 1層、White 4層へ割り当てます。明暗値は全色列で共通の上部White連続高へ変換し、Y100だけが別の高さ段階にならないようにします。0%は顔料なしのWhiteです。
16
+ 140 mm × 104 mmの`examples/cmy-color-chart.svg`では、ルート要素の材料表示色マーカーにより、横方向の表示色を図中のCMY配合へ割り当て、縦方向の0〜100%を明暗値として扱います。Yellowを含む列だけでなく、Cyan、Magentaおよび混色の列も5%からCMY配合を保持します。平均CMY濃度が4%以下のごく薄い色差をWhiteのノイズとして除去する処理は既定で無効です。`--suppress-pale-colors`または`suppress_pale_colors: true`で有効にできます。暗い無彩色と茶色い細線はCyan 1層、Magenta 1層、Yellow 1層、White 4層へ割り当てます。明暗値は全色列で共通の上部White連続高へ変換し、Y100だけが別の高さ段階にならないようにします。0%は顔料なしのWhiteです。このマーカーは同梱の材料評価用SVGにだけ指定し、一般画像には指定しません。
17
+
18
+ LED透過確認でYellowが明るすぎる場合は、`yellow_mix_color`と`yellow_mix_percent`でYellow被覆量の一部をCyanまたはMagentaへ置き換えられます。これは材料と光源の組み合わせに応じた任意補正で、既定の0%では無効です。Y100へCyanを20%指定すると目標被覆量はC20/Y80となり、標準7層ではCyan 1層、Yellow 6層が選ばれます。入力RGBとWhite厚さは変えず、CMYWレシピ選択だけを調整します。
17
19
 
18
20
  ## 色の作り方
19
21
 
@@ -27,7 +29,7 @@ Cyan、Magenta、Yellowは減法混色として扱います。
27
29
 
28
30
  標準の色領域7層にCyan、Magenta、Yellow、Whiteを配分すると、120個の整数レシピになります。入力sRGBから求めたCMY被覆量に最も近いレシピを選びます。実際の色は材料の透過率、層数、積層順、光源に依存します。
29
31
 
30
- 明暗は主に上部Whiteの厚さで表します。厚い場所ほどバックライトを通しにくく、暗く見えます。材料表示色とチャート配合には指定された明暗値を使い、それ以外の入力色はRec.601輝度を反転して画像内の最小・最大で正規化します。White上面は連続高のまま生成します。0.04 mmは上面メッシュの刻みではなく、Bambu Studioへ渡すスライス層高です。
32
+ 明暗は主に上部Whiteの厚さで表します。厚い場所ほどバックライトを通しにくく、暗く見えます。材料表示色マーカー付きSVGのチャート配合には指定された明暗値を使い、それ以外の入力色はRec.601輝度を反転して画像内の最小・最大で正規化します。White上面は連続高のまま生成し、Bambu Studioへ渡すスライス層高は0.08 mmです。
31
33
 
32
34
  ## 現行の積層構造
33
35
 
@@ -36,24 +38,24 @@ Cyan、Magenta、Yellowは減法混色として扱います。
36
38
  ```text
37
39
  +Z / 観察側
38
40
  ┌─────────────────────────┐
39
- │ White: 1.0 mm以上で可変 │ 明暗を制御
41
+ │ White: 0.66 mm以上で可変 │ 明暗を制御
40
42
  ├─────────────────────────┤
41
43
  │ CMYWレシピ: 標準7層 │ 色相を制御
42
44
  ├─────────────────────────┤
43
- │ White: 下地2層 │ 共通の背面
45
+ │ White: 下地1層 0.10 mm │ 共通の背面
44
46
  └─────────────────────────┘
45
47
  Z=0 / バックライト側
46
48
  ```
47
49
 
48
50
  ### 下地のWhite
49
51
 
50
- 最初の2層はモデル全体を支える連続したWhiteです。各層は0.1 mmで、平らなバックライト側の面になります。
52
+ 最初の1層はモデル全体を支える連続したWhiteです。層高は0.10 mmで、平らなバックライト側の面になります。
51
53
 
52
54
  ### CMYWの色領域
53
55
 
54
- 下地の上へ、各0.1 mmの色レイヤーを7層置きます。各XYセル・各高さには4材料のどれか一つだけを割り当て、重複や空洞を作りません。
56
+ 下地の上へ、各0.08 mmの色レイヤーを7層置きます。各XYセル・各高さには4材料のどれか一つだけを割り当て、重複や空洞を作りません。
55
57
 
56
- 顔料はバックライト側から`Cyan -> Magenta -> Yellow`の順に並び、残りをWhiteが埋めます。`pigment_order`が表すのは3顔料の順序で、Whiteは常にその後です。
58
+ 顔料は既定でバックライト側から`Yellow -> Magenta -> Cyan`の順に並び、残りをWhiteが埋めます。`pigment_order`ではCMY、CYM、MCY、MYC、YCM、YMCの6通りから選択でき、Whiteは常にその後です。
57
59
 
58
60
  | 表現する色 | 色領域7層の例 |
59
61
  | ---------- | ------------------------- |
@@ -67,19 +69,19 @@ Z=0 / バックライト側
67
69
 
68
70
  ### 明暗を作る上部White
69
71
 
70
- 色領域の上を1.0 mmまでWhiteで埋め、その上面を連続高にします。材料表示色と同梱カラーチャートの配合色では指定された明暗値を使い、それ以外の入力色ではRec.601輝度を使います。明るい場所は薄く、暗い場所は厚くします。
72
+ 色領域が終わるZ=0.66 mmから、0.08 mmピッチの上部Whiteを置き、上面を連続高にします。材料表示色と同梱カラーチャートの配合色では指定された明暗値を使い、それ以外の入力色ではRec.601輝度を使います。明るい場所は薄く、暗い場所は厚くします。
71
73
 
72
74
  `cmy-color-chart.svg`では同じ明暗行にある全13色列を共通のWhite高さへ変換します。YellowのRGB表示色はほかの材料色より明るく見えますが、Y100だけに別のWhite段差は作りません。高さの比較には`preview.png`の見た目ではなく`thickness.png`を使います。
73
75
 
74
76
  | 領域 | 既定の層数 | Z範囲 |
75
77
  | ---------- | ---------: | ------------ |
76
- | 下地White | 2 | 0.00–0.20 mm |
77
- | CMYW色領域 | 7 | 0.20–0.90 mm |
78
- | 上部White | 可変 | 0.90–2.14689422 mm |
78
+ | 下地White | 1 | 0.00–0.10 mm |
79
+ | CMYW色領域 | 7 | 0.10–0.66 mm |
80
+ | 上部White | 可変 | 0.66–1.94 mm |
79
81
 
80
- `--separate-z-parts`で出力する4プレート、Base Whiteキャリア、元のZ境界、積層順は[3MFタイル分割とZ分割](tiling.md)を参照してください。
82
+ `--separate-z-parts`では色領域を8層・0.64 mmへ変更します。各プレートの1層目はBase White 0.10 mm、それ以降は共通の0.08 mm積層ピッチです。3分割時のZプレート3はCMYを含まず、強度確保のためBase Whiteを3層・0.26 mmとします。最薄部はTop White 1層を加えたWhite合計4層・0.34 mmです。積層順は[3MFタイル分割とZ分割](tiling.md)を参照してください。
81
83
 
82
- 標準の最小厚さは1.0 mm、最大厚さは2.14689422 mmです。
84
+ 標準の指定厚さと実効厚さは0.74–1.94 mmです。最薄部は下地White 0.10 mm、色領域0.56 mm、上部White 1層0.08 mmで構成し、明るい色の透過を妨げる余分な上部Whiteを置きません。
83
85
 
84
86
  ## 材料別メッシュの関係
85
87
 
@@ -89,16 +91,16 @@ Bambu Studioでは一つの親オブジェクトの材料部品として扱い
89
91
 
90
92
  ## 積層構造の比較結果
91
93
 
92
- 4層／5層は比較用に指定できます。標準構造は7層の`Cyan -> Magenta -> Yellow -> White`です。
94
+ 4層／5層は比較用に指定できます。標準構造は0.08 mmの7層`Yellow -> Magenta -> Cyan -> White`です。
93
95
 
94
96
  | 項目 | 標準構造 | 比較可能な代替構造 |
95
97
  | ------ | ------------------------- | ------------------------- |
96
98
  | 色領域 | 7層 | 4層または5層 |
97
- | 顔料順 | Cyan -> Magenta -> Yellow | Yellow -> Magenta -> Cyan |
98
- | 下地 | White 2層 | White 2層 |
99
+ | 顔料順 | Yellow -> Magenta -> Cyan | CMY、CYM、MCY、MYC、YCM |
100
+ | 下地 | White 1層、0.10 mm | White 1層、0.10 mm |
99
101
  | 上部 | 可変厚のWhite | 可変厚のWhite |
100
102
 
101
- `--color-layer-count`と`--pigment-order`で比較構造を再生成できます。これは目視による発色バランスの採用結果であり、測色校正の結果ではありません。
103
+ `--color-layer-count`と`--pigment-order`で比較構造を再生成できます。ローカルUIでは「基本設定」の「色の積層順」から選択します。順序はバックライト側から観察側の向きです。
102
104
 
103
105
  ## 現在の制約
104
106
 
data/docs/command.md CHANGED
@@ -25,8 +25,8 @@ Usage: lithop IMAGE [options]
25
25
  | `--tile-layout MODE` | String | `auto` | `auto`、`columns`、`rows`、`grid`から配置を選ぶ |
26
26
  | `--tile-rows COUNT` | Integer | なし | `grid`配置の行数を指定する |
27
27
  | `--tile-columns COUNT` | Integer | なし | `grid`配置の列数を指定する |
28
- | `--separate-z-parts` | — | 無効 | 下地White、CMYW色領域、上部Whiteを別プレートにする |
29
- | `--color-region-parts COUNT` | Integer | `3` | CMYW色領域のZ方向の分割数を指定する |
28
+ | `--separate-z-parts` | — | 無効 | CMYWモデルを連続Zプレートへ分割し、強度に応じたBase Whiteを追加する |
29
+ | `--color-region-parts COUNT` | Integer | `3` | Zプレート数を1〜3で指定する。3分割時のZプレート3はWhite合計4層、最小0.34 mm |
30
30
  | `--margin-top MM` | Float | `0` | 上側のWhite余白をmm単位で指定する |
31
31
  | `--margin-right MM` | Float | `0` | 右側のWhite余白をmm単位で指定する |
32
32
  | `--margin-bottom MM` | Float | `0` | 下側のWhite余白をmm単位で指定する |
@@ -38,16 +38,20 @@ Usage: lithop IMAGE [options]
38
38
  | `--brightness PERCENT` | Float | `0` | sRGB明るさを`-100`〜`100`で補正する |
39
39
  | `--contrast PERCENT` | Float | `0` | sRGBコントラストを`-100`〜`100`で補正する |
40
40
  | `--saturation PERCENT` | Float | `0` | sRGB彩度を`-100`〜`100`で補正する |
41
- | `--min-thickness MM` | Float | `1.0` | 要求最小厚さをmm単位で指定する |
42
- | `--max-thickness MM` | Float | `2.14689422` | 要求最大厚さをmm単位で指定する |
41
+ | `--suppress-pale-colors` | — | 無効 | ごく薄い色をWhiteへ落とす |
42
+ | `--no-suppress-pale-colors` | — | — | ごく薄い色もCMYレイヤー候補として残す |
43
+ | `--yellow-mix-color COLOR` | String | `cyan` | Yellowへ混ぜる色を`cyan`または`magenta`から選ぶ |
44
+ | `--yellow-mix-percent PERCENT` | Float | `0` | Yellow被覆量から選択色へ置き換える割合を`0`〜`100`で指定する |
45
+ | `--min-thickness MM` | Float | `0.74` | 要求最小厚さをmm単位で指定する |
46
+ | `--max-thickness MM` | Float | `1.94` | 要求最大厚さをmm単位で指定する |
43
47
  | `--pixel-size MM` | Float | `0.22` | XYセル寸法をmm単位で指定する |
44
48
  | `--color-pixel-size MM` | Float | `--pixel-size`と同じ | `--pixel-size`以上のCMYW色セル寸法を指定する |
45
49
  | `--first-layer-height MM` | Float | `0.1` | 下地Whiteの層高をmm単位で指定する |
46
- | `--layer-height MM` | Float | `0.1` | CMYW色領域の積層ピッチを指定する |
50
+ | `--layer-height MM` | Float | `0.08` | CMYW色領域の積層ピッチを指定する |
47
51
  | `--nozzle-diameter MM` | Float | `0.2` | ノズル径を`0.2`または`0.4`から選ぶ |
48
52
  | `--color-model MODEL` | String | `cmy` | 色モデルを指定する。現在は`cmy`のみ |
49
- | `--color-layer-count COUNT` | Integer | `7` | 色領域を`4`層、`5`層、`7`層から選ぶ |
50
- | `--pigment-order LIST` | String | `cyan,magenta,yellow` | CMYの顔料順をカンマ区切りで指定する |
53
+ | `--color-layer-count COUNT` | Integer | `7` | 色領域を`4`層、`5`層、`7`層、`8`層から選ぶ。Z分割時は`8`層へ固定する |
54
+ | `--pigment-order LIST` | String | `yellow,magenta,cyan` | バックライト側からの顔料順。CMY、CYM、MCY、MYC、YCM、YMC |
51
55
  | `--config FILE` | Path | `PROJECT/config/settings.json` | 入力設定JSONを明示する |
52
56
  | `--project-dir DIR` | Path | 現在のディレクトリ | 設定を読み、`build/`を作るプロジェクトを選ぶ |
53
57
  | `--calibration-profile FILE` | Path | なし | 完了した実測プロファイルを選ぶ |
@@ -102,6 +106,18 @@ lithop image.png --image-fit contain
102
106
  lithop image.png --brightness 10 --contrast 15 --saturation 20
103
107
  ```
104
108
 
109
+ ごく薄い色をWhiteとして扱いたい場合は、淡色のWhite化を有効にします。
110
+
111
+ ```sh
112
+ lithop image.png --suppress-pale-colors
113
+ ```
114
+
115
+ Yellowの光透過を抑えるため、その被覆量の20%をCyanへ置き換えます。7層では最寄りのCyan 1層、Yellow 6層へ量子化されます。
116
+
117
+ ```sh
118
+ lithop examples/cmy-color-chart.svg --yellow-mix-color cyan --yellow-mix-percent 20
119
+ ```
120
+
105
121
  別のプロジェクトと入力設定を使います。
106
122
 
107
123
  ```sh
@@ -131,7 +147,7 @@ in /absolute/path/to/build/<job_id>
131
147
 
132
148
  ## 校正片を生成する
133
149
 
134
- 標準の7層・`Cyan -> Magenta -> Yellow`構造について、全120レシピとWhite厚み8段階を持つ140 × 104 mmの校正SVGと、同じ配置の印刷用3MFを生成します。画像は指定しません。
150
+ 標準の7層と選択した積層順について、全120レシピとWhite厚み8段階を持つ140 × 104 mmの校正SVGと、同じ配置の印刷用3MFを生成します。既定はYMCで、画像は指定しません。
135
151
 
136
152
  ```text
137
153
  Usage: lithop calibrate [options]
@@ -139,14 +155,14 @@ Usage: lithop calibrate [options]
139
155
 
140
156
  | オプション | 型 | 既定値 | 説明 |
141
157
  | --- | --- | ---: | --- |
142
- | `--min-thickness MM` | Float | `1.0` | 要求最小厚さを指定する |
143
- | `--max-thickness MM` | Float | `2.14689422` | 要求最大厚さを指定する |
158
+ | `--min-thickness MM` | Float | `0.74` | 要求最小厚さを指定する |
159
+ | `--max-thickness MM` | Float | `1.94` | 要求最大厚さを指定する |
144
160
  | `--first-layer-height MM` | Float | `0.1` | 下地Whiteの層高を指定する |
145
- | `--layer-height MM` | Float | `0.1` | CMYW色領域の積層ピッチを指定する |
161
+ | `--layer-height MM` | Float | `0.08` | CMYW色領域の積層ピッチを指定する |
146
162
  | `--nozzle-diameter MM` | Float | `0.2` | ノズル径を`0.2`または`0.4`から選ぶ |
147
163
  | `--color-model MODEL` | String | `cmy` | 色モデルを指定する |
148
164
  | `--color-layer-count COUNT` | Integer | `7` | 色領域の層数を指定する |
149
- | `--pigment-order LIST` | String | `cyan,magenta,yellow` | CMYの顔料順を指定する |
165
+ | `--pigment-order LIST` | String | `yellow,magenta,cyan` | バックライト側からの顔料順を指定する |
150
166
  | `--config FILE` | Path | `PROJECT/config/settings.json` | 入力設定JSONを明示する |
151
167
  | `--project-dir DIR` | Path | 現在のディレクトリ | 設定と出力先のプロジェクトを選ぶ |
152
168
  | `-v`, `--version` | — | — | バージョンを表示して終了する |