@geastack/core 0.1.37 → 0.1.39

package/include/display_present.h

@@ -2,6 +2,7 @@
 
 #include "canvas.h"
 #include "display.h"
+#include "image.h"
 
 #include <algorithm>
 #include <array>
@@ -284,6 +285,13 @@ inline void addCommandBounds(const Command &command, Rect *rects, int *count, in
 	addRect(rects, count, capacity, commandBounds(command, width, height), width, height);
 }
 
+// An app-registered buffer (native surface, ImageData565, video frame) is
+// rewritten in place, so equal pointers say nothing about equal pixels.
+inline bool imagePixelsStable(const Command &command)
+{
+	return !gea::framework::graphics::ImageStore::instance().pixelsMayChange(command.pixels);
+}
+
 inline bool commandsEqual(const Command &a, const Command &b)
 {
 	if (a.type != b.type || a.alpha != b.alpha) return false;
@@ -321,15 +329,15 @@ inline bool commandsEqual(const Command &a, const Command &b)
 		                       sizeof(gea::framework::graphics::TriangleEntry)) == 0;
 	}
 	case Type::DrawImage:
-		return a.pixels == b.pixels && a.alphaPixels == b.alphaPixels &&
+		return a.pixels == b.pixels && a.alphaPixels == b.alphaPixels && imagePixelsStable(a) &&
 		       a.srcWidth == b.srcWidth && a.srcHeight == b.srcHeight && a.x == b.x && a.y == b.y;
 	case Type::DrawImageScaled:
 	case Type::DrawImageRotated90CW:
-		return a.pixels == b.pixels && a.alphaPixels == b.alphaPixels &&
+		return a.pixels == b.pixels && a.alphaPixels == b.alphaPixels && imagePixelsStable(a) &&
 		       a.srcWidth == b.srcWidth && a.srcHeight == b.srcHeight &&
 		       a.x == b.x && a.y == b.y && a.w == b.w && a.h == b.h;
 	case Type::DrawImageTiledX:
-		return a.pixels == b.pixels && a.alphaPixels == b.alphaPixels &&
+		return a.pixels == b.pixels && a.alphaPixels == b.alphaPixels && imagePixelsStable(a) &&
 		       a.srcWidth == b.srcWidth && a.srcHeight == b.srcHeight &&
 		       a.x == b.x && a.y == b.y && a.w == b.w;
 	case Type::FillText:
@@ -574,8 +582,17 @@ inline bool frameHasOpaqueBase(const Frame &frame, int width, int height)
 	const Command &first = frame.commands.front();
 	using Type = gea::platform::display::DisplayPresentCommandType;
 	if (first.type == Type::Clear) return true;
-	if (first.type != Type::FillRectRgb565 || first.alpha != 255) return false;
-	const Rect bounds = rectFromBox(first.x, first.y, first.w, first.h);
+	if (first.alpha != 255) return false;
+	Rect bounds;
+	if (first.type == Type::FillRectRgb565) {
+		bounds = rectFromBox(first.x, first.y, first.w, first.h);
+	} else if (first.type == Type::DrawImage && first.alphaPixels == nullptr) {
+		// A full-panel opaque image (putImageData of a whole-screen buffer)
+		// paints every pixel, the same as a full-panel fill.
+		bounds = rectFromBox(first.x, first.y, first.srcWidth, first.srcHeight);
+	} else {
+		return false;
+	}
 	return bounds.x0 <= 0 && bounds.y0 <= 0 && bounds.x1 >= width - 1 && bounds.y1 >= height - 1;
 }
 

package/include/image.h

@@ -61,6 +61,9 @@ struct ImageSlot {
 	pixel::native_t *pixels = nullptr;
 	std::uint8_t *alpha = nullptr;
 	bool ownsPixels = false;
+	// Registered by the app (registerBuffer): the app writes these pixels in
+	// place between frames, so the same pointer does not mean the same image.
+	bool mutablePixels = false;
 
 	void *gifDecoder = nullptr;
 	std::uint8_t *gifData = nullptr;
@@ -98,6 +101,11 @@ public:
 	// camera capture, which hands over a freshly-allocated RGBA8888 still.
 	int registerBuffer(pixel::native_t *pixels, int width, int height, int preferredSlot = -1, bool takeOwnership = false);
 
+	// True when `pixels` point into a registerBuffer() image, whose content the
+	// app rewrites in place. The present diff never treats such an image as
+	// unchanged from the previous frame.
+	bool pixelsMayChange(const pixel::native_t *pixels) const;
+
 	int width(int id) const;
 	int height(int id) const;
 	int frameCount(int id) const;

package/index.d.ts

@@ -653,6 +653,13 @@ export interface ImageProps extends DataAttributes {
   onFrame?: (frame: number) => void
 }
 
+export interface ImageData565 {
+  readonly width: number
+  readonly height: number
+  /** Row-major RGB565 pixels, `width * height` long. */
+  readonly data16: Uint16Array
+}
+
 export interface GeaEmbeddedImage {
   readonly width: number
   readonly height: number
@@ -1008,6 +1015,24 @@ export interface CanvasRenderingContext2D {
   drawImageCircle(image: GeaEmbeddedImage, dx: number, dy: number, width: number, height: number): void
   drawImageRotated90CW(image: GeaEmbeddedImage, dx: number, dy: number, width: number, height: number): void
   drawImageTiledX(image: GeaEmbeddedImage, dx: number, dy: number, width: number): void
+  /**
+   * An RGB565 pixel buffer the app writes directly:
+   * `img.data16[i] = ((r & 0xf8) << 8) | ((g & 0xfc) << 3) | (b >> 3)`.
+   * Allocate once, write every frame, then draw with `putImageData`.
+   */
+  createImageData565(width: number, height: number): ImageData565
+  /** Draw an `ImageData565` with its top-left corner at (dx, dy): one blit. */
+  putImageData(image: ImageData565, dx: number, dy: number): void
+  /** Draw only the dirty rectangle of an `ImageData565`, at (dx + dirtyX, dy + dirtyY). */
+  putImageData(
+    image: ImageData565,
+    dx: number,
+    dy: number,
+    dirtyX: number,
+    dirtyY: number,
+    dirtyWidth: number,
+    dirtyHeight: number,
+  ): void
   flush(): void
   beginBatch(): void
   endBatch(): void

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geastack/core",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "description": "GeaStack app API, reactivity headers, runtime sources, and type declarations.",
   "license": "Apache-2.0",
   "repository": {
@@ -65,8 +65,8 @@
     "@babel/types": "^7.23.0",
     "@geajs/core": "1.5.1",
     "@geajs/vite-plugin": "1.5.0",
-    "@geastack/compiler": "^1.0.22",
-    "@geastack/geatsc-plugin-gea": "^0.1.19",
+    "@geastack/compiler": "^1.0.25",
+    "@geastack/geatsc-plugin-gea": "^0.1.21",
     "opentype.js": "^2.0.0",
     "vite": "^8.0.0"
   }

package/runtime-surface.ts

@@ -119,6 +119,7 @@ export type {
   HttpModule,
   HttpRequestHandler,
   HttpServer,
+  ImageData565,
   ImageProps,
   ImageSource,
   IncomingMessage,