.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "_gallery/feature_demo/instancing_mesh.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download__gallery_feature_demo_instancing_mesh.py>`
        to download the full example code.

.. rst-class:: sphx-glr-example-title

.. _sphx_glr__gallery_feature_demo_instancing_mesh.py:


Instancing
==========

Example rendering the same mesh object multiple times, using instancing.

.. GENERATED FROM PYTHON SOURCE LINES 7-55



.. image-sg:: /_gallery/feature_demo/images/sphx_glr_instancing_mesh_001.webp
   :alt: instancing mesh
   :srcset: /_gallery/feature_demo/images/sphx_glr_instancing_mesh_001.webp
   :class: sphx-glr-single-img





.. code-block:: Python



    import numpy as np
    import imageio.v3 as iio
    from rendercanvas.auto import RenderCanvas, loop
    import pygfx as gfx
    import pylinalg as la


    canvas = RenderCanvas()
    renderer = gfx.renderers.WgpuRenderer(canvas)
    scene = gfx.Scene()

    im = iio.imread("imageio:bricks.jpg").astype(np.float32) / 255
    tex = gfx.Texture(im, dim=2)

    geometry = gfx.torus_knot_geometry(1, 0.3, 128, 32)
    geometry.texcoords.data[:, 0] *= 10  # stretch the texture
    material = gfx.MeshPhongMaterial(map=tex)
    obj = gfx.InstancedMesh(geometry, material, 100)
    scene.add(obj)


    # Set matrices. Note that these are sub-transforms of the mesh's own matrix.
    for y in range(10):
        for x in range(10):
            m = la.mat_from_translation((y * 2, x * 2, 0))
            obj.set_matrix_at(x + y * 10, m)


    camera = gfx.PerspectiveCamera(70, 1)
    camera.local.position = (9, 9, 15)

    scene.add(gfx.AmbientLight())
    scene.add(camera.add(gfx.DirectionalLight()))


    def animate():
        rot = la.quat_from_euler((0.0071, 0.01), order="XY")
        obj.local.rotation = la.quat_mul(rot, obj.local.rotation)

        renderer.render(scene, camera)
        canvas.request_draw()


    if __name__ == "__main__":
        canvas.request_draw(animate)
        loop.run()


.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 1.224 seconds)


.. _sphx_glr_download__gallery_feature_demo_instancing_mesh.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: instancing_mesh.ipynb <instancing_mesh.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: instancing_mesh.py <instancing_mesh.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: instancing_mesh.zip <instancing_mesh.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_

.. only:: html

    Interactive example
    -------------------

    Try this example in your browser using Pyodide. Might not work with all examples and all devices. Check the output and your browser's console for details.

    .. raw:: html

        <iframe src="./../pyodide.html#instancing_mesh.py"></iframe>