wgpu-matrix 项目教程

wgpu-matrix 项目教程

wgpu-matrix Fast WebGPU 3d math library 项目地址: https://gitcode.com/gh_mirrors/wg/wgpu-matrix

1. 项目的目录结构及介绍

wgpu-matrix/
├── dist/
│   ├── 3/
│   │   ├── wgpu-matrix.min.js
│   └── wgpu-matrix.min.js
├── src/
│   ├── mat2.js
│   ├── mat3.js
│   ├── mat4.js
│   ├── vec2.js
│   ├── vec3.js
│   ├── vec4.js
│   └── index.js
├── test/
│   ├── mat2.js
│   ├── mat3.js
│   ├── mat4.js
│   ├── vec2.js
│   ├── vec3.js
│   ├── vec4.js
│   └── index.js
├── .gitignore
├── LICENSE
├── package.json
├── README.md
└── webpack.config.js

目录结构介绍

• dist/: 存放编译后的文件，包括压缩后的 JavaScript 文件。
  • 3/: 存放特定版本的压缩文件。
  • wgpu-matrix.min.js: 压缩后的主文件。
• src/: 源代码目录，包含各种矩阵和向量操作的实现。
  • mat2.js, mat3.js, mat4.js: 分别对应 2x2, 3x3, 4x4 矩阵的操作。
  • vec2.js, vec3.js, vec4.js: 分别对应 2 维、3 维、4 维向量的操作。
  • index.js: 入口文件，导出所有模块。
• test/: 测试代码目录，包含各种测试用例。
  • mat2.js, mat3.js, mat4.js, vec2.js, vec3.js, vec4.js: 分别对应各个模块的测试用例。
  • index.js: 测试入口文件。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• package.json: 项目依赖和脚本配置文件。
• README.md: 项目说明文档。
• webpack.config.js: Webpack 配置文件。

2. 项目的启动文件介绍

项目的启动文件是 src/index.js，该文件导出了所有矩阵和向量操作的模块，方便其他项目引用。

// src/index.js
export * from './mat2.js';
export * from './mat3.js';
export * from './mat4.js';
export * from './vec2.js';
export * from './vec3.js';
export * from './vec4.js';

3. 项目的配置文件介绍

package.json

package.json 文件包含了项目的依赖、脚本配置等信息。

{
  "name": "wgpu-matrix",
  "version": "1.0.0",
  "description": "Fast WebGPU 3d math library",
  "main": "dist/wgpu-matrix.min.js",
  "scripts": {
    "build": "webpack --config webpack.config.js",
    "test": "mocha test/**/*.js"
  },
  "dependencies": {
    "webpack": "^5.0.0"
  },
  "devDependencies": {
    "mocha": "^9.0.0"
  },
  "license": "MIT"
}

webpack.config.js

webpack.config.js 文件是 Webpack 的配置文件，用于打包和压缩 JavaScript 文件。

const path = require('path');

module.exports = {
  entry: './src/index.js',
  output: {
    filename: 'wgpu-matrix.min.js',
    path: path.resolve(__dirname, 'dist')
  },
  mode: 'production'
};

通过以上配置，项目可以自动打包生成压缩后的 JavaScript 文件，并放置在 dist/ 目录下。

wgpu-matrix Fast WebGPU 3d math library 项目地址: https://gitcode.com/gh_mirrors/wg/wgpu-matrix