Tactile.js 开源项目教程

Tactile.js 开源项目教程

tactile-js A Javascript library for representing, manipulating, and drawing periodic tilings of the plane. 项目地址: https://gitcode.com/gh_mirrors/ta/tactile-js

1. 项目介绍

Tactile.js 是一个用于表示、操作和绘制平面周期性镶嵌的 JavaScript 库。该库专注于一种特殊的镶嵌类型，称为等面镶嵌（isohedral tilings）。等面镶嵌由单一形状的重复副本组成，具有简单的重复模式。尽管模式简单，但等面镶嵌非常具有表现力，并且计算效率高。Tactile.js 是作者在1990年代末期创建的原始 Tactile 库的现代升级版，最初是用 C++ 编写的。

2. 项目快速启动

安装

首先，克隆项目到本地：

git clone https://github.com/isohedral/tactile-js.git
cd tactile-js

使用

Tactile.js 作为一个 ES6 模块提供，可以通过以下方式导入到你的 JavaScript 代码中：

import { EdgeShape, numTypes, tilingTypes, IsohedralTiling } from './tactile.js';

示例代码

以下是一个简单的示例，展示如何创建一个等面镶嵌并设置其参数：

// 导入必要的模块
import { IsohedralTiling, tilingTypes } from './tactile.js';

// 创建一个新的等面镶嵌
let a_tiling = new IsohedralTiling(tilingTypes[0]);

// 获取当前参数
let params = a_tiling.getParameters();

// 修改参数
if (a_tiling.numParameters() > 1) {
    params[1] += 1.0;
    // 将参数应用回镶嵌
    a_tiling.setParameters(params);
}

// 绘制镶嵌
// 这里需要使用具体的绘图库，例如 P5.js

3. 应用案例和最佳实践

应用案例

Tactile.js 可以用于创建各种艺术作品，特别是那些基于等面镶嵌的作品。例如，可以创建类似于 M.C. Escher 的镶嵌艺术作品。此外，该库还可以用于教育目的，帮助学生理解镶嵌理论和几何学。

最佳实践

1. 参数调整：在调整镶嵌参数时，建议一次性设置所有参数，以避免频繁的内部数据重新计算。
2. 使用示例代码：参考 demo/ 目录中的示例代码，这些代码展示了如何使用 Tactile.js 创建交互式和非交互式的绘图程序。
3. 在线演示：可以尝试在线演示，了解库的功能和使用方法。

4. 典型生态项目

Tactile-python

Tactile-python 是 Tactile.js 的 Python 移植版本，由 David Braun 开发。这个项目允许你在 Python 环境中使用等面镶嵌的功能，适合那些更熟悉 Python 的开发者。

P5.js

P5.js 是一个用于创建图形和交互式内容的 JavaScript 库。Tactile.js 可以与 P5.js 结合使用，以创建更复杂的图形和动画效果。

QuickSettings

QuickSettings 是一个用于创建交互式用户界面的 JavaScript 库。它可以与 Tactile.js 结合使用，以创建用户友好的镶嵌编辑器。

通过这些生态项目，Tactile.js 可以扩展其功能，并适应不同的开发环境和需求。

tactile-js A Javascript library for representing, manipulating, and drawing periodic tilings of the plane. 项目地址: https://gitcode.com/gh_mirrors/ta/tactile-js