@botharness/pixel-banner

中文文档
0.1.0发布于 2026/10/08MITTypeScriptES Module零依赖近 30 天下载 4329

种子像素艺术自然旗 (3: 1, 1,1500×500) 在10个场景中, 作为简洁的 RGBA 像素

中文使用文档

@ botharness/像素班纳

种子像素艺术自然旗分十幕,为剖面头. 每个横幅被绘制为150×50并缩放整个数字,精确到1500×500(3:1),所以每个像素都保持了一块脆的平方形.

All ten banner scenes on a light page

import { pixelBannerImage, seededBannerRecipe } from '@botharness/pixel-banner';

const recipe = seededBannerRecipe('DeepSeekBot'); // { scene: 'sea', seed: 2786543041 }, same name, same banner
const { width, height, data } = pixelBannerImage(recipe); // 1500×500 RGBA

const canvas = document.createElement('canvas');
canvas.width = width;
canvas.height = height;
canvas.getContext('2d')!.putImageData(new ImageData(data, width, height), 0, 0);
canvas.toBlob((png) => upload(png!), 'image/png');
  • BANNER_SCENES数字 : spring, (中文(简体) ), summer, (中文(简体) ), autumn, (中文(简体) ), winter, (中文(简体) ), sea, (中文(简体) ), mountain, (中文(简体) ), desert, (中文(简体) ), forest, (中文(简体) ), night-sky, (中文(简体) ), space。 。 。 .
  • 食谱是简单的JSON: { scene, seed }时 seed 是32位无符号整数. isPixelBannerRecipe 验证保存的 .
  • seededBannerRecipe(name):同名总是给出相同的食谱.
  • pixelBannerPixels(recipe):150×50源像素. 画在150×50画布上 用CSS放大 image-rendering: pixelated 如果您不需要完整大小的文件.
  • pixelBannerImage(recipe, { scale }): 像素重现 scale 时间( 默认) BANNER_SCALE, 10),没有平滑. scalePixels(image, scale) 对任何图像都一样.

输出为RGBA,行相干,每像素有4个字节,完全不透明. 它只使用整数和基本浮点算法,因此同一种配方在每个JavaScript引擎中给出了相同的字节. test/fixtures/banner-golden.json 锁定每个场景的输出;改变已存在的横幅需要一个新的场景名称,而不是新的固定.

版本与发布记录

@botharness/pixel-banner 共发布 2 个版本,首次发布于 2026/10/08;过去 12 个月发布了 2 个版本。

版本发布日期距今
0.1.0latest2026/10/0830 天前
0.0.0-stage2026/10/0830 天前

关于 @botharness/pixel-banner 的常见问题

@botharness/pixel-banner 是什么?

种子像素艺术自然旗 (3: 1, 1,1500×500) 在10个场景中, 作为简洁的 RGBA 像素

如何安装 @botharness/pixel-banner?

在项目目录运行 npm install @botharness/pixel-banner,或使用 pnpm add / yarn add / bun add。

@botharness/pixel-banner 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@botharness/pixel-banner 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@botharness/pixel-banner 可以商用吗?

@botharness/pixel-banner 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@botharness/pixel-banner 的下载量有多少?

根据 npm 官方下载统计,@botharness/pixel-banner 在 2026/10/09 – 2026/11/07 这 30 天内被下载 4,329 次,日均约 144 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@botharness/pixel-banner 还在维护吗?

最新版本 0.1.0 发布于 2026/10/08(30 天前);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/10/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。