1

作者:心叶
时间:2020-01-21 20:08

image3D是一个基于WebGL开发的web端3D绘图库,包括常用的三维接口和辅助方法,帮助你快速绘制自己的三维图形。

downloadsinstall sizeCDNVersionLicense

如何使用?

首先,我们不得不说明一下绘图的基本流程: 编辑着色器 → 创建3D对象 → 准备好数据 → 绘制

我们接下来准备绘制一个点,点的颜色、大小和位置不停改变。

着色器

绘图的时候,本质上我们都是需要通过着色器来和GPU进行数据交互,因此,需要传递的数据都需要在这里提前定义好,看看本例子的着色器:

<!-- 顶点着色器 -->
<script type\='x-shader/x-vertex' id\='vs'\> attribute vec4 a\_position;
    attribute float a\_size;
    attribute vec4 a\_color;
    varying vec4 v\_color;
    void main(){
        gl\_Position=a\_position;
        gl\_PointSize=a\_size;
        v\_color=a\_color;
    }
<script\> <!-- 片段着色器 -->
<script type\='x-shader/x-fragment' id\='fs'\> precision mediump float;
    varying vec4 v\_color;
    void main(){
        gl\_FragColor=v\_color;
    }
<script\> 

着色器分二类:顶点着色器和片段着色器,前者用于传递点的位置和大小,后者用于传递点的颜色。

本质上来讲,着色器其实就是二个字符串,用script标签包裹是为了在html文本中方便编辑,在后面的过程就可以看出来了。

着色器的代码有点像C语言,我们目前需要了解这三点:

  • gl开头的有三个,分别对应点的位置、大小和颜色(从上到下),这是着色器内置的变量,分别隶属于二个着色器,我们所谓的传值,从这个层次看,就是最终给这三个变量赋值。
  • 然后再看看attribute修饰的三个变量,被这个修饰符修饰的变量等于暴露了一个入口,image3D提供了传值的方法,所谓的传值,也就是通过这个入口实现的(第二个修饰符,vec4和float是变量的数据类型,类似别的语言)。
  • 前一条说的入口由attribute修饰实现,是针对每个点提供的,片段着色器是针对全部的点,因此attribute不可以直接出现在第二类着色器中,我们需要使用varying修饰符来标记一个桥梁,实现二个着色器之间的数据传递。

3D对象

着色器准备好了以后,我们就可以使用这二个着色器创建3D对象了,同样的,看看本例中的代码:

var image3d = new image3D(document.getElementsByTagName('canvas')\[0\], {

    // 传递着色器
    "vertex-shader": document.getElementById("vs").innerText,
    "fragment-shader": document.getElementById("fs").innerText

});
    

从这里是不是可以看出来,着色器只不过是二段字符串。

传递数据

实际的例子是不停的改变,我们为了方便说明,这里假设某个瞬间的操作:

image3d
    // 设置点的位置
    .setAttributeFloat("a\_position", 0.5, 0.5, 0.0)
    // 设置点的大小
    .setAttributeFloat("a\_size", 50.0)
    // 设置点的颜色
    .setAttributeFloat("a\_color", 1.0, 0.0, 0.0);
    

比如点的位置,“a_position”是和着色器中attribute修饰的变量对应的。大部分根据感觉应该就可以看出来,下面稍微提二点:

  • image3D选择的是右手坐标系,记作uvz(对应数学中的坐标系就是xyz),每个轴的有效可视范围是-1.0~1.0,因此这里的坐标(0.5, 0.5, 0.0)页面上看上去就是位于第一象限中心(右上角),请注意和浏览器的坐标区分。
  • 点的颜色需要传递三个值,范围是0.0~1.0,分别对应RGB(当然还可以有一个alpha透明度,这里没有传递)。

绘制

一切准备完毕,获取画笔绘制即可:

image3d.Painter().drawPoint(0, 1);
    

这里缩减版的例子最终会绘制一个大小是50px,位于第一象限中心的红色正方形。完整的例子请 点击此处 查看运行效果。

当然,上面的例子可能过于简单,你也可以试试旋转的24边形这个稍微复杂点的例子,下面是某个瞬间的截图(本身是运动的,不停旋转):


心叶
304 声望114 粉丝

我还惊讶地意识到, 在我生命中有很多时刻, 每当我遇到一个遥不可及、令人害怕的情境,并感到惊慌失措时, 我都能够应付——因为我回想起了很久以前自己上过的那一课。