Skip to content

Oak v4.0.0
Compare
Choose a tag to compare
@200sc 200sc released this 21 May 16:34
· 39 commits to master since this release
v4.0.0
a75e0d2
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.

High level changelog:

Overall

  • Bump from Go 1.17 to 1.18
  • Operations that would previously fail on an oak window because they were not supported on a specific OS will now fail at compile time instead.
  • Windows, Linux, and OSX have had their window functionality standardized.
  • Examples have been trimmed down and compressed.

Testing

  • Added Linux AMD64 and Windows AMD64 automated test agents

Alg Package

  • alg/range has been replaced by alg/span, a genericized version of the package.
  • Intgeom rectangles now implement the alg/span interface. In other words, rectangles can be queried for arbitrary points within them and have points clamped to their boundaries.

Audio Package

  • The audio and pcm packages have been rewritten from scratch.
  • A program can now select a specific audio driver for a platform. There are minimal options currently, but this can be extended in the future.
  • The pcm package now defines the audio interface in a streamable fashion, and audio defines options for playing back pcm streams.
  • Some functionality has been removed with no current replacement, e.g. Ears, positional filters. They can be re-added in the future.
  • Streaming enables new functionality like FadeIn and FadeOut stream wrappers.
  • Audio format packages can now be compiled in at request instead of always compiled into programs. This should decrease binary sizes of most programs, particularly those not using audio or only using one format.
  • The synth package has additional functionality for manipulating generated waveforms like detuning, combining waveforms, and detecting a waveform's pitch.

Entities Package

  • This package has been rewritten from scratch to use optional constructors instead of a series of scaling types with additional functionality. entities/x/move has been moved to entities itself.
  • entities/x/btn has been trimmed down to use entities internally instead of its own structures.
  • entities/x/force and entities/x/stat have been removed.
  • entities/x/shake has been promoted to oak/shake.

Event Handling

  • Event handling has been augmented to support type safe argument handling via generics.
  • The interface for binding and unbinding events, and the internal logic for processing requests, has been overhauled.
  • Example: previously to unbind a specific known binding in collision.Detach, we did this:
if _, ok := en.(attachSpace); ok { 
event.UnbindBindable(
	event.UnbindOption{
		Event: event.Event{
			Name:     event.Enter,
			CallerID: s.CID,
		},
		Fn: attachSpaceEnter,
	},
)
}

Now, bindings return a value that can be explicitly used to unbind themselves later:

if as, ok := en.(attachSpace); ok {
    as.getAttachSpace().binding.Unbind()
}
  • These rewrites eliminate the need for oak.Config.EventRefreshRate.

Render

  • The build tag nogift can be added to exclude the disintegration/gift dependency and its helper functions.
  • The build tag noimages can be added to exclude registering the standard library's built in image support.

Scene Handling

  • Scenes no longer have a Loop function. For operations that should happen every frame, the event package is preferred, with helpers like scene.Context.DoEachFrame added. scene.Context.GoToScene and its like are preferred for handling when a scene ends.
  • Scene contexts embed most of their component constructs, and can be provided to the event and render packages as appropriate.

Changelog by PRs:

Full Changelog: v3.4.0...v4.00

Contributors

Implausiblyfun and 200sc
Assets 2
Loading