bagl 0.4.0

Basic Graphics Library for Dart.

BaGL Change Log

0.4.0

• BREAKING: deprovisionGeometry, deprovisionProgram and deprovisionSampler have been removed from RenderingContext. Use context.geometryResource.deprovision, context.programResources.deprovision and 'context.samplerResources.deprovision` instead.
• RenderingContext now exposes geometryResources, programResources and samplerResources fields to allow manual management of resource provisioning/ deprovisioning.
• Frame.draw now takes autoProvisioning as an optional named parameter. When set to false, BaGL will not automagically provision GPU resources for you. Instead resources should have been provisioned manually prior to the draw call (see change above).

This version refactors the rendering internals to make heavy use of Expandos so as to only hold on to weak references to geometry, programs and samplers. This means that once geometry, program and sampler objects become inaccessible in your code, these objects may be garbage collected by the Dart/Javascript runtime. Importantly, any GPU resources that BaGL previously provisioned for these objects will then also be freed by the runtime. This means that in most cases, you do not have to worry about deprovisioning these resources manually.

0.3.0

• BREAKING: the translation constructors on Matrix3 and Matrix4 now take separate double values for each translation direction rather than a single vector. This aligns the signature with the scale constructor signature.
• BREAKING: removes withValues and withValuesTranspose from Vector2, Vector3, Vector4, Matrix2, Matrix3 and Matrix4. These methods are no longer necessary with rl_matrix 0.6.0 and had no real function in BaGL. Use the fromList constructors instead.
• Adds a Struct type. Frame.draw now accepts uniform values of type Struct and List<Struct>. These map to user defined struct types in GLSL shaders.

0.2.0

• BREAKING: IndexGeometry now takes a type parameter Primitive (should be of type Point, Line or Triangle) and extends Iterable<Primitive>.
• BREAKING: VertexArrayBuilder and VertexArray.toBuilder() have been removed. For the moment I'm not sure they belong in this library and they introduce a lot of complexity. May be added back in at a later point in time.
• BREAKING: the keys and values for the draw parameter attributeNameMap have been reversed: keys should now be names as they appear in the shader program, values should be the name of the attribute on the geometry.
• BREAKING: Frame.draw no longer allows missing attributes. If an attribute is active on the shader program, then the geometry must define a matching attribute (either by defining an attribute with the same name, or through a mapping provided by the attributeNameMap draw parameter).
• The geometry provided to a Frame.draw call may now define attributes that are not used by the shader program without raising an error.