A driver library for 7-segment displays
npm install 7segment-driver#### 简介
7segment-driver 是一个轻量级的七段数码管显示驱动程序库,支持在网页和Node.js环境中快速生成数码管显示所需的顶点数据。支持数字和部分特殊字符的显示,可自定义显示样式和布局。
#### 安装方法
通过npm安装 (推荐用于Node.js项目或使用构建工具的项目)
``bash`
npm install 7segment-driver
浏览器直接引入 (适合快速原型开发)
`html`
#### 使用指南
本库提供三种模块化方案的支持:
1. CommonJS (CJS) 格式 (Node.js环境)
`javascript`
const { createHexagonVertices } = require('7segment-driver');
const vertices = createHexagonVertices('88:88');
2. ES Module (ESM) 格式 (现代前端项目)
`javascript`
import { createHexagonVertices } from '7segment-driver';
const vertices = createHexagonVertices('12:34');
3. UMD 格式 (浏览器全局变量)
`html`
#### API 文档
##### createHexagonVertices(content, options)
功能:生成七段数码管显示的顶点数据
参数:
- content (String): 要显示的内容,支持字符:0-9, :, *options
- (Object): 可选配置项long
- (Number): 数码管长边长度,默认20short
- (Number): 数码管短边长度,默认20angle
- (Number): 短边与长边的夹角(度),默认30gap
- (Number): 数码管间距,默认10cw
- (Number): 显示区域总宽度,默认400ch
- (Number): 显示区域总高度,默认300
返回值:包含所有数码管顶点数据的数组
示例:
`javascript
// 显示时间格式
const vertices = createHexagonVertices('12:34:56', {
long: 25,
short: 18,
angle: 30,
gap: 8,
cw: 500,
ch: 200
});
// 简单数字显示
const simpleDisplay = createHexagonVertices('2024');
`
#### 注意事项
1. 内容字符串中不支持显示的字符将被忽略
2. 建议根据实际显示区域大小调整cw和ch参数angle`建议保持在20-45度之间以获得最佳显示效果
3. 角度参数
#### 应用场景
- 电子时钟显示
- 数字计数器
- 仪表盘数字显示
- 任何需要七段数码管风格显示的项目