1.1: 安装

以下是安装Karamba 3D的前提条件：

• Rhino 6, 7或8

• Grasshopper (Karamba3D的1.3.3版本已在GH 1.0.0007上进行了测试)

如果您还未曾安装Rhino软件，可从以下网址下载功能齐全的免费试用版本：http://www.rhino3d.com/download.html. Rhino5 的 Grasshopper 插件是免费的，可通过以下链接找到：http://www.grasshopper3d.com/. 它已被整合在 Rhino6 以及 Rhino7中。

标准安装

请在下载安装程序后双击msi-文件。使用Rhino5时，请确保选择正确的安装位数（32或64）。Rhino5的64位版本名为“Rhinoceros 5 (64-bit）”。Rhino6和Rhino7仅提供64位应用程序。

在安装过程中，用户可以设置用于运算的物理单位。默认情况下，Karamba3D假定其输入为国际单位制（例如，使用米为点坐标单位）。用户可在安装时或在安装后通过编辑“karamba.ini”文件将运算的物理单位切换到英制单位。这种情况下坐标的单位将为“feet（英尺）”，力的单位为“kips（千磅）”，而材料强度则为“ksi（千磅/平方英寸）”，等等。

如果用户打算在后期激活PRO（专业版）或EDU（教育版）使用授权许可，请确保安装完整版Karamba3D。

安装成功后，在Rhino中打开Grasshopper时会看到一个Karamba3D标签。此外，作为默认设置，安装文件夹的快捷方式将会出现在计算机桌面上。

如未能显示Karamba3D图标，请参考我们的故障排除指南。

Karamba3D的安装可以为独立、云端或网络使用授权许可：

page1.2.4: 独立使用授权许可page1.2.1: 云端使用授权许可

虚拟机软件parallel上的Rhino5, Rhino6和Rhino7

用户可将Rhino 5的64位版本与Rhino 6和Rhino 7版本的Karamba3D一起安装。只需依次先后运行两个安装程序即可。

不过，Rhino 5的32位版本Karamba3D无法与其他任何版本一同安装。

静默安装

出于在远程计算机上安装Karamba3D的目的，“msiexec.exe”提供了一些选项来规避安装程序的图形用户界面。启动Windows CommandPrompt，导航到Karamba 3D安装程序所在的位置后键入如下内容：

msiexec.exe /i karamba3d_1_3_2_RH7.msi /passive ADDLOCAL=FullFeatures,SIUnits,LicensePublicKey,Tables,Examples

用户只需键入如上文的一行文字即可安装包括SI-Unit（国际单位制），横截面和材料表格（“Tables（表格）”）以及定义范例（“Examples（示例）”）等在内的完整版本Karamba 3D（“FullFeatures（完整功能 ）”）。出于获取免费版本的考虑，在英制单位中将“FullFeatures（完整功能）”替换为“FreeFeatures（自由功能）”，将“SIUnits（国际单位制）”替换为“IM-PUnits（英制单位制）”。

通过将使用授权许可文件重新命名为“licensePRO.lic”并将其复制到...\Rhino Plug-ins\Karamba\下面的“License”文件夹内，可以在不使用图形用户界面（GUI）的情况下提供静默使用授权信息。

自动安装

在安装过程中，以下文件和文件夹将被复制到您的机器上：

• 将“karamba.dll” 和 “libiomp5md.dll” 添加至 C:\Windows.

• 将“karambaCommon.dll”、“karamba.gha”和Karamba文件夹添加到Rhino的“Plug-ins”文件夹中。Karamba3D文件夹包含材料库和横截面库、范例、karamba.ini文件，以及使用授权许可文件夹。通常位于C:\Program Files\Rhinoceros 5 (64-bit)\Plug-ins或C:\Program Files\Rhino 6\Plug-ins。

• 如果Visual Studio 2019的C++运行时库尚不存在，请将其复制到您的计算机上。

默认情况下，将为计算机上所有用户安装Karamba3D。如希望在没有安装程序的情况下运行Karamba3D，只需将上述文件和Karamba3D文件夹从一台计算机复制到另一台。除非取消选择，否则安装程序会在计算机桌面上放置一个Karamba3D图标。双击该图标可以打开Karamba3D文件夹。

在Mac上安装

现阶段，Karamba3D仅适用于Windows用户。在安装Parallels或Bootcamp Windows的前提下，Mac用户也可以运行Karamba3D。