深海游弋的鱼 – 默默的点滴

解决OpenSCAD导出的WRL格式文件不正确的问题

前置条件

macOS Sequoia (15.2)
MacBook Pro 2023-Apple M2 Pro （4能效核、8性能核、32GB内存、2TB磁盘）
OpenSCAD 2025.02.03 (或更高版本)
FreeCAD 1.0.0 (或更高版本)
KiCad 8.0.8 (或更高版本)
MeshLab 2023.12 (或更高版本)
Wings 3D 2.4.1 (或更高版本)

问题描述

在文章 KiCad-V8.0.8 制作收音机中周（中频变压器）封装 中，我们讨论了如何借助 OpenSCAD 2024.12.13 创建 KiCAD 需要的器件 3D 模型 的过程。

接下来，由于 PCB 板大小的限制，我们需要对部分电阻进行垂直安装，以节约 PCB 面积。可是 KiCAD 自带的电阻 3D模型 都是水平放置的，没有相关的垂直放置模型。这样就迫使我们必须创建电阻的自定义3D模型。

于是我们通过借助 NopSCADlib 绘制电阻的垂直封装，具体代码如下：

// 直插电阻
include <NopSCADlib/lib.scad>

ax_res(res1_2, 20000, 1, inch(0.2));

// 直插电阻

include <NopSCADlib/lib.scad>

ax_res(res1_2, 20000, 1, inch(0.2));

渲染效果如下图：

问题现象

当我们使用 FreeCAD 导入这个模型的时候，会发生如下报错：

23:07:20  opening /var/folders/z8/_cvsdvbd4x51vm4szw5xkw0w0000gn/T/fc-33837-764042-000048.dxf...
23:07:20  drawing 1 polylines...
23:07:20  skipping texts...
23:07:20  skipping dimensions...
23:07:20  skipping points...
23:07:20  skipping leaders...
23:07:20  skipping hatches...
23:07:20  skipping *blocks...
23:07:20  done processing
23:07:20  successfully imported /var/folders/z8/_cvsdvbd4x51vm4szw5xkw0w0000gn/T/fc-33837-764042-000048.dxf
23:07:20  <Exception> makeOffset2D: offset result has no wires.
23:07:20  Offset2D001: makeOffset2D: offset result has no wires.
23:07:20  <Exception> makeOffset2D: offset result has no wires.
23:07:20  Recompute failed : Offset2D001
23:07:20  pyException: Traceback (most recent call last):
  File "<string>", line 2, in <module>
  File "/Applications/FreeCAD.app/Contents/Resources/lib/python3.11/site-packages/freecad/module_io.py", line 16, in OpenInsertObject
    getattr(importerModule, importMethod)(objectPath, *importArgs, **importKwargs)
  File "/Applications/FreeCAD.app/Contents/Resources/Mod/OpenSCAD/importCSG.py", line 120, in open
    processcsg(tmpfile)
  File "/Applications/FreeCAD.app/Contents/Resources/Mod/OpenSCAD/importCSG.py", line 178, in processcsg
    result = parser.parse(f.read())
             ^^^^^^^^^^^^^^^^^^^^^^
  File "/Applications/FreeCAD.app/Contents/Resources/lib/python3.11/site-packages/ply/yacc.py", line 333, in parse
    return self.parseopt_notrack(input, lexer, debug, tracking, tokenfunc)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Applications/FreeCAD.app/Contents/Resources/lib/python3.11/site-packages/ply/yacc.py", line 1120, in parseopt_notrack
    p.callable(pslice)
  File "/Applications/FreeCAD.app/Contents/Resources/Mod/OpenSCAD/importCSG.py", line 457, in p_offset_action
    if subobj.Shape.Volume == 0 :
       ^^^^^^^^^^^^^^^^^^^
<class 'RuntimeError'>: shape is invalid

23:07:20 opening /var/folders/z8/_cvsdvbd4x51vm4szw5xkw0w0000gn/T/fc-33837-764042-000048.dxf...

23:07:20 drawing 1 polylines...

23:07:20 skipping texts...

23:07:20 skipping dimensions...

23:07:20 skipping points...

23:07:20 skipping leaders...

23:07:20 skipping hatches...

23:07:20 skipping *blocks...

23:07:20 done processing

23:07:20 successfully imported /var/folders/z8/_cvsdvbd4x51vm4szw5xkw0w0000gn/T/fc-33837-764042-000048.dxf

23:07:20 <Exception> makeOffset2D: offset result has no wires.

23:07:20 Offset2D001: makeOffset2D: offset result has no wires.

23:07:20 <Exception> makeOffset2D: offset result has no wires.

23:07:20 Recompute failed : Offset2D001

23:07:20 pyException: Traceback (most recent call last):

File "<string>", line 2, in <module>

File "/Applications/FreeCAD.app/Contents/Resources/lib/python3.11/site-packages/freecad/module_io.py", line 16, in OpenInsertObject

getattr(importerModule, importMethod)(objectPath, *importArgs, **importKwargs)

File "/Applications/FreeCAD.app/Contents/Resources/Mod/OpenSCAD/importCSG.py", line 120, in open

processcsg(tmpfile)

File "/Applications/FreeCAD.app/Contents/Resources/Mod/OpenSCAD/importCSG.py", line 178, in processcsg

result = parser.parse(f.read())

^^^^^^^^^^^^^^^^^^^^^^

File "/Applications/FreeCAD.app/Contents/Resources/lib/python3.11/site-packages/ply/yacc.py", line 333, in parse

return self.parseopt_notrack(input, lexer, debug, tracking, tokenfunc)

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

File "/Applications/FreeCAD.app/Contents/Resources/lib/python3.11/site-packages/ply/yacc.py", line 1120, in parseopt_notrack

p.callable(pslice)

File "/Applications/FreeCAD.app/Contents/Resources/Mod/OpenSCAD/importCSG.py", line 457, in p_offset_action

if subobj.Shape.Volume == 0 :

^^^^^^^^^^^^^^^^^^^

<class 'RuntimeError'>: shape is invalid

继续阅读解决OpenSCAD导出的WRL格式文件不正确的问题

OpenSCAD输入某些字符导致应用闪退问题分析定位（QScintilla）

前置条件

macOS Sequoia (15.2)
MacBook Pro 2023-Apple M2 Pro （4能效核、8性能核、32GB内存、2TB磁盘）
OpenSCAD 2024.12.13 (或更高版本)
QScintilla 2.14.1
Xcode 16.2

问题现象

输入法切换到 “简体拼音”，然后按下自带键盘上的左侧 Shift 与 - 按键，目的是按出下划线，会导致 OpenSCAD 闪退，崩溃堆栈如下：

-------------------------------------
Translated Report (Full Report Below)
-------------------------------------

Process:               OpenSCAD [87606]
Path:                  /Applications/OpenSCAD.app/Contents/MacOS/OpenSCAD
Identifier:            org.openscad.OpenSCAD
Version:               2024.12 (2024.12.30)
Code Type:             ARM-64 (Native)
Parent Process:        launchd [1]
User ID:               501

Date/Time:             2025-01-07 10:43:50.0163 +0800
OS Version:            macOS 15.2 (24C101)
Report Version:        12
Anonymous UUID:        XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Sleep/Wake UUID:       XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Time Awake Since Boot: 1700000 seconds
Time Since Wake:       5033 seconds

System Integrity Protection: enabled

Crashed Thread:        0  Dispatch queue: com.apple.main-thread

Exception Type:        EXC_CRASH (SIGABRT)
Exception Codes:       0x0000000000000000, 0x0000000000000000

Termination Reason:    Namespace SIGNAL, Code 6 Abort trap: 6
Terminating Process:   OpenSCAD [87606]

Application Specific Information:
abort() called


Thread 0 Crashed::  Dispatch queue: com.apple.main-thread
0   libsystem_kernel.dylib        	       0x18fec7720 __pthread_kill + 8
1   libsystem_pthread.dylib       	       0x18fefff70 pthread_kill + 288
2   libsystem_c.dylib             	       0x18fe0c908 abort + 128
3   libc++abi.dylib               	       0x18feb644c abort_message + 132
4   libc++abi.dylib               	       0x18fea4a24 demangling_terminate_handler() + 320
5   libobjc.A.dylib               	       0x18fb4d3f4 _objc_terminate() + 172
6   libc++abi.dylib               	       0x18feb5710 std::__terminate(void (*)()) + 16
7   libc++abi.dylib               	       0x18feb8cdc __cxxabiv1::failed_throw(__cxxabiv1::__cxa_exception*) + 88
8   libc++abi.dylib               	       0x18feb8c84 __cxa_throw + 92
9   libqscintilla2_qt6.15.dylib   	       0x1025f20f8 0x10245c000 + 1663224
10  libqscintilla2_qt6.15.dylib   	       0x1025bb4e8 0x10245c000 + 1438952
11  libqscintilla2_qt6.15.dylib   	       0x1025ed018 0x10245c000 + 1642520
12  libqscintilla2_qt6.15.dylib   	       0x10246f358 QsciScintillaBase::keyPressEvent(QKeyEvent*) + 448
13  QtWidgets                     	       0x1039d17d8 QWidget::event(QEvent*) + 556
14  QtWidgets                     	       0x103a4f780 QFrame::event(QEvent*) + 56
15  QtWidgets                     	       0x103988c58 QApplicationPrivate::notify_helper(QObject*, QEvent*) + 272
16  QtWidgets                     	       0x103989cec QApplication::notify(QObject*, QEvent*) + 972
17  OpenSCAD                      	       0x100a85440 OpenSCADApp::notify(QObject*, QEvent*) + 28
18  QtCore                        	       0x104dd124c QCoreApplication::notifyInternal2(QObject*, QEvent*) + 292
19  QtWidgets                     	       0x1039e43a0 QWidgetWindow::event(QEvent*) + 168
20  QtWidgets                     	       0x103988c58 QApplicationPrivate::notify_helper(QObject*, QEvent*) + 272
21  QtWidgets                     	       0x103989af8 QApplication::notify(QObject*, QEvent*) + 472
22  OpenSCAD                      	       0x100a85440 OpenSCADApp::notify(QObject*, QEvent*) + 28
23  QtCore                        	       0x104dd124c QCoreApplication::notifyInternal2(QObject*, QEvent*) + 292
24  QtGui                         	       0x102e1b110 QGuiApplicationPrivate::processKeyEvent(QWindowSystemInterfacePrivate::KeyEvent*) + 260
25  QtGui                         	       0x102e70c24 QWindowSystemInterface::sendWindowSystemEvents(QFlags<QEventLoop::ProcessEventsFlag>) + 396
26  QtGui                         	       0x102e70810 QWindowSystemInterface::flushWindowSystemEvents(QFlags<QEventLoop::ProcessEventsFlag>) + 284
27  libqcocoa.dylib               	       0x1038446d4 -[QNSView(Keys) handleKeyEvent:] + 1760
28  libqcocoa.dylib               	       0x10384540c -[QNSView(Keys) keyDown:] + 76
29  AppKit                        	       0x193c77e5c -[NSWindow(NSEventRouting) _reallySendEvent:isDelayedEvent:] + 316
30  AppKit                        	       0x193c77b50 -[NSWindow(NSEventRouting) sendEvent:] + 284
31  libqcocoa.dylib               	       0x10384d16c -[QNSWindow sendEvent:] + 824
32  AppKit                        	       0x1944b4378 -[NSApplication(NSEventRouting) sendEvent:] + 2360
33  libqcocoa.dylib               	       0x1037f2330 -[QNSApplication sendEvent:] + 68
34  AppKit                        	       0x1940bb4e8 -[NSApplication _handleEvent:] + 60
35  AppKit                        	       0x193b44088 -[NSApplication run] + 520
36  libqcocoa.dylib               	       0x1037fde9c QCocoaEventDispatcher::processEvents(QFlags<QEventLoop::ProcessEventsFlag>) + 1904
37  QtCore                        	       0x104ddabc4 QEventLoop::exec(QFlags<QEventLoop::ProcessEventsFlag>) + 532
38  QtCore                        	       0x104dd18d8 QCoreApplication::exec() + 112
39  OpenSCAD                      	       0x100a34c9c gui(std::__1::vector<std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>>, std::__1::allocator<std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>>>>&, std::__1::__fs::filesystem::path const&, int, char**) + 2076
40  OpenSCAD                      	       0x100716b10 main + 18796
41  dyld                          	       0x18fb80274 start + 2840

-------------------------------------

Translated Report (Full Report Below)

-------------------------------------

Process: OpenSCAD [87606]

Path: /Applications/OpenSCAD.app/Contents/MacOS/OpenSCAD

Identifier: org.openscad.OpenSCAD

Version: 2024.12 (2024.12.30)

Code Type: ARM-64 (Native)

Parent Process: launchd [1]

User ID: 501

Date/Time: 2025-01-07 10:43:50.0163 +0800

OS Version: macOS 15.2 (24C101)

Report Version: 12

Anonymous UUID: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Sleep/Wake UUID: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Time Awake Since Boot: 1700000 seconds

Time Since Wake: 5033 seconds

System Integrity Protection: enabled

Crashed Thread: 0 Dispatch queue: com.apple.main-thread

Exception Type: EXC_CRASH (SIGABRT)

Exception Codes: 0x0000000000000000, 0x0000000000000000

Termination Reason: Namespace SIGNAL, Code 6 Abort trap: 6

Terminating Process: OpenSCAD [87606]

Application Specific Information:

abort() called

Thread 0 Crashed:: Dispatch queue: com.apple.main-thread

0 libsystem_kernel.dylib 0x18fec7720 __pthread_kill + 8

1 libsystem_pthread.dylib 0x18fefff70 pthread_kill + 288

2 libsystem_c.dylib 0x18fe0c908 abort + 128

3 libc++abi.dylib 0x18feb644c abort_message + 132

4 libc++abi.dylib 0x18fea4a24 demangling_terminate_handler() + 320

5 libobjc.A.dylib 0x18fb4d3f4 _objc_terminate() + 172

6 libc++abi.dylib 0x18feb5710 std::__terminate(void (*)()) + 16

7 libc++abi.dylib 0x18feb8cdc __cxxabiv1::failed_throw(__cxxabiv1::__cxa_exception*) + 88

8 libc++abi.dylib 0x18feb8c84 __cxa_throw + 92

9 libqscintilla2_qt6.15.dylib 0x1025f20f8 0x10245c000 + 1663224

10 libqscintilla2_qt6.15.dylib 0x1025bb4e8 0x10245c000 + 1438952

11 libqscintilla2_qt6.15.dylib 0x1025ed018 0x10245c000 + 1642520

12 libqscintilla2_qt6.15.dylib 0x10246f358 QsciScintillaBase::keyPressEvent(QKeyEvent*) + 448

13 QtWidgets 0x1039d17d8 QWidget::event(QEvent*) + 556

14 QtWidgets 0x103a4f780 QFrame::event(QEvent*) + 56

15 QtWidgets 0x103988c58 QApplicationPrivate::notify_helper(QObject*, QEvent*) + 272

16 QtWidgets 0x103989cec QApplication::notify(QObject*, QEvent*) + 972

17 OpenSCAD 0x100a85440 OpenSCADApp::notify(QObject*, QEvent*) + 28

18 QtCore 0x104dd124c QCoreApplication::notifyInternal2(QObject*, QEvent*) + 292

19 QtWidgets 0x1039e43a0 QWidgetWindow::event(QEvent*) + 168

20 QtWidgets 0x103988c58 QApplicationPrivate::notify_helper(QObject*, QEvent*) + 272

21 QtWidgets 0x103989af8 QApplication::notify(QObject*, QEvent*) + 472

22 OpenSCAD 0x100a85440 OpenSCADApp::notify(QObject*, QEvent*) + 28

23 QtCore 0x104dd124c QCoreApplication::notifyInternal2(QObject*, QEvent*) + 292

24 QtGui 0x102e1b110 QGuiApplicationPrivate::processKeyEvent(QWindowSystemInterfacePrivate::KeyEvent*) + 260

25 QtGui 0x102e70c24 QWindowSystemInterface::sendWindowSystemEvents(QFlags<QEventLoop::ProcessEventsFlag>) + 396

26 QtGui 0x102e70810 QWindowSystemInterface::flushWindowSystemEvents(QFlags<QEventLoop::ProcessEventsFlag>) + 284

27 libqcocoa.dylib 0x1038446d4 -[QNSView(Keys) handleKeyEvent:] + 1760

28 libqcocoa.dylib 0x10384540c -[QNSView(Keys) keyDown:] + 76

29 AppKit 0x193c77e5c -[NSWindow(NSEventRouting) _reallySendEvent:isDelayedEvent:] + 316

30 AppKit 0x193c77b50 -[NSWindow(NSEventRouting) sendEvent:] + 284

31 libqcocoa.dylib 0x10384d16c -[QNSWindow sendEvent:] + 824

32 AppKit 0x1944b4378 -[NSApplication(NSEventRouting) sendEvent:] + 2360

33 libqcocoa.dylib 0x1037f2330 -[QNSApplication sendEvent:] + 68

34 AppKit 0x1940bb4e8 -[NSApplication _handleEvent:] + 60

35 AppKit 0x193b44088 -[NSApplication run] + 520

36 libqcocoa.dylib 0x1037fde9c QCocoaEventDispatcher::processEvents(QFlags<QEventLoop::ProcessEventsFlag>) + 1904

37 QtCore 0x104ddabc4 QEventLoop::exec(QFlags<QEventLoop::ProcessEventsFlag>) + 532

38 QtCore 0x104dd18d8 QCoreApplication::exec() + 112

39 OpenSCAD 0x100a34c9c gui(std::__1::vector<std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>>, std::__1::allocator<std::__1::basic_string<char, std::__1::char_traits<char>, std::__1::allocator<char>>>>&, std::__1::__fs::filesystem::path const&, int, char**) + 2076

40 OpenSCAD 0x100716b10 main + 18796

41 dyld 0x18fb80274 start + 2840

继续阅读OpenSCAD输入某些字符导致应用闪退问题分析定位（QScintilla）

OpenSCAD圆角矩形

OpenSCAD实现圆角矩形，可以参考如下代码：

// 圆角矩形模块代码
module roundedcube(xx, yy, height, radius) {
    difference() {
        cube([xx, yy, height]);
        difference() {
            translate([-.5, -.5, -.2])
            cube([radius + .5, radius + .5, height + .5]);

            translate([radius, radius, height / 2])
            cylinder(height, radius, radius, true);
        }
        
        translate([xx, 0, 0])
        rotate(90)
        difference() {
            translate([-.5, -.5, -.2])
            cube([radius + .5, radius + .5, height + .5]);

            translate([radius, radius, height / 2])
            cylinder(height, radius, radius, true);
        }

        translate([xx, yy, 0])
        rotate(180)
        difference() {
            translate([-.5, -.5, -.2])
            cube([radius + .5, radius + .5, height + .5]);

            translate([radius, radius, height / 2])
            cylinder(height, radius, radius, true);
        }

        translate([0, yy, 0])
        rotate(270)
        difference() {
            translate([-.5, -.5, -.2])
            cube([radius + .5, radius + .5, height + .5]);

            translate([radius, radius, height / 2])
            cylinder(height, radius, radius, true);
        }
    }
}

// 圆角矩形模块代码

module roundedcube(xx, yy, height, radius) {

difference() {

cube([xx, yy, height]);

difference() {

translate([-.5, -.5, -.2])

cube([radius + .5, radius + .5, height + .5]);

translate([radius, radius, height / 2])

cylinder(height, radius, radius, true);

}

translate([xx, 0, 0])

rotate(90)

difference() {

translate([-.5, -.5, -.2])

cube([radius + .5, radius + .5, height + .5]);

translate([radius, radius, height / 2])

cylinder(height, radius, radius, true);

}

translate([xx, yy, 0])

rotate(180)

difference() {

translate([-.5, -.5, -.2])

cube([radius + .5, radius + .5, height + .5]);

translate([radius, radius, height / 2])

cylinder(height, radius, radius, true);

}

translate([0, yy, 0])

rotate(270)

difference() {

translate([-.5, -.5, -.2])

cube([radius + .5, radius + .5, height + .5]);

translate([radius, radius, height / 2])

cylinder(height, radius, radius, true);

}

参考链接

Way to round edges of objects opensCAD

ubuntu 18.04编译OpenSCAD源代码

ubuntu 18.04编译OpenSCAD源代码，本意想研究一下如何加速 CGAL 的计算过程，目前还没完成。

编译过程如下：

$ git clone git://github.com/openscad/openscad.git

$ cd openscad

$ git submodule update --init

# 每次重新编译，都需要先执行此脚本，否则会出现环境变量设置问题
$ sudo ./scripts/uni-get-dependencies.sh

# #include <Qsci/qsciglobal.h>
$ sudo apt-get install libqscintilla2-dev

$ sudo apt-get install libqscintilla2-qt5-dev

# 大量软件被卸载，但是可惜的是，如果不卸载 libpulse0 没办法安装 libpulse-dev
# 不安装 libpulse-dev 就没办法安装 qtmultimedia5-dev
$ sudo apt-get remove libpulse0

$ sudo apt-get install libpulse-dev

# Project ERROR: Unknown module(s) in QT: multimedia
$ sudo apt-get install qtmultimedia5-dev

# 如果安装过 anaconda 则要在路径中去除 anaconda，否则会出现编译问题
$ qmake openscad.pro

$ make

$ git clone git://github.com/openscad/openscad.git

$ cd openscad

$ git submodule update --init

# 每次重新编译，都需要先执行此脚本，否则会出现环境变量设置问题

$ sudo ./scripts/uni-get-dependencies.sh

# #include <Qsci/qsciglobal.h>

$ sudo apt-get install libqscintilla2-dev

$ sudo apt-get install libqscintilla2-qt5-dev

# 大量软件被卸载，但是可惜的是，如果不卸载 libpulse0 没办法安装 libpulse-dev

# 不安装 libpulse-dev 就没办法安装 qtmultimedia5-dev

$ sudo apt-get remove libpulse0

$ sudo apt-get install libpulse-dev

# Project ERROR: Unknown module(s) in QT: multimedia

$ sudo apt-get install qtmultimedia5-dev

# 如果安装过 anaconda 则要在路径中去除 anaconda，否则会出现编译问题

$ qmake openscad.pro

$ make

继续阅读ubuntu 18.04编译OpenSCAD源代码

使用OpenSCAD绘制一个简单的键帽

继续阅读

OpenSCAD用户手册/OpenSCAD用户界面

用户界面

就

视图导航

视图设置

OpenSCAD用户手册/第一步

1.创建一个简单的模型

对于我们的第一个模型，我们将会创建一个简单的2*3*4大小的立方体。在OpenSCAD编辑器中，输入下面的命令

cube([2,3,4]);

1	cube([2,3,4]);

编译并渲染我们的第一个模型

当焦点在OpenSCAD的编辑器上面的时候，按下F5或F6就可以编译并渲染这个立方体模型了。

2.打开一个已有的示例模型

打开OpenSCAD自带的许多例子中的一个，或者复制下面的例子代码到OpenSCAD的编辑窗口中：

difference() {
    cube(30, center=true);
    sphere(20);
}
translate([0, 0, 30]) {
    cylinder(h=40, r=10);
}

difference() {

cube(30, center=true);

sphere(20);

}

translate([0, 0, 30]) {

cylinder(h=40, r=10);

}

然后，按下F5预览（或者F6渲染）。

有三种方式对预览框进行操作：

鼠标左键的拖拽来旋转视图，底部状态栏显示的rotate会随着旋转而改变。
鼠标右键（OSX使用Ctrl+鼠标左键）的拖拽会移动视图，底部状态栏显示的translate会随着拖拽而改变。
鼠标滚轮用来缩放。也可以使用Shift+鼠标右键（OSX使用Shift+Crtl+鼠标左键），底部状态栏显示的distance会随之而改变。

3.放置一个对象

我们已经学会如何创建一个简单的立方体。我们的下一个任务是学习使用位置偏移命令来放置一个立方体到一个已经存在的立方体边上。

cube([2,3,4]);
translate([3,0,0]) {
  cube([2,3,4]);
}

cube([2,3,4]);

translate([3,0,0]) {

cube([2,3,4]);

}

在位置偏移命令最后没有分号：

注意在位置偏移命令后面没有分号。因为位置偏移命令需要包含后面的对象，如果在小括号后面使用了分号，对于位置偏移的影响将会终止，第二个立方体将会放到第一个立方体相同的位置。

4.改变一个对象的颜色

通过指定一个RGB数字，可以改变对象的颜色。不同于传统的用0-255来表示的RGB颜色，OpenSCAD使用0.0到1.0之间的浮点数来表示。注意！颜色的改变只在预览模式下面有效（F5)。渲染模式（F6)暂时不支持设置颜色。

color([1,0,0]) cube([2,3,4]);
translate([3,0,0])
color([0,1,0]) cube([2,3,4]);
translate([6,0,0])
color([0,0,1]) cube([2,3,4]);

color([1,0,0]) cube([2,3,4]);

translate([3,0,0])

color([0,1,0]) cube([2,3,4]);

translate([6,0,0])

color([0,0,1]) cube([2,3,4]);

2011.12 版本(以及后续版本）可以使用颜色名字指定颜色。颜色名字与Web colors使用相同的定义。比如：color("red") cube();

如果把整条命令当作一个语句来分析的话，color()是整个句子中描述"对象"(名词)的形容词，而cube()就是要创建的那个对象。一般句子中，形容词放在名词的前面，比如color() cube();。同理，translate()可以理解为操作对象的动词，因此排列方式应该是这样的translate() color() cube();。如下的代码来展示这种情况：

translate([6,0,0])
{
   color([0,0,1])    // notice that there is NO semicolon
   cube([2,3,4]);    // notice the semicolon is at the end of all related commands
}

translate([6,0,0])

{

color([0,0,1]) // notice that there is NO semicolon

cube([2,3,4]); // notice the semicolon is at the end of all related commands

}

5.模型视图

视图("View")菜单在OpenSCAD应用窗口顶部的菜单栏上，提供了一系列的视图选项。

预览(Preview)

当模型代码首次渲染的视图就是预览视图。选择"View->Preview"可以返回预览视图。

外表面(Surfaces)

选择"View->Surfaces"将会使用开源构造立体几何库(OpenCSG)利用OpenGL进行渲染。如果OpenCSG不存在，或者显卡驱动不支持OpenGL会导致渲染失败。

线框(Wireframe)

当处理非常复杂的3D模型的时候，设计师一般会选择"View->Wireframe"。
轮廓视图只呈现支撑框架。可参考埃菲尔铁塔。
线框是一种三维或者物理对象的视觉表现形式。使用线框模型允许一个3D模型的基本结构设计可视化。由于线框渲染相当的简单并且计算快速，因此常被用于需要高帧率渲染的场景（比如，当需要渲染复杂3D模型，或者实时模型外观渲染系统）。当需要更多的图像细节的时候，可以自动在复杂的框架渲染之后再追加表面纹理。这就允许设计师可以在不经过长时间的重新渲染的情况下，快速的预览改变或者旋转到一个其他的设计视图。线框格式也被数控机械设备良好支持，并被广泛用于程序化路径控制。线框模型常被用于计算机辅助制造（CAM）。线框是三种主要CAD视图中，最抽象，最逼真的。这种建模方法只包括直线、点和曲线的定义。

混合(Thrown Together)

选择"View->Thrown Together"可以把上述所有视图一起显示出来。

OpenSCAD中文手册

简介

OpenSCAD是一款用于构建三维立体模型的软件。它是一款自由软件,可用于多种操作系统，包括GNU/Linux，微软Windows和苹果OSX。

不同于其他多数用于构建三维立体模型的自由软件（比如大家熟知的Blender），OpenSCAD的主要用途并不是用于外观艺术渲染，而是更多致力于CAD方面的功能。所以如果你在寻找一款用于构建机械零件模型的应用软件，他可能正好是你想要找的，而如果你更感兴趣的是制作电脑动画或模拟生命模型软件的话，他可能不够胜任。

OpenSCAD并不是交互建模工具，这一点跟多数的CAD工具也不同。它更像是一个2D/3D编译器，读取描述对象的程序文件，从中生成出模型。这样使得设计者能够全面控制模型处理过程，能够容易的改变其中的步骤，或者通过定义配置参数来进行设计。

OpenSCAD主要有两种操作模式，预览和渲染。预览通过利用三维图形技术和计算机图形处理单元进行处理，速度相对较快，但是只能输出一个模型的近似结果，预览使用的是OpenCSG跟OpenGL。渲染生成精确的几何模型并完全棋盘化，栅格化，而不是近似模拟，因而过程较为漫长，较大的设计通常需要以分钟甚至小时记的时间，渲染使用的是CGAL几何引擎。

OpenSCAD提供了两种类型的3D建模，构造立体几何Constructive Solid Geometry(CSG)或通过二维图元生成三维空间。

AutoCAD的DXF文件作为二维轮廓数据的交换格式。除了使用二维路径建立模型，还可以直接从DXF文件读取设计参数。除了可以读取DXF文件，OpenSCAD还可以读取和创建STL和OFF文件格式的三维模型。

OpenSCAD可以在http://openscad.org/下载。

如果不想（或者不能）在电脑上面安装新的OpenSCAD软件，在浏览器支持WebGL的情况下，也可以使用OpenJSCAD（http://OpenJSCAD.org/),一个运行在Web浏览器上的OpenSCAD工具。

CGAL开源项目,目标是以C++库的形式提供方便，高效，可靠的几何运算，CGAL应用到在诸多方面有几何运算需要的地方，如：计算机图形学，科学可视化，计算机辅助设计与建模，地理信息系统，分子生物学，医学成像，机器人技术和运动规划，网格生成，数值计算方法等等。

第一步
OpenSCAD用户界面
OpenSCAD语言
1. 综述-初步了解-注释，数值以及数据类型，变量
2. 基本立体模型-立方体，球体，柱体&多面体
3. 数学运算符
4. 数学函数
  1. 三角函数（cos sin tan acos asin atan atan2)
  2. 其他（abs ceil concat cross exp floor ln len let log lookup max min norm pow rands round sign sqrt)
5. 字符串函数-str,chr
6. 列表
7. 变换-尺寸&方位.scale,resize,rotate,translate,mirror,multmatrix,offset,color,minkowsik&hull
8. 条件and迭代-for,if&assign
9. CSG建模-基本模型的组合.union,difference,intersection&render
10. 修饰字符-辅助调试，% # ！*
11. 模型-编写自定义基本模型与变换
12. 用户自定义功能
13. 包含声明
14. 其他语言特性-特殊的'$'变量，echo,render,surface,search,version()&version_num()
使用二维子系统
STL导入与导出
带注释的项目示例
在OpenSCAD上使用外部编辑器
在命令行环境下使用OpenSCAD
使用源文件编译OpenSCAD
常见问题
库

View Fullscreen

openSCAD中文教程

分类： OpenSCAD

解决OpenSCAD导出的WRL格式文件不正确的问题

前置条件

问题描述

问题现象

OpenSCAD输入某些字符导致应用闪退问题分析定位（QScintilla）

前置条件

问题现象

OpenSCAD圆角矩形

参考链接

ubuntu 18.04编译OpenSCAD源代码

使用OpenSCAD绘制一个简单的键帽

OpenSCAD用户手册/OpenSCAD用户界面

目录

内容

用户界面

视图导航

视图设置

OpenSCAD用户手册/第一步

目录

1.创建一个简单的模型

2.打开一个已有的示例模型

3.放置一个对象

4.改变一个对象的颜色

5.模型视图

内容

预览(Preview)

外表面(Surfaces)

线框(Wireframe)

混合(Thrown Together)

OpenSCAD中文手册

简介

目录

2025 年 2 月
一	二	三	四	五	六	日
					1	2
3	4	5	6	7	8	9
10	11	12	13	14	15	16
17	18	19	20	21	22	23
24	25	26	27	28