1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

Release notes for WordCram 0.4.1, 2011-03-27:

* Bug fix for issue 10: unicode characters in text don't show up in
  the image.


Release notes for WordCram 0.4, 2011-03-17:

WordCram 0.4 changes center around three themes: styling words
directly; knowing whether a Word was placed or skipped, and why; and
finer control over the rendering process.

* If you're creating and weighting your own Words, you can pre-set
  their styles by calling setAngle(), setColor(), setFont(),
  setSize(), and/or setPlace(). These values will pre-empt the rules
  set by the WordAngler, etc. Added getRenderedAngle(),
  getRenderedColor(), etc, so you can tell how it all turned out.

* Back-ported to run on Java 1.5, to match Processing, and updated the
  source build to use Processing 1.2.1.

* Added tutorial sketches, which walk you through WordCram in a more
  orderly way than the examples. Also added a few examples, and moved
  the sample text files & font files up, to shrink the download size.

* Added getWordAt(x,y).

* Added getSkippedWords(), which returns a Word[] of all words that
  were (so far) skipped, and getWords(), which returns a Word[] of all
  words the WordCram is looking at.

* Added wasPlaced(), wasSkipped(), and wasSkippedBecause() to Word,
  along with static ints on WordCram for the reasons (NO_SPACE,
  etc). Also added this info to Word's toString() method, so you can
  just println(yourWord) and see some good info.

* Dropped BBTree minimum size from 7 to 1 - there's no noticable
  slow-down, and it should make more accurate collision detection.

* Added withCustomCanvas(PGraphics), so a WordCram can be drawn to a
  PGraphics besides the sketch it's running in, and getProgress(), to
  provide feedback while it's rendering to the customCanvas. WordCram
  throws an exception if you try to pass it a P2D buffer, though -
  only JAVA2D works.

* Added maxAttemptsForPlacement(int), which tells WordCram to only
  try so many times to place a word.

* Added maxNumberOfWordsToDraw(int), which limits how many words
  WordCram will try to draw.

* Added minShapeSize(int), to weed out words that render to Shapes
  smaller than the given size.

* Added WordCram methods fromHtmlFile() and withColor(); made
  fromTextString() and fromHtmlString() n-arity (so they can be used
  w/ loadStrings() more easily).

* Changed Word.weight from a double to a float, so we can all stop
  casting.

* Added StopWords.GERMAN. Thank you, Felix, Marco, and Steffen!

* Deleted deprecated methods currentWord() and currentWordIndex().

* Reorganized text-parsing classes to make some classes (Html2Text)
  unavailable in the Processing sketch, to declutter the API.

* RandomWordNudger: you can now pass the standard deviation to use as
  a constructor parameter.

* Word now has methods getProperty(String name) and setProperty(String
  name, Object value).  The firstnamesUsingWordProperties example
  sketch shows how it works. Properties can be useful with a custom
  WordPlacer, WordColorer, etc.


Release notes for WordCram 0.3.1, 2010-11-10:

* Bug fix: in 0.3, the WordCram library folder under Processing was 
  renamed from wordcram to WordCram, but the .jar was still 
  wordcram.jar, so Processing didn't load it.  Renamed it to 
  WordCram.jar.


Release notes for WordCram 0.3, 2010-11-07:

* Added TextSource, so WordCram can count words from different kinds
  of source, including web pages and text files.
* Added a fluent API for building WordCrams: 
  new WordCram(this).forWebPage("{url}").sizedByWeight(10, 100).
* Added case-sensitive word counting, and the ability to exclude
  numeric words.
* Added javadoc comments for lots of classes -- more to come.
* Added Processing examples: in Processing, look under File >
  Sketchbook > libraries > WordCram > examples.
* Bug fix: issue 1, Stop-words with punctuation have no effect.
* Added StopWords.JAVA for making WordCrams from java source code.
* Added Anglers.heaped(), Anglers.randomBetween(min,max),
  Colorers.twoHuesRandomSatsOnWhite(), and
  Placers.horizBandAnchoredLeft().
* Deprecated old WordCram constructors, WordCram.currentWord(), and
  WordCram.currentWordIndex().
* Changed minimum shape size from 4 to 7, to speed up rendering.
* WaveWordPlacer and SwirlWordPlacer no longer randomly offset
  placement, so they should look crisper.
* Improved SpiralWordNudger's spiralling, so more words should show,
  and faster.