fractalwright 是做什麼的?
成果:每張圖片都是一個 PNG,旁邊附有一個 recipe JSON,可以逐像素重新繪製該圖片。數字(維度、面積、對稱性)是測量而來的,絕非猜測。
FW 代表從儲存庫根目錄執行 python scripts/fw.py(直接執行,不要閱讀它)。
步驟 0:工具
直接執行任務。只有當某個命令因缺少工具而失敗時,才執行 FW doctor(NumPy 是核心;moderngl、Playwright 和 ffmpeg 是可選的,且僅會在需要時探查)。新鮮度(evergreen.json)僅在 'refresh fractalwright' 時讀取,並非每次使用。按給定的預設渲染;僅在要求時才調整外觀(疊代次數、密度、超取樣)。
步驟 1:選擇家族
FW explain <family> 會給出公式、製作方式及預設。家族:mandelbrot、julia、burning-ship、tricorn、multibrot、kronecker(精確網格碎形:FW render kronecker-carpet 或 --mask 111,101,111 --power 6)。混沌新手:FW explain logistic 給出教學順序,--plot cobweb|bifurcation -o out.png 可繪製;FW explain coastline 透過 Richardson 的量尺解釋 D。僅在使用者詢問深度或超越平滑的色彩方法時,才閱讀 references/02-escape-time.md。
步驟 2:渲染
FW render <preset 或 recipe.json> -o out.png [--size WxH] [--iter N] [--palette NAME] [--supersample 2]。它會寫出 out.png 和 out.json。在報告前,請確認兩個檔案都存在。若要更改視圖,請編輯 recipe 的 view.centre 和 view.width(十進位字串,保留每一位數字),然後再次渲染該 recipe。FW palette 列出色板;FW palette NAME -o swatch.png 顯示一個色板。當寬度超過約 1e-13 時,float64 會失敗;請說明此情況,而不是渲染出雜訊(references/03-deep-zoom.md)。
步驟 2a:探索
FW serve [--port 8765] [--out-dir DIR] [--open] 在僅限 127.0.0.1 上執行 WebGL2 瀏覽器(拒絕任何其他主機)。拖曳平移,滾輪或捏合縮放,Shift+點擊選取茱莉亞 c;公式、疊代次數、旋轉([ 和 ] 每次轉 15 度)和色板位於側面板;帶有停止色板(最多 8 個停止點)的 recipe 以 ps=pos:rrggbb,... 形式存在於雜湊中。URL 雜湊就是整個視圖,因此該位址就是一個分享連結。當 float32 接近其極限時,會出現精度警告框;超過極限時,曼德博集合和茱莉亞集合(冪次 2,寬度 >= 1e-60)會切換到 GPU 深度:頁面將視圖 POST 到 /orbit,伺服器計算 Decimal 參考軌道,然後頁面使用雙精度浮點擾動著色器繪製它(中心字串在縮放時保留每一位數字;當新軌道正在處理時,頁面會顯示來自上次軌道的粗略預覽,並取消過時的請求);「Render exact」要求伺服器提供相同視圖的 NumPy(或擾動)PNG,「Export」將 recipe JSON 寫入輸出目錄。FW export "<share url 或 #hash>" -o recipe.json 從命令列執行相同操作。--route browser 使用無頭 Edge 和頁面著色器渲染;--deep --route browser(或任何寬度小於 1e-12)在 GPU 上執行雙精度浮點擾動,可達寬度 1e-60(0.1-1% 的計數差異),因此當需要精確計數時,請使用 CPU 路由。詳細資訊(備援方案、--gpu-precision float32、燃燒之船):references/13-route-details.md。
步驟 2b:圖片表與影片
FW audio <song.wav> [--preset julia-pulse|mandel-dive] [--recipe R] [--size 640x360] [--fps 30] [--duration S] [--intensity 0.6] [--route auto|browser|numpy] 製作音樂影片:歌曲包絡驅動碎形(低音、節拍、中音、色度、高音、響度;靜音時無任何移動),影格通過閃爍限制器,閃爍檢查會把關結果(失敗時退出碼 4),然後將歌曲混入。除非使用 --allow-mp3,否則拒絕 MP3。FW serve 也會提供 /audio,這是一個即時頁面。映射詳細資訊:references/13-route-details.md。
FW sheet <recipe> --palettes A,B,C 或 --vary params.max_iter --values 100,300,1000(複數值為 re:im)會寫出一個帶標籤的連絡人表 PNG 以及一個包含每個圖塊 recipe 的 JSON。影片:FW zoom <recipe> --to-width W [--from-width W0] [--to-centre re,im](指數寬度,緩動中心),FW morph <recipe> --path "re,im;re,im"(預設為茱莉亞 c,--vary 用於其他參數),FW loop <recipe> --circle re,im,r [--phase](閉合路徑,最後一影格繞回第一影格)。所有選項都接受 --size WxH --fps N --duration S,會將確切的影格寫入 <out>_frames/,一個 H.264 mp4(yuv420p,CRF 18)和 <out>.json,其中包含 animation(關鍵影格、fps、duration_s)。AI 風格化預設為關閉;--ai 會新增一個 ComfyUI Z-Image img2img 副本(<out>_ai.*,標記為 interpreted)並始終保留確切影片(references/13-route-details.md)。每個影片都會進行閃爍檢查;FW flashcheck <video 或 frame dir> 會單獨執行它,並在每秒超過 3 次、在超過 25% 的 10 度視場中發生 10% 亮度(或飽和紅色)閃爍時退出碼 4;判決行會命名失敗的規則及其區域(整個影格的 swings/s 僅供參考,因此 "1 swings/s" 不代表通過或失敗)。請報告失敗,切勿發布(references/09)。
步驟 2c:IFS、吸引子、地形、內插
FW ifs sierpinski|fern|unequal-tiles -o out.png(混沌遊戲,p 由 |det| 決定,前 20 個點捨棄,由一個可證明容納吸引子的球體框定)。FW attractor-search --hits 5 -o best.png(Sprott 二次映射,按 D2 1.1-1.5 和小的 L 排序,一個書本規則;Lyapunov 以位元為單位)。FW terrain -o t.png [--method midpoint] [--H 0.8](預設為譜方法;中點折痕會被測量)會寫出 PNG 和 .npy。FW fif --points "0,0;1,1;2,0" --d 0.5,-0.5 -o f.png [--numbers y.txt] 會通過這些點繪製一條碎形內插曲線。
步驟 2d:火焰、L-system、吸引子
FW flame [sierpinski|swirl-sierpinski|recipe.json] -o f.png [--seed N --tries 24](在 xform 上的混沌遊戲,12 種 Draves-Reckase 變化,最終 xform,顏色混合,對數密度與 gamma 和 vibrancy,超取樣 2,密度估計;無預設 = 根據覆蓋率評分的隨機火焰,保留最佳者)。FW lsystem koch|koch-snowflake|dragon|hilbert|sierpinski-arrowhead|plant-a|plant-b|plant-d|plant-e|plant-f|plant-stochastic -o p.png [--n N --seed N] 會寫出 PNG、SVG 和 recipe。FW attractor clifford|dejong|icon|icon-3|icon-halloween|icon-clam|icon-streamers|icon-flower|lorenz|chen|lu|multiscroll -o a.png [--params a,b,c,d] [--search](icon 來自混沌對稱性表 A.1;multiscroll 參數是 Yalcin 的 a, Mx, Nx)(密度著色;搜尋會根據 Sprott 規則對隨機 Clifford 或 de Jong 集合進行排序)。每個命令都會寫出一個可重新繪製的 recipe JSON。
步驟 2f:鄰近主題(並非全部都是碎形)
FW rd coral|mitosis|default [--f F --k K --steps N --seed N](Gray-Scott)。FW ca 90|30|B3/S23 [--steps N](基本規則或生命遊戲)。FW tiling square|triangle|hex|penrose [--n N]。FW kleinian apollonian|grandma [--ta T --tb T](阿波羅尼斯填充,或來自 Grandma recipe 的雙生成器極限集合,透過書本的深度優先單詞搜尋繪製;--method random 用於逆迭代)。每個都會寫出 PNG 和 recipe。直接說明反應擴散和鑲嵌並非碎形;FW measure box 在鑲嵌上會顯示 "not fractal"(references/12-neighbours.md)。
步驟 2e:3D
FW 3d render mandelbulb|mandelbox|quatjulia|menger|hybrid [--view whole|close] [--remedy ao|shadow|fog|trap|dof|aa|camera|all|none] -o x.png(在無頭 Edge 中進行球體追蹤 DE;寫出含明確相機的 recipe)。自 0.8.0 版以來的預設外觀:路徑追蹤 256 個樣本(天空 + 太陽,約 0.5-2 秒),搭配組合相機(40 毫米,低角度,主體在左三分之一處);--pt 0 提供快速陰影 + 環境光遮蔽外觀,這更適合盒狀的 Menger 類形式;recipe 檔案會保留其自己的設定。--remedy 會增加到陰影/ao 外觀中,--remedy none 會先清除它。除非被要求,否則保持霧和景深關閉:霧在外觀測試中會沖淡主體,而景深會模糊近距離視圖。FW 3d recipe ... 印出 recipe;FW 3d gate -o DIR 渲染補救方案矩陣和圖表。僅限瀏覽器路由,無 NumPy 備援方案。自 3D 外觀測試(2026-11-14)以來的正常路由。--pt N [--bounces 2] [--seed 1] 設定樣本數(相同種子產生相同像素;512 像素 @ 256 spp 約需 0.5-1.8 秒);請參閱 references/07-3d.md。可列印網格:FW 3d mesh <formula|recipe> [--size-mm 60] [--res 200] [--engine auto|skimage|numpy] [--wall-mm 0.9] -o x.stl 在 NumPy 中對相同的 DE 進行取樣,並寫出一個水密實體為二進位 STL,單位為公釐(側邊 JSON:三角形、殼體、體積、時間;如果不是水密則退出碼 3)。Menger 預設為第 3 級以用於列印。--wall-mm X 對偏移曲面 DE = t(t = X/2,以列印比例計)進行網格化,使薄的部分朝 X 公釐增厚;0.9 清除了 Mandelbulb FDM 薄壁警告(2.7% -> 0.1% 低於 0.9 公釐)。多色:-o x.3mf(或 --colors N,預設 4,最多 8;--palette "#hex,...")還會寫出一個 3MF,根據軌道陷阱著色(等表面箱格,每個燈絲一個;Bambu Studio 和 PrusaSlicer 會讀取每個三角形的燈絲標籤)。然後執行 pw.py check x.stl --target print-fdm(polywright-print;它也會讀取 3MF)。
步驟 3:測量
FW measure box image.png [--invert] [--threshold T]:暗色(或亮色)像素的盒計數維度,使用 15 個以上的盒子大小和種子隨機偏移,並附有擬合範圍(以十的冪次為單位)、局部斜率曲線和判決。請照原樣傳遞判決:低於兩個十的冪次時為 "descriptor only";局部斜率漂移時為 "not fractal"。從 references/08-measuring.md 給出帶有誤差線的 D,絕不能作為精確值,也絕不能僅從 D 來命名形狀。FW measure lacunarity image.png:每個盒子大小的間隙度,是 D 旁邊的第二個數字(相同的 D 可能看起來不同)。FW measure ifs --ratios 0.5,0.5,0.5:相似維度;僅在碎片不重疊時才精確,否則為上限。- 高度輪廓和高度圖是自仿射的:
FW measure profile numbers.txt(譜斜率、半變異圖、Katz)和FW measure heightmap map.png|.npy(徑向譜,表面 D = 3 - H)。measure box會拒絕數字檔案。 FW measure katz curve.txt(x,y 或單一欄):一個粗略的粗糙度數字,不是 D。FW measure area --size 1024:透過像素計數的曼德博集合面積(在 1024 像素時,已被證明在 1.50659 的 0.0002 範圍內)。
步驟 4:辨識
FW identify <preset | recipe.json | image.png> [--c re,im]:手工特徵(像素的鏡像對稱性、茱莉亞集合從 0 的軌道判斷是連通的還是灰塵狀、c 的主心形線或週期-2 燈泡、該家族的已知對稱性)。圖片的盒維度僅作為描述符報告。切勿僅根據其維度來辨識碎形。
維護
儲存庫根目錄的單元檔案:evergreen.json、RESEARCH.md、CHANGELOG.md、LEARNINGS.md、TESTS.md。fractal-art 訊息源可觸發更新;harvest.json 列出收穫目標。