vector_math

[vector_math] Document geometry filter APIs (#22)

Summary

• Documents the public Plane API in vector_math and
  vector_math_64.
• Removes the file-level public_member_api_docs ignore for both
  Plane implementations.
• Adds a CHANGELOG.md entry for the docs update.

Part of flutter/flutter#186827

• Removes the deprecated SimplexNoise class.
• Optimizes the identity constructors on the Matrix classes.
• Updates metadata to reflect the move from google/vector_math.dart to flutter/core-packages, which is the new source of truth for this package.
• Updates source and metadata to follow Flutter team package conventions and analysis options.
• Updates minimum supported SDK version to Dart 3.10.

• Add leftTranslateByVector2 method to Matrix4. Equivalent to the leftTranslate set of methods, that multiplies this matrix by a translation matrix from the left.
• Added Matrix4.leftMultiply method.
• Add translateByVector2 method to Matrix4.
• Require sdk: ^3.7.0.

• Performance of functions that take dynamic arguments improved.

• Most of the members that take dynamic arguments are deprecated. New members with non-dynamic arguments added.

  Deprecated members:

  • Matrix4.translate

    Instead use: Matrix4.translateByDouble, Matrix4.translateByVector3, Matrix4.translateByVector4.

  • Matrix4.leftTranslate

    Instead use: Matrix4.leftTranslateByDouble, Matrix4.leftTranslateByVector3, Matrix4.leftTranslateByVector4.

  • Matrix4.scale

    Instead use: Matrix4.scaleByDouble, Matrix4.scaleByVector3, Matrix4.scaleByVector4.

  • Matrix4.scaled

    Instead use: Matrix4.scaledByDouble, Matrix4.scaledByVector3, Matrix4.scaledByVector4.

• Fixed operator -() of Quaternion (Contributed by tlserver)
• Fixed Matrix3.rotationY direction (Contributed by tlserver, moritzblume)
• Added an operator== to Quaternion so that two instances of quaternions can be evaluated for equality.
• Require Dart 3.1

• Refactor the locations of the SimplexNoise related part files.

• operator == overrides no longer take nullable arguments. This is only visible for classes that implement the interfaces defined in this package which no longer need to also widen the argument type.
• Deprecate SimplexNoise (see https:github.com/google/vector_math.dart/issues/270 for more information).

• Fix to Quad.copy (#221)

• Deprecate hash.dart.
• Require Dart v2.14 or greater.

• Stable release for null safety.
• Improve performance of Matrix4.decompose by reusing objects.

• Internal fix to use Dart 2 core library constant names.

• Fixed indexing bug in MeshGeometry.combine

• Fixed angleTo for vectors that do not have unit length
• Added Matrix4.tryInvert.

• Strong mode clean

• Added Matrix4.isIdentity()
• Added Matrix4.isZero()
• Added Matrix3.isIdentity()
• Added Matrix3.isZero()
• Added Vector2.angleTo and Vector2.angleToSigned

• Synchronize Float64 version

• Add Matrix4.leftTranslate

• Add Matrix4.SkewX, Matrix4.SkewY, and Matrix4.Skew constructors

• Remove call chaining, methods don't return this anymore. You can use the method cascade operator instead.
• Remove dependency on quiver package

• Fixed ArgumentError usage in Matrix4.inverted constructor

• Added MatrixX.fromList constructor

• Added Matrix4.inverted constructor

• Updated dependencies.
• Moved benchmark code into benchmark/
• Updated vector_math_64.

• Add color conversion routines (Contributed by Oliver Sand)
• More collision and geometry routines (Contributed by Oliver Sand)
• More tests (Contributed by Oliver Sand)
• v 1.4.3 pub release

• Better mesh generators (contributed by Brandon Jones)
• Fix bug in ray v. triangle intersection test (contributed by @AMagill)

• Class names now start with upper case, following Dart style guide.
• Performance audit.
• New vector_math_operations library.
• New vector_math_lists library.
• Added Aabb2 and fleshed out Aabb3 (thanks to Laszlo Korte)
• Added Matrix solve methods (thanks to Laszlo Korte)
• Added Methods needed for Three.dart (thanks to Anders Forsell)

• Large refactoring.

• Refactor generated constructor code into small functions.
• Refactor generated operator* code into small functions.
• Fix typo in quaternion code.

• Update to latest String library.
• Fix holding references in matrix constructor.
• Replace double type with num in rotationY, and rotationZ.

• Remove remaining double type tests and replace them with num.
• Don't throw in the default matrix and vector constructors.

• Remove unnecessary dart:scalarlist import.
• Now that dart2js is fixed, rename negate_ back to negate.
• Fix library imports in test suites.
• Flexible constructor fix added to the generator.
• Tested library under dart2js

• Revert to using a single library!
• Public API reverted to taking nums instead of doubles.
• Fixed all warnings/errors introduced by M3.
• drone.io integrated tests.
• Fixed bug in rotation construction.
• Fixed bug in orthographic matrix construction.
• External contribution by fkleon fixing flexible constructors.
• External contribution by donny-dont adding a missing cast .toDouble().

• Pub: Dart Vector Math now fully supports the pub package management system!
• API++: Minor changes to the API everywhere. The changes improve the aesthetics and performance of the library.
• Faster: Lots of performance tweaks resulting in the library getting faster and generating less garbage.
• 2D Cross Product: The Box2D Dart port requires a 2D cross product.
• Library Split: Two libraries, one for browser applications and console applications.