.. _sphx_glr__gallery_validation:

Validation Examples
-------------------



.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example showing the axes helper.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_helpers1_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_helpers1.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Axes Helper 1</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Shows a semi-transparent square. On the left it uses a background, on the right it does not.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_blend_bg_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_blend_bg.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate transparency with and without bg</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example showing the box geometry.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_box_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_box.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Box Geometry</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example demonstrating the capabilities of text outline to stay behind the text itself, even for very thick value of the outline thickness where the outline of one character may overlap with the neighboring one.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_text_outline_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_text_outline.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Text outline always behind text itself</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example showing the axes and grid helpers with a perspective camera.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_helpers2_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_helpers2.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Axis Helper 2</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Show an image displayed the correct way.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_image2_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_image2.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Image Material</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example draws overlapping circles of reference colors with additive blending.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_blend_additive_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_blend_additive.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Additive Blending</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Show an image using a plane geometry. For historic reasons, image data (usually) has the first rows representing the top of the image. But the plane gemeometry is such that it is reversed again.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_image1_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_image1.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Image on Plane Geometry 1</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example validates that normals are handled such that both the front and back faces are lit. Further it validates the appearance of the normal lines material.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_normals_sides_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_normals_sides.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Normals on front and back</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip=" On the left are points with increasing size, without aa, they don&#x27;t get smaller than one physical pixel.  On the right are poonts with increasing size, with aa, really small points diminish with alpha.  Note that due to the set pixel_ratio, a thickness of 2 is 1 physical pixel.  The bottom row demonstrates per-vertex sizing.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_points_size_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_points_size.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Points with different sizes</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example (and test) for behavior of the depth buffer w.r.t. overlays, implemented using Material.depth_test. The overlaid object should always be on top.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_depth_overlay2_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_depth_overlay2.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Depth Overlay 2</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example draws a series of semitransparent planes using weighted_plus.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_blend_weightedplus_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_blend_weightedplus.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate weighted_plus</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip=" The top line is drawn with the thin line material, a classic gl one-pixel line.  On the left are lines with increasing thickness, without aa, they don&#x27;t get thinner than one physical pixel.  On the right are lines with increasing thickness, with aa, really thin lines diminish with alpha.  Note that due to the set pixel_ratio, a thickness of 2 is 1 physical pixel. * When dashes are present, they will eventually diminish as the line thickness reduces.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_line_thickness_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_line_thickness.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Lines with different thicknesses</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example (and test) for behavior of the depth buffer w.r.t. overlays, implemented by multiple render calls. The overlay should always be on top.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_depth_overlay1_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_depth_overlay1.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Depth Overlay 1</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example draws a series of semitransparent planes using dither mode.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_blend_dither_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_blend_dither.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate dither</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example draws squares of reference colors. These can be compared to similar output from e.g. Matplotlib.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_color_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_color.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Reference Color</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows texts with different anchors, so the text can be aligned in the scene.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_text_anchor_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_text_anchor.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Text anchor</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Pygfx text supports multiple text directions. Latin scripts (like English) are left-to-right. A right-to-left direction is used for e.g. Arabic, and top-to-bottom sometimes for Asian languages.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_text_direction_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_text_direction.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Text direction</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Show images with physical colorspace, and srgb colorspace via three methods.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_srgb_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_srgb.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">srgb texture colorspace</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Test markdown formatting features.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_text_md_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_text_md.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Text markdown formatting</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows the ability to render different images of small sizes from 32x32 to 1x1 pixels in both RGB and grayscale formats.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_tiny_image_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_tiny_image.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Tiny Image Validation</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Display 4 semi-transparent planes::">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_blend_ordered2_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_blend_ordered2.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate transparency for the ordered2 blend mode</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Show an image with points overlaid. Both the image and points are uploaded with send_data.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_send_data_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_send_data.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate send_data</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip=" Demoing densely sampled lines with dashing.  Thicker lines show the same pattern (i.e. dash phase increases with thickness). * Dash offset is expressed in same space as the pattern.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_line_dash_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_line_dash.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Dashing</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Apply a variety of transform combinations.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_transform_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_transform.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate transforms</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example combines MeshPhongMaterial and MeshStandardMaterial with PointLight, AmbientLight, SpotLight and DirectionalLight to check that all combinations are working properly.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_light_shadow_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_light_shadow.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Light and Shadow</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This validates that the skybox background is rendered correctly, as well as that the environment-map matches that background. Therefore it also covers the internal cube-camera-renderer.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_skybox_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_skybox.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate Skybox</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Show an image with four different colormaps.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_image_colormap_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_image_colormap.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate Colormap</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example (and test) for camera depth clipping planes. This draws four rectangles near the near and far clipping planes.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_depth_clipping_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_depth_clipping.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Depth Clipping</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Display infinite line segments.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_line_inf_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_line_inf.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Infinite line segments</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example demonstrating the capabilities of text to be aligned and justified according to the user&#x27;s decision.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_text_align_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_text_align.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Text alignment</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Showing off some ruler tricks.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_ruler_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_ruler.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate ruler</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Render a volume and volume slices. You should see:">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_volume_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_volume.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Volume and Volume Slice Rendering</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example (and test) for the NDC coordinates. Draws a square that falls partly out of visible range.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_ndc_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_ndc.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">NDC Coordinates</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example shows text with different sizes.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_text_size_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_text_size.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Text size</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip=" This shows a 2D line in 3 flavours.  It shows a gap due to nan values.  It has duplicate points to test correct handling for that.  It also puts a few points in quick succession to test that it staus a continuous line (with joins, no caps). * It includes a point that only has its z-value different, which should behave like a duplicate point.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_line_2d_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_line_2d.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Lines in 2D</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Show a bunch of grids touching various grid-cases.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_grid1_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_grid1.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate the grid</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example draws 3 rows of cubes, each with size 10, but each row in a different size_space (and color). The left column is positioned directly in the scene. The next two columns are smaller cubes, but placed in scaled containers.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_points_size_space_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_points_size_space.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Points drawn with different size_space</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This renders a sine wave on a gradient background. But the four quadrants are rendered separately using set_view_offset and put together using textured gfx.Mesh objects with a margin in between.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_view_offset_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_view_offset.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Validate view offset</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example draws 3 rows of cubes, each with thickness 10, but each row in a different thickness_space (and color). The left column is positioned directly in the scene. The next two columns are smaller cubes, but placed in scaled containers.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_line_thickness_space_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_line_thickness_space.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Lines drawn with different thickness_space</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Show meshes with 1D, 2D, and 3D colormaps, and per-vertex colors too.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_mesh_colormap_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_mesh_colormap.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Mesh Colormaps</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example test to validate winding and culling.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_culling_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_culling.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Culling</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Drawing multiple line loops using material.loop and separating line-pieces with nans.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_line_loop_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_line_loop.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Line loop</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip=" All available marker shapes are shown.  Shows red, green and blue faces. Then a semi-transparent face, and finally a fully-transparent face.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_points_markers_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_points_markers.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Points with different markers</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Example to validate the mesh slice rendering.">

.. only:: html

  .. image:: /_gallery/validation/images/thumb/sphx_glr_validate_meshslice_thumb.webp
    :alt:

  :ref:`sphx_glr__gallery_validation_validate_meshslice.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Mesh slice</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /_gallery/validation/validate_helpers1
   /_gallery/validation/validate_blend_bg
   /_gallery/validation/validate_box
   /_gallery/validation/validate_text_outline
   /_gallery/validation/validate_helpers2
   /_gallery/validation/validate_image2
   /_gallery/validation/validate_blend_additive
   /_gallery/validation/validate_image1
   /_gallery/validation/validate_normals_sides
   /_gallery/validation/validate_points_size
   /_gallery/validation/validate_depth_overlay2
   /_gallery/validation/validate_blend_weightedplus
   /_gallery/validation/validate_line_thickness
   /_gallery/validation/validate_depth_overlay1
   /_gallery/validation/validate_blend_dither
   /_gallery/validation/validate_color
   /_gallery/validation/validate_text_anchor
   /_gallery/validation/validate_text_direction
   /_gallery/validation/validate_srgb
   /_gallery/validation/validate_text_md
   /_gallery/validation/validate_tiny_image
   /_gallery/validation/validate_blend_ordered2
   /_gallery/validation/validate_send_data
   /_gallery/validation/validate_line_dash
   /_gallery/validation/validate_transform
   /_gallery/validation/validate_light_shadow
   /_gallery/validation/validate_skybox
   /_gallery/validation/validate_image_colormap
   /_gallery/validation/validate_depth_clipping
   /_gallery/validation/validate_line_inf
   /_gallery/validation/validate_text_align
   /_gallery/validation/validate_ruler
   /_gallery/validation/validate_volume
   /_gallery/validation/validate_ndc
   /_gallery/validation/validate_text_size
   /_gallery/validation/validate_line_2d
   /_gallery/validation/validate_grid1
   /_gallery/validation/validate_points_size_space
   /_gallery/validation/validate_view_offset
   /_gallery/validation/validate_line_thickness_space
   /_gallery/validation/validate_mesh_colormap
   /_gallery/validation/validate_culling
   /_gallery/validation/validate_line_loop
   /_gallery/validation/validate_points_markers
   /_gallery/validation/validate_meshslice