MakieOrg · SimonDanisch · Dec 19, 2023 · Dec 19, 2023 · Dec 2, 2025 · Dec 3, 2025
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+## Unreleased
+
+- `Subfigure` now anchors its content to the top-left instead of centring it. A `GridLayout` defaults to `valign = :center`, so content shorter than the scroll region floated in the middle of it; when content overflows the alignment has no effect, so this only changes the short case.
+- Added a `Card` block: a titled, foldable container for building lists of settings panels. `open` folds the body away and leaves the header; `visible = false` COLLAPSES the card — unlike `hide!`, which stops a block drawing but leaves its row at full height, so a filtered list showed holes where its hidden entries used to be. A card's bottom spacing is part of the card rather than a gap in the parent layout, so hiding one leaves no double gap; build the stack with `default_rowgap = 0`. `filter_cards!(predicate, stack, cards)` applies a filter in a single relayout (measured over 100 cards, toggling 50: 147 ms one at a time, 14 ms batched, 433 ms to rebuild them instead). Header widgets go in `card_accessory(card)`, and `headerclicks` counts presses on the title bar for list selection.
+- Fixed a GLMakie `InexactError` that killed the first render of a fresh window when a scene's viewport had not been laid out yet: the empty-`Rect2i()` sentinel (typemax/typemin) makes `effective_clip`'s Int64 `intersect` overflow to a garbage-but-finite rect, and rounding that to `Int` for `glViewport`/`glScissor` threw. The per-scene scissor code now clamps each pixel extent to a sane `GLint` range (`gl_extent`).
+- Added a unified `colors` theme block for Block widgets, plus a `Makie.derive_colors(; accent, gray, background)` helper that produces a full scheme from a few inputs. `set_theme!(colors = Makie.derive_colors(accent = :crimson))` recolors every interactive Block consistently — see the Block colors docs. Default neutral surfaces shift very slightly from the historical literals. [#5628](https://github.com/MakieOrg/Makie.jl/pull/5628)
+  - The `@inherit` macro inside `@Block` now accepts a tuple of symbols (`@inherit((:colors, :accent), default)`) to walk nested theme dicts.
+- Added `Tabs` and `Subfigure` blocks, a tabbed container and the scrollable, event-isolated sub-region it is built on. [#5650](https://github.com/MakieOrg/Makie.jl/pull/5650)
+- Added a `Table` block for displaying tabular data, with row/cell selection, column sorting and scrolling. [#5510](https://github.com/MakieOrg/Makie.jl/pull/5510)
+- Added pointer-event routing based on visual scene stacking so overlay scenes (menus, dropdowns, popups) no longer leak mouse events to widgets underneath. `receives_events(scene)` returns `false` when a scene in a different subtree visually covers the pointer, and `is_mouseinside(scene)` honors it automatically. [#5510](https://github.com/MakieOrg/Makie.jl/pull/5510)
+- Added a high-level figure GUI: a `HoverMenu` toolbar (save / copy / reset) plus opt-in automatic `Legend`/`Colorbar` insertion, controlled via `Figure(; gui, legend, colorbar)` or the theme. Also added convenience constructors `Legend(ax; ...)`, `Colorbar(ax, plot; ...)` and `axiscolorbar`. [#3491](https://github.com/MakieOrg/Makie.jl/pull/3491)
+- Fixed a searchable `Menu` dying on a query that matches no option: the empty option list left its per-option color vectors empty, and the next query that did match resolved the option text plot against them and threw a `BoundsError` — inside the compute graph, which takes the render loop down with it. Per-option positions, rects and colors are now resized before the text plot sees the new strings, and `per_glyph_block` no longer indexes into an empty per-string attribute vector.
+- Added a `Modal` block: a theme-styled dialog with a translucent backdrop that blocks pointer input to everything underneath while open (`open!`/`close!`, × button, optional backdrop-click dismissal). The content area is a `Subfigure`, so fixed-size modals scroll. Scenes can opt into pointer capture explicitly with `scene.captures_mouse = true`.
+
 ## Breaking
 
 - **breaking** Moved `FFMPEG_jll` from a hard dependency to a package extension to avoid pulling in GPL-licensed libraries (e.g. libx264). `record`, `VideoStream`, `convert_video`, and `extract_frames` now require `FFMPEG_jll` to be available in the active environment; Makie will load it automatically on first use. A custom ffmpeg binary can be configured via `Makie.ffmpeg_path!(path)` (or persistently via Preferences.jl). [#5588](https://github.com/MakieOrg/Makie.jl/pull/5588)

diff --git a/CairoMakie/Project.toml b/CairoMakie/Project.toml
@@ -24,7 +24,7 @@ FileIO = "1.1"
 FreeType = "3, 4.0"
 GeometryBasics = "0.5"
 LinearAlgebra = "1.0, 1.6"
-Makie = "=0.25.0"
+Makie = "=0.24.13"
 PrecompileTools = "1.0"
 julia = "1"
 

diff --git a/CairoMakie/src/plot-primitives.jl b/CairoMakie/src/plot-primitives.jl
@@ -32,7 +32,7 @@ function cairo_draw(screen::Screen, scene::Scene)
         # only prepare for scene when it changes
         # this should reduce the number of unnecessary clipping masks etc.
         pparent = Makie.parent_scene(p)::Scene
-        pparent.visible[]::Bool || continue
+        Makie.scene_visible(pparent) || continue
         if pparent != last_scene
             Cairo.restore(screen.context)
             Cairo.save(screen.context)
@@ -92,22 +92,27 @@ function prepare_for_scene(screen::Screen, scene::Scene)
 
     # get the root area to correct for its size when translating
     root_area_height = widths(Makie.root(scene))[2]
-    scene_area = viewport(scene)[]
-    scene_height = widths(scene_area)[2]
-    scene_x_origin, scene_y_origin = scene_area.origin
 
-    # we need to translate x by the origin, so distance from the left
-    # but y by the distance from the top, which is not the origin, but can
-    # be calculated using the parent's height, the scene's height and the y origin
-    # this is because y goes downwards in Cairo and upwards in Makie
+    # Clip to the intersection of all ancestor viewports — `effective_clip`
+    # — so the scene only renders within the bounds its parents share.
+    # The scene's own viewport is excluded from the intersection, so e.g.
+    # axis markers near a spine extend past the plot scene into the axis's
+    # decoration area (which is clipped at the figure / container edge).
+    clip_area = Makie.effective_clip(scene)
+    clip_x, clip_y_makie = origin(clip_area)
+    clip_w, clip_h = widths(clip_area)
+    clip_top = root_area_height - clip_y_makie - clip_h
+    Cairo.rectangle(screen.context, clip_x, clip_top, clip_w, clip_h)
+    Cairo.clip(screen.context)
 
+    # Translate so scene-local (0, 0) corresponds to the scene's window origin.
+    # Cairo's y goes down, Makie's goes up, hence the parent-height correction.
+    scene_area = viewport(scene)[]
+    scene_x_origin, scene_y_origin = scene_area.origin
+    scene_height = widths(scene_area)[2]
     top_offset = root_area_height - scene_height - scene_y_origin
     Cairo.translate(screen.context, scene_x_origin, top_offset)
 
-    # clip the scene to its viewport
-    Cairo.rectangle(screen.context, 0, 0, widths(scene_area)...)
-    Cairo.clip(screen.context)
-
     return
 end
 
@@ -119,7 +124,7 @@ end
 function draw_background(screen::Screen, scene::Scene, root_h)
     cr = screen.context
     Cairo.save(cr)
-    if scene.clear[]
+    if scene.clear[] && Makie.scene_visible(scene)
         bg = scene.backgroundcolor[]
         Cairo.set_source_rgba(cr, red(bg), green(bg), blue(bg), alpha(bg))
         r = viewport(scene)[]

diff --git a/GLMakie/Project.toml b/GLMakie/Project.toml
@@ -30,7 +30,7 @@ FreeTypeAbstraction = "0.10"
 GLFW = "3.4.3"
 GeometryBasics = "0.5"
 LinearAlgebra = "1.0, 1.6"
-Makie = "=0.25.0"
+Makie = "=0.24.13"
 Markdown = "1.0, 1.6"
 MeshIO = "0.5"
 ModernGL = "1"

diff --git a/GLMakie/src/postprocessing.jl b/GLMakie/src/postprocessing.jl
@@ -286,6 +286,15 @@ end
 
 on_resize(stage::RenderPlots, w, h) = resize!(stage.framebuffer, w, h)
 
+# glViewport / glScissor take GLint pixel extents. A scene whose viewport hasn't
+# been laid out yet carries the empty-`Rect2i()` sentinel (typemax/typemin), which
+# makes `effective_clip`'s Int64 `intersect` overflow to a garbage-but-finite rect;
+# `round(Int, ppu .* that)` then throws `InexactError` and kills the whole frame
+# (seen as "Error while rendering!" on the very first render of a fresh window).
+# Clamp each component to a sane pixel range so a transient pre-layout viewport
+# degrades to a valid rect instead of crashing the render loop.
+@inline gl_extent(x::Real) = isfinite(x) ? round(GLint, clamp(x, -1.0f8, 1.0f8)) : GLint(0)
+
 function run_stage(screen, glscene, stage::RenderPlots)
     # Somehow errors in here get ignored silently!?
     try
@@ -301,23 +310,31 @@ function run_stage(screen, glscene, stage::RenderPlots)
 
         set_draw_buffers(stage.framebuffer)
 
+        glEnable(GL_SCISSOR_TEST)
         for (zindex, screenid, elem) in screen.renderlist
             elem.visible && haskey(elem.variants, stage.target) || continue
 
             found, scene = id2scene(screen, screenid)
-            (found && scene.visible[]) || continue
+            (found && Makie.scene_visible(scene)) || continue
 
             ppu = screen.px_per_unit[]
             a = viewport(scene)[]
+            # Scissor to the intersection of all ancestor viewports (excluding
+            # the scene's own) so each scene draws only within the bounds its
+            # parents share; lets markers near a scene edge extend past it
+            # while still being cut off at the enclosing container / window.
+            sa = Makie.effective_clip(scene)
 
             require_context(screen.glscreen)
-            glViewport(round.(Int, ppu .* minimum(a))..., round.(Int, ppu .* widths(a))...)
+            glViewport(gl_extent.(ppu .* minimum(a))..., gl_extent.(ppu .* widths(a))...)
+            glScissor(gl_extent.(ppu .* minimum(sa))..., gl_extent.(ppu .* widths(sa))...)
             elem[:px_per_unit] = ppu
 
             stage.prerender(elem[:overdraw]::UInt8)
 
             render(elem, elem.variants[stage.target])
         end
+        glDisable(GL_SCISSOR_TEST)
     catch e
         @error "Error while rendering!" exception = e
         rethrow(e)

diff --git a/GLMakie/src/rendering.jl b/GLMakie/src/rendering.jl
@@ -12,11 +12,11 @@ function setup!(screen::Screen, fb)
     glEnable(GL_SCISSOR_TEST)
     ppu = screen.px_per_unit[]
     for (id, scene) in screen.screens
-        if scene.visible[] && scene.clear[]
+        if Makie.scene_visible(scene) && scene.clear[]
             a = viewport(scene)[]
-            rt = (round.(Int, ppu .* minimum(a))..., round.(Int, ppu .* widths(a))...)
-            glViewport(rt...)
-            glScissor(rt...)
+            sa = Makie.effective_clip(scene)
+            glViewport(round.(Int, ppu .* minimum(a))..., round.(Int, ppu .* widths(a))...)
+            glScissor(round.(Int, ppu .* minimum(sa))..., round.(Int, ppu .* widths(sa))...)
             c = scene.backgroundcolor[]
             glClearColor(red(c), green(c), blue(c), alpha(c))
             glClear(GL_COLOR_BUFFER_BIT)

diff --git a/Makie/Project.toml b/Makie/Project.toml
@@ -1,7 +1,7 @@
 name = "Makie"
 uuid = "ee78f7c6-11fb-53f2-987a-cfe4a2b5a57a"
 authors = ["Simon Danisch", "Julius Krumbiegel"]
-version = "0.25.0"
+version = "0.24.13"
 
 [deps]
 Animations = "27a7e980-b3e6-11e9-2bcd-0b925532e340"
@@ -27,6 +27,7 @@ FreeTypeAbstraction = "663a7486-cb36-511b-a19d-713bb74d65c9"
 GeometryBasics = "5c1252a2-5f33-56bf-86c9-59e7332b4326"
 GridLayoutBase = "3955a311-db13-416c-9275-1d80ed98e5e9"
 ImageBase = "c817782e-172a-44cc-b673-b171935fbb9e"
+ImageClipboard = "6db54171-f50f-4661-a74f-bc514ef16cee"
 ImageIO = "82e4d734-157c-48bb-816b-45c225c6df19"
 InteractiveUtils = "b77e0a4c-d291-57a0-90e8-8db25a27a240"
 Interpolations = "a98d9a8b-a2ab-59e6-89dd-64a1c18fca59"
@@ -39,6 +40,7 @@ LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
 MacroTools = "1914dd2f-81c6-5fcd-8719-6d5c9610ff09"
 Markdown = "d6f4376e-aef5-505a-96c1-9c027394607a"
 MathTeXEngine = "0a4f8689-d25c-4efe-a92b-7142dfc1aa53"
+NativeFileDialog_jll = "94d9ae2c-efc7-56f8-9a02-54c47b797961"
 Observables = "510215fc-4207-5dde-b226-833fc4488ee2"
 OffsetArrays = "6fe1bfb0-de20-5000-8ca7-80f57d26f881"
 PNGFiles = "f57f5aa1-a3ce-4bc8-8ab9-96f992907883"
@@ -95,9 +97,10 @@ FixedPointNumbers = "0.6, 0.7, 0.8"
 Format = "1.3"
 FreeType = "3.0, 4.0"
 FreeTypeAbstraction = "0.10.3"
-GeometryBasics = "0.5.9"
+GeometryBasics = "0.5.11"
 GridLayoutBase = "0.11"
 ImageBase = "0.1.7"
+ImageClipboard = "1.0.0"
 ImageIO = "0.5, 0.6"
 InteractiveUtils = "1.0, 1.6"
 Interpolations = "0.14, 0.15.1, 0.16"
@@ -110,6 +113,7 @@ LinearAlgebra = "1.0, 1.6"
 MacroTools = "0.5"
 Markdown = "1.0, 1.6"
 MathTeXEngine = "0.5, 0.6"
+NativeFileDialog_jll = "1.1.6"
 Observables = "0.5.5"
 OffsetArrays = "1"
 PNGFiles = "0.4.4"

diff --git a/Makie/src/GUI/file-dialogue.jl b/Makie/src/GUI/file-dialogue.jl
@@ -0,0 +1,35 @@
+using NativeFileDialog_jll
+
+function choose_file_dialogue(filter = C_NULL)
+    path = Ref(Ptr{UInt8}())
+    r = @ccall libnfd.NFD_OpenDialog(
+        filter::Ptr{Cchar}, C_NULL::Ptr{Cchar},
+        path::Ref{Ptr{UInt8}}
+    )::Cint
+    if r == 2
+        # User clicked "Cancel"
+        out = nothing
+    elseif r == 1
+        out = unsafe_string(path[])
+    else
+        error()
+    end
+    return out
+end
+
+function save_file_dialogue(filter = C_NULL)
+    path = Ref(Ptr{UInt8}())
+    r = @ccall libnfd.NFD_SaveDialog(
+        filter::Ptr{Cchar}, C_NULL::Ptr{Cchar},
+        path::Ref{Ptr{UInt8}}
+    )::Cint
+    if r == 2
+        # User clicked "Cancel"
+        out = nothing
+    elseif r == 1
+        out = unsafe_string(path[])
+    else
+        error()
+    end
+    return out
+end