SuperAPI AI 工具集

asciify-engine

前端与建站

查看项目

更新于 10-23 16:15

技能介绍

Asciify Engine 是一个以 npm 包形式发布的工具,用于在真实界面中应用 ASCII 字符组件和背景,效果与 asciify.org 一致。资料中给出的测试版本为 4.32.0,安装命令为 npm install asciify-engine@latest。

用途方面,它主要面向前端界面:把字符化的视觉元素放进按钮、状态、图表、AI 思考与流式输出、过渡、登录、价格页、404 等组件,或用作英雄区、价格区、文档区等位置的背景。

主要能力按入口划分。

/kit 入口用于界面组件与背景,每次调用生成一个组件。资料提到 components.md 收录了 37 个组件,分类为 Components、AI、Text、Transitions、Media、Pages 和 Backgrounds。background() 提供 12 个精选背景预设,分别是 Swell、Drift、Halo、Caustics、Contour、Ripple、Mesh、Interference、Constellation、Cascade、Field 和 Fluid,均基于 GPU 字符场(WebGL2)。已弃用的旧预设仍会导出,但新项目不建议使用。fieldBackground 另有 hero、brand、notFound 预设。kit 函数会在元素上或内部挂载一个 aria-hidden 的字符场,跟随尺寸与圆角,从主题取色,离屏暂停,遵循减少动态设置,无 WebGL2 时返回惰性句柄;销毁时调用 destroy()。

/core 与 asciify-engine 入口用于媒体和文本转换,包括 asciify(静态图)、asciifyVideo(视频)、asciifyGif(GIF,调用时加载 gifuct-js)、asciifyText、renderTextToCanvas,以及 imageToAsciiTextFrame、renderTextFrameToCanvas 等更底层的帧处理函数。

/hover 入口用于网站悬停效果与动态图像运动,包含 Trail、Dissolve、Contour、Emboss、Ripple rings、Ink bleed、Water、Silk、Vortex 等交互,以及 Relight、Parallax、Focus pull 等十种照片感知静图运动。

/studio 入口用于艺术风格、外观保存、遮罩、效果以及 PNG/MP4/GIF 导出,mountStudioProject 支持多图层作品。

/field 入口提供原始 GPU 字符场 mountGlyphField,用于 kit 无法覆盖的自定义字符场外观。

使用方式上,资料建议先判断需求是 UI 组件还是背景,优先使用 kit,并按 applying-asciify.md、components.md、kit.md 的顺序查阅。集成时应先读取项目设计令牌(底色、表面色、文本色、强调色、字体、圆角、亮暗态、动效时长与缓动、减少动态处理),把 kit 的 ink 令牌映射上去。使用媒体转换时,直接用普通图片或视频转换,不要让图像生成器预先生成 ASCII;起始参数可参考 fontSize: 7、fps: 24 或 30、maxRenderDimension: 960,但这只是起始预算,不保证帧率。颜色模式有 fullcolor、grayscale、accent、matrix。

适用场景包括:带字符效果的按钮与状态、AI 流式回答、字符化背景、品牌文字标、视频字符化、照片或 GIF 转换、成品海报/壁纸/封面等艺术导出,以及多图层作品。

限制方面:背景预设基于 WebGL2,无 WebGL2 时只能降级;YouTube 页面 URL 与 iframe 播放器不能直接作为 canvas 视频源,需使用允许 CORS 的直接媒体文件;细密抖动在运动视频上可能闪烁;引擎的 HoverEffect 与网站增强交互并不相同,需分别处理;用 /studio 时不要再叠加 /hover 实例。资料未提供价格、平台支持矩阵、具体性能数值或商用授权信息。