Skip to content
This repository

generate word clouds in Processing

Add WordCram.testPlacer(), which renders a heatmap over your sketch, …

…based on where your words will be placed
latest commit ef49d50f29
Dan Bernier authored December 07, 2013
Octocat-spinner-32 .settings backported from java1.6 to java1.5 - should run on 1.5 JVMs now February 13, 2011
Octocat-spinner-32 example Rename withCustomCanvas to toCanvas July 18, 2013
Octocat-spinner-32 ideExample Strip out ASL copyright headers. The LICENSE file should suffice. December 01, 2013
Octocat-spinner-32 javadoc Updating javadoc for 0.5.7 release. February 25, 2013
Octocat-spinner-32 lib Revert "Add batik.jar to /lib, Rakefile, and .classpath" July 13, 2013
Octocat-spinner-32 src Add WordCram.testPlacer(), which renders a heatmap over your sketch, … December 07, 2013
Octocat-spinner-32 test Strip out ASL copyright headers. The LICENSE file should suffice. December 01, 2013
Octocat-spinner-32 .classpath Remove .svn excludes from .classpath, since we're off .svn December 01, 2013
Octocat-spinner-32 .gitignore Add .swp to .gitignore December 01, 2013
Octocat-spinner-32 .project Initial Commit August 30, 2010
Octocat-spinner-32 .ruby-gemset Switch from .rvmrc to .ruby-version June 19, 2013
Octocat-spinner-32 .ruby-version Switch from .rvmrc to .ruby-version June 19, 2013
Octocat-spinner-32 Gemfile For #15, move downloads from github to Amazon S3 February 25, 2013
Octocat-spinner-32 Gemfile.lock For #15, move downloads from github to Amazon S3 February 25, 2013
Octocat-spinner-32 LICENSE Initial Commit August 30, 2010
Octocat-spinner-32 NOTICE Initial Commit August 30, 2010
Octocat-spinner-32 README.md Update README: we have lots of examples now February 13, 2013
Octocat-spinner-32 RELEASENOTES.txt Add #42 bug fix to Release notes August 10, 2013
Octocat-spinner-32 Rakefile Kill unused release summaries from Rakefile August 24, 2013
Octocat-spinner-32 VERSION Bump version to 0.6.1 December 01, 2013
Octocat-spinner-32 build.json.example Make a build.json.example for peeps who want to build WordCram February 25, 2013
Octocat-spinner-32 wordcram.png javadoc: added overview.html and wordcram.png; added some javadoc com… October 20, 2010
README.md

WordCram lets you generate word clouds in Processing. It does the heavy lifting -- text analysis, collision detection -- for you, so you can focus on making your word clouds as beautiful, as revealing, or as silly as you like.

Word Cloud by
WordCram

Make a Word Cloud

import wordcram.*;

// Set up the Processing sketch
size(1000, 600);
colorMode(HSB);
background(230);

// Make a wordcram from a random wikipedia page.
new WordCram(this)
  .fromWebPage("http://en.wikipedia.org/wiki/Special:Random")
  .withColors(color(30), color(110),
              color(random(255), 240, 200))
  .sizedByWeight(5, 120)
  .withFont("Copse")
  .drawAll();

You can control where words appear, what angle they're at, their font, their color, and how they're sized.

Install

Installing WordCram is simple, like any standard Processing library.

How do I use this thing? Show me examples!

You can check out the tutorials and examples at http://wordcram.org. You can watch WordCram in action, on OpenProcessing: popular baby names, and the U.S. Constitution.

But the best way to see WordCram in action is to install it, and look at the examples under File > Examples > Contributed Libraries > WordCram.

Problems?

If you're running into problems, see the FAQ, or read the javadocs.

If a question has you stumped, and the FAQ is no help, send me a note. My email account is 'wordcram', and I use gmail.

Want a better WordCram?

WordCram is open-source under the Apache 2 license. That means you can help make it better! I try to keep the source clean so it's easy to find your way around. There's a laundry list of things to do, and it's easy to build WordCram from source.

Something went wrong with that request. Please try again.