core 0.1-beta

This commit is contained in:
Fokinator
2026-05-27 22:02:28 +03:00
parent 38c599c2cf
commit e788a99545
224 changed files with 7812 additions and 3946 deletions
+20 -25
View File
@@ -1,40 +1,35 @@
TODO List
===
## Core goals (Almost there!)
## Core goals
1. Create `Image` implementations (~~`RasterImage`~~, ~~`SVGImage`~~, `AnimatedImage<F extends Image>`)
2. ~~Create a `ru.fokinatorr.sparkle.graphics.GraphicsManager` interface and an implementation based on a native
1. ~~Create `Image` implementations (`RasterImage`, `SVGImage`)~~ **DONE**: No AnimatedImage since Images are immutable
2. ~~Create a `graphics.net.fokinatorr.sparkle.GraphicsManager` interface and an implementation based on a native
graphics engine. Make it a default headful bean.
Also create an interface `ru.fokinatorr.sparkle.graphics.render.RenderingContext` based on the graphics manager interface.~~ **DONE**:
implemented with OpenGL: `OpenGLGraphicsManager`, `OpenGLContext`. To do: `SoftwareContext`
Also create an interface `render.graphics.net.fokinatorr.sparkle.RenderingContext` based on the graphics manager interface.~~ **DONE**:
implemented with OpenGL: `OpenGLGraphicsManager`, `OpenGLContext`. To do: `SoftwareRenderingContext`
3. ~~Implement `RenderingContext` and `RenderCanvas`~~ **DONE**: `OpenGLContext` and `GLRenderCanvas`. To do: `SoftwareContext` and `OffscreenRenderCanvas`.
4. Improve `RenderCanvas` to unify 2D and 3D
4. ~~Fix `GLSubCanvas` and image rendering~~ **DONE**
5. ~~Add support for `Renderable` and `Renderer` interfaces in `Stage`~~ **DONE**: Created an arbitrary renderable object map
6. Create a bootstrap class `ru.fokinatorr.sparkle.SparkleApp`
6. ~~Create a bootstrap class `net.fokinatorr.sparkle.SparkleApp`~~ **DONE:** also created `SparkleInit` and `Lifecycle` classes
7. ~~Add support for `GraphicEffectMap` in `RenderCanvas`~~ **DONE**
8. ~~Maybe rename `GraphicsContext` to `CanvasAccessor` or something canvas-related? To avoid confusion with bgfx/glfw context, if there is one~~
**DONE: Renamed to `RenderCanvas`**
9. ~~Implement `Renderable2D`'s methods in `Sprite`~~ **DONE**
10. ~~Create a `RendererRegistry` bean that maps type -> `Renderer`s for that type or supertype~~ **DONE**
11. ~~Create class `Renderer.ForRenderable2D` that applies transformations according to `Renderable2D`'s properties
9. Fix distortion shaders (in [this directory](/src/main/resources/shaders/snippets))
10. Implement font support
11. ~~Implement `Renderable2D`'s methods in `Sprite`~~ **DONE**
12. ~~Create a `RendererRegistry` bean that maps type -> `Renderer`s for that type or supertype~~ **DONE**
13. ~~Create class `Renderer.ForRenderable2D` that applies transformations according to `Renderable2D`'s properties
(`Renderable`s don't do that, they just draw)~~ **DONE**
12. ~~Make some kind of `Stage` registry? A `Stage` instance will probably be tied to a `GraphicsManager` instance~~ **DONE: `Stage`s are attached to `RenderingContext`s**
13. Find all TODO comments and apply them
14. ~~Add LICENSE to resources (MIT)~~ **DONE: [created file](/src/main/resources/LICENSE)**
15. Update version to `0.1-beta` in `pom.xml`
16. Create a Git repository and commit everything
14. ~~Make some kind of `Stage` registry? A `Stage` instance will probably be tied to a `GraphicsManager` instance~~ **DONE: `Stage`s are attached to `RenderingContext`s**
15. ~~Find all TODO comments and apply them~~ **DONE:** planned ones applied
16. ~~Add LICENSE to resources (MIT)~~ **DONE: [created file](/src/main/resources/LICENSE)**
17. Update version to `0.1-beta` in `pom.xml`
18. ~~Create a Git repository and~~ commit everything
---
## Future goals
1. Create a demo app `sparkle-demo-app`
2. Create extensions `sparkle-ext-3d`, `sparkle-ext-ui`, `sparkle-ext-box2d`, `sparkle-ext-cloud-variables`,
`sparkle-ext-midi`, `sparkle-ext-tts`, `sparkle-ext-asset-library`,...
3. Maybe create a converter app `sparkle-scratch2sparkle`?
4. Create website (potential base URLs: https://fokinatorr.net/sparkle, https://sfns.fokinatorr.net.ru/, any combo of those)
5. Attract Scratchers that know basics of Java and hope they'll find Sparkle usable
---
## Notes
- SFNS - **Sparkle Framework is Not Scratch** (API similar to Scratch, but it's a different thing)
- If you like the GNU trend, you can call it **SFNS Framework is Not Scratch** :)
- Code name: Project Sparkle or just Sparkle
`sparkle-ext-midi`, `sparkle-ext-tts`, `sparkle-ext-asset-library`, `sparkle-ext-dev-live-reload`,...
3. Create website (potential base URLs: https://fokinatorr.net/sparkle, https://spjf.fokinatorr.net/, any combo of those)
4. Attract Scratchers that know basics of Java and hope they'll find Sparkle usable