changelog

pageClass	sidebarDepth	title	lang
change-log	3	Two.js Changelog	en-US

Changelog

All notable changes to this project will be documented in this file. The format is inspired by Keep a Changelog, and this project adheres to Semantic Versioning.

Nightly

• Added static method fromObject to all Two.Element and descendant classes
• Added method copy to all Two.Element and descendant classes
• Added tests for toObject methods
• Improved TypeScript types for argument relation
• Two.WebGLRenderer correctly handles negative scale values
• Two.Path.noStroke, Two.Text.noStroke, and derivative methods now include setting both the stroke color to "none" and the line width to 0
• Fixed Two.Arc flag behavior for Two.Arc.width and Two.Arc.height properties

June 10, 2024 v0.8.14

June 10, 2024

• Made objectBoundingBox application consistent accross renderers
• Patched texture scaling in Two.SVGRenderer
• Updated Typescript definitions @kevin-nano

February 22, 2024 v0.8.13

February 22, 2024

• Added Two.Text.direction for rendering text either left to right or right to left
• Improved Two.WebGLRenderer texture crispness / aliasing
• Improved consistency of Two.Text.baseline rendering across all renderers

October 16, 2023 v0.8.12

October 16, 2023

• Added "no-referrer" policy to image requests
• Updated extras to be compatible with Two.Matrix API changes
• Two.Path.noFill() yields "none" instead of "transparent"
• Two.Path.noStroke() yields "none" instead of "transparent"
• Two.Text.noFill() yields "none" instead of "transparent"
• Two.Text.noStroke() yields "none" instead of "transparent"
• Two.Points.noFill() yields "none" instead of "transparent"
• Two.Points.noStroke() yields "none" instead of "transparent"

August 7, 2023 v0.8.11

August 7, 2023

• Fixed getters on Two.Anchor.left and Two.Anchor.right @eatgrass
• Improved Two.Path.getBoundingClientRect, Two.Group.getBoundingClientRect, and Two.Text.getBoundingClientRect to correctly handle projected points that are rotated by matrices
• Improved types.d.ts for Two.Group
• Two.Text rendered to SVG directly instead of <defs />
• Two.SVGRenderer disposes of unused effects from <defs />
• Override Two.Collection.map method to be more explicit
• Improved types.d.ts for renderers and base Two class

June 9, 2022 v0.8.10

June 9, 2022

• Added Two.Arc to /extras directory
• Made /extras/js/zui.js ES6 compliant
• Removed /extras modules from generated documentation
• Added method documentation to Two.ZUI
• Improved types.d.ts
• Fixed Commonjs imports from package.json

May 9, 2022 v0.8.7

May 9, 2022

• Fixed documentation links
• Made Two.Group and Two.Text properties public in TypeScript types
• Added overloaded methods to TypeScript types
• Fixed Two.Path.ending discrepancies when Two.Path.curved = true

Mar 29, 2022 v0.8.5

Mar 29, 2022

• Added Two.Gradient parent parameter to Two.Stop.clone
• Breaking: Added export maps so extras are imported like so import { ZUI } from 'two.js/extras/zui.js'

Jan 29, 2022 v0.8.3

Jan 29, 2022

• Improved Two.Element.className flagging and classList construction
• Manually amended types.d.ts for better TypeScript developing

Jan 19, 2022 v0.8.2

Jan 21, 2022

• Removed # private declared variables for better EcmaScript compatibility
• Fixed Two.Path.begining and Two.Path.ending interpolation when Two.Anchor.relative = false
• Added Two.Utils.read.path(string) which allows for string interpretation of an SVG path's d attribute
• Added Two.Shape.worldMatrix

Jan 10, 2022 v0.8.0

Jan 10, 2022

• Added Two.Element as an EcmaScript 6 class
• Converted Two.ImageSequence to EcmaScript 6 class
• Converted Two.Sprite to EcmaScript 6 class
• Converted Two.Texture to EcmaScript 6 class
• Converted Two.Stop to EcmaScript 6 class
• Converted Two.RadialGradient to EcmaScript 6 class
• Converted Two.LinearGradient to EcmaScript 6 class
• Converted Two.Gradient to EcmaScript 6 class
• Converted Two.Star to EcmaScript 6 class
• Converted Two.RoundedRectangle to EcmaScript 6 class
• Converted Two.Rectangle to EcmaScript 6 class
• Converted Two.Polygon to EcmaScript 6 class
• Converted Two.Points to EcmaScript 6 class
• Converted Two.Line to EcmaScript 6 class
• Converted Two.Ellipse to EcmaScript 6 class
• Converted Two.Circle to EcmaScript 6 class
• Converted Two.ArcSegment to EcmaScript 6 class
• Converted Two.Path to EcmaScript 6 class
• Converted Two.Group to EcmaScript 6 class
• Converted Two.Text to EcmaScript 6 class
• Converted Two.Shape to EcmaScript 6 class
• Converted Two.Matrix to EcmaScript 6 class
• Converted Two.Registry to EcmaScript 6 class
• Converted Two.Children to EcmaScript 6 class
• Converted Two.Collection to EcmaScript 6 class
• Converted Two.Events to EcmaScript 6 class
• Converted Two.Anchor to EcmaScript 6 class
• Converted Two.Vector to EcmaScript 6 class
• Two.interpret appropriately inherits classes to <g /> tags @elShiaLabeouf
• Two.interpret inherits classes and data-* attributes @elShiaLabeouf

Dec 15, 2021 v0.7.13

Dec 15, 2021

• Improved SVG gradient interpretation
• Two.interpret can properly unwrap CSS url() commands
• Added Two.Gradient.units and respected in all renderers
• Default units space for Two.Gradient is objectBoundingBox
• Removed destructive attribute assignments in Two.interpret
• Interpreted gradients are reused as <defs />

Nov 24, 2021 v0.7.12

Nov 24, 2021

• Made mask removal possible on Two.Groups, Two.Paths, and Two.Points'
• Simplified Two.Points.vertices management for renderers improving adaptability

Nov 20, 2021 v0.7.10

Nov 20, 2021

• Fixed empty vertices issue on Two.Points

Nov 11, 2021 v0.7.9

Nov 11, 2021

• Made Two.load and Two.interpret consistently apply SVG viewBox
• Made Two.Rectangle.origin act as inverse anchor positioning
• Made Two.Path.toObject objectify fill and stroke attributes that are Two.Texture and Two.Gradient
• Improved reassigned id selection on interpreted SVG elements
• Improved Two.load group duplication
• Added Two.Points and Two.makePoints to all renderers
• Made Two.release mimic behavior of Two.remove

Jul 13, 2021 v0.7.8

Jul 13, 2021

• Made types.d.ts a shim of a module so that it can at least be loaded in TypeScript projects while the ES6 class declaration is still work-in-progress

Jul 10, 2021 v0.7.6

Jul 10, 2021

• Fixed id setting on all objects of Two.js
• Fixed Two.ArcSegment.clone outer radius issue
• Standardized vertex generation in higher order primitives
• Type declaration improvements
• Improved Two.Group.center, Two.Group.corner, Two.Path.center, Two.Path.corner
• Improved SVG gradient interpretation
• Added <defs /> interpretation
• Added Two.Path.mask and Two.Text.mask properties
• Standardized Texture.id to be compliant with other Two.Shape.id
• Added ability to interpret <clipPath /> and <image /> SVG elements

Apr 23, 2021 v0.7.5

Apr 23, 2021

• Improved Two.Circle.beginning & Two.Circle.ending behavior
• Improved fitted logic on instances of Two
• Improved Two.Children and Two.Collection instantiation versatility
• Improved Two.Group.getBoundingClientRect, Two.Path.getBoundingClientRect, and Two.Text.getBoundingClientRect
• Improved higher level shapes', like Two.Circle, ability to handle zeroed out arguments

Apr 2, 2021 v0.7.4

Apr 2, 2021

• Improved Typescript type declarations
• Successfully export extras/ directory in both JavaScript and JavaScript Module format
• Added Two.Shape.skewX and Two.Shape.skewY @gburlet

Mar 26, 2021 v0.7.3

Mar 26, 2021

• Exposed Two.Shape.renderer for easier access to underlying SVG elements
• Added Typescript declaration types to Two.js
• Made Two.Group listen to Two.Shape.id changes through new observable property and flags
• Improved Two.interpret performance and functionality through improved regular expressions @adroitwhiz
• Two.Group.visible is a property held on the group and does not trickle down to children
• Improved scientific notation interpretation in SVG elements
• Two.load appends a hidden DOM element to the document's <head /> so that getComputedStyles works more consistently with Two.interpret

Jan 12, 2021 v0.7.1

Jan 12, 2021

• Added Two.AutoCalculateImportedMatrices to control different ways of importing SVG transformations
• Fixed Two.Text.className application
• Added basic text support in Two.interpret
• Exposed Two.fit for external use
• Added a fitted argument to the Two constructor to make instance adaptively match the size of its parent element
• Simplified Two.release method
• Added support for scientific notation in Two.interpret
• Added Two.Text.decoration styling to Two.CanvasRenderer and Two.WebGLRenderer
• Increased precision on Two.Utils.toFixed for Firefox transformation engine performance increase
• Added support to import <use /> tags from SVG interpretation @eulertour
• Removed extraneous underscore calls from Two.Utils @adroitwhiz
• Ensured Two.interpret respects the add parameter to be added (or not) to the current instance
• Modularized Two.js classes / files @adroitwhiz
• Made Two.js compatible with import modules @adroitwhiz
• Added wiki as VuePress project

Jan 22, 2020 v0.7.0

Jan 22, 2020

• Exposed resolution parameter in Two.makeCircle and Two.makeEllipse as the final parameter
• Made Two.Circle and Two.Ellipse recalculate controls points on _update and made vertex amounts cyclical @adroitwhiz
• Added ESLint scripts to development environment @adroitwhiz
• Improve performance of WebGLRenderer by leveraging uniform to construct plane and removing duplicate render calls @adroitwhiz
• Unpacked scale objects in WebGLRenderer @adroitwhiz
• Removed unnecessary gl.colorMask calls @adroitwhiz
• Removed Two.Utils.toFixed calls on Canvas and WebGLRenderers @adroitwhiz
• Two.Shape.clone clones Two.Shape.matrix when Two.Shape.matrix.manual is set to true
• Improved Two.Group.mask rendering in Two.WebGLRenderer
• Fixed Two.WebGLRenderer.setSize recursive loop error
• Connected Two.Shape.className to Two.Shape.classList for searching and class assignment in SVG elements
• Performance improvements on canvas HTML5 styles @brandonheyer
• Added trickle down styling to Two.Group.closed, Two.Group.curved, and Two.Group.automatic
• Check for Duplicity on Two.Group.add
• Accounted for offset positions in Two.Path.center and Two.Group.center methods
• Exposed Two.Shape.matrix as a publicly accessible property
• Removed Two.Utils.deltaTransformPoint and patched Two.Utils.decomposeMatrix to more accurately parse matrices
• Added support for various position inclusion of gradients and other effects in Two.interpret
• Improved Two.Utils.applySvgAttributes rotation from SVG interpretation
• Added Two.makeArrow for Simple Triangular Tipped Arrows @mike168m
• Improved Two.Matrix efficiency of calculations
• Added Two.Path.dashes.offset and Two.Text.dashes.offset properties for animating dashed strokes in all renderers
• Fixed Two.Path.corner method to not be additive on successive invocations
• Split Two.Matrix.toArray into two different functions. One for 2D transforms and one for a plain object (JSON) representation
• Added Two.Matrix.toTransformArray intended for 2D transformation use internally
• WebGLRenderer more robustly supports displaying bitmap content
• Added <g /> attributes to be inherited by children in SVG interpretation
• Added offscreenElement as an option when constructing WebGL Renderers for WebWorker compatibility
• Added Two.Shape.position accessor to Two.Shape.translation for ease of use with matter.js
• Added Two.Path.dashes and Two.Text.dashes support to WebGL and Canvas Renderers

Dec 8, 2018 v0.7.0-beta.3

Dec 8, 2018

• Canvas Renderer supports dashed and non dashed paths
• Enforce Two.Rectangle has four vertices
• Fixed Two.Path.closed on latest ending calculations

Nov 18, 2018 v0.7.0-beta.2

Nov 18, 2018

• Updated Two.js compatibility with webpack and node-canvas 2.0.0+

Nov 3, 2018 v0.7.0-beta.1

Nov 3, 2018

• Altered Two.Path.clone and Two.Text.clone to use references where possible and to _update() on return
• Improved multi-decimal and arc SVG interpretation
• Added Two.Commands.arc for better arc rendering across all renderers
• Two.Path and Two.Text now have dashes property to define stroke dashing behavior @danvanorden
• Two.Vector arithmetic methods made more consistent — still need to improve performance
• Two.Path.vertices will not clone vectors, improving developer clarity
• Two.js clone methods do not force adding to a parent
• Two.ImageSequence, Two.Sprite, and Two.Rectangle have origin properties for offset rendering
• Two.Group.getBoundingClientRect will pass-through on effects instead of break
• Two.interpret apply SVG node style attributes to paths. Inherits from groups and infers SVG viewBox attribute against Two.js instance
• Two.interpret improves multi-decimal formatted d attributes
• Two.ZUI added through the new /extras folder
• Two.Text.getBoundingClientRect now returns an estimated bounding box object
• Two.interpret properly assigns back calculated Z coordinates
• Two.load now immediately returns a Two.Group for use without callbacks if desired
• Added Two.Group.length to return the calculated length of all child paths
• Two.Group.beginning and Two.Group.ending calculate based on child Two.Paths for intuitive grouped animating
• Added Two.Utils.shim to properly handle canvas and image element spoofing in headless environments
• Improved conformance between primitive shapes
• Two.Path.getBoundingClientRect considers control points from bezier curves
• Two.Path.beginning and Two.Path.ending calculate based on distance increasing accuracy for animation, but also performance load
• Moved Two.Path._vertices underlying to list of rendered points to Two.Path._renderer.vertices
• Improved accuracy of Two.Path.ending and Two.Path.beginning on open paths
• Added specific clone method to Two.ArcSegment, Two.Circle, Two.Ellipse, Two.Polygon, Two.Rectangle, Two.RoundedRectangle, and Two.Star primitives
• Added ability to read viewBox property from root SVG node in Two.interpret
• Added more reliable transform getter in Two.interpret
• Added rx and ry property reading on Two.Utils.read.rect
• Added Two.Utils.read['rounded-rect'] to interpret Rounded Rectangles
• Added ability for Two.RoundedRectangle.radius to be a Two.Vector for x, y component styling
• Added ES6 compatible ./build/two.module.js for importing library
• Improved Q SVG interpretation
• Two.Texture, Two.Sprite, and Two.ImageSequence implemented in WebGLRenderer
• Added className property to Two.Shapes for easier CSS styling in SVGRenderer @fr0
• Two.Events.resize is now bound to a renderer's setSize function giving a more generic solution to change scenegraph items based on dimensions changing

Dec 1, 2017 v0.7.0-alpha.1

Dec 1, 2017

• Fixed closed Two.Path.getPointAt method to clamp properly
• Added Two.Texture.repeat for describing pattern invocations
• Added Two.Texture, Two.Sprite, and Two.ImageSequence
• Removed Two.Shape inheritance for Two.Gradients
• Added Two.Vector.rotate method @ferm10n
• Objects clone to parent only if parent exists @ferm10n
• Vendor agnostic requestAnimationFrame @ferm10n
• Two.Utils.Events.listenTo and Two.Utils.Events.stopListening @ferm10n
• Two.Utils.Events added to Two.Path.prototype for event inheritance @ferm10n
• Enhanced Two.Shape.scale to allow both numbers and Two.Vector as property value
• Made Two.interpret use latest primitives
• Added Two.Circle primitive
• Two.Shape.translation is now a getter/setter and can be replaced
• Fixed translation interpretation to strip out 'px' strings
• Removed Two.SineRing — make Two.Star.curved = true and it's the same effect
• Enhanced Two.ArcSegment, Two.Ellipse, Two.Polygon, Two.Rectangle, Two.RoundedRectangle, Two.Star
• Fixed Two.Anchor.relative interpretation in svg, canvas, and webgl renderers
• Made Getters / Setters enumerable for iteration compatibility
• Fixed Two.Utils.Collection.splice method and added additional test
• Added compatibility with node.js, browserify, and node-canvas
• Removed third party dependencies
• Added remove method to Two.Text
• Fixed ordering on same parent additions for Two.Group

Feb 9, 2016 v0.6.0

Feb 9, 2016

• Updated Two.CanvasRenderer.ctx.imageSmoothingEnabled to not use deprecated invocation, issue 178
• Fixed Two.Group.mask in SVGRenderer to append to DOM correctly
• Updated require imports to be compatible with require.js
• Added Two.Text for programmatically writing text in Two.js

Oct 1, 2015 v0.5.0

Oct 1, 2015

• Added support for two.interpret to import svg's gradients
• Added Two.Utils.xhr and two.load methods to asynchronously load SVG files
• Added Two.Gradient, Two.LinearGradient, and Two.RadialGradient
• Added dependency check to ensure ASM loading in environments like NPM as well as in the browser
• Properly deleted webgl textures on removal of Two.Path
• Added support for two.interpret to import svg's Elliptical Arcs
• Added Two.ArcSegment and Two.SineRing as new shapes invoked like Two.Path @chrisdelbuck
• Added Two.Line, Two.Rectangle, Two.RoundedRectangle, Two.Ellipse, Two.Polygon, and Two.Star as new shapes invoked like Two.Path
• Breaking: renamed Two.Polygon to Two.Path
• Performance enhancements to webgl renderer
• Performance enhancements to canvas renderer Leo Koppelkamm
• Enabled render ordering in Two.Group.children based on previous augmentation
• Augmented Two.Group.children to inherit from Two.Collection effectively making it an array instead of a map Leo Koppelkamm
  • The map can still be accessed at Two.Group.children.ids

Jul 22, 2014 v0.4.0

Jul 22, 2014

• Updated Two.interpret to handle polybezier path data
• Added Two.Group.mask and Two.Polygon.clip in order to create clipping masks
• Two.Group has own opacity property Leo Koppelkamm
• Rendering optimizations Leo Koppelkamm
• Two.noConflict non-destructive command internally to the library
• Two.interpret decomposes transform attribute of source tag
• Two.interpret handles item irregularities from Inkscape
• Changed Two.Identifier to use underscores instead of hyphens for dot-notation access Leo Koppelkamm
• Added Two.Group.getById and Two.Group.getByClassName methods for convenient selection Leo Koppelkamm
• Added classList to all Two.Shapes Leo Koppelkamm
• Enabled inference of applied styles on imported svgs Leo Koppelkamm
• Added Two.Polygon.getPointAt method to get coordinates on a curve/line
• Added Two.Polygon.length property and Two.Polygon._updateLength method to calculate length of curve/line
• Updated Two.Group.prototype observable properties on Two.Polygon.Properties to ensure each property is considered unique
• Two.Polygon.vertices first and last vertex create automated control points when Two.Polygon.curved = true
• Updated Two.Polygon.subdivide method to accommodate Two.makeEllipse
• Enabled id to be properly interpreted from SVG elements @chrisdelbuck
• Updated webgl renderer getBoundingClientRect to accommodate relative anchors
• Updated beginning and ending to clamp to each other
• Reorganized Two.Polygon._update and Two.Polygon.plot in order to handle beginning and ending properties
• Updated Two.getComputedMatrix and Two.Polygon.getBoundingClientRect to adhere to nested transformations
• Updated Two.Anchor to change control points relatively by default through anchor.relative property
• Updated Two.Polygon.subdivide method to accommodate curved = false circumstances
• Updated svg, canvas, and webgl renderers to properly reflect holes in curved Two.Polygons
• Updated Two.Group clone method
• Added toObject method to Two.Group, Two.Polygon, Two.Anchor
• Two.Polygon initializes polygon.cap = 'butt' and polygon.join = 'miter' based on Adobe Illustrator defaults
• Two.Polygon.subdivide method now works with Two.Commands.move for noncontiguous polygons
• Internally update matrices on getBoundingClientRect in order to remove the need to defer or wait for internal variables to be up-to-date
• Refactor of renderers and scenegraph for performance optimization and lower memory footprint
  • Relinquished internal events for flags
  • Prototypical declaration of Object.defineProperty
  • Added _update and flagReset methods to Two.Shape, Two.Group, and Two.Polygon
  • Decoupled canvas and webgl renderers and are now independent
  • Added _matrix.manual to override the default behavior of a Two.Polygon transformation
  • Localized variables per file as much as possible to reduce Garbage Collection on runtime

Oct 25, 2013 v0.3.0

Oct 25, 2013

• Can properly pass domElement on construction of new instance of two
• Added overdraw boolean to webgl renderer @arodic
• Added support for ie9 svg interpretation @tomconroy
• Added subdivide method for Two.Polygon and Two.Group
• Ensure sure that manual properly is set on construction of Two.Polygon that it binds Two.Anchor.controls change events
• Added automatic High DPI support for webgl renderer
• Updated two.interpret(svg) to handle compound paths
• Added Two.Anchor which represents all anchor points drawn in two.js
• Modified source to not have any instances of window for node use
• Updated to underscore.js 1.5.1
• Added Two.Utils.getReflection method to properly get reflection's in svg interpretation
• Made Two.Vector inherently not broadcast events and now needs to be explicitly bound to in order to broadcast events, which two.js does internally for you
• Created Two.Utils.Collection an observable array-like class that polygon.vertices inherit @fchasen
• Added Two.Events.insert and Two.Events.remove for use with Two.Utils.Collection
• Properly recurses getBoundingClientRect for both Two.Group and Two.Polygon
• Added Two.Version to clarify forthcoming builds
• Updated hierarchy ordering of group.children in canvas and webgl renderers
• Updated shallow and bidirectional remove method for Two.Group and Two.Polygon
• Added corner method to Two.Group and Two.Polygon allowing anchoring along the upper lefthand corner of the form
• Modified center method of Two.Group and Two.Polygon to not affect the translation property to stay inline with corner method and any future orientation and anchoring logic
• Added automatic High DPI support for canvas renderer
• Added overdraw boolean to canvas renderer
• Added AMD loader compatibility @thomasrudin
• Deferred two.update(); to account for canvas and webgl
• Added remove and clear methods to two instance
• Updated svg interpretation for webgl context
• Added matrix property to all Two.Shape's for advanced transformations
• Added inverse method to Two.Matrix
• Remove execution path dependency on utils/build.js @masonblier
• Added timeDelta property to every two instance
• Added gruntfile, package.json for more integration with npm, and dependency free build (build/two.clean.js) @iros
• Crossbrowser compatibility with noStroke and noFill commands

May 3, 2013 v0.2.0

May 3, 2013

• First alpha release

Jan 29, 2013 v0.1.0-alpha

Jan 29, 2013

• Proof of Concept built from Three.js