[{"data":1,"prerenderedAt":975},["ShallowReactive",2],{"header-article-translation-zh-section-none":3,"wiki-zh-preview-run-3D-preview":4,"wiki-tree-zh":835},null,{"id":5,"title":6,"body":7,"category":819,"description":820,"extension":821,"locale":822,"meta":823,"navigation":824,"order":825,"path":826,"seo":827,"slug":828,"source":829,"stem":832,"updatedAt":833,"__hash__":834},"wiki\u002Fwiki\u002Fzh\u002Fpreview-run\u002F3D-preview.md","3D 预览",{"type":8,"value":9,"toc":807},"minimark",[10,14,27,35,40,62,67,76,80,84,87,90,94,99,102,140,143,147,151,154,221,225,228,232,236,239,258,262,265,274,303,311,325,328,331,388,393,396,403,406,426,429,531,534,537,687,691,714,718,722,725,729,732,746,750,754,757,771,775,779,782,786,789],[11,12,13],"p",{},"Laetoly 的 3D 预览功能旨在帮助用户：",[15,16,17,21,24],"ul",{},[18,19,20],"li",{},"以三维视角查看待雕刻的作品",[18,22,23],{},"自动生成与作品匹配的刀具路径",[18,25,26],{},"提供雕刻任务的启动入口",[11,28,29,30,34],{},"该功能支持路径验证与参数调整（详见本文后续",[31,32,33],"strong",{},"预览区域","），并在加工前提供直观的任务模拟体验。",[36,37,39],"h2",{"id":38},"️-生成刀具路径","✏️ 生成刀具路径",[11,41,42,43,48,49,53,54,57,58,61],{},"当用户在画布中完成图形设计与参数设置后（详见",[44,45,47],"a",{"href":46},"\u002Fzh\u002Fwiki\u002Fdesign\u002Fdrawing-tools","绘图工具","，",[44,50,52],{"href":51},"\u002Fzh\u002Fwiki\u002Fdesign\u002Fimporting","导入","），可点击顶部菜单中的 ",[31,55,56],{},"Preview"," 按钮进入三维预览界面。随后\n点击 ",[31,59,60],{},"Generate Toolpath"," 按钮，系统将自动计算并生成刀具路径。如下图所示：",[63,64],"figure",{"alt":65,"src":66},"生成前的 3D 预览，Generate Toolpath 按钮被红框标出","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fgenerate-toolpath-v2.webp",[68,69,70],"blockquote",{},[11,71,72,73,75],{},"注意：若用户在画布中导入 G-code 文件，将直接进入 3D 预览界面，此时无法点击 ",[31,74,60],{}," 按钮。",[63,77],{"alt":78,"src":79},"已生成的人像浮雕刀路 3D 预览，Generate Toolpath 被红框标出","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fimport-gcode.webp",[36,81,83],{"id":82},"刀具路径模拟与-3d-预览","🧊 刀具路径模拟与 3D 预览",[11,85,86],{},"Laetoly 的 3D 预览界面融合了任务监控、路径模拟、模型交互与参数配置等关键功能，帮助用户在加工前全面掌握任务流程与预期效果。",[11,88,89],{},"界面总览如下：",[63,91],{"alt":92,"src":93},"预览界面总览：状态栏、控制面板和材料区域","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Foverview-v2.webp",[95,96,98],"h3",{"id":97},"机器信息区","🧩 机器信息区",[11,100,101],{},"该区域位于 3D 预览界面顶部，用于展示设备的实时状态，便于用户在雕刻前或加工过程中快速确认设备运行情况。当前支持的设备状态包括：",[15,103,104,110,116,122,128,134],{},[18,105,106,109],{},[31,107,108],{},"DISCONNECTED","：未连接设备",[18,111,112,115],{},[31,113,114],{},"IDLE","：设备已连接但处于空闲状态",[18,117,118,121],{},[31,119,120],{},"RUN","：设备正在执行雕刻任务",[18,123,124,127],{},[31,125,126],{},"JOG","：设备处于手动移动（JOG）模式",[18,129,130,133],{},[31,131,132],{},"HOLD","：任务暂停，设备处于保持状态",[18,135,136,139],{},[31,137,138],{},"ALARM","：设备触发报警，需检查错误信息",[11,141,142],{},"界面示意如下：",[63,144],{"alt":145,"src":146},"机器信息栏：状态 DISCONNECTED，以及工件坐标和机器坐标","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Ftop-info.webp",[95,148,150],{"id":149},"控制面板区","🧭 控制面板区",[11,152,153],{},"控制面板集成以下功能模块：",[155,156,157,173],"table",{},[158,159,160],"thead",{},[161,162,163,167,170],"tr",{},[164,165,166],"th",{},"功能模块",[164,168,169],{},"中文术语",[164,171,172],{},"功能说明",[174,175,176,188,199,210],"tbody",{},[161,177,178,182,185],{},[179,180,181],"td",{},"Job Status",[179,183,184],{},"任务状态区",[179,186,187],{},"显示任务行数、剩余时间与已用时间",[161,189,190,193,196],{},[179,191,192],{},"Machine Control",[179,194,195],{},"加工控制区",[179,197,198],{},"控制路径生成、任务启动、G-code 导出与取消",[161,200,201,204,207],{},[179,202,203],{},"Playback Control",[179,205,206],{},"播放控制区",[179,208,209],{},"控制路径动画播放、快进\u002F快退、速度调节与进度显示",[161,211,212,215,218],{},[179,213,214],{},"Display Options",[179,216,217],{},"显示选项区",[179,219,220],{},"设置路径颜色方案，切换粗加工与精加工显示",[222,223,224],"h4",{"id":184},"📊 任务状态区",[11,226,227],{},"用于展示当前雕刻任务的执行进度，包括行数、剩余时间与已用时间。任务开始后，仅“暂停”与“取消”按钮可用，其余操作将被禁用。",[63,229],{"alt":230,"src":231},"运行中的任务状态面板：状态 RUN，显示行数、剩余时间和已用时间","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Frun-v2.webp",[222,233,235],{"id":234},"️-加工控制区","🛠️ 加工控制区",[11,237,238],{},"包含以下操作按钮：",[15,240,241,246,252],{},[18,242,243,245],{},[31,244,60],{},"：生成刀具路径（当设备处于雕刻中或Laetoly未连接到驱动程序时禁用）",[18,247,248,251],{},[31,249,250],{},"Download G-code","：下载已生成的 G-code 文件（仅在路径生成成功后可用）",[18,253,254,257],{},[31,255,256],{},"Craft","：启动雕刻任务（需满足“已生成路径”且“设备已连接”）",[222,259,261],{"id":260},"️-播放控制区","🎞️ 播放控制区",[11,263,264],{},"用于控制路径动画或实际雕刻任务的执行状态，分为两种模式：",[11,266,267,270,273],{},[31,268,269],{},"实时雕刻模式",[271,272],"br",{},"\n仅“暂停 \u002F 恢复”按钮可用，其余操作禁用：",[15,275,276,291],{},[18,277,278,279,283,284,286],{},"暂停雕刻：设备进入 ",[280,281,282],"code",{},"Hold"," 状态",[271,285],{},[287,288],"img",{"alt":289,"src":290},"播放控制区：状态 HOLD，继续按钮被红框标出","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fhold-v2.webp",[18,292,293,294,296,297,299],{},"恢复雕刻：解除 ",[280,295,282],{}," 状态，继续加工",[271,298],{},[287,300],{"alt":301,"src":302},"播放控制区：状态 RUN，暂停按钮被红框标出","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fresume-v2.webp",[11,304,305,308,310],{},[31,306,307],{},"模拟预览模式",[271,309],{},"\n可使用以下功能控制动画播放：",[15,312,313,316,319,322],{},[18,314,315],{},"快退 \u002F 快进",[18,317,318],{},"播放 \u002F 暂停",[18,320,321],{},"播放速度调节",[18,323,324],{},"进度百分比显示",[222,326,327],{"id":217},"🎨 显示选项区",[11,329,330],{},"显示选项区用于调整刀路路径的视觉样式与展示模式，包括以下两项功能：",[15,332,333,359],{},[18,334,335,338,340,341,343,346,347,346,350,346,353,346,356],{},[31,336,337],{},"路径颜色方案切换",[271,339],{},"\n用户可选择不同的路径配色方案，以提升可视性或适配不同背景环境。可选方案包括：",[271,342],{},[280,344,345],{},"Default","、",[280,348,349],{},"Blue-Orange",[280,351,352],{},"High Contrast",[280,354,355],{},"Neon",[280,357,358],{},"Industrial",[18,360,361,364,366,367,370,371,373,377,379,380,383,384],{},[31,362,363],{},"加工阶段路径切换",[271,365],{},"\n在成功生成刀路路径后，系统默认展示的是",[31,368,369],{},"粗加工路径","，如下图所示：",[271,372],{},[287,374],{"alt":375,"src":376},"显示选项：Roughing Pass 开关被红框标出，下方是粗加工刀路预览","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Frough-v2.webp",[271,378],{},"点击切换按钮后，即可切换显示为",[31,381,382],{},"精加工路径","：\n",[287,385],{"alt":386,"src":387},"显示选项：Roughing Pass 开关被红框标出，下方是精加工刀路预览","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Ffinish-v2.webp",[68,389,390],{},[11,391,392],{},"⚠️ 注意：粗加工与精加工切换按钮仅在设计阶段为雕刻作品设置了两把刀具，且已成功生成两遍路径后才可启用。",[95,394,395],{"id":33},"🧱 预览区域",[11,397,398,399,402],{},"在预览区域，",[31,400,401],{},"Laetoly"," 用于展示雕刻作品与刀路路径，支持静态查看与动态动画两种模式，帮助用户在加工前全面掌握加工路径。",[11,404,405],{},"在三维模型模式下，系统支持以下交互操作：",[15,407,408,414,420],{},[18,409,410,413],{},[31,411,412],{},"平移","：按住鼠标右键拖动模型，调整视角位置",[18,415,416,419],{},[31,417,418],{},"旋转","：按住鼠标左键围绕中心轴旋转模型，观察不同角度",[18,421,422,425],{},[31,423,424],{},"缩放","：滑动鼠标滚轮放大或缩小模型，便于查看细节或整体布局",[11,427,428],{},"为确保雕刻效果，预览区域右侧提供一系列参数设置项。以下为参数总览（各项功能详见后续章节）：",[155,430,431,443],{},[158,432,433],{},[161,434,435,438,440],{},[164,436,437],{},"参数名称",[164,439,172],{},[164,441,442],{},"适用场景",[174,444,445,458,471,483,495,507,519],{},[161,446,447,452,455],{},[179,448,449],{},[31,450,451],{},"Material（材料类型）",[179,453,454],{},"指定模型的视觉材质或加工材质",[179,456,457],{},"二维与三维",[161,459,460,465,468],{},[179,461,462],{},[31,463,464],{},"Download STL",[179,466,467],{},"下载 STL 文件，仅在通过浮雕图片生成模型后可用（详见后续章节）",[179,469,470],{},"三维",[161,472,473,478,481],{},[179,474,475],{},[31,476,477],{},"Orientation",[179,479,480],{},"设置模型旋转方向（如 Top、Front、Left 等）",[179,482,470],{},[161,484,485,490,493],{},[179,486,487],{},[31,488,489],{},"Position (mm)",[179,491,492],{},"设置模型在材料中的位置坐标（X\u002FY）",[179,494,470],{},[161,496,497,502,505],{},[179,498,499],{},[31,500,501],{},"Size (mm)",[179,503,504],{},"设置模型尺寸（宽度、高度）",[179,506,470],{},[161,508,509,514,517],{},[179,510,511],{},[31,512,513],{},"Frame Type",[179,515,516],{},"指定边框处理方式（如 Frameless 或带定位 tab）",[179,518,470],{},[161,520,521,526,529],{},[179,522,523],{},[31,524,525],{},"Hide",[179,527,528],{},"显示或隐藏参数设置面板，便于专注查看模型或路径",[179,530,457],{},[222,532,451],{"id":533},"material材料类型",[11,535,536],{},"用于指定模型的视觉材质或加工材质。下方为可选项一览：",[155,538,539,552],{},[158,540,541],{},[161,542,543,546,549],{},[164,544,545],{},"分组类别",[164,547,548],{},"选项名称",[164,550,551],{},"说明",[174,553,554,565,575,586,596,606,616,626,636,646,657,667,677],{},[161,555,556,559,562],{},[179,557,558],{},"高度图配色方案",[179,560,561],{},"HeightMap(Dark)",[179,563,564],{},"暗色调高低差模拟效果",[161,566,567,569,572],{},[179,568],{},[179,570,571],{},"HeightMap(Rainbow)",[179,573,574],{},"彩虹色高低差模拟效果",[161,576,577,580,583],{},[179,578,579],{},"木材色系",[179,581,582],{},"Wheat",[179,584,585],{},"浅麦色木纹材质",[161,587,588,590,593],{},[179,589],{},[179,591,592],{},"Light Oak",[179,594,595],{},"浅色橡木纹理",[161,597,598,600,603],{},[179,599],{},[179,601,602],{},"Camel",[179,604,605],{},"驼色木纹",[161,607,608,610,613],{},[179,609],{},[179,611,612],{},"Peru",[179,614,615],{},"深驼色木纹",[161,617,618,620,623],{},[179,619],{},[179,621,622],{},"Dark Oak",[179,624,625],{},"深色橡木纹理",[161,627,628,630,633],{},[179,629],{},[179,631,632],{},"Saddle Brown",[179,634,635],{},"鞍棕色木纹",[161,637,638,640,643],{},[179,639],{},[179,641,642],{},"Dark Walnut",[179,644,645],{},"深胡桃木纹理",[161,647,648,651,654],{},[179,649,650],{},"其他表面材质",[179,652,653],{},"Leaf",[179,655,656],{},"叶片纹理材质",[161,658,659,661,664],{},[179,660],{},[179,662,663],{},"Leather",[179,665,666],{},"皮革质感材质",[161,668,669,671,674],{},[179,670],{},[179,672,673],{},"MDF",[179,675,676],{},"中密度纤维板（推荐用于雕刻）",[161,678,679,681,684],{},[179,680],{},[179,682,683],{},"Pine",[179,685,686],{},"松木材质",[222,688,690],{"id":689},"orientation模型旋转方向","Orientation（模型旋转方向）",[11,692,693,694,697,698,346,701,346,704,346,707,346,710,713],{},"默认为 ",[280,695,696],{},"Top","，可切换至 ",[280,699,700],{},"Bottom",[280,702,703],{},"Left",[280,705,706],{},"Right",[280,708,709],{},"Front",[280,711,712],{},"Back","，用于调整模型最终的雕刻效果，如下界面所示：",[63,715],{"alt":716,"src":717},"浮雕人像预览，Orientation 设置被红框标出","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fstl-orientation-front.webp",[222,719,721],{"id":720},"position位置坐标","Position（位置坐标）",[11,723,724],{},"用于调整模型在材料中的位置。",[222,726,728],{"id":727},"size尺寸大小","Size（尺寸大小）",[11,730,731],{},"用于设置模型的宽度与高度，例如：",[15,733,734,740],{},[18,735,736,737],{},"Position：",[280,738,739],{},"X=20, Y=20",[18,741,742,743],{},"Size：",[280,744,745],{},"Width=100, Height=100",[63,747],{"alt":748,"src":749},"Size 设置：叶片形模型及其外框","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fleaf-v2.webp",[222,751,753],{"id":752},"frame-type边框类型","Frame Type（边框类型）",[11,755,756],{},"用于指定边框处理方式：",[15,758,759,765],{},[18,760,761,764],{},[280,762,763],{},"Frameless","：完全切割边框",[18,766,767,770],{},[280,768,769],{},"Cutout with tabs","：自动保留若干定位 tab",[63,772],{"alt":773,"src":774},"Frame Type 设置被红框标出，预览为带连接桥的切出","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fcut-with-tabs-v2.webp",[222,776,778],{"id":777},"hide隐藏设置项","Hide（隐藏设置项）",[11,780,781],{},"用于隐藏当前所有设置项，便于专注查看模型或路径。",[36,783,785],{"id":784},"导出-g-code-文件","📤 导出 G-code 文件",[11,787,788],{},"确认路径无误后，可将任务导出为标准 G-code 文件：",[15,790,791,797,804],{},[18,792,793,794,796],{},"点击 ",[31,795,250],{}," 按钮",[18,798,799,800,803],{},"支持保存为 ",[280,801,802],{},".gcode"," 格式",[18,805,806],{},"文件可用于 Laetoly 内直接执行，或导入系统用于延迟加工。",{"title":808,"searchDepth":809,"depth":809,"links":810},"",2,[811,812,818],{"id":38,"depth":809,"text":39},{"id":82,"depth":809,"text":83,"children":813},[814,816,817],{"id":97,"depth":815,"text":98},3,{"id":149,"depth":815,"text":150},{"id":33,"depth":815,"text":395},{"id":784,"depth":809,"text":785},"preview-run","在 2D 和 3D 中预览生成的刀路，查看机器和任务状态区域，并使用播放和显示选项。","md","zh",{},true,10,"\u002Fwiki\u002Fzh\u002Fpreview-run\u002F3d-preview",{"title":6,"description":820},"3D-preview",{"wikijsId":830,"wikijsPath":831},49,"preview-run\u002F3D-preview","wiki\u002Fzh\u002Fpreview-run\u002F3D-preview","2026-09-14","fEvOO-93t-JG9oRBhPPH3y6YdKJWCiwNutY5rOqV53I",[836,858,885,897,916,948],{"category":837,"pages":838},"getting-started",[839,843,848,853],{"title":840,"category":837,"slug":841,"order":825,"path":842},"欢迎使用 Laetoly","welcome-to-laetoly","\u002Fwiki\u002Fgetting-started\u002Fwelcome-to-laetoly",{"title":844,"category":837,"slug":845,"order":846,"path":847},"驱动程序配置","driver-setup",20,"\u002Fwiki\u002Fgetting-started\u002Fdriver-setup",{"title":849,"category":837,"slug":850,"order":851,"path":852},"你的第一个项目","your-first-project",30,"\u002Fwiki\u002Fgetting-started\u002Fyour-first-project",{"title":854,"category":837,"slug":855,"order":856,"path":857},"视频教程","video-tutorial",40,"\u002Fwiki\u002Fgetting-started\u002Fvideo-tutorial",{"category":859,"pages":860},"design",[861,864,867,871,875,880],{"title":52,"category":859,"slug":862,"order":825,"path":863},"importing","\u002Fwiki\u002Fdesign\u002Fimporting",{"title":47,"category":859,"slug":865,"order":846,"path":866},"drawing-tools","\u002Fwiki\u002Fdesign\u002Fdrawing-tools",{"title":868,"category":859,"slug":869,"order":851,"path":870},"编辑与变换","editing-transformation","\u002Fwiki\u002Fdesign\u002Fediting-transformation",{"title":872,"category":859,"slug":873,"order":856,"path":874},"属性面板","properties","\u002Fwiki\u002Fdesign\u002Fproperties",{"title":876,"category":859,"slug":877,"order":878,"path":879},"设计库","libraries",50,"\u002Fwiki\u002Fdesign\u002Flibraries",{"title":881,"category":859,"slug":882,"order":883,"path":884},"其他","others",60,"\u002Fwiki\u002Fdesign\u002Fothers",{"category":819,"pages":886},[887,889,893],{"title":6,"category":819,"slug":828,"order":825,"path":888},"\u002Fwiki\u002Fpreview-run\u002F3D-preview",{"title":890,"category":819,"slug":891,"order":846,"path":892},"运行加工任务","running-jobs","\u002Fwiki\u002Fpreview-run\u002Frunning-jobs",{"title":894,"category":819,"slug":895,"order":851,"path":896},"实时监控","real-time-monitoring","\u002Fwiki\u002Fpreview-run\u002Freal-time-monitoring",{"category":898,"pages":899},"system-config",[900,904,908,912],{"title":901,"category":898,"slug":902,"order":825,"path":903},"添加设备","add-device","\u002Fwiki\u002Fsystem-config\u002Fadd-device",{"title":905,"category":898,"slug":906,"order":846,"path":907},"设置","settings","\u002Fwiki\u002Fsystem-config\u002Fsettings",{"title":909,"category":898,"slug":910,"order":851,"path":911},"用户中心","user-panel","\u002Fwiki\u002Fsystem-config\u002Fuser-panel",{"title":913,"category":898,"slug":914,"order":856,"path":915},"G-code 控制台","g-code-console","\u002Fwiki\u002Fsystem-config\u002Fg-code-console",{"category":917,"pages":918},"faq",[919,923,927,931,935,939,943],{"title":920,"category":917,"slug":921,"order":825,"path":922},"安装与设置","installation_setup","\u002Fwiki\u002Ffaq\u002Finstallation_setup",{"title":924,"category":917,"slug":925,"order":846,"path":926},"连接设备","connection","\u002Fwiki\u002Ffaq\u002Fconnection",{"title":928,"category":917,"slug":929,"order":851,"path":930},"设计与文件","design_files","\u002Fwiki\u002Ffaq\u002Fdesign_files",{"title":932,"category":917,"slug":933,"order":856,"path":934},"刀路与 G-code","toolpath_g-code","\u002Fwiki\u002Ffaq\u002Ftoolpath_g-code",{"title":936,"category":917,"slug":937,"order":878,"path":938},"切削质量问题","engraving_quality","\u002Fwiki\u002Ffaq\u002Fengraving_quality",{"title":940,"category":917,"slug":941,"order":883,"path":942},"机器操作","device_operation","\u002Fwiki\u002Ffaq\u002Fdevice_operation",{"title":944,"category":917,"slug":945,"order":946,"path":947},"安全操作","safety_guidelines",70,"\u002Fwiki\u002Ffaq\u002Fsafety_guidelines",{"category":949,"pages":950},"appendix",[951,955,959,963,967,971],{"title":952,"category":949,"slug":953,"order":825,"path":954},"下载中心","download-center","\u002Fwiki\u002Fappendix\u002Fdownload-center",{"title":956,"category":949,"slug":957,"order":846,"path":958},"版本发布说明","release-notes","\u002Fwiki\u002Fappendix\u002Frelease-notes",{"title":960,"category":949,"slug":961,"order":851,"path":962},"术语表","glossary","\u002Fwiki\u002Fappendix\u002Fglossary",{"title":964,"category":949,"slug":965,"order":856,"path":966},"G-code 命令表","g-code-commands","\u002Fwiki\u002Fappendix\u002Fg-code-commands",{"title":968,"category":949,"slug":969,"order":878,"path":970},"刀具与材料参考","bit-material-reference","\u002Fwiki\u002Fappendix\u002Fbit-material-reference",{"title":972,"category":949,"slug":973,"order":883,"path":974},"积分指南","credit-system-guide","\u002Fwiki\u002Fappendix\u002Fcredit-system-guide",1792396297075]