3d-core-raub 中文文档教程

Question

Node.js 3D Core

这是 Node3D 项目的一部分。

npm i 3d-core-raub

Synopsis

在 WebGL 模式下启动 Node.js。

• Shipped together with three.js for convenience.
• Multiple windows are supported, with the help of GLFW.
• WebGL implementation is also using GLEW.
• Image loading uses FreeImage encoder/decoder.
• Window icons are supported and both JS- and Image-friendly.

注意：这个包使用了一堆 N-API 插件，它们是 ABI 兼容的 不同的 Node.js 版本。 Addon 二进制文件是预编译的，没有编译 npm i 命令中的步骤。

Usage

该模块只直接导出一个函数——init()。 有或没有调用它 从第一个窗口开始并获取所有功能的自定义选项。

const init = require('3d-core-raub');
const { Screen, Brush, loop } = init(); // no opts is fine too

const screen = new Screen();
loop(() => screen.draw());

const brush = new Brush({ screen, color: 0x00FF00 });
screen.on('mousemove', e => brush.pos = [e.x, e.y]);

init(opts = {})

初始化 Node3D。 创建第一个窗口并设置全局环境。 该函数可以重复调用，但会忽略后续调用。 对于任意数量的重复调用，返回值都是相同的。

参数 opts 及其所有字段都是可选的：

• number major 2 - major OpenGL version to be used.
• number minor 1 - minor OpenGL version to be used.
• string title $PWD - window title, takes current directory as default.
• number width 800 - window initial width.
• number height 600 - window initial height.
• number display undefined - display id to open window on a specific display.
• boolean vsync false - if vsync should be used.
• string mode 'windowed' - one of 'windowed', 'borderless', 'fullscreen'.
• boolean autoIconify true - if fullscreen windows should iconify automatically on focus loss.
• number msaa 2 - multisample antialiasing level.
• boolean decorated true - if window has borders (use false for borderless fullscreen).
• webgl - override for module "webgl-raub".
• Image - override for module "image-raub".
• glfw - override for module "glfw-raub".
• location - override for window.location.
• navigator - override for window.navigator.
• WebVRManager - override for window.WebVRManager.
• three, opts.THREE - override for module "three".
• [{search,replace}] shaderHacks - a list of shader replacement rules. Each rule is later translated into a call of String.replace()
• [string|function|{name,opts}] plugins - a list of plugins to initialize. Plugins are inited the very last. Right before the result of init() is returned. Given the name of the plugin init() will try to require it and call it passing the future-return-value. Plugins are inited in the same order as they present in the array. You may also pass the plugin as a function, which is equivalent to a manual call plugin(initResult), where initResult is what init() returns. Yet even in this case using the array parameter allows shorter syntax and order control.
• Object extend - extend or override the returning fields.

返回：

• class Image - Almost the same as Image in a browser. Also document.createElement('img') does the same thing as new Image(). For more info see the respective docs of image-raub.
• class Window - This constructor spawns a new platform window. For more info see the respective docs of glfw-raub.
• class Document - This constructor spawns a new platform window with a web-document like interface. For more info see the respective docs of glfw-raub.
• gl, webgl, context - A WebGL context instance. This is almost the same as real WebGL stuff. For more info see the respective docs of webgl-raub.
• glfw - Low level GLFW interface. For more info see the respective docs of glfw-raub.
• doc, canvas, document, window - The default instance of Document. It is used to immediately initialize three.js. This implies, that (the first occurance of) require('node-3d-core-raub') results in a new platform window being immediately created.
• three, THREE - An instance of three.js. For more info see the respective docs of three.js.
• loop - A convenience shortcut to induce requestAnimationFrame-driven render loop. Function cb is called, whenever the default document is ready to produce a new frame. The function is BOUND to the default document instance.
• requestAnimationFrame, frame - What is known as window.requestAnimationFrame. Function cb is called, whenever the default document is ready to produce a new frame. The function is BOUND to the default document instance.
• class Brush - Creates a screen-sized overlay, where a circle is drawn around the specified position.
• class Cloud - Base class for custom-VBO based geometries.
• class Drawable - Base class for all drawable classes exported by this module.
• class Points - A custom-VBO based point-cloud.
• class Lines - A custom-VBO based line-cloud.
• class Tris - A custom-VBO based triangle-cloud.
• class Rect - A single rectangle. Probably supports corner-radius
• class Screen - A further abstraction of Document, encapsulating some three.js-specific logics.
• class Surface - A Rect that mimics a Screen for drawable objects.
• ... - whatever is added by plugins or the opts.extend parameter.

Plugins

根据此处的定义：

• A plugin needs some of the fields returned by init().
• The core "does not know" about any specific plugins.
• Plugins do not have 3d-core-raub in their dependencies.

优点：

• You can run a plugin against a fork of 3d-core-raub.
• Plugins won't ever try to load 2 different glfw3.dll comming from different dependency versions. A plugin may always be replaced by its fork.

缺点：

• You have to manage the compatibility between the core and the plugins manually (now).

module.exports = core => {
    // ...
    // core.something = something;
}