Skip to content

Anubisxcw/anichart.js

 
 

Repository files navigation


Code Time NPM npm GitHub last commit GitHub closed issues Language grade: JavaScript

轻松地制作数据可视化动画视频。

示例

在线编辑

Edit e8em0

效果展示

点击前往示例项目

写在前面

开发过程中我认识到架构上的不合理之处,API正在重构中,仅有测试用例,没有项目文档。请谨慎使用。

本项目开源、自由、免费。

这是一个Web、Node等环境下,利用TypeScript或者JavaScript编程的动画库。可用于数据可视化、视频动画展示、片头片尾等领域。

目前正在开发中,虽然该有的功能已经实现了,但是没有提供友好的接口,想要做出自己的作品需要阅读源代码并了解JavaScript编程。

目前前端、后端导出视频均使用内置的FFmpeg。能够直接导出MP4。如果觉得wasm版本的FFmpeg速度过慢,也支持导出Png序列,调用本地FFmpeg生成视频。

人机交互友好的网站建设已经在搞了(指建好了仓库),还要较长一段时间才能完成。

本项目需要各位技术人员的技术支持。但如果你只是一个普通的使用者,也能通过赞助的方式支持。你可以通过爱赞助利用支付宝或者微信进行支持。也能通过GitHub Sponsor功能支持(需要信用卡一张)。

简介

这是一个更好的可视化模板。

相较于它的前身,主要优势在于:

  • 可编程化:开放接口,允许插入自定义的代码,利用框架计算的数据,基于Canvas Api进行绘图。
  • 直出视频:可以直接通过每一帧的图像渲染视频,无需借助任何录屏工具。
  • 自动边距:不用再自己指定内边距,导致文字超出范围了。
  • 任意比例:能够导出任何分辨率而无需后期处理。
  • 高效绘图:采用Canvas而不是Svg,更加节能。
  • 帧率可控:逐帧绘图,导出视频而不会掉帧。
  • 逐帧调试:提供组件进行逐帧调试和播放。
  • 自带插值:提供了更加友好的数据预处理。
  • 优化着色:提供了更好的颜色随机算法。

此外,对于柱状图:

  • 交换算法:现在的交换不必在关键帧之间卡点了。
  • 显示效果:画风变了。

安装

使用Yarn

yarn add anichart

使用Npm

npm i anichart

标签导入

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/anichart.min.js"></script>

用法

即将过时:以下用法为1.x版本的API,2.x版本正在开发中,暂无API文档,但可以通过test文件夹的测试用例浏览用法。

使用Npm或者Yarn导入

如果使用标签导入可以跳过这一步,如果使用npm或者Yarn需要通过以下代码引入包:

const anichart = require("anichart");

或者

import * as anichart from "anichart";

准备数据

以CSV文件为例。

name,date,value,channel,other
Jannchie,2020-01-01,1,科技,other
Jannchie,2020-01-03,6,科技,other
Jannchie,2020-01-05,3,科技,other
Jannchie,2020-01-07,-,科技,other
Jannchie,2020-01-09,7,科技,other
Jannchie,2020-01-12,12,科技,other
Cake47,2020-01-03,10,生活,other
Cake47,2020-01-02,5,生活,other
Cake47,2020-01-06,2,生活,other
Cake47,2020-01-09,3,生活,other
Cake47,2020-01-11,4,生活,other

创建对象

let a = new anichart.Bar();

载入数据

// 回调语法
b.loadCsv("./data.csv").then(() => {
  b.initCanvas();
  b.readyToDraw();
});
// 你也可以使用 async 语法
await a.loadCsv(pathData);
a.initCanvas();
a.readyToDraw();

播放动画

默认情况下,在浏览器内会有一个类似进度条的组件用于控制播放。

你也可以使用代码控制播放。

// 代码控制
a.play();

导出视频

内置了ffmpeg进行导出。输出信息会在console中打印。

// 配置导出视频
a.output = true;

测试

Browser环境

使用yarn:

yarn serve

或者npn:

npm run serve

Node.js环境

不建议使用:Node.js 的版本在未来被暂时移除。因为相关依赖的包安装速度过于缓慢,使用体验较差。同时Browser版本的导出速度得到了极大的提升,这使得node版本显得不是特别重要了。之后Node.js版本将来会作为独立的版本进行安装。

如果有特殊需求,比如服务器端定时导出视频的用户,请等待正式版本。

node --experimental-wasm-threads --experimental-wasm-bulk-memory index.js

About

Easily create data visualization animation videos

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 86.1%
  • JavaScript 13.9%