For more information about iStoryline
iStoryline.js is a JavaScript library for producing storyline visualizations with diverse sketchy styles. Storyline visualization is a fancy way to tell a story. Lines represent characters in the story. This fancy visualization naturally has some advantages in explaining the story:
Example storyline visualizations created using iStoryline.js. The styles and visual labels are customized manually to embellish the storylines. For more information, please check our paper and the supplement material.
Use the package manager npm or yarn to install iStoryline.
npm install i-storyline-js
or
yarn add i-storyline-js
import iStoryline from "i-storyline-js"
let iStoryliner = new iStoryline();
// generate storyline visualizations from the story script
let storyScriptUrl = './data/xml/Redcap.xml';
// graph can be drawed using any canvas or svg libraries
let graph = iStoryliner.load(storyScriptUrl);
// obtain the characters names
console.log(graph.characters); // ['Red cap', 'Mother', 'Wolf', 'GrandMa']
// obtain the paths of the characters
console.log(graph.storylines); // [[[x1, y1], [x2, y2], ...], ...]
iStoryline.js provides a build-in editor for producing storyline visualizations.
Install Node.js (>= 10.0)
Install dependencies npm i
or yarn
Start the editor npm run start
Please visit localhost:8080
We appreciate your citation if this library contributes to your work.
@article{iStoryline2018,
title = {{iStoryline: Effective Convergence to Hand-drawn Storylines}},
author = {Tang, Tan and Rubab, Sadia and Lai, Jiewen and Cui, Weiwei and Yu, Lingyun and Wu, Yingcai},
journal = {IEEE Transactions on Visualization and Computer Graphics},
volume = {25},
number = {1},
pages = {769--778},
year = {2018},
publisher = {IEEE}
}
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.