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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207

208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276

= Release Notes =

Avatar Core Framework - a free framework for creating and displaying avatars.

http://avatarcore.googlecode.com/


== Known issues ==

- None


== Change List ==

=== 0.2.0 (August 28, 2009) ===

There have been a number of new API changes, as well as a reworking
of how parenting is handled.  The new approach allows Constrain behaviors
to work better with parenting. In addition some rendering changes have
been made that change the effects of parent transforms on their children.

- Added Viewport.resetContent()
- Added a padding parameter to Viewport.fitContent()
- Added ThumbnailArtSprite class
- Added SourceLoaderSprite class as a base class for ArtSprite and
  ThumbnailArtSprite
- Renamed AvatarArt to AvatarDisplay to prevent confusion with with the
  Art/ArtSprite classes
- ArtSprites no longer redraw themselves (i.e. their feature) when their
  feature property is set. This was creating many more calls to draw() than
  was necessary, though may require additional manual calls for updates
- Scaling a parent feature no longer scales its children; child position,
  however, is still affected by scale
- Renamed Transform to Adjust to prevent confusion with flash.geom.Transform
- Instead of mirroring features with a negative scale, flipX and flipY
  properties have been added to the Adjust (Transform) class 
- Fixed a bug in Adjust.add and Adjust.subtract where x and y were flipped
- Renamed "update"-related API in Feature and Avatar to "redraw"
- Changed parent-related API in Feature (removed getParentFeature, added
  parent, [internal]parentCount, [internal]updateParent)
- Features are no longer hidden if their parent cannot be found. They are
  instead left visible and treated as though they have no parent
- Added Feature.getConcatenatedParentMatrix()
- Added Avatar.updateParentHierarchy(). This is called frequently through
  other APIs but may be necessary to call to make sure the parent 
  hierarchy of an avatar is accurate
- Added getDefaultPropertiesInXML to IXMLWritable, helping to reduce the 
  inclusion of default values in generated XML
- Range class now has a steps property
- Separated Constrain.position (Rect) to Constrain.x (Range) and 
  Constrain.y (Range)
- Removed Rect class (was only used by Constrain before)
- Constrain uses its Ranges' steps, if provided, to apply stepping
  to constrained values
- Constrain is now applied to feature adjusts (transforms) rather than
  directly to art sprites to allow child adjusts to honor the
  constrain
- Added Constrain.name, making it more convenient to access Contrain
  behaviors in a feature
- Other minor bug fixes

=== 0.1.5 (May 25, 2009) ===

Minor API changes, mostly to Definitions class.

- Added xml parameter to Definitions constructor
- Renamed Definitions.setXML() to parse()
- Renamed Definitions.loadXML() to load()
- Added Definitions.updateAvatar()
- Added Definitions.updateAvatars()
- Avatar.libraryName will return the name of any Library objects associated
  with the avatar if available rather than the Avatar's own, internal
  libraryName value
- Changed a print WARNING to print NORMAL for features using a default
  feature definition item (e.g. art.name not specified so first Art in a 
  linked FeatureDefinition.artSet is used)

=== 0.1.0 (May 5, 2009) ===

This release is a quickfix for an outstanding issue related to content
loading. It also signifies a change in version numbering, now using the
minor version for new releases instead of just the build.

- Fixed a bug preventing art referencing assets from an external source (not
  in SWF library) from being displayed on the screen.

=== 0.0.5 (May 3, 2009) ===

This release mostly focused on exposing more of the API (such as getRendered*)
to make it easier to develop custom behaviors for features. Additional methods
and attention was also given to make avatar/feature updates easier.

- Added frame support for art assets. Frames are specified by placing a hash
  (#) and the frame identifier (number or label) at the end of the Art src
  field, e.g. <Art src="eyes.swf#12" /> - goes to frame 12 in the eyes.swf
  timeline when loaded in as an art asset
- Added support for BitmapData class names in Art.src for bitmap images in
  a Flash library
- Smoothing for bitmaps can now be specified with Art.smoothing.
- Added ArtSet.smoothing so child Art instances can inherit default smoothing
- Added Feature.getRenderedArt() (existed but not exposed)
- Added Feature.getRenderedColor() (existed but not exposed)
- Added Feature.getRenderedTransform() (existed but not exposed)
- Added Feature.getParentFeature() (existed but not exposed)
- Added Feature.avatar
- Added Feature.update()
- Added Avatar.updateFeatures()
- Many Feature members now automatically call update() when set (art, color, 
  transform, their respective name members, and artStyle). Calling update
  manually may still be needed for some operations such as modifiying nested
  members of objects contained within Feature objects
- Constrain behavior now distinguishes between scaleX and scaleY

=== 0.0.4 (April 30, 2009) ===

This release strengthens the ability for an Avatar to be fully functional and
self-contained without the need for a library.  This includes the introduction
of behaviors.

- Removed Transform.fill() as it no longer applied
- Added Transform.add() and respective subtract()
- Base transforms are no longer used with concatenation but are added to the
  actual transforms of the feature (i.e. they're truely now a starting
  transform rather than a parent transform)
- Added clone() methods to Constraint, Rect, and Range
- Added a new class FeatureBase as a base class to FeatureDefinition and 
  Feature
- Added support for behaviors
- Added behaviorSet to FeatureBase
- Removed FeatureDefinition.constraint and converted it to a behavior named
  Constrain
- Removed MirroredFeatureDefinition and converted it to a bahavior named 
  Mirror; Mirroring now works with the consolidate APIs
- Reworked parent references to now also work through Features using 
  Feature.parentName (now inherited from FeatureBase)
- Removed TransformSet and ColorSet, changing FeatureDefinition.transformSet
  and colorSet to be SetCollection instances.
- Moved all classes within the data package into the parent avatarcore.
  This also requires XML to use the namespace com.myavatareditor.avatarcore
  (removing the data)
- XMLDefinitionParser no longer throws an error for definitions in XML it 
  cannot resolve into class definitions
- XMLDefinitionWriter no longer creates XML nodes for properties with no
  attributes or children (e.g. empty collections)
- Added AvatarCoreVersion to indicate the current version of the framework
- Added clone() to FeatureEvent and FeatureDefinitionEvent classes
- Added SimpleDataEvent class
- Added Definitions.loadXML()/setXML() to make it easier to load definitions
  from an external XML source.
- Renamed FeatureDefinitionEvent.definition to 
  FeatureDefinitionEvent.featureDefinition
- Added a name property to Collection (but not as part of ICollection)

=== 0.0.3 (April 27, 2009) ===

This release mostly improves on the API, simplifying it and making it
more consistent.

- Removed Library.getDefinitions as it was redundant with
  ICollection.getItemsByType(FeatureDefinition)
- Combined the FeatureEvent.FEATURE_TRANSFORMED and
  FeatureEvent.FEATURE_CHANGED events into just one
  FeatureEvent.FEATURE_CHANGED event
- Removed the rebuildArt parameter in Avatar.refreshFeature.  It is now 
  automatically detected whether or not art needs to be rebuilt.
- Renamed Avatar.refreshFeature to Avatar.updateFeature
- Added AvatarArt.updateFeature - the respective call made from the Avatar
  event dispatched when Avatar.updateFeature is called
- Removed redraw parameter from AvatarArt.addFeatureArt
- Removed AvatarArt.updateArtArrangement; it is now handled in AvatarArt.draw
- Removed creator property from Avatar. If needed, this property, and others
  like it, should be added in custom extensions by developers
- Created a TransformSet class, a collection for containing variations on
  transformations
- Added the transformSet property to the FeatureDefinition class for
  containing a set of pre-defined transforms
- Added Feature.transformName
- Added clone() methods to Transform, Color, and Art.
- Added ICollection.copyCollectionFrom() for deep cloning of ICollection
  collections for objects that support the clone method
- Fixed a bug in Collection where removing an item would delete the item index
  rather than splicing it from the collection array if the name of that item
  was numeric (which is the default assigned name - the index - if one is not
  explicitly provided)
- Feature.color will now be correctly applied to an Avatar if that feature has
  no associated definition
- Included separate scaleX and scaleY properties in Transform. The scale
  property now reflects an average of these two values when queried, or
  defines both when set.
- Fixed Viewport contstructor arguments which were previously being ignored
- Added Library.name
- Added Avatar.libraryName
- Added a new Definitions class which automatically links avatars to libraries
  when Avatar.libraryName matches Library.name
- Changed behavior of Feature.artName and Feature.colorName to now reference
  Feature.art.name and Feature.color.name respectively if defined, or default
  to the names used as defaults when that feature is rendered through a library
- Added SetCollection class as a base class for ArtSet, ColorSet and 
  TransformSet for their redundant properties
- Added a defaultName property to set classes (in SetCollection) to specify
  default items. This replaces FeatureDefinition.defaultColorName and
  defaultArtName as well as what would have been defaultTransformName.
- Removed FeatureDefinition.defaultArt, defaultColor and defaultTransform
- Added FeatureDefinition/Feature.baseTransform
- Added Feature.consildate() and Avatar.consolidateFeatures()
- Changed behavior of Transform to write Transform properties as attributes
  when written to XML by XMLDefinitionWriter rather than child elements

=== 0.0.2 (April 14, 2009) === 

This release improves on the API design as well as extends the XML
capabilities of the framework.

- Renamed MirrorArtSprite to MirroredArtSprite
- Art objects now replace ArtGroup objects completely.  Art requiring multiple
  art assets would consist of one Art instance containing multiple other Art 
  instances.
- Updated Art constructor to include a src parameter
- Added a thumbnail property to the Art class. This would be used by editors 
  to present selections to the user
- Updated Rect with constructor parameters that mirror flash.geom.Rectangle
- Added constructor parameters to Constraint
- Fixed bug where new features added to avatar weren't being updated to use 
  that avatar's library
- Avatar.addFeature and similar APIs have been removed in favor of sticking 
  with the inherited collection APIs of the same type.  These methods are 
  overridden as necessary to provide feature events.
- Feature.transform is now null by default
- Added additional default properties into FeatureDefinition
- FeatureDefinition.transform renamed to defaultTransform
- Added FeatureDefinitionEvent
- Library now dispatches FeatureDefinitionEvent events for definition 
  addition, removal and changes
- Changes in libraries (invoking events) are recognized by Avatars allowing 
  them to update automatically as needed
- Moved XMLDefinitionParse out of avatarcore.data.xml package into just 
  avatarcore.xml
- XMLDefinitionParser now creates instances for null objects where xml 
  nodes attempt to define values
- Added XMLDefinitionWriter for writing XML from objects
- Added IXMLWritable interface for defining properties related to writing XML 
- Removed term "Collection" from ICollection API
- Added getItemsByType method in ICollection
- Added Viewport class for containing avatar graphics and capturing graphics 
  as bitmaps
- Converted most class member variables to accessor methods
- More documentation within source code


=== 0.0.1 (March 27, 2009) ===

- First release


== License == 

Copyright (c) 2009 Trevor McCauley

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.