https://github.com/hacksalot/xkcdown

Smash xkcd comics into other...xkcd comics. In 3D! [Prototype]
https://github.com/hacksalot/xkcdown

Last synced: 4 months ago
JSON representation

Smash xkcd comics into other...xkcd comics. In 3D! [Prototype]

• Host: GitHub
• URL: https://github.com/hacksalot/xkcdown
• Owner: hacksalot
• License: other
• Created: 2015-05-28T05:42:08.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2022-12-06T19:58:27.000Z (about 2 years ago)
• Last Synced: 2024-04-14T22:17:25.153Z (10 months ago)
• Language: JavaScript
• Homepage: https://xkcdown.indevious.com
• Size: 1.7 MB
• Stars: 5
• Watchers: 3
• Forks: 0
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
xkcdown

===

*Transform cartoons from the xkcd webcomic into colliding 3D blocks directly

in the browser.*

xkcdown is an interactive 3D visualization of popular webcomic [xkcd][2] with

support for physics, collisions, camera movement, and smashing xkcd comics into

stacks of other comics. **[View the live demo][1]**.

![][3]

## Features ##

- Standard HTML5 / CSS / JavaScript implementation.

- Cross-browser with recent Chrome, Firefox, IE, Safari.

- HTML-driven via standard `` tags and layouting.

- Simulation runs are shareable (through permalinks).

- Simulation runs are seedable (through an optional seed).

- Simulations runs are repeatable (by repeating the seed).

- Simulations runs are (pseudo-) random; new comics with each page load.

- Multiple visualization/simulation types.

- Full mouse and keyboard controls.

## Build ##

1. Clone or fork the sources.

2. BYOI (Bring Your Own Images). Place images in the `src/img` folder and name

them consecutively (`1.png`, `2.png`, etc.) for easy random selection.

3. Run `bower install` and `npm install` in the top-level project folder to

install dependencies.

4. To build and serve a local copy of the demo run `grunt serve:debug` or

`grunt serve:release`. You can also run `grunt build:debug` or

`grunt build:release` to build without serving.

## Credits ##

- Original comics by Randall Munroe (http://xkcd.com).

- "xkcdown" concept and code by James Devlin (https://deskchained.com).

## License ##

MIT

[1]: https://xkcdown.indevious.com

[2]: https://xkcd.com

[3]: https://xkcdown.indevious.com/img/xkcdown_static_float.png