class_atlastexture.rst 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the AtlasTexture.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_AtlasTexture:
  6. AtlasTexture
  7. ============
  8. **Inherits:** :ref:`Texture2D<class_Texture2D>` **<** :ref:`Texture<class_Texture>` **<** :ref:`Resource<class_Resource>` **<** :ref:`Reference<class_Reference>` **<** :ref:`Object<class_Object>`
  9. Packs multiple small textures in a single, bigger one. Helps to optimize video memory costs and render calls.
  10. Description
  11. -----------
  12. :ref:`Texture2D<class_Texture2D>` resource aimed at managing big textures files that pack multiple smaller textures. Consists of a :ref:`Texture2D<class_Texture2D>`, a margin that defines the border width, and a region that defines the actual area of the AtlasTexture.
  13. Properties
  14. ----------
  15. +-----------------------------------+-------------------------------------------------------------+-------------------------+
  16. | :ref:`Texture2D<class_Texture2D>` | :ref:`atlas<class_AtlasTexture_property_atlas>` | |
  17. +-----------------------------------+-------------------------------------------------------------+-------------------------+
  18. | :ref:`bool<class_bool>` | :ref:`filter_clip<class_AtlasTexture_property_filter_clip>` | ``false`` |
  19. +-----------------------------------+-------------------------------------------------------------+-------------------------+
  20. | :ref:`Rect2<class_Rect2>` | :ref:`margin<class_AtlasTexture_property_margin>` | ``Rect2( 0, 0, 0, 0 )`` |
  21. +-----------------------------------+-------------------------------------------------------------+-------------------------+
  22. | :ref:`Rect2<class_Rect2>` | :ref:`region<class_AtlasTexture_property_region>` | ``Rect2( 0, 0, 0, 0 )`` |
  23. +-----------------------------------+-------------------------------------------------------------+-------------------------+
  24. Property Descriptions
  25. ---------------------
  26. .. _class_AtlasTexture_property_atlas:
  27. - :ref:`Texture2D<class_Texture2D>` **atlas**
  28. +----------+------------------+
  29. | *Setter* | set_atlas(value) |
  30. +----------+------------------+
  31. | *Getter* | get_atlas() |
  32. +----------+------------------+
  33. The texture that contains the atlas. Can be any :ref:`Texture2D<class_Texture2D>` subtype.
  34. ----
  35. .. _class_AtlasTexture_property_filter_clip:
  36. - :ref:`bool<class_bool>` **filter_clip**
  37. +-----------+------------------------+
  38. | *Default* | ``false`` |
  39. +-----------+------------------------+
  40. | *Setter* | set_filter_clip(value) |
  41. +-----------+------------------------+
  42. | *Getter* | has_filter_clip() |
  43. +-----------+------------------------+
  44. If ``true``, clips the area outside of the region to avoid bleeding of the surrounding texture pixels.
  45. ----
  46. .. _class_AtlasTexture_property_margin:
  47. - :ref:`Rect2<class_Rect2>` **margin**
  48. +-----------+-------------------------+
  49. | *Default* | ``Rect2( 0, 0, 0, 0 )`` |
  50. +-----------+-------------------------+
  51. | *Setter* | set_margin(value) |
  52. +-----------+-------------------------+
  53. | *Getter* | get_margin() |
  54. +-----------+-------------------------+
  55. The margin around the region. The :ref:`Rect2<class_Rect2>`'s :ref:`Rect2.size<class_Rect2_property_size>` parameter ("w" and "h" in the editor) resizes the texture so it fits within the margin.
  56. ----
  57. .. _class_AtlasTexture_property_region:
  58. - :ref:`Rect2<class_Rect2>` **region**
  59. +-----------+-------------------------+
  60. | *Default* | ``Rect2( 0, 0, 0, 0 )`` |
  61. +-----------+-------------------------+
  62. | *Setter* | set_region(value) |
  63. +-----------+-------------------------+
  64. | *Getter* | get_region() |
  65. +-----------+-------------------------+
  66. The AtlasTexture's used region.