-
-
Notifications
You must be signed in to change notification settings - Fork 3.3k
Archived Content
This project developed out of a Fellowship with the Processing Foundation exploring the future of Processing with JavaScript. Documentation of research in process and references is below.
#Starting points#
##Possibilities##
- what would be gained/lost by js, removing java altogether
- processing-lite, js syntax
- processing-js bridge to c++ compiles
- installations without c++
- processing as web dev
##Approaches##
- a bunch of different scenarios - writing out what code for that would look like
- speculative source code - examples or hack usable
##Goals##
- processing identity - running in browser, barrier to entry low
- primary audience - hard-core programmers, 19yr old design students
- system+api
- as a library, focus what processing does and doesn’t do
##Questions##
- What is unique about javascript?
- What are main ways it diverges/differs from java/processing?
- dynamic vs static
- loosely-typed vs strongly-typed
- prototypal vs classical inheritance
- functions as classes, constructors, methods
- classical objects are hard, the only way to add a new member to a hard object is to create a new class. js objects are soft, a new member can be added to a soft object by simple assignment. shallow hierarchies are efficient and expressive, deep hierarchies are often inappropriate.
- event driven vs linear/loop based
- Focus on browser experience? What about node, etc.
- Network connectivity, manipulating dom, interfacing with other elts outside canvas, user interface built-on elts that processing doesn't have, multiple drawing surfaces, interfaces with other libraries / also spec for other - maybe IDE adds in auto (like import library feature).
- question - limited to canvas?
##Considerations##
- Prototypal inheritance vs emulating classical inheritance.
- tool to make it more clear
- Optimization
- Embed instead of having to learn speed tricks?
- Callbacks/async
- helper fxn like newThread() method
- identify what sync/async, async ones have callback methods. if you have your own, here's how, and how to specify callback or not
- start everything with a
- use async module
- Library spec
- https://github.com/daniellmb/JavaScript-Scope-Context-Coloring
- http://codemirror.net/
- http://www.jslint.com/
##Core classes## PImage, PFont, PShape and PShader, PGraphics (needed to create offscreen drawing surfaces), and PVector.
##What js things could be improved?##
- libraries - documentready annoying, processing-js handles loading order for you (modernizer.js, queue.js), waits to execute
- (controlled loading and execution built-in)
- canvas/error handling
##Other notes##
- Library spec?
- dynamic typing - better typeof method, switch statement
- strict typeof
- enforce a type of code, scope
- jslint strict mode
- pokeyoke
- easy way to define your own events, bind listeners
##Current Processing JavaScript mode##
- processing.org/learning/javascript/
- github.com/jeresig/processing-js
- Processing.js is really two things: a Processing-to-JavaScript translator; and an implementation of the Processing API (e.g., functions like line(), stroke(), etc.) written in JavaScript instead of Java.
- Nothing new to learn - Processing.js automatically converts your Processing code to JavaScript. This means that you don't have to learn JavaScript in order to run your code in a browser.
- Does not currently support libraries.
- Possible to write native JS code inside sketch, but not intended use.
- Simulates synchronous I/O using Directives (preloading assets).
##Notes / considerations##
- web developer tools
- processing-js as entry point to web development
- more transparent, more standard web structure
- standard javascript - quasi auto complete, strict mode, viz of var scope, sequence
- live, quasi-live coding environment, dev tools built in
- also use processing methods
- visually represent what's going on, in terms of inheritance
- find in reference
- not too cluttered
- all the benefits, but executes like it's in the browser
##References##
###Tools
- JSHint - tool to detect errors and potential problems in JavaScript code and to enforce chosen coding conventions, flexible, easily adjusted to enforce particular coding guidelines and environment
- JSLint
###Editors
-
atom.io - open source, hackable editor created by github
-
- built on top of ace editor, processingjs, jshint
- real-time code execution - many tools to take advantage of this (number pickers, color picker, image picker)
- extensive error correction / suggestion
- philosophy behind khan academy cs
-
Light Table - desktop editor allows realtime modification of running code
-
Brackets - "open-source editor for web design and development built on top of web technologies such as HTML, CSS and JavaScript"
-
github.com/daniellmb/JavaScript-Scope-Context-Coloring - Experiment in switching between syntax highlighting and scope colorizing built on JSLint and CodeMirror.
-
CodeMirror - JavaScript component that provides a code editor in the browser. For supported languages, it will color your code, and optionally help with indentation. Also provides API and CSS theming system for customizing to fit your application, and extending it with new functionality.
-
Komodo Edit - free, open source version based on Mozilla XULRunner (like Firefox), comes with SpiderMonkey JS engine included and uses Scintilla as code editor
-
ICE Coder - pure browser IDE
-
codebender - arduino editor with sharing github.com/codebendercc
-
tributary - experimental environment for rapidly prototyping visualization code
-
OpenProcessing - has a page to create, run, stop a simple sketch from scratch
-
HasCanvas - tool for creating and sharing Processing sketches
See References on IDE page github.com/lmccart/js-processing/wiki/IDE-thoughts#references
- Plask - JS based creative coding env, Uses: V8, Skia, NodeJS, Cocoa & OpenGL, FreeImage, Syphon
- Plask on github
- two.js - two-dimensional drawing api geared towards modern web browsers. It is renderer agnostic enabling the same api to draw in multiple contexts: svg, canvas, and webgl. Aims to make the creation and animation of flat shapes easier and more concise, does not support text or image. Built in scene graph, animation loop, svg interpreter.
- paper.js - vector graphics scripting framework that runs on top of the HTML5 Canvas. It offers a clean Scene Graph / DOM and a lot of powerful functionality to create and work with vector graphics and bezier curves, largely compatible with Scriptographer
-
Ruby-Processing - Ruby syntax but utilizes the ease of Processing for drawing
- Uses regular Ruby for generating sketches, exporting applications and applets; and uses Java via JRuby for running Processing.
- Supports live coding, includes a control panel.
- Convenience method for searching through methods $app.find_method("ellipse") will return a list of the method names that may match what you’re looking for: “ellipse”, “ellipseMode”, and “ellipse_mode”.
- Transliteration vs. translation (Despite the fact that the entire Processing API is available to you, it’s best to work in idiomatic Ruby as much as possible.)
- Ruby-Processing in practice
-
ofxJavaScript (running JS in OF)
- Uses Mozilla SpiderMonkey.
- Exposes several classes of openframeworks library to Javascript, allows you to call C++ functions from Javascript, call Javascript functions from C++, or create your "own" Javascript classes.
- ofLiveCoding
-
Ringo - (based on Rhino) runs JS on Java and adds "goodies"
- allows use of any java class
- Ringo Java integration docs
- quil - processing + clojure
- python mode for processing
- another processing in python lib
- coffeescript mode for processing
- scala + processing
- Explains differences in JS engines quite nicely http://stackoverflow.com/questions/2137320/javascript-engines-advantages
- Performance http://stackoverflow.com/questions/9060841/rhino-vs-spidermonkey-performance-tests
- C++ binding http://stackoverflow.com/questions/93692/which-javascript-engine-would-you-embed-in-your-application
- desktop JS development http://stackoverflow.com/questions/109399/can-you-do-desktop-development-using-javascript
- appjs - HTML5 / CSS3, nodejs as backbone
- [Awesomium](http://awesomium.com/
- QT Webkit
- Berkelium
#References and Research
#Starting points#
Basic concept description / goals
This Processing+JavaScript library starts with the original goal of Processing at it's beginning, to serve as a software sketchbook and to teach computer programming fundamentals within a visual context, and reimagines it for today, based on JavaScript instead of Java. The focus will first be on basic API and 2D drawing functionality, leaving more advanced graphics features, like shaders and 3D, for later.
start with canvas, reveal
something about syntax, API
Spec out and test a JavaScript library that would enable Processing-like syntax for drawing using Canvas and WebGL. It's both about the syntax and how to code.
Bring "Processing" ideas to JavaScript, rather than to emulate Processing/Java through JavaScript. Explore how to take positive parts of what Processing does, and see what the affordances of JS add/remove to the equation.
Involves both "language design" and "ide design".
Idea of Processing syntax-wise was to take some of the nastiness out of writing Java code (having to define classes, threaded animation loops, etc) before you could make things show up on screen. Starting from scratch with JavaScript as the base language would ideally 1) use the nice bits of JS, and 2) hide the uglier bits.
Current work on the Processing JS port is focused on being able to be code compatible and having things run right out of the box (which is great!), but comes at the cost of keeping some of Java's quirks, while potentially hiding the nicer parts of JS. (Strictly speaking, you can still do JS inside of that mode, but it's not necessarily the intent or the current setup.)
- Khan Academy Computer Science
- Studio Sketchpad
- Light Table
- Sublime
- paper.js
- Ruby-Processing - Ruby syntax but utilizes the ease of Processing for drawing
- Ruby-Processing in practice
- Programming in a visual arts context
- Made for teaching programming
- Bridge to other languages
- Simple publishing for sharing
- Provide educational infrastructure (tutorials, videos, books)
- Community infrastructure
- Extensible through libraries
- Import/Export to diverse media and formats
- Concise IDE, scale to professional IDE
- Free to download
- Open Source
- Developed through workshops, forums, etc.
####DEVELOPER DOC ####INLINE DOCS GUIDE
If you are working on one of these things, create an issue on github and place your github username in brackets in the title, so others can collaborate rather than duplicate!
###Projects list
- DOM manipulation. The intention with this library is not to limit to the canvas, and to allow access to DIVs and other elements. It's not meant to replace jQuery, but to give some basic access to the DOM in a way that is intuitive and useful. This tutorial describes the current functionality. This area of functionality is just a first draft, and some further thought in terms of functionality and syntax would be really useful.
- https://github.com/processing/p5.js/issues/389
- https://github.com/processing/p5.js/issues/391
- https://github.com/processing/p5.js/issues/395
- https://github.com/processing/p5.js/issues/394
-
Touch interactions. Examples 5-0 through 5-3 here http://p5js.org/workshop/, demonstrate the current supported touch functionality. However, there are a few more questions to think about.
- Should there be some notion of a touch id for the touches[] array? This could be useful for persistently tracking touches.
- Example 5-2 demonstrates how to write your sketch to support both touch and mouse depending on device, but maybe we want a smart function or wrapper that automatically returns mouseX/Y or touchX/Y depending on device.
- Right now there is
touchStarted
,touchMoved
, andtouchEnded
. Should there be more functions to support touch?
-
Some file I/O stuff to finish up: https://github.com/processing/p5.js/issues/40
-
Thinking about text:
- https://github.com/processing/p5.js/issues/60
- https://github.com/processing/p5.js/issues/356
- Some materials are here from my A to Z class
- Thinking about svgs and pdf export:
-
Various bugs and issues.
-
Tutorial for sketch instantiation -- global and instance modes. This functionality was recently added! Now we need some explanation:
-
Developer page, extended version. [LUISA] This could be a great task for someone less experienced with JS or JS development. You could start by copying the current developer page into a new wiki page, then working through each step of the development setup process, and add a few sentences/paragraphs of lay mans explanation anywhere you would have liked to see it.
-
Other documentation currently needed: https://github.com/processing/p5.js/issues/346
-
Something else you are excited about?
- Sound module, data module, module template. And what is a "module" called anyway? Extension, addon, module?
- IDE
- WebGL
- Node.js + Websockets + p5.js
- Arduino or Physical stuff + p5.js
If you would like to edit this wiki and don't already have edit access, please open an issue or comment on an existing one noting the wiki page you'd like to edit. You will then be added as a repository contributor with edit access.