example: add ManyImages sample

Add a ManyImages example that loads 500 PNG pictures and
animates their translate, scale, and rotation values to
exercise picture-heavy scenes.

Register the sample in the Meson build so it is built with
the other examples.

Author: hermet

src/ManyImages.cpp

@@ -0,0 +1,81 @@
+/*
+ * Copyright (c) 2026 ThorVG project. All rights reserved.
+
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+#include "Example.h"
+#include <random>
+
+
+constexpr int kCanvasSize = 1650;
+constexpr int kImageCount = 500;
+constexpr int kRotationRange = 360;
+constexpr int kMinScaleStep = 10;
+constexpr int kScaleRange = 90;
+constexpr float kScaleFactor = 0.005f;
+
+static int randomValue(int upper)
+{
+    // Keep RNG state per-thread instead of relying on global rand().
+    thread_local std::minstd_rand rng{std::random_device{}()};
+    thread_local std::uniform_int_distribution<int> dist;
+    return dist(rng, decltype(dist)::param_type(0, upper - 1));
+}
+
+/************************************************************************/
+/* ThorVG Drawing Contents                                              */
+/************************************************************************/
+
+struct UserExample : tvgexam::Example
+{
+    bool content(tvg::Canvas* canvas, uint32_t w, uint32_t h) override
+    {
+        for (int i = 0; i < kImageCount; ++i) {
+            auto p = tvg::Picture::gen();
+            if (!tvgexam::verify(p->load(EXAMPLE_DIR"/image/test.png"))) return false;
+            p->origin(0.5f, 0.5f);
+            p->translate(randomValue(kCanvasSize), randomValue(kCanvasSize));
+            p->scale(float(kMinScaleStep + randomValue(kScaleRange)) * kScaleFactor);
+            p->rotate(float(randomValue(kRotationRange)));
+            canvas->add(p);
+        }
+        return true;
+    }
+
+    bool update(tvg::Canvas* canvas, uint32_t elapsed) override
+    {
+        for (auto paint : canvas->paints()) {
+            auto p = static_cast<tvg::Picture*>(paint);
+            p->translate(randomValue(kCanvasSize), randomValue(kCanvasSize));
+            p->scale(float(kMinScaleStep + randomValue(kScaleRange)) * kScaleFactor);
+            p->rotate(float(randomValue(kRotationRange)));
+        }
+        return canvas->update() == tvg::Result(0);
+    }
+};
+
+/************************************************************************/
+/* Entry Point                                                          */
+/************************************************************************/
+
+int main(int argc, char **argv)
+{
+    return tvgexam::main(new UserExample, argc, argv, true, kCanvasSize, kCanvasSize, 4, true);
+}

src/meson.build

@@ -55,6 +55,7 @@ source_file = [
     'LinearGradient.cpp',
     'Masking.cpp',
     'MaskingMethods.cpp',
+    'ManyImages.cpp',
     'ManyRects.cpp',
     'MultiCanvas.cpp',
     'Opacity.cpp',