class_rdpipelinedepthstencilstate.rst 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485
  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/RDPipelineDepthStencilState.xml.
  6. .. _class_RDPipelineDepthStencilState:
  7. RDPipelineDepthStencilState
  8. ===========================
  9. **Inherits:** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
  10. Pipeline depth/stencil state (used by :ref:`RenderingDevice<class_RenderingDevice>`).
  11. .. rst-class:: classref-introduction-group
  12. Description
  13. -----------
  14. **RDPipelineDepthStencilState** controls the way depth and stencil comparisons are performed when sampling those values using :ref:`RenderingDevice<class_RenderingDevice>`.
  15. .. rst-class:: classref-reftable-group
  16. Properties
  17. ----------
  18. .. table::
  19. :widths: auto
  20. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  21. | :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` | :ref:`back_op_compare<class_RDPipelineDepthStencilState_property_back_op_compare>` | ``7`` |
  22. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  23. | :ref:`int<class_int>` | :ref:`back_op_compare_mask<class_RDPipelineDepthStencilState_property_back_op_compare_mask>` | ``0`` |
  24. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  25. | :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` | :ref:`back_op_depth_fail<class_RDPipelineDepthStencilState_property_back_op_depth_fail>` | ``1`` |
  26. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  27. | :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` | :ref:`back_op_fail<class_RDPipelineDepthStencilState_property_back_op_fail>` | ``1`` |
  28. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  29. | :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` | :ref:`back_op_pass<class_RDPipelineDepthStencilState_property_back_op_pass>` | ``1`` |
  30. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  31. | :ref:`int<class_int>` | :ref:`back_op_reference<class_RDPipelineDepthStencilState_property_back_op_reference>` | ``0`` |
  32. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  33. | :ref:`int<class_int>` | :ref:`back_op_write_mask<class_RDPipelineDepthStencilState_property_back_op_write_mask>` | ``0`` |
  34. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  35. | :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` | :ref:`depth_compare_operator<class_RDPipelineDepthStencilState_property_depth_compare_operator>` | ``7`` |
  36. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  37. | :ref:`float<class_float>` | :ref:`depth_range_max<class_RDPipelineDepthStencilState_property_depth_range_max>` | ``0.0`` |
  38. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  39. | :ref:`float<class_float>` | :ref:`depth_range_min<class_RDPipelineDepthStencilState_property_depth_range_min>` | ``0.0`` |
  40. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  41. | :ref:`bool<class_bool>` | :ref:`enable_depth_range<class_RDPipelineDepthStencilState_property_enable_depth_range>` | ``false`` |
  42. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  43. | :ref:`bool<class_bool>` | :ref:`enable_depth_test<class_RDPipelineDepthStencilState_property_enable_depth_test>` | ``false`` |
  44. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  45. | :ref:`bool<class_bool>` | :ref:`enable_depth_write<class_RDPipelineDepthStencilState_property_enable_depth_write>` | ``false`` |
  46. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  47. | :ref:`bool<class_bool>` | :ref:`enable_stencil<class_RDPipelineDepthStencilState_property_enable_stencil>` | ``false`` |
  48. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  49. | :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` | :ref:`front_op_compare<class_RDPipelineDepthStencilState_property_front_op_compare>` | ``7`` |
  50. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  51. | :ref:`int<class_int>` | :ref:`front_op_compare_mask<class_RDPipelineDepthStencilState_property_front_op_compare_mask>` | ``0`` |
  52. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  53. | :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` | :ref:`front_op_depth_fail<class_RDPipelineDepthStencilState_property_front_op_depth_fail>` | ``1`` |
  54. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  55. | :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` | :ref:`front_op_fail<class_RDPipelineDepthStencilState_property_front_op_fail>` | ``1`` |
  56. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  57. | :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` | :ref:`front_op_pass<class_RDPipelineDepthStencilState_property_front_op_pass>` | ``1`` |
  58. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  59. | :ref:`int<class_int>` | :ref:`front_op_reference<class_RDPipelineDepthStencilState_property_front_op_reference>` | ``0`` |
  60. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  61. | :ref:`int<class_int>` | :ref:`front_op_write_mask<class_RDPipelineDepthStencilState_property_front_op_write_mask>` | ``0`` |
  62. +----------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------+
  63. .. rst-class:: classref-section-separator
  64. ----
  65. .. rst-class:: classref-descriptions-group
  66. Property Descriptions
  67. ---------------------
  68. .. _class_RDPipelineDepthStencilState_property_back_op_compare:
  69. .. rst-class:: classref-property
  70. :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` **back_op_compare** = ``7``
  71. .. rst-class:: classref-property-setget
  72. - void **set_back_op_compare** **(** :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` value **)**
  73. - :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` **get_back_op_compare** **(** **)**
  74. .. container:: contribute
  75. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  76. .. rst-class:: classref-item-separator
  77. ----
  78. .. _class_RDPipelineDepthStencilState_property_back_op_compare_mask:
  79. .. rst-class:: classref-property
  80. :ref:`int<class_int>` **back_op_compare_mask** = ``0``
  81. .. rst-class:: classref-property-setget
  82. - void **set_back_op_compare_mask** **(** :ref:`int<class_int>` value **)**
  83. - :ref:`int<class_int>` **get_back_op_compare_mask** **(** **)**
  84. .. container:: contribute
  85. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  86. .. rst-class:: classref-item-separator
  87. ----
  88. .. _class_RDPipelineDepthStencilState_property_back_op_depth_fail:
  89. .. rst-class:: classref-property
  90. :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **back_op_depth_fail** = ``1``
  91. .. rst-class:: classref-property-setget
  92. - void **set_back_op_depth_fail** **(** :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` value **)**
  93. - :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **get_back_op_depth_fail** **(** **)**
  94. .. container:: contribute
  95. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  96. .. rst-class:: classref-item-separator
  97. ----
  98. .. _class_RDPipelineDepthStencilState_property_back_op_fail:
  99. .. rst-class:: classref-property
  100. :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **back_op_fail** = ``1``
  101. .. rst-class:: classref-property-setget
  102. - void **set_back_op_fail** **(** :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` value **)**
  103. - :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **get_back_op_fail** **(** **)**
  104. .. container:: contribute
  105. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  106. .. rst-class:: classref-item-separator
  107. ----
  108. .. _class_RDPipelineDepthStencilState_property_back_op_pass:
  109. .. rst-class:: classref-property
  110. :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **back_op_pass** = ``1``
  111. .. rst-class:: classref-property-setget
  112. - void **set_back_op_pass** **(** :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` value **)**
  113. - :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **get_back_op_pass** **(** **)**
  114. .. container:: contribute
  115. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  116. .. rst-class:: classref-item-separator
  117. ----
  118. .. _class_RDPipelineDepthStencilState_property_back_op_reference:
  119. .. rst-class:: classref-property
  120. :ref:`int<class_int>` **back_op_reference** = ``0``
  121. .. rst-class:: classref-property-setget
  122. - void **set_back_op_reference** **(** :ref:`int<class_int>` value **)**
  123. - :ref:`int<class_int>` **get_back_op_reference** **(** **)**
  124. .. container:: contribute
  125. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  126. .. rst-class:: classref-item-separator
  127. ----
  128. .. _class_RDPipelineDepthStencilState_property_back_op_write_mask:
  129. .. rst-class:: classref-property
  130. :ref:`int<class_int>` **back_op_write_mask** = ``0``
  131. .. rst-class:: classref-property-setget
  132. - void **set_back_op_write_mask** **(** :ref:`int<class_int>` value **)**
  133. - :ref:`int<class_int>` **get_back_op_write_mask** **(** **)**
  134. .. container:: contribute
  135. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  136. .. rst-class:: classref-item-separator
  137. ----
  138. .. _class_RDPipelineDepthStencilState_property_depth_compare_operator:
  139. .. rst-class:: classref-property
  140. :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` **depth_compare_operator** = ``7``
  141. .. rst-class:: classref-property-setget
  142. - void **set_depth_compare_operator** **(** :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` value **)**
  143. - :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` **get_depth_compare_operator** **(** **)**
  144. .. container:: contribute
  145. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  146. .. rst-class:: classref-item-separator
  147. ----
  148. .. _class_RDPipelineDepthStencilState_property_depth_range_max:
  149. .. rst-class:: classref-property
  150. :ref:`float<class_float>` **depth_range_max** = ``0.0``
  151. .. rst-class:: classref-property-setget
  152. - void **set_depth_range_max** **(** :ref:`float<class_float>` value **)**
  153. - :ref:`float<class_float>` **get_depth_range_max** **(** **)**
  154. .. container:: contribute
  155. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  156. .. rst-class:: classref-item-separator
  157. ----
  158. .. _class_RDPipelineDepthStencilState_property_depth_range_min:
  159. .. rst-class:: classref-property
  160. :ref:`float<class_float>` **depth_range_min** = ``0.0``
  161. .. rst-class:: classref-property-setget
  162. - void **set_depth_range_min** **(** :ref:`float<class_float>` value **)**
  163. - :ref:`float<class_float>` **get_depth_range_min** **(** **)**
  164. .. container:: contribute
  165. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  166. .. rst-class:: classref-item-separator
  167. ----
  168. .. _class_RDPipelineDepthStencilState_property_enable_depth_range:
  169. .. rst-class:: classref-property
  170. :ref:`bool<class_bool>` **enable_depth_range** = ``false``
  171. .. rst-class:: classref-property-setget
  172. - void **set_enable_depth_range** **(** :ref:`bool<class_bool>` value **)**
  173. - :ref:`bool<class_bool>` **get_enable_depth_range** **(** **)**
  174. .. container:: contribute
  175. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  176. .. rst-class:: classref-item-separator
  177. ----
  178. .. _class_RDPipelineDepthStencilState_property_enable_depth_test:
  179. .. rst-class:: classref-property
  180. :ref:`bool<class_bool>` **enable_depth_test** = ``false``
  181. .. rst-class:: classref-property-setget
  182. - void **set_enable_depth_test** **(** :ref:`bool<class_bool>` value **)**
  183. - :ref:`bool<class_bool>` **get_enable_depth_test** **(** **)**
  184. If ``true``, enables depth testing which allows objects to be automatically occluded by other objects based on their depth. This also allows objects to be partially occluded by other objects. If ``false``, objects will appear in the order they were drawn (like in Godot's 2D renderer).
  185. .. rst-class:: classref-item-separator
  186. ----
  187. .. _class_RDPipelineDepthStencilState_property_enable_depth_write:
  188. .. rst-class:: classref-property
  189. :ref:`bool<class_bool>` **enable_depth_write** = ``false``
  190. .. rst-class:: classref-property-setget
  191. - void **set_enable_depth_write** **(** :ref:`bool<class_bool>` value **)**
  192. - :ref:`bool<class_bool>` **get_enable_depth_write** **(** **)**
  193. .. container:: contribute
  194. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  195. .. rst-class:: classref-item-separator
  196. ----
  197. .. _class_RDPipelineDepthStencilState_property_enable_stencil:
  198. .. rst-class:: classref-property
  199. :ref:`bool<class_bool>` **enable_stencil** = ``false``
  200. .. rst-class:: classref-property-setget
  201. - void **set_enable_stencil** **(** :ref:`bool<class_bool>` value **)**
  202. - :ref:`bool<class_bool>` **get_enable_stencil** **(** **)**
  203. .. container:: contribute
  204. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  205. .. rst-class:: classref-item-separator
  206. ----
  207. .. _class_RDPipelineDepthStencilState_property_front_op_compare:
  208. .. rst-class:: classref-property
  209. :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` **front_op_compare** = ``7``
  210. .. rst-class:: classref-property-setget
  211. - void **set_front_op_compare** **(** :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` value **)**
  212. - :ref:`CompareOperator<enum_RenderingDevice_CompareOperator>` **get_front_op_compare** **(** **)**
  213. .. container:: contribute
  214. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  215. .. rst-class:: classref-item-separator
  216. ----
  217. .. _class_RDPipelineDepthStencilState_property_front_op_compare_mask:
  218. .. rst-class:: classref-property
  219. :ref:`int<class_int>` **front_op_compare_mask** = ``0``
  220. .. rst-class:: classref-property-setget
  221. - void **set_front_op_compare_mask** **(** :ref:`int<class_int>` value **)**
  222. - :ref:`int<class_int>` **get_front_op_compare_mask** **(** **)**
  223. .. container:: contribute
  224. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  225. .. rst-class:: classref-item-separator
  226. ----
  227. .. _class_RDPipelineDepthStencilState_property_front_op_depth_fail:
  228. .. rst-class:: classref-property
  229. :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **front_op_depth_fail** = ``1``
  230. .. rst-class:: classref-property-setget
  231. - void **set_front_op_depth_fail** **(** :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` value **)**
  232. - :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **get_front_op_depth_fail** **(** **)**
  233. .. container:: contribute
  234. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  235. .. rst-class:: classref-item-separator
  236. ----
  237. .. _class_RDPipelineDepthStencilState_property_front_op_fail:
  238. .. rst-class:: classref-property
  239. :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **front_op_fail** = ``1``
  240. .. rst-class:: classref-property-setget
  241. - void **set_front_op_fail** **(** :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` value **)**
  242. - :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **get_front_op_fail** **(** **)**
  243. .. container:: contribute
  244. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  245. .. rst-class:: classref-item-separator
  246. ----
  247. .. _class_RDPipelineDepthStencilState_property_front_op_pass:
  248. .. rst-class:: classref-property
  249. :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **front_op_pass** = ``1``
  250. .. rst-class:: classref-property-setget
  251. - void **set_front_op_pass** **(** :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` value **)**
  252. - :ref:`StencilOperation<enum_RenderingDevice_StencilOperation>` **get_front_op_pass** **(** **)**
  253. .. container:: contribute
  254. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  255. .. rst-class:: classref-item-separator
  256. ----
  257. .. _class_RDPipelineDepthStencilState_property_front_op_reference:
  258. .. rst-class:: classref-property
  259. :ref:`int<class_int>` **front_op_reference** = ``0``
  260. .. rst-class:: classref-property-setget
  261. - void **set_front_op_reference** **(** :ref:`int<class_int>` value **)**
  262. - :ref:`int<class_int>` **get_front_op_reference** **(** **)**
  263. .. container:: contribute
  264. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  265. .. rst-class:: classref-item-separator
  266. ----
  267. .. _class_RDPipelineDepthStencilState_property_front_op_write_mask:
  268. .. rst-class:: classref-property
  269. :ref:`int<class_int>` **front_op_write_mask** = ``0``
  270. .. rst-class:: classref-property-setget
  271. - void **set_front_op_write_mask** **(** :ref:`int<class_int>` value **)**
  272. - :ref:`int<class_int>` **get_front_op_write_mask** **(** **)**
  273. .. container:: contribute
  274. There is currently no description for this property. Please help us by :ref:`contributing one <doc_updating_the_class_reference>`!
  275. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  276. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  277. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  278. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  279. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  280. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  281. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`