On Mon, 2 Nov 2026 23:26:57 GMT, John Hendrikx <[email protected]> wrote:

>> This PR adds a `getDrawingContext` method to `WritableImage`, which works 
>> similar to `Canvas::getGraphicsContext` and shares the same signatures. Key 
>> features include:
>> 
>> - **Shape rendering**: `strokeRect`, `fillRect`, `strokeOval`, `fillOval`, 
>> `strokeArc`, `fillArc`, `strokePolyline`, `fillPolygon`, etc.
>> - **Stroke and fill attributes**: `lineWidth`, `lineCap`, `lineJoin`, 
>> `miterLimit`, `fillRule`, `stroke` and `fill` paints.
>> - **Global graphics settings**: `globalAlpha` and `globalBlendMode`.
>> - **Image drawing**: draw other `Image` instances with scaling and 
>> source/destination rectangles.
>> - **Text rendering**: render text
>> - **Save/Restore**: store current stroke, font, dashes, etc and restore them 
>> later
>> - **Paths**: begin a path, with lines, curves, etc, then stroke or fill it
>> - **Clips**: support rectangular clips in the SW renderer
>> 
>> This feature enables direct software rendering to `WritableImage` without 
>> requiring a `Canvas` + snapshot.
>> 
>> **New API for `GraphicsContext`**
>> 
>> Because `GraphicsContext` was never designed to support a more generic API 
>> when it was conceived, it has gained a few new methods that were a better 
>> fit for the reusable `DrawingContext` interface:
>> 
>> - `clipRect(x, y, w, h)` -- convenience equivalent to `rect(...)` + `clip()`
>> - `getEffect()` -- no arg getter for the `Effect`
>> - `getTextDirection()` and `setTextDirection(NodeOrientation)` -- takes 
>> precedence over `Canvas.getNodeOrientation()` when not set to `INHERIT` (the 
>> default)
>> 
>> **Additional notes**:
>> 
>> - The implementation leverages the software stack consisting of the Marlin 
>> rasterizer and Pisces compositor/painter.
>> 
>> **Example usage**:
>> 
>> 
>> WritableImage img = new WritableImage(400, 400);
>> DrawingContext ctx = img.getDrawingContext();
>> ctx.setFill(Color.RED);
>> ctx.fillRect(50, 50, 100, 100);
>> 
>> 
>> See the sample program `RandomShapesDemo` to see a `WritableImage` and 
>> `Canvas` side by side performing the same operations:
>> 
>> <img width="1249" height="741" alt="image" 
>> src="https://github.com/user-attachments/assets/4a0b9dcc-8f96-4faa-99cf-83c66d2c851e";
>>  />
>> 
>> Newer version:
>> 
>> <img width="1249" height="741" alt="image" 
>> src="https://github.com/user-attachments/assets/c0502620-3d02-4fbd-8c33-43bd5138b42c";
>>  />
>> 
>> ---------
>> - [x] I confirm that I make this contribution in accordance with the 
>> [OpenJDK Interim AI Policy](https://openjdk.org/legal/ai).
>
> John Hendrikx has updated the pull request incrementally with one additional 
> commit since the last revision:
> 
>   Use Cleaner instead of Disposer for Pisces surface/renderer cleanup

one minor suggestion (in two places), otherwise looks good.

will re-approve if you decide to change.

modules/javafx.graphics/src/main/java/com/sun/pisces/AbstractSurface.java line 
63:

> 61:      */
> 62:     public final synchronized void dispose() {
> 63:         Cleanable c = cleanable;

minor: to minimize time spent in the synchronized block, perhaps we should move 
out the if statement from the sync'd block:


public final void dispose() {
  Cleanable c;
  synchronized(this) {
    c = cleanable;
    cleanable = null;
  }
  if (c != null) {
    c.clean();
  }
}


here and also in PiscesRenderer

what do you think?

-------------

Marked as reviewed by angorya (Reviewer).

PR Review: https://git.openjdk.org/jfx/pull/1969#pullrequestreview-5756009609
PR Review Comment: https://git.openjdk.org/jfx/pull/1969#discussion_r4457641102

Reply via email to