This repository has been archived by the owner. It is now read-only.
DoubleDraw allows multiple people to work collaboratively on a vector drawing
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
doc/img
public
views
.gitignore
README.md
package.json
server.js

README.md

DoubleDraw

This project is abandoned. If you would like to take it over, please send me a message.

DoubleDraw allows multiple people to work collaboratively on a vector drawing. A possible outdated or unstable example may or may not run here. This project aims to create a pure HTML5 vector editor as a response to Microsoft's decision for the next version of Windows™ to disallow any native applications.

DoubleDraw preview

Installing and running

The server-side is written in JavaScript. It requires NodeJs and npm (npm comes with NodeJs).

Dependencies:

Install all dependencies for node-canvas before proceeding.

For downloading all nodejs dependencies into ./node_modueles/:

npm install

The following dependencies are included in this repo and do not need to be downloaded:

Running

Start the server:

npm start

Access the server using any modern browser:

  • IE9 (or better)
  • Firefox
  • Chromium
  • Opera

Roadmap

  • User management
  • Layers
  • Upload picture
  • Record/playback
  • Save widget layout
  • Ensure consistent canvas (checksums)
  • More tools
  • Selection (deleting and moving drawings)
  • Operational transformation
  • Icons in user interface

Code

This chapter is mainly for reading the code and hacking.

Paper.js is an open source vector graphics scripting framework that runs on top of the HTML5 Canvas. When we draw using paper.js we will refer to it as drawing on "the paper".

The clients send mouse inputs (click/drag/release) events to the server. The server redistributes the events to all (including the sender) clients. The events are processed on all parties by a tool which knows what transformations (create path, edit, ect..) it should apply to the paper. All clients process the same events in the same order, this ensures a consistent paper across all parties. The server contains a paper too, this is serialized and send if a new user joins a room. A consequence of this setup is the round trip before any of your inputs show any effect on your paper.

The public folder contains all the client related code and resources. It is organized according to extjs MVC structure.

The server part is rather simply and is actually a small portion of the total code base. Its primary purposes:

  • Receive events and re-transmit them to all clients.
  • Process those events using a tool on a local paper.
  • Send paper if a new client joins a room.

The following code is shared between the server and the client for processing events and drawing on the local paper:

  • public/app/SharedPaper.js
  • public/app/UserDrawContext.js
  • public/app/model/tools/*

Contact

For bugs and feature requests you should make a ticket. Please check if there issent already a ticket open about the same issue.

For questions or offering help of any kind (programming, graphics, testers, advice) you can send a email or join on irc: room #DoubleDraw on irc.freenode.net. For convenience you can join using webchat.

License

All written code is released under WTFPL.

This program uses GPLv3 code (extjs), MIT licensed code and Creative Commons 2.5 licensed code (ntc.js Chirag Mehta, 4 Sep. 2007).