stroke_tone_error — PRINTPATH `stroke` op

• 資料種類:image2d × pairs → table

• 呼叫: import fullseye as fs; fs.ledger.stroke_tone_error(image, points, pen_width=1.0, blur_sigma=3.0, gamma=1.0)(要直接呼叫實作,import printpath; printpath.stroke_tone_error(image, points, pen_width=1.0, blur_sigma=3.0, gamma=1.0);從台帳取用則 opsprintpath.get("stroke_tone_error"))

用法

> 該運算子的說明尚無譯文,以下照原文給出。

線を引いた結果の濃淡が目標とどれだけ違うか。→ `table`

★これが一筆書きの本当の目的関数。「絵として似ている」を人の目に任せず、

ペン幅で描いて目の尺度にぼかし、目標の暗さと比べて数で返す。

返り値: dict

"rms" / "max_abs" / "bias" —— 暗さの差(`[0, 1]` の尺度)

"corr" —— 目標の暗さと描いた暗さの相関(1 に近いほど濃淡を追えている)

"ink_fraction" —— 紙に乗ったインクの面積率

"target_darkness" —— 目標の平均暗さ(インク率と釣り合うべき量)

"length_px" —— 線の長さ[px]

★ペン幅は連続なノブ(被覆率で塗る)。線が重ならない範囲では

`インク率 ≈ 線長 × ペン幅 / 画像の面積` が成り立つので、目標の濃さに合う

ペン幅を 閉形式で解いてから確かめられる:

`pen_width ≈ target_darkness × area / length_px`。

詳細使用指南

• printpath 族使用指南

參考(範例資料・文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

• 演算法的正典(作者・年份)與用途見上面的族使用指南。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• poc_one_stroke_epicycles — py -3.11 examples/poc_one_stroke_epicycles.py

型別可銜接的下一個運算子(可接受 `table` 作為輸入)

gcode_write · gcode_extrusion_volume · gcode_time_estimate · gcode_layer_image · contours_to_gcode

同類別(`stroke`)

stipple_points_from_image · stipple_energy · stroke_tour_closed · mst_length · stroke_resample_closed

*Provenance: printpath.py — PRINTPATH 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

stroke_tone_error — PRINTPATH stroke op

用法