Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Release 0.22 #795

Merged
merged 3 commits into from
Oct 24, 2024
Merged

Release 0.22 #795

merged 3 commits into from
Oct 24, 2024

Conversation

zeux
Copy link
Owner

@zeux zeux commented Oct 23, 2024

  • Updates all version numbers to 0.22
  • Stabilizes decode/encode filters with the exception of recently added meshopt_EncodeExpClamped

For posterity, APIs that are still experimental:

  • meshopt_generateProvokingIndexBuffer: added in this release, unclear if it will need changes
  • meshopt_EncodeExpClamped enum: added in this release, unclear if it will stay (cutoff fixed to 0) or be replaced by meshopt_encodeFilterExpClamped function (customizable cutoff)
  • meshopt_SimplifyPrune enum: added in this release, implementation is still in flux with likely behavior changes in future releases
  • meshopt_simplifyWithAttributes: a lot of implementation changes in this release; while the implementation should be relatively stable, it's unclear if interface changes will be needed for at least one planned feature
  • meshopt_simplifySloppy: hasn't changed in a few releases but significant implementation work may be outstanding
  • meshopt_simplifyPoints: a few implementation changes in this release; likely effectively stable, unless we decide we need to support RGB/RGBA modes which would need an interface change to specify if the input color is 3-float or 4-float
  • meshopt_optimizeMeshlet: no changes since last release, but would like to wait for one more release to stabilize in case clusterizer sees significant changes in the next release.
  • meshopt_spatialSortTriangles: no changes in a while; meshopt_spatialSortRemap has been stabilized and is useful for point clouds, but there's some issues with sorting triangles for compression efficiency that I'd like to look into before stabilizing this, as right now it's unclear if the triangle sort is practically useful.

As a reminder, "experimental" means the interface or implementation may see significant change; non-experimental means interface is de-facto locked down (both API/ABI) and implementation should be production ready, but future releases may still improve behavior/performance in a compatible manner. Experimental APIs are still fine to use, it's just that the compatibility isn't guaranteed.

meshopt_generateProvokingIndexBuffer, meshopt_simplifyWithAttributes, meshopt_simplifyPoints and meshopt_optimizeMeshlet will most likely become stable in the next release.

@zeux zeux changed the title Update version to 0.22 everywhere Release 0.22 Oct 23, 2024
These functions have existed for several years now, with stable
implementation and interface. They are exposed via JS interface and used
by gltfpack, and thus are unlikely to change dramatically.

A recent change added meshopt_EncodeExpClamped, which also had a
possible alternative of adding more fine-grained exponent clamping
control to meshopt_encodeFilterExp. Instead of marking the entire
function as experimental, let's mark just the enum entry as
experimental. If more control is necessary in the future, we can remove
this enum entry and add a meshopt_encodeFilterExpClamped instead.
Fix duplicate documentation for generateShadowIndexBuffer after a failed
rewording attempt.
@zeux zeux marked this pull request as ready for review October 24, 2024 23:47
@zeux
Copy link
Owner Author

zeux commented Oct 24, 2024

After doing some more pre-release testing and review I think we're set for a release tomorrow morning.

@zeux zeux merged commit 4affad0 into master Oct 24, 2024
12 checks passed
@zeux zeux deleted the nextver branch October 24, 2024 23:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant