class_spritebase3d.rst 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/SpriteBase3D.xml.
  6. .. _class_SpriteBase3D:
  7. SpriteBase3D
  8. ============
  9. **Inherits:** :ref:`GeometryInstance3D<class_GeometryInstance3D>` **<** :ref:`VisualInstance3D<class_VisualInstance3D>` **<** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  10. **Inherited By:** :ref:`AnimatedSprite3D<class_AnimatedSprite3D>`, :ref:`Sprite3D<class_Sprite3D>`
  11. 2D sprite node in 3D environment.
  12. .. rst-class:: classref-introduction-group
  13. Description
  14. -----------
  15. A node that displays 2D texture information in a 3D environment. See also :ref:`Sprite3D<class_Sprite3D>` where many other properties are defined.
  16. .. rst-class:: classref-reftable-group
  17. Properties
  18. ----------
  19. .. table::
  20. :widths: auto
  21. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  22. | :ref:`float<class_float>` | :ref:`alpha_antialiasing_edge<class_SpriteBase3D_property_alpha_antialiasing_edge>` | ``0.0`` |
  23. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  24. | :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>` | :ref:`alpha_antialiasing_mode<class_SpriteBase3D_property_alpha_antialiasing_mode>` | ``0`` |
  25. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  26. | :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` | :ref:`alpha_cut<class_SpriteBase3D_property_alpha_cut>` | ``0`` |
  27. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  28. | :ref:`float<class_float>` | :ref:`alpha_hash_scale<class_SpriteBase3D_property_alpha_hash_scale>` | ``1.0`` |
  29. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  30. | :ref:`float<class_float>` | :ref:`alpha_scissor_threshold<class_SpriteBase3D_property_alpha_scissor_threshold>` | ``0.5`` |
  31. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  32. | Vector3.Axis | :ref:`axis<class_SpriteBase3D_property_axis>` | ``2`` |
  33. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  34. | :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` | :ref:`billboard<class_SpriteBase3D_property_billboard>` | ``0`` |
  35. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  36. | :ref:`bool<class_bool>` | :ref:`centered<class_SpriteBase3D_property_centered>` | ``true`` |
  37. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  38. | :ref:`bool<class_bool>` | :ref:`double_sided<class_SpriteBase3D_property_double_sided>` | ``true`` |
  39. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  40. | :ref:`bool<class_bool>` | :ref:`fixed_size<class_SpriteBase3D_property_fixed_size>` | ``false`` |
  41. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  42. | :ref:`bool<class_bool>` | :ref:`flip_h<class_SpriteBase3D_property_flip_h>` | ``false`` |
  43. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  44. | :ref:`bool<class_bool>` | :ref:`flip_v<class_SpriteBase3D_property_flip_v>` | ``false`` |
  45. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  46. | :ref:`Color<class_Color>` | :ref:`modulate<class_SpriteBase3D_property_modulate>` | ``Color(1, 1, 1, 1)`` |
  47. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  48. | :ref:`bool<class_bool>` | :ref:`no_depth_test<class_SpriteBase3D_property_no_depth_test>` | ``false`` |
  49. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  50. | :ref:`Vector2<class_Vector2>` | :ref:`offset<class_SpriteBase3D_property_offset>` | ``Vector2(0, 0)`` |
  51. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  52. | :ref:`float<class_float>` | :ref:`pixel_size<class_SpriteBase3D_property_pixel_size>` | ``0.01`` |
  53. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  54. | :ref:`int<class_int>` | :ref:`render_priority<class_SpriteBase3D_property_render_priority>` | ``0`` |
  55. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  56. | :ref:`bool<class_bool>` | :ref:`shaded<class_SpriteBase3D_property_shaded>` | ``false`` |
  57. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  58. | :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` | :ref:`texture_filter<class_SpriteBase3D_property_texture_filter>` | ``3`` |
  59. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  60. | :ref:`bool<class_bool>` | :ref:`transparent<class_SpriteBase3D_property_transparent>` | ``true`` |
  61. +-----------------------------------------------------------------+-------------------------------------------------------------------------------------+-----------------------+
  62. .. rst-class:: classref-reftable-group
  63. Methods
  64. -------
  65. .. table::
  66. :widths: auto
  67. +-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
  68. | :ref:`TriangleMesh<class_TriangleMesh>` | :ref:`generate_triangle_mesh<class_SpriteBase3D_method_generate_triangle_mesh>` **(** **)** |const| |
  69. +-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
  70. | :ref:`bool<class_bool>` | :ref:`get_draw_flag<class_SpriteBase3D_method_get_draw_flag>` **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag **)** |const| |
  71. +-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
  72. | :ref:`Rect2<class_Rect2>` | :ref:`get_item_rect<class_SpriteBase3D_method_get_item_rect>` **(** **)** |const| |
  73. +-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
  74. | void | :ref:`set_draw_flag<class_SpriteBase3D_method_set_draw_flag>` **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag, :ref:`bool<class_bool>` enabled **)** |
  75. +-----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
  76. .. rst-class:: classref-section-separator
  77. ----
  78. .. rst-class:: classref-descriptions-group
  79. Enumerations
  80. ------------
  81. .. _enum_SpriteBase3D_DrawFlags:
  82. .. rst-class:: classref-enumeration
  83. enum **DrawFlags**:
  84. .. _class_SpriteBase3D_constant_FLAG_TRANSPARENT:
  85. .. rst-class:: classref-enumeration-constant
  86. :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_TRANSPARENT** = ``0``
  87. If set, the texture's transparency and the opacity are used to make those parts of the sprite invisible.
  88. .. _class_SpriteBase3D_constant_FLAG_SHADED:
  89. .. rst-class:: classref-enumeration-constant
  90. :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_SHADED** = ``1``
  91. If set, lights in the environment affect the sprite.
  92. .. _class_SpriteBase3D_constant_FLAG_DOUBLE_SIDED:
  93. .. rst-class:: classref-enumeration-constant
  94. :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_DOUBLE_SIDED** = ``2``
  95. If set, texture can be seen from the back as well. If not, the texture is invisible when looking at it from behind.
  96. .. _class_SpriteBase3D_constant_FLAG_DISABLE_DEPTH_TEST:
  97. .. rst-class:: classref-enumeration-constant
  98. :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_DISABLE_DEPTH_TEST** = ``3``
  99. Disables the depth test, so this object is drawn on top of all others. However, objects drawn after it in the draw order may cover it.
  100. .. _class_SpriteBase3D_constant_FLAG_FIXED_SIZE:
  101. .. rst-class:: classref-enumeration-constant
  102. :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_FIXED_SIZE** = ``4``
  103. Label is scaled by depth so that it always appears the same size on screen.
  104. .. _class_SpriteBase3D_constant_FLAG_MAX:
  105. .. rst-class:: classref-enumeration-constant
  106. :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` **FLAG_MAX** = ``5``
  107. Represents the size of the :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` enum.
  108. .. rst-class:: classref-item-separator
  109. ----
  110. .. _enum_SpriteBase3D_AlphaCutMode:
  111. .. rst-class:: classref-enumeration
  112. enum **AlphaCutMode**:
  113. .. _class_SpriteBase3D_constant_ALPHA_CUT_DISABLED:
  114. .. rst-class:: classref-enumeration-constant
  115. :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **ALPHA_CUT_DISABLED** = ``0``
  116. This mode performs standard alpha blending. It can display translucent areas, but transparency sorting issues may be visible when multiple transparent materials are overlapping.
  117. .. _class_SpriteBase3D_constant_ALPHA_CUT_DISCARD:
  118. .. rst-class:: classref-enumeration-constant
  119. :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **ALPHA_CUT_DISCARD** = ``1``
  120. This mode only allows fully transparent or fully opaque pixels. Harsh edges will be visible unless some form of screen-space antialiasing is enabled (see :ref:`ProjectSettings.rendering/anti_aliasing/quality/screen_space_aa<class_ProjectSettings_property_rendering/anti_aliasing/quality/screen_space_aa>`). On the bright side, this mode doesn't suffer from transparency sorting issues when multiple transparent materials are overlapping. This mode is also known as *alpha testing* or *1-bit transparency*.
  121. .. _class_SpriteBase3D_constant_ALPHA_CUT_OPAQUE_PREPASS:
  122. .. rst-class:: classref-enumeration-constant
  123. :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **ALPHA_CUT_OPAQUE_PREPASS** = ``2``
  124. This mode draws fully opaque pixels in the depth prepass. This is slower than :ref:`ALPHA_CUT_DISABLED<class_SpriteBase3D_constant_ALPHA_CUT_DISABLED>` or :ref:`ALPHA_CUT_DISCARD<class_SpriteBase3D_constant_ALPHA_CUT_DISCARD>`, but it allows displaying translucent areas and smooth edges while using proper sorting.
  125. .. _class_SpriteBase3D_constant_ALPHA_CUT_HASH:
  126. .. rst-class:: classref-enumeration-constant
  127. :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **ALPHA_CUT_HASH** = ``3``
  128. This mode draws cuts off all values below a spatially-deterministic threshold, the rest will remain opaque.
  129. .. rst-class:: classref-section-separator
  130. ----
  131. .. rst-class:: classref-descriptions-group
  132. Property Descriptions
  133. ---------------------
  134. .. _class_SpriteBase3D_property_alpha_antialiasing_edge:
  135. .. rst-class:: classref-property
  136. :ref:`float<class_float>` **alpha_antialiasing_edge** = ``0.0``
  137. .. rst-class:: classref-property-setget
  138. - void **set_alpha_antialiasing_edge** **(** :ref:`float<class_float>` value **)**
  139. - :ref:`float<class_float>` **get_alpha_antialiasing_edge** **(** **)**
  140. Threshold at which antialiasing will be applied on the alpha channel.
  141. .. rst-class:: classref-item-separator
  142. ----
  143. .. _class_SpriteBase3D_property_alpha_antialiasing_mode:
  144. .. rst-class:: classref-property
  145. :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>` **alpha_antialiasing_mode** = ``0``
  146. .. rst-class:: classref-property-setget
  147. - void **set_alpha_antialiasing** **(** :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>` value **)**
  148. - :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>` **get_alpha_antialiasing** **(** **)**
  149. The type of alpha antialiasing to apply. See :ref:`AlphaAntiAliasing<enum_BaseMaterial3D_AlphaAntiAliasing>`.
  150. .. rst-class:: classref-item-separator
  151. ----
  152. .. _class_SpriteBase3D_property_alpha_cut:
  153. .. rst-class:: classref-property
  154. :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **alpha_cut** = ``0``
  155. .. rst-class:: classref-property-setget
  156. - void **set_alpha_cut_mode** **(** :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` value **)**
  157. - :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` **get_alpha_cut_mode** **(** **)**
  158. The alpha cutting mode to use for the sprite. See :ref:`AlphaCutMode<enum_SpriteBase3D_AlphaCutMode>` for possible values.
  159. .. rst-class:: classref-item-separator
  160. ----
  161. .. _class_SpriteBase3D_property_alpha_hash_scale:
  162. .. rst-class:: classref-property
  163. :ref:`float<class_float>` **alpha_hash_scale** = ``1.0``
  164. .. rst-class:: classref-property-setget
  165. - void **set_alpha_hash_scale** **(** :ref:`float<class_float>` value **)**
  166. - :ref:`float<class_float>` **get_alpha_hash_scale** **(** **)**
  167. The hashing scale for Alpha Hash. Recommended values between ``0`` and ``2``.
  168. .. rst-class:: classref-item-separator
  169. ----
  170. .. _class_SpriteBase3D_property_alpha_scissor_threshold:
  171. .. rst-class:: classref-property
  172. :ref:`float<class_float>` **alpha_scissor_threshold** = ``0.5``
  173. .. rst-class:: classref-property-setget
  174. - void **set_alpha_scissor_threshold** **(** :ref:`float<class_float>` value **)**
  175. - :ref:`float<class_float>` **get_alpha_scissor_threshold** **(** **)**
  176. Threshold at which the alpha scissor will discard values.
  177. .. rst-class:: classref-item-separator
  178. ----
  179. .. _class_SpriteBase3D_property_axis:
  180. .. rst-class:: classref-property
  181. Vector3.Axis **axis** = ``2``
  182. .. rst-class:: classref-property-setget
  183. - void **set_axis** **(** Vector3.Axis value **)**
  184. - Vector3.Axis **get_axis** **(** **)**
  185. The direction in which the front of the texture faces.
  186. .. rst-class:: classref-item-separator
  187. ----
  188. .. _class_SpriteBase3D_property_billboard:
  189. .. rst-class:: classref-property
  190. :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` **billboard** = ``0``
  191. .. rst-class:: classref-property-setget
  192. - void **set_billboard_mode** **(** :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` value **)**
  193. - :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` **get_billboard_mode** **(** **)**
  194. The billboard mode to use for the sprite. See :ref:`BillboardMode<enum_BaseMaterial3D_BillboardMode>` for possible values.
  195. .. rst-class:: classref-item-separator
  196. ----
  197. .. _class_SpriteBase3D_property_centered:
  198. .. rst-class:: classref-property
  199. :ref:`bool<class_bool>` **centered** = ``true``
  200. .. rst-class:: classref-property-setget
  201. - void **set_centered** **(** :ref:`bool<class_bool>` value **)**
  202. - :ref:`bool<class_bool>` **is_centered** **(** **)**
  203. If ``true``, texture will be centered.
  204. .. rst-class:: classref-item-separator
  205. ----
  206. .. _class_SpriteBase3D_property_double_sided:
  207. .. rst-class:: classref-property
  208. :ref:`bool<class_bool>` **double_sided** = ``true``
  209. .. rst-class:: classref-property-setget
  210. - void **set_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag, :ref:`bool<class_bool>` enabled **)**
  211. - :ref:`bool<class_bool>` **get_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag **)** |const|
  212. If ``true``, texture can be seen from the back as well, if ``false``, it is invisible when looking at it from behind.
  213. .. rst-class:: classref-item-separator
  214. ----
  215. .. _class_SpriteBase3D_property_fixed_size:
  216. .. rst-class:: classref-property
  217. :ref:`bool<class_bool>` **fixed_size** = ``false``
  218. .. rst-class:: classref-property-setget
  219. - void **set_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag, :ref:`bool<class_bool>` enabled **)**
  220. - :ref:`bool<class_bool>` **get_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag **)** |const|
  221. If ``true``, the label is rendered at the same size regardless of distance.
  222. .. rst-class:: classref-item-separator
  223. ----
  224. .. _class_SpriteBase3D_property_flip_h:
  225. .. rst-class:: classref-property
  226. :ref:`bool<class_bool>` **flip_h** = ``false``
  227. .. rst-class:: classref-property-setget
  228. - void **set_flip_h** **(** :ref:`bool<class_bool>` value **)**
  229. - :ref:`bool<class_bool>` **is_flipped_h** **(** **)**
  230. If ``true``, texture is flipped horizontally.
  231. .. rst-class:: classref-item-separator
  232. ----
  233. .. _class_SpriteBase3D_property_flip_v:
  234. .. rst-class:: classref-property
  235. :ref:`bool<class_bool>` **flip_v** = ``false``
  236. .. rst-class:: classref-property-setget
  237. - void **set_flip_v** **(** :ref:`bool<class_bool>` value **)**
  238. - :ref:`bool<class_bool>` **is_flipped_v** **(** **)**
  239. If ``true``, texture is flipped vertically.
  240. .. rst-class:: classref-item-separator
  241. ----
  242. .. _class_SpriteBase3D_property_modulate:
  243. .. rst-class:: classref-property
  244. :ref:`Color<class_Color>` **modulate** = ``Color(1, 1, 1, 1)``
  245. .. rst-class:: classref-property-setget
  246. - void **set_modulate** **(** :ref:`Color<class_Color>` value **)**
  247. - :ref:`Color<class_Color>` **get_modulate** **(** **)**
  248. A color value used to *multiply* the texture's colors. Can be used for mood-coloring or to simulate the color of light.
  249. \ **Note:** If a :ref:`GeometryInstance3D.material_override<class_GeometryInstance3D_property_material_override>` is defined on the **SpriteBase3D**, the material override must be configured to take vertex colors into account for albedo. Otherwise, the color defined in :ref:`modulate<class_SpriteBase3D_property_modulate>` will be ignored. For a :ref:`BaseMaterial3D<class_BaseMaterial3D>`, :ref:`BaseMaterial3D.vertex_color_use_as_albedo<class_BaseMaterial3D_property_vertex_color_use_as_albedo>` must be ``true``. For a :ref:`ShaderMaterial<class_ShaderMaterial>`, ``ALBEDO *= COLOR.rgb;`` must be inserted in the shader's ``fragment()`` function.
  250. .. rst-class:: classref-item-separator
  251. ----
  252. .. _class_SpriteBase3D_property_no_depth_test:
  253. .. rst-class:: classref-property
  254. :ref:`bool<class_bool>` **no_depth_test** = ``false``
  255. .. rst-class:: classref-property-setget
  256. - void **set_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag, :ref:`bool<class_bool>` enabled **)**
  257. - :ref:`bool<class_bool>` **get_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag **)** |const|
  258. If ``true``, depth testing is disabled and the object will be drawn in render order.
  259. .. rst-class:: classref-item-separator
  260. ----
  261. .. _class_SpriteBase3D_property_offset:
  262. .. rst-class:: classref-property
  263. :ref:`Vector2<class_Vector2>` **offset** = ``Vector2(0, 0)``
  264. .. rst-class:: classref-property-setget
  265. - void **set_offset** **(** :ref:`Vector2<class_Vector2>` value **)**
  266. - :ref:`Vector2<class_Vector2>` **get_offset** **(** **)**
  267. The texture's drawing offset.
  268. .. rst-class:: classref-item-separator
  269. ----
  270. .. _class_SpriteBase3D_property_pixel_size:
  271. .. rst-class:: classref-property
  272. :ref:`float<class_float>` **pixel_size** = ``0.01``
  273. .. rst-class:: classref-property-setget
  274. - void **set_pixel_size** **(** :ref:`float<class_float>` value **)**
  275. - :ref:`float<class_float>` **get_pixel_size** **(** **)**
  276. The size of one pixel's width on the sprite to scale it in 3D.
  277. .. rst-class:: classref-item-separator
  278. ----
  279. .. _class_SpriteBase3D_property_render_priority:
  280. .. rst-class:: classref-property
  281. :ref:`int<class_int>` **render_priority** = ``0``
  282. .. rst-class:: classref-property-setget
  283. - void **set_render_priority** **(** :ref:`int<class_int>` value **)**
  284. - :ref:`int<class_int>` **get_render_priority** **(** **)**
  285. Sets the render priority for the sprite. Higher priority objects will be sorted in front of lower priority objects.
  286. \ **Note:** This only applies if :ref:`alpha_cut<class_SpriteBase3D_property_alpha_cut>` is set to :ref:`ALPHA_CUT_DISABLED<class_SpriteBase3D_constant_ALPHA_CUT_DISABLED>` (default value).
  287. \ **Note:** This only applies to sorting of transparent objects. This will not impact how transparent objects are sorted relative to opaque objects. This is because opaque objects are not sorted, while transparent objects are sorted from back to front (subject to priority).
  288. .. rst-class:: classref-item-separator
  289. ----
  290. .. _class_SpriteBase3D_property_shaded:
  291. .. rst-class:: classref-property
  292. :ref:`bool<class_bool>` **shaded** = ``false``
  293. .. rst-class:: classref-property-setget
  294. - void **set_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag, :ref:`bool<class_bool>` enabled **)**
  295. - :ref:`bool<class_bool>` **get_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag **)** |const|
  296. If ``true``, the :ref:`Light3D<class_Light3D>` in the :ref:`Environment<class_Environment>` has effects on the sprite.
  297. .. rst-class:: classref-item-separator
  298. ----
  299. .. _class_SpriteBase3D_property_texture_filter:
  300. .. rst-class:: classref-property
  301. :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` **texture_filter** = ``3``
  302. .. rst-class:: classref-property-setget
  303. - void **set_texture_filter** **(** :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` value **)**
  304. - :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` **get_texture_filter** **(** **)**
  305. Filter flags for the texture. See :ref:`TextureFilter<enum_BaseMaterial3D_TextureFilter>` for options.
  306. .. rst-class:: classref-item-separator
  307. ----
  308. .. _class_SpriteBase3D_property_transparent:
  309. .. rst-class:: classref-property
  310. :ref:`bool<class_bool>` **transparent** = ``true``
  311. .. rst-class:: classref-property-setget
  312. - void **set_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag, :ref:`bool<class_bool>` enabled **)**
  313. - :ref:`bool<class_bool>` **get_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag **)** |const|
  314. If ``true``, the texture's transparency and the opacity are used to make those parts of the sprite invisible.
  315. .. rst-class:: classref-section-separator
  316. ----
  317. .. rst-class:: classref-descriptions-group
  318. Method Descriptions
  319. -------------------
  320. .. _class_SpriteBase3D_method_generate_triangle_mesh:
  321. .. rst-class:: classref-method
  322. :ref:`TriangleMesh<class_TriangleMesh>` **generate_triangle_mesh** **(** **)** |const|
  323. Returns a :ref:`TriangleMesh<class_TriangleMesh>` with the sprite's vertices following its current configuration (such as its :ref:`axis<class_SpriteBase3D_property_axis>` and :ref:`pixel_size<class_SpriteBase3D_property_pixel_size>`).
  324. .. rst-class:: classref-item-separator
  325. ----
  326. .. _class_SpriteBase3D_method_get_draw_flag:
  327. .. rst-class:: classref-method
  328. :ref:`bool<class_bool>` **get_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag **)** |const|
  329. Returns the value of the specified flag.
  330. .. rst-class:: classref-item-separator
  331. ----
  332. .. _class_SpriteBase3D_method_get_item_rect:
  333. .. rst-class:: classref-method
  334. :ref:`Rect2<class_Rect2>` **get_item_rect** **(** **)** |const|
  335. Returns the rectangle representing this sprite.
  336. .. rst-class:: classref-item-separator
  337. ----
  338. .. _class_SpriteBase3D_method_set_draw_flag:
  339. .. rst-class:: classref-method
  340. void **set_draw_flag** **(** :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` flag, :ref:`bool<class_bool>` enabled **)**
  341. If ``true``, the specified flag will be enabled. See :ref:`DrawFlags<enum_SpriteBase3D_DrawFlags>` for a list of flags.
  342. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  343. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  344. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  345. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  346. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  347. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  348. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`