[{"data":1,"prerenderedAt":919},["ShallowReactive",2],{"header-article-translation-en-section-none":3,"wiki-en-preview-run-3D-preview":4,"wiki-tree-en":779},null,{"id":5,"title":6,"body":7,"category":763,"description":764,"extension":765,"locale":766,"meta":767,"navigation":768,"order":769,"path":770,"seo":771,"slug":772,"source":773,"stem":776,"updatedAt":777,"__hash__":778},"wiki\u002Fwiki\u002Fen\u002Fpreview-run\u002F3D-preview.md","3D Preview",{"type":8,"value":9,"toc":751},"minimark",[10,14,27,35,40,62,67,76,80,84,87,90,94,99,102,140,143,147,151,154,157,162,165,169,173,176,195,199,202,211,240,248,262,266,269,328,333,337,344,347,367,370,479,482,485,634,637,660,664,668,671,675,678,692,696,699,702,716,720,723,726,730,733],[11,12,13],"p",{},"Laetoly’s 3D Preview feature is designed to help users:",[15,16,17,21,24],"ul",{},[18,19,20],"li",{},"View the workpiece to be carved from a 3D perspective",[18,22,23],{},"Automatically generate toolpaths that match the workpiece",[18,25,26],{},"Provide an entry point to start the carving task",[11,28,29,30,34],{},"This feature supports path verification and parameter adjustment (see ",[31,32,33],"strong",{},"Preview Area"," later in this document), and offers an intuitive task simulation experience before machining.",[36,37,39],"h2",{"id":38},"️-generate-toolpath","✏️ Generate Toolpath",[11,41,42,43,48,49,53,54,57,58,61],{},"After completing the graphic design and parameter settings on the canvas (see ",[44,45,47],"a",{"href":46},"\u002Fzh\u002Fwiki\u002Fdesign\u002Fdrawing-tools","drawing-tools"," and ",[44,50,52],{"href":51},"\u002Fzh\u002Fwiki\u002Fdesign\u002Fimporting","importing","), click the ",[31,55,56],{},"Preview"," button in the top menu to enter the 3D preview interface. Then click the ",[31,59,60],{},"Generate Toolpath"," button, and the system will automatically calculate and generate the toolpath. As shown below:",[63,64],"figure",{"alt":65,"src":66},"3D preview before generating, with the Generate Toolpath button highlighted","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fgenerate-toolpath-v2.webp",[68,69,70],"blockquote",{},[11,71,72,73,75],{},"Note: If the user imports a G-code file into the canvas, the system will directly enter the 3D preview interface, and the ",[31,74,60],{}," button will not be available.",[63,77],{"alt":78,"src":79},"3D preview of a generated relief toolpath of a portrait, with Generate Toolpath highlighted","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fimport-gcode.webp",[36,81,83],{"id":82},"toolpath-simulation-and-3d-preview","🧊 Toolpath Simulation and 3D Preview",[11,85,86],{},"The 3D preview interface of Laetoly integrates key functions such as task monitoring, path simulation, model interaction, and parameter configuration, helping users fully understand the workflow and expected results before machining.",[11,88,89],{},"Overview of the interface:",[63,91],{"alt":92,"src":93},"Overview of the preview interface: state bar, control panels and material area","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Foverview-v2.webp",[95,96,98],"h3",{"id":97},"machine-information-area","🧩 Machine Information Area",[11,100,101],{},"Located at the top of the 3D preview interface, this area displays the real-time status of the device, allowing users to quickly confirm the machine’s condition before or during carving. Supported device states include:",[15,103,104,110,116,122,128,134],{},[18,105,106,109],{},[31,107,108],{},"DISCONNECTED",": Device not connected",[18,111,112,115],{},[31,113,114],{},"IDLE",": Device connected but idle",[18,117,118,121],{},[31,119,120],{},"RUN",": Device is executing a carving task",[18,123,124,127],{},[31,125,126],{},"JOG",": Device is in manual movement (JOG) mode",[18,129,130,133],{},[31,131,132],{},"HOLD",": Task paused, device in hold state",[18,135,136,139],{},[31,137,138],{},"ALARM",": Device triggered an alarm, error information needs to be checked",[11,141,142],{},"Example interface:",[63,144],{"alt":145,"src":146},"Machine information bar: state DISCONNECTED with work and machine positions","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Ftop-info.webp",[95,148,150],{"id":149},"control-panel-area","🧭 Control Panel Area",[11,152,153],{},"The control panel integrates the following modules:",[11,155,156],{},"| Module            |     Description |\n|-------------------|----------------|-------------|\n| Job Status        |       Displays task line count, remaining time, and elapsed time |\n| Machine Control   |       Controls path generation, task start, G-code export, and cancel |\n| Playback Control  |       Controls path animation playback, fast forward\u002Frewind, speed adjustment, and progress display |\n| Display Options   |       Sets path color schemes, switches between roughing and finishing display |",[158,159,161],"h4",{"id":160},"job-status-area","📊 Job Status Area",[11,163,164],{},"Displays the execution progress of the current carving task, including line count, remaining time, and elapsed time. Once the task starts, only the “Pause” and “Cancel” buttons are available; other operations are disabled.",[63,166],{"alt":167,"src":168},"Job status panel during a run: state RUN with line count, remaining and elapsed time","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Frun-v2.webp",[158,170,172],{"id":171},"️-machine-control-area","🛠️ Machine Control Area",[11,174,175],{},"Includes the following buttons:",[15,177,178,183,189],{},[18,179,180,182],{},[31,181,60],{},": Generate toolpath (disabled when the device is carving or Laetoly is not connected to the driver)",[18,184,185,188],{},[31,186,187],{},"Download G-code",": Download the generated G-code file (available only after successful path generation)",[18,190,191,194],{},[31,192,193],{},"Craft",": Start the carving task (requires both “path generated” and “device connected”)",[158,196,198],{"id":197},"️-playback-control-area","🎞️ Playback Control Area",[11,200,201],{},"Used to control the execution state of path animation or actual carving tasks, with two modes:",[11,203,204,207,210],{},[31,205,206],{},"Real-time Carving Mode",[208,209],"br",{},"\nOnly “Pause \u002F Resume” buttons are available, others are disabled:",[15,212,213,228],{},[18,214,215,216,220,221,223],{},"Pause carving: Device enters ",[217,218,219],"code",{},"Hold"," state",[208,222],{},[224,225],"img",{"alt":226,"src":227},"Playback controls with state HOLD and the resume button highlighted","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fhold-v2.webp",[18,229,230,231,233,234,236],{},"Resume carving: Release ",[217,232,219],{}," state and continue machining",[208,235],{},[224,237],{"alt":238,"src":239},"Playback controls with state RUN and the pause button highlighted","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fresume-v2.webp",[11,241,242,245,247],{},[31,243,244],{},"Simulation Preview Mode",[208,246],{},"\nThe following functions are available to control animation playback:",[15,249,250,253,256,259],{},[18,251,252],{},"Rewind \u002F Fast forward",[18,254,255],{},"Play \u002F Pause",[18,257,258],{},"Playback speed adjustment",[18,260,261],{},"Progress percentage display",[158,263,265],{"id":264},"display-options-area","🎨 Display Options Area",[11,267,268],{},"Used to adjust the visual style and display mode of toolpaths, including:",[15,270,271,297],{},[18,272,273,276,278,279,281,284,285,284,288,284,291,284,294],{},[31,274,275],{},"Path Color Scheme Switching",[208,277],{},"\nUsers can choose different path color schemes to improve visibility or adapt to different backgrounds. Options include:",[208,280],{},[217,282,283],{},"Default",", ",[217,286,287],{},"Blue-Orange",[217,289,290],{},"High Contrast",[217,292,293],{},"Neon",[217,295,296],{},"Industrial",[18,298,299,302,304,305,308,309,311,315,317,318,321,322,324],{},[31,300,301],{},"Machining Stage Path Switching",[208,303],{},"\nAfter successfully generating toolpaths, the system defaults to showing the ",[31,306,307],{},"roughing path",", as shown below:",[208,310],{},[224,312],{"alt":313,"src":314},"Display options with the Roughing Pass toggle highlighted, over a rough toolpath preview","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Frough-v2.webp",[208,316],{},"Clicking the switch button will change the display to the ",[31,319,320],{},"finishing path",":",[208,323],{},[224,325],{"alt":326,"src":327},"Display options with the Roughing Pass toggle highlighted, over a finishing toolpath preview","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Ffinish-v2.webp",[68,329,330],{},[11,331,332],{},"⚠️ Note: The roughing\u002Ffinishing switch button is only enabled if two tools were set during the design stage and two paths were successfully generated.",[95,334,336],{"id":335},"preview-area","🧱 Preview Area",[11,338,339,340,343],{},"In the preview area, ",[31,341,342],{},"Laetoly"," displays the workpiece and toolpaths, supporting both static viewing and dynamic animation, helping users fully understand the machining path before processing.",[11,345,346],{},"In 3D model mode, the system supports the following interactions:",[15,348,349,355,361],{},[18,350,351,354],{},[31,352,353],{},"Pan",": Hold the right mouse button and drag to adjust the view position",[18,356,357,360],{},[31,358,359],{},"Rotate",": Hold the left mouse button to rotate the model around the central axis",[18,362,363,366],{},[31,364,365],{},"Zoom",": Scroll the mouse wheel to zoom in or out for detail or overall view",[11,368,369],{},"To ensure carving quality, the right side of the preview area provides a set of parameter settings. Overview:",[371,372,373,389],"table",{},[374,375,376],"thead",{},[377,378,379,383,386],"tr",{},[380,381,382],"th",{},"Parameter Name",[380,384,385],{},"Description",[380,387,388],{},"Applicable Scene",[390,391,392,406,419,431,443,455,467],"tbody",{},[377,393,394,400,403],{},[395,396,397],"td",{},[31,398,399],{},"Material",[395,401,402],{},"Specify the visual or machining material of the model",[395,404,405],{},"2D & 3D",[377,407,408,413,416],{},[395,409,410],{},[31,411,412],{},"Download STL",[395,414,415],{},"Download STL file, available only after generating a model from a relief image",[395,417,418],{},"3D",[377,420,421,426,429],{},[395,422,423],{},[31,424,425],{},"Orientation",[395,427,428],{},"Set model rotation direction (Top, Front, Left, etc.)",[395,430,418],{},[377,432,433,438,441],{},[395,434,435],{},[31,436,437],{},"Position (mm)",[395,439,440],{},"Set model position coordinates (X\u002FY) in the material",[395,442,418],{},[377,444,445,450,453],{},[395,446,447],{},[31,448,449],{},"Size (mm)",[395,451,452],{},"Set model size (width, height)",[395,454,418],{},[377,456,457,462,465],{},[395,458,459],{},[31,460,461],{},"Frame Type",[395,463,464],{},"Specify border processing (Frameless or with tabs)",[395,466,418],{},[377,468,469,474,477],{},[395,470,471],{},[31,472,473],{},"Hide",[395,475,476],{},"Show or hide parameter panel for focused viewing",[395,478,405],{},[158,480,399],{"id":481},"material",[11,483,484],{},"Specifies the visual or machining material of the model. Options include:",[371,486,487,499],{},[374,488,489],{},[377,490,491,494,497],{},[380,492,493],{},"Category",[380,495,496],{},"Option Name",[380,498,385],{},[390,500,501,512,522,533,543,553,563,573,583,593,604,614,624],{},[377,502,503,506,509],{},[395,504,505],{},"Heightmap Schemes",[395,507,508],{},"HeightMap(Dark)",[395,510,511],{},"Dark tone height difference simulation",[377,513,514,516,519],{},[395,515],{},[395,517,518],{},"HeightMap(Rainbow)",[395,520,521],{},"Rainbow tone height difference simulation",[377,523,524,527,530],{},[395,525,526],{},"Wood Textures",[395,528,529],{},"Wheat",[395,531,532],{},"Light wheat wood texture",[377,534,535,537,540],{},[395,536],{},[395,538,539],{},"Light Oak",[395,541,542],{},"Light oak texture",[377,544,545,547,550],{},[395,546],{},[395,548,549],{},"Camel",[395,551,552],{},"Camel wood texture",[377,554,555,557,560],{},[395,556],{},[395,558,559],{},"Peru",[395,561,562],{},"Dark camel wood texture",[377,564,565,567,570],{},[395,566],{},[395,568,569],{},"Dark Oak",[395,571,572],{},"Dark oak texture",[377,574,575,577,580],{},[395,576],{},[395,578,579],{},"Saddle Brown",[395,581,582],{},"Saddle brown wood texture",[377,584,585,587,590],{},[395,586],{},[395,588,589],{},"Dark Walnut",[395,591,592],{},"Dark walnut texture",[377,594,595,598,601],{},[395,596,597],{},"Other Surface Textures",[395,599,600],{},"Leaf",[395,602,603],{},"Leaf texture",[377,605,606,608,611],{},[395,607],{},[395,609,610],{},"Leather",[395,612,613],{},"Leather texture",[377,615,616,618,621],{},[395,617],{},[395,619,620],{},"MDF",[395,622,623],{},"Medium-density fiberboard (recommended for carving)",[377,625,626,628,631],{},[395,627],{},[395,629,630],{},"Pine",[395,632,633],{},"Pine wood texture",[158,635,425],{"id":636},"orientation",[11,638,639,640,643,644,284,647,284,650,284,653,284,656,659],{},"Default is ",[217,641,642],{},"Top",", can be switched to ",[217,645,646],{},"Bottom",[217,648,649],{},"Left",[217,651,652],{},"Right",[217,654,655],{},"Front",[217,657,658],{},"Back"," to adjust the final carving effect.",[63,661],{"alt":662,"src":663},"Orientation setting highlighted on a relief portrait preview","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fstl-orientation-front.webp",[158,665,667],{"id":666},"position","Position",[11,669,670],{},"Adjusts the model’s position within the material.",[158,672,674],{"id":673},"size","Size",[11,676,677],{},"Sets the model’s width and height, e.g.:",[15,679,680,686],{},[18,681,682,683],{},"Position: ",[217,684,685],{},"X=20, Y=20",[18,687,688,689],{},"Size: ",[217,690,691],{},"Width=100, Height=100",[63,693],{"alt":694,"src":695},"Size setting with a leaf-shaped model and its bounding box","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fleaf-v2.webp",[158,697,461],{"id":698},"frame-type",[11,700,701],{},"Specifies border processing:",[15,703,704,710],{},[18,705,706,709],{},[217,707,708],{},"Frameless",": Completely cut out the border",[18,711,712,715],{},[217,713,714],{},"Cutout with tabs",": Automatically retain positioning tabs",[63,717],{"alt":718,"src":719},"Frame Type setting highlighted, with a cutout-with-tabs preview","\u002Fmedia\u002Fwiki\u002Fpreviewrun\u002Fcut-with-tabs-v2.webp",[158,721,473],{"id":722},"hide",[11,724,725],{},"Hides all current settings for focused viewing of the model or path.",[36,727,729],{"id":728},"export-g-code-file","📤 Export G-code File",[11,731,732],{},"After confirming the path is correct, export the task as a standard G-code file:",[15,734,735,741,748],{},[18,736,737,738,740],{},"Click the ",[31,739,187],{}," button",[18,742,743,744,747],{},"Supports saving as ",[217,745,746],{},".gcode"," format",[18,749,750],{},"The file can be executed directly in Laetoly or imported into the system for delayed machining.",{"title":752,"searchDepth":753,"depth":753,"links":754},"",2,[755,756,762],{"id":38,"depth":753,"text":39},{"id":82,"depth":753,"text":83,"children":757},[758,760,761],{"id":97,"depth":759,"text":98},3,{"id":149,"depth":759,"text":150},{"id":335,"depth":759,"text":336},{"id":728,"depth":753,"text":729},"preview-run","Preview the generated toolpath in 2D and 3D, read the machine and job status areas, and use the playback and display options.","md","en",{},true,10,"\u002Fwiki\u002Fen\u002Fpreview-run\u002F3d-preview",{"title":6,"description":764},"3D-preview",{"wikijsId":774,"wikijsPath":775},75,"preview-run\u002F3D-preview","wiki\u002Fen\u002Fpreview-run\u002F3D-preview","2026-09-14","WVtYrMn6LquhXWYtbz8-nvo15EZXseV7w01Vegtd3qI",[780,802,829,841,860,892],{"category":781,"pages":782},"getting-started",[783,787,792,797],{"title":784,"category":781,"slug":785,"order":769,"path":786},"Welcome to Laetoly","welcome-to-laetoly","\u002Fwiki\u002Fgetting-started\u002Fwelcome-to-laetoly",{"title":788,"category":781,"slug":789,"order":790,"path":791},"Driver Configuration","driver-setup",20,"\u002Fwiki\u002Fgetting-started\u002Fdriver-setup",{"title":793,"category":781,"slug":794,"order":795,"path":796},"Your First Project","your-first-project",30,"\u002Fwiki\u002Fgetting-started\u002Fyour-first-project",{"title":798,"category":781,"slug":799,"order":800,"path":801},"Video Tutorial","video-tutorial",40,"\u002Fwiki\u002Fgetting-started\u002Fvideo-tutorial",{"category":803,"pages":804},"design",[805,808,811,815,819,824],{"title":806,"category":803,"slug":52,"order":769,"path":807},"Importing","\u002Fwiki\u002Fdesign\u002Fimporting",{"title":809,"category":803,"slug":47,"order":790,"path":810},"Drawing Tools","\u002Fwiki\u002Fdesign\u002Fdrawing-tools",{"title":812,"category":803,"slug":813,"order":795,"path":814},"Editing & Transformation","editing-transformation","\u002Fwiki\u002Fdesign\u002Fediting-transformation",{"title":816,"category":803,"slug":817,"order":800,"path":818},"Properties","properties","\u002Fwiki\u002Fdesign\u002Fproperties",{"title":820,"category":803,"slug":821,"order":822,"path":823},"Libraries","libraries",50,"\u002Fwiki\u002Fdesign\u002Flibraries",{"title":825,"category":803,"slug":826,"order":827,"path":828},"Others","others",60,"\u002Fwiki\u002Fdesign\u002Fothers",{"category":763,"pages":830},[831,833,837],{"title":6,"category":763,"slug":772,"order":769,"path":832},"\u002Fwiki\u002Fpreview-run\u002F3D-preview",{"title":834,"category":763,"slug":835,"order":790,"path":836},"Running Jobs","running-jobs","\u002Fwiki\u002Fpreview-run\u002Frunning-jobs",{"title":838,"category":763,"slug":839,"order":795,"path":840},"Real-Time Monitoring","real-time-monitoring","\u002Fwiki\u002Fpreview-run\u002Freal-time-monitoring",{"category":842,"pages":843},"system-config",[844,848,852,856],{"title":845,"category":842,"slug":846,"order":769,"path":847},"Add Device","add-device","\u002Fwiki\u002Fsystem-config\u002Fadd-device",{"title":849,"category":842,"slug":850,"order":790,"path":851},"Settings","settings","\u002Fwiki\u002Fsystem-config\u002Fsettings",{"title":853,"category":842,"slug":854,"order":795,"path":855},"User Panel","user-panel","\u002Fwiki\u002Fsystem-config\u002Fuser-panel",{"title":857,"category":842,"slug":858,"order":800,"path":859},"G-code Console","g-code-console","\u002Fwiki\u002Fsystem-config\u002Fg-code-console",{"category":861,"pages":862},"faq",[863,867,871,875,879,883,887],{"title":864,"category":861,"slug":865,"order":769,"path":866},"Installation & Setup","installation_setup","\u002Fwiki\u002Ffaq\u002Finstallation_setup",{"title":868,"category":861,"slug":869,"order":790,"path":870},"Connection","connection","\u002Fwiki\u002Ffaq\u002Fconnection",{"title":872,"category":861,"slug":873,"order":795,"path":874},"Design & Files","design_files","\u002Fwiki\u002Ffaq\u002Fdesign_files",{"title":876,"category":861,"slug":877,"order":800,"path":878},"Toolpath & G-code","toolpath_g-code","\u002Fwiki\u002Ffaq\u002Ftoolpath_g-code",{"title":880,"category":861,"slug":881,"order":822,"path":882},"Engraving Quality","engraving_quality","\u002Fwiki\u002Ffaq\u002Fengraving_quality",{"title":884,"category":861,"slug":885,"order":827,"path":886},"Device Operation","device_operation","\u002Fwiki\u002Ffaq\u002Fdevice_operation",{"title":888,"category":861,"slug":889,"order":890,"path":891},"Safety Guidelines","safety_guidelines",70,"\u002Fwiki\u002Ffaq\u002Fsafety_guidelines",{"category":893,"pages":894},"appendix",[895,899,903,907,911,915],{"title":896,"category":893,"slug":897,"order":769,"path":898},"Download Center","download-center","\u002Fwiki\u002Fappendix\u002Fdownload-center",{"title":900,"category":893,"slug":901,"order":790,"path":902},"Release Notes","release-notes","\u002Fwiki\u002Fappendix\u002Frelease-notes",{"title":904,"category":893,"slug":905,"order":795,"path":906},"Glossary","glossary","\u002Fwiki\u002Fappendix\u002Fglossary",{"title":908,"category":893,"slug":909,"order":800,"path":910},"G-Code Commands","g-code-commands","\u002Fwiki\u002Fappendix\u002Fg-code-commands",{"title":912,"category":893,"slug":913,"order":822,"path":914},"Bit & Material Reference","bit-material-reference","\u002Fwiki\u002Fappendix\u002Fbit-material-reference",{"title":916,"category":893,"slug":917,"order":827,"path":918},"Credit System Guide","credit-system-guide","\u002Fwiki\u002Fappendix\u002Fcredit-system-guide",1792396296081]