OpenSCAD用户手册/第一步

目录

1. 创建一个简单的模型
2. 打开一个已有的示例模型
3. 放置一个对象
4. 改变一个对象的颜色
5. 模型视图

1.创建一个简单的模型

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

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);
}

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

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

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

3.放置一个对象

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

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]);

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
}

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"可以把上述所有视图一起显示出来。