pboyer / flood

Visual programming for the browser

flood

What is it?

flood is a dataflow-style visual programming language based on Scheme written in JavaScript. flood runs in a browser and as a standalone application on all platforms via node-webkit.

Features

• Constructive solid geometry - Cube, cylinder, sphere, union, intersect, subtract
• Formula node - evaluate javascript in a node
• Never save your work
• Fast node library search
• Undo/redo across user sessions
• Copy/paste
• Multiple workspaces
• Async evaluation
• Partial function application
• "Always on" continuous execution

flood, like early versions of Dynamo, is based on Scheme and thus has many of the features of that language. It uses a lightweight scheme interpreter I wrote called scheme.js.

Getting started

The flood app is scaffolded with Yeoman, uses Grunt for task management and Bower for web package management. If you're not familiar with these tools, you should take a look at the docs and get them installed.

flood uses require.js to manage dependencies between JavaScript files and backbone.js to stick it all together.

flood also has a server written in node.js that handles user authentication and model synchronization.

Installing dependencies for the app

To install all of the dependencies for the flood app, run the following commands in the root directory:

bower install
npm install

This will install all of the development dependencies for Grunt and all of the public dependencies with bower.

Installing dependencies for the server

To install all of the node.js dependencies for the flood server, run the following commands in the "server" directory:

npm install

You will also need to install MongoDB and run an instance on port 27017, the default port for MongoDB. You can get MongoDB here.

Running the server

For development, I recommend using the great nodemon tool:

npm install -g nodemon

Go to the "server" directory and run:

nodemon app.js

You can also run the server using:

node app.js

Building for the web (outdated)

The entire app can be compressed into lightweight, minified, and concatenated css, js, and html files using Grunt:

grunt 

Building for the desktop

flood can be used as a standalone application via node-webkit. Just do this:

grunt desktop

This will generate binaries for use on Mac and Windows in the dist_desktop folder.

License

The MIT License (MIT)

Copyright (c) Peter Boyer 2014-2020

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

flood's Issues

SolidSubtract doesn't seem to work?

Input is two Solids --- does some third object need to be connected for output? I couldn't get it to work.

zoom focus suggestion

When in editor mode the ability to zoom into a node by double clicking on mobile would make it much more usable.

At the moment its very hard to control / use it.

The other parts are excellent I am finding.

On a side note I wonder if the files can be linked to google drive ,?

Unable to log in

Hi, this project looks really cool and I would love to try it out. However, I am unable to log in. After installing the app locally, navigating to http://localhost:3000/app.html, and logging in via Google, I got redirected to Google's 401 error page which says this:

401: That’s an error.

Error: invalid_client

The OAuth client was not found.

Request Details
scope=profile email
response_type=code
redirect_uri=http://localhost:3000/auth/google/callback
client_id=Your Client ID

Is there any way I can access the app without logging into a service?

Thanks for your help!

OT: contacting @procedural

Hye @procedural, I saw you starred this repo.

What happened to all your repos, in particular the excellent but closed source GifRecorder, for which people paid?

@pboyer: apologies; @procedural hasn't left any contact method on their GitHub profile.

Awesome program! Some quick feedback/feature requests

Add a 3rd view where you could hide all but designated input objects and rotation and so forth would still work?

Create a way to snap / group the numeric objects? Also an align option?

Is there a way to control the rendering quality? I'd like smoother spheres when exporting to STL

DOMParser is not defined

Hi @pboyer,

I'm trying to parse an XML file in Flood. Script node returns an error that DOMParser is not defined. Is there an easy way to fix this? Am I making a mistake?

I can run the script from console with no problem.

failure getting reach build past loading screen [Reach] branch

Hi there, I'm trying to bring the reach branch up on a virtual server. I followed the instructions from the main readme and it appeared to install correctly.

I launched the app and connected to it. but asked to 'wait for it'... forever

i tried in firefox as well same result. opening the console show that socket connection can't be opened...

previously, i was able to bring the master branch up, got into the editor, but couldn't product any geometry.

Super interested in getting this running and learning more. please let me know if there is something simple i'im missing

Moving or Translating the objects

I tried to move a cube. But when I tried moving it, the Flood have made the replica of the cube but according to the new co-ordinate? How do I move the object without creating the replica?