class_multimeshinstance3d.rst 2.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the MultiMeshInstance3D.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_MultiMeshInstance3D:
  6. MultiMeshInstance3D
  7. ===================
  8. **Inherits:** :ref:`GeometryInstance3D<class_GeometryInstance3D>` **<** :ref:`VisualInstance3D<class_VisualInstance3D>` **<** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  9. Node that instances a :ref:`MultiMesh<class_MultiMesh>`.
  10. Description
  11. -----------
  12. ``MultiMeshInstance3D`` is a specialized node to instance :ref:`GeometryInstance3D<class_GeometryInstance3D>`\ s based on a :ref:`MultiMesh<class_MultiMesh>` resource.
  13. This is useful to optimize the rendering of a high amount of instances of a given mesh (for example trees in a forest or grass strands).
  14. Tutorials
  15. ---------
  16. - :doc:`Animating thousands of fish with MultiMeshInstance <../tutorials/performance/vertex_animation/animating_thousands_of_fish>`
  17. - :doc:`Using MultiMeshInstance <../tutorials/3d/using_multi_mesh_instance>`
  18. - :doc:`Optimization using MultiMeshes <../tutorials/performance/using_multimesh>`
  19. Properties
  20. ----------
  21. +-----------------------------------+----------------------------------------------------------------+
  22. | :ref:`MultiMesh<class_MultiMesh>` | :ref:`multimesh<class_MultiMeshInstance3D_property_multimesh>` |
  23. +-----------------------------------+----------------------------------------------------------------+
  24. Property Descriptions
  25. ---------------------
  26. .. _class_MultiMeshInstance3D_property_multimesh:
  27. - :ref:`MultiMesh<class_MultiMesh>` **multimesh**
  28. +----------+----------------------+
  29. | *Setter* | set_multimesh(value) |
  30. +----------+----------------------+
  31. | *Getter* | get_multimesh() |
  32. +----------+----------------------+
  33. The :ref:`MultiMesh<class_MultiMesh>` resource that will be used and shared among all instances of the ``MultiMeshInstance3D``.
  34. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  35. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  36. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  37. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  38. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  39. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`