add test

ReferenceTests/src/tests/primitives.jl

@@ -457,3 +457,18 @@ end
 
     fig
 end
+
+@reference_test "datashader" begin
+    airports = Point2f.(eachrow(readdlm(Makie.assetpath("airportlocations.csv"))))
+    fig, ax, ds = datashader(airports, async = false)
+    Colorbar(fig[1, 2], ds, width=100)
+    hidedecorations!(ax); hidespines!(ax)
+
+    normaldist = randn(Point2f, 1_000_000)
+    ds1 = normaldist .+ (Point2f(-1, 0),)
+    ds2 = normaldist .+ (Point2f(1, 0),)
+    ax, pl = datashader(fig[2, :], Dict("a" => ds1, "b" => ds2))
+    hidedecorations!(ax)
+    axislegend(ax)
+    fig
+end

docs/reference/plots/datashader.md

@@ -11,7 +11,7 @@
 using DelimitedFiles, GLMakie
 GLMakie.activate!() # hide
 # For saving/showing/inlining into documentation we need to disable async calculation.
-Makie.set_theme!(DataShader = (; async_latest=false))
+Makie.set_theme!(DataShader = (; async=false))
 airports = Point2f.(eachrow(readdlm(assetpath("airportlocations.csv"))))
 fig, ax, ds = datashader(airports,
     colormap=[:white, :black],

src/basic_recipes/datashader.jl

@@ -273,6 +273,7 @@ end
 
 !!! warning
     This feature might change outside breaking releases, since the API is not yet finalized.
+    Please be vary of bugs in the implementation and open issues if you encounter odd behaviour.
 
 Points can be any array type supporting iteration & getindex, including memory mapped arrays.
 If you have separate arrays for x and y coordinates and want to avoid conversion and copy, consider using: