Discover three.js is now open source!
Word Count:120, reading time: ~1minutes

GitHub 上的 three.js - 魔法出现的地方

整个 three.js 项目是免费的开源软件 ( FOSS ),所有开发都 在 Github 上的一个巨大仓库中进行。它由原始创建者 @mrdoob(又名 Ricardo Cabello)和一群开源爱好者维护。这是一个庞大而活跃的 repo,上面有 ReactjQueryNode.js等超级明星。

与 three.js 项目正式相关的所有内容都在 repo 中:源代码、 数百个演示如何使用库的每个部分的示例、 文档交互式场景编辑器以及大量插件和免费资源,例如 3D 模型、纹理、声音和 3D 字体。 现在打开 repo,我们来一探究竟。有很多内容需要考虑,但目前只有几个文件夹与我们相关。

build文件夹

build文件夹是 repo 中最重要的文件夹,因为它包含最重要的 three.js 文件(库的核心 ):

  • build/three.module.js

这是运行基本的 three.js 应用程序所需的唯一文件。

文件名中的**.module**告诉我们这是一个 JavaScript 模块。在此文件夹中,如果您想支持无法使用模块的过时浏览器,还可以使用两个旧版本的 three.js 核心:

  • build/three.js
  • build/three.min.js

在本书中,我们将始终使用three.module.js,因为上述 2 个老版本的文件将在即将发布的版本中删除。

examples/ 文件夹

几乎同样重要的是, examples/文件夹包含许多好东西,包括:

  • 所有 官方示例源代码,您应该将其作为主要学习资源之一进行学习。
  • examples/jsm文件夹中的插件 ,例如相机控件和模型加载器,我们在整本书中都会用到它们。您也应该在这里学习代码,尽管它往往更高级,所以您可能要等到您先了解更多其他基础内容。
  • examples/js文件夹中的旧插件 。这些与您在 examples/jsm 中找到的插件集相同,但是,它们将适用于过时的浏览器。就像核心的遗留版本一样,遗留插件将很快被删除,我们将在本书中忽略它们。
  • 3D 字体
  • 许多不同格式的 3D 模型
  • 音效
  • 纹理
  • … 还有很多。

你需要学习 three.js 的一切都在那里——除了这本书!更重要的是,该文件夹中的几乎所有内容都包含在 MIT license中,这意味着您可以以任何您喜欢的方式自由使用项目中的任何内容。

src/ 文件夹

您将在 src/文件夹中找到 three.js 源代码。随着您对 three.js 的熟练程度越来越高,您会想知道实际的 three.js 代码是如何实现的。每个 文档页面底部都有指向对应**src/**文件夹中相关源码文件的直接链接,因此您可以在阅读文档时快速导航到相关文件。

three.js 源代码简单、干净、简洁,与您对 3D 图形库的期望相比,它易于访问且易于理解。

其他文件夹和文件

除了我们这里提到的之外,还有很多其他的文件夹和文件,包括 官方文档的源代码和 three.js 场景编辑器。其中大部分与开发 three.js 有关,此处不再赘述,但请随意探索。

Wiki (维基)

作为 repo 的一部分维护的还有 three.js wiki。wiki 的主要目的是为希望为 three.js 的开发做出贡献的人们提供指南。但是,还有另一个重要页面: 迁移指南,它提供了 three.js 版本之间任何更改的快速列表。每当您需要将旧的 three.js 应用程序升级到新版本时,这里就是您的去处。

Import Style
Selected Texture