Home Explore Help
Sign In
Godot
/
godot-docs
mirror of https://github.com/godotengine/godot-docs.git
2
0
Fork 0
Files Issues 0 Wiki
Tree: 2be4e9b938
Branches Tags
godot-docs
/
classes
/
class_visualshadernode.rst

class_visualshadernode.rst 13 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176 
  1. :github_url: hide
    2. 

  2. 

  3. .. DO NOT EDIT THIS FILE!!!
    4. 

  4. .. Generated automatically from Godot engine sources.
    5. 

  5. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
    6. 

  6. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/VisualShaderNode.xml.
    7. 

  7. 

  8. .. _class_VisualShaderNode:
    9. 

  9. 

  10. VisualShaderNode
    11. 

  11. ================
    12. 

  12. 

  13. **Inherits:** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
    14. 

  14. 

  15. **Inherited By:** :ref:`VisualShaderNodeBillboard<class_VisualShaderNodeBillboard>`, :ref:`VisualShaderNodeClamp<class_VisualShaderNodeClamp>`, :ref:`VisualShaderNodeColorFunc<class_VisualShaderNodeColorFunc>`, :ref:`VisualShaderNodeColorOp<class_VisualShaderNodeColorOp>`, :ref:`VisualShaderNodeCompare<class_VisualShaderNodeCompare>`, :ref:`VisualShaderNodeConstant<class_VisualShaderNodeConstant>`, :ref:`VisualShaderNodeCubemap<class_VisualShaderNodeCubemap>`, :ref:`VisualShaderNodeCustom<class_VisualShaderNodeCustom>`, :ref:`VisualShaderNodeDerivativeFunc<class_VisualShaderNodeDerivativeFunc>`, :ref:`VisualShaderNodeDeterminant<class_VisualShaderNodeDeterminant>`, :ref:`VisualShaderNodeDotProduct<class_VisualShaderNodeDotProduct>`, :ref:`VisualShaderNodeFloatFunc<class_VisualShaderNodeFloatFunc>`, :ref:`VisualShaderNodeFloatOp<class_VisualShaderNodeFloatOp>`, :ref:`VisualShaderNodeFresnel<class_VisualShaderNodeFresnel>`, :ref:`VisualShaderNodeIf<class_VisualShaderNodeIf>`, :ref:`VisualShaderNodeInput<class_VisualShaderNodeInput>`, :ref:`VisualShaderNodeIntFunc<class_VisualShaderNodeIntFunc>`, :ref:`VisualShaderNodeIntOp<class_VisualShaderNodeIntOp>`, :ref:`VisualShaderNodeIs<class_VisualShaderNodeIs>`, :ref:`VisualShaderNodeMix<class_VisualShaderNodeMix>`, :ref:`VisualShaderNodeMultiplyAdd<class_VisualShaderNodeMultiplyAdd>`, :ref:`VisualShaderNodeOuterProduct<class_VisualShaderNodeOuterProduct>`, :ref:`VisualShaderNodeOutput<class_VisualShaderNodeOutput>`, :ref:`VisualShaderNodeParticleAccelerator<class_VisualShaderNodeParticleAccelerator>`, :ref:`VisualShaderNodeParticleConeVelocity<class_VisualShaderNodeParticleConeVelocity>`, :ref:`VisualShaderNodeParticleEmit<class_VisualShaderNodeParticleEmit>`, :ref:`VisualShaderNodeParticleEmitter<class_VisualShaderNodeParticleEmitter>`, :ref:`VisualShaderNodeParticleMultiplyByAxisAngle<class_VisualShaderNodeParticleMultiplyByAxisAngle>`, :ref:`VisualShaderNodeParticleRandomness<class_VisualShaderNodeParticleRandomness>`, :ref:`VisualShaderNodeResizableBase<class_VisualShaderNodeResizableBase>`, :ref:`VisualShaderNodeSDFRaymarch<class_VisualShaderNodeSDFRaymarch>`, :ref:`VisualShaderNodeSDFToScreenUV<class_VisualShaderNodeSDFToScreenUV>`, :ref:`VisualShaderNodeSample3D<class_VisualShaderNodeSample3D>`, :ref:`VisualShaderNodeScreenUVToSDF<class_VisualShaderNodeScreenUVToSDF>`, :ref:`VisualShaderNodeSmoothStep<class_VisualShaderNodeSmoothStep>`, :ref:`VisualShaderNodeStep<class_VisualShaderNodeStep>`, :ref:`VisualShaderNodeSwitch<class_VisualShaderNodeSwitch>`, :ref:`VisualShaderNodeTexture<class_VisualShaderNodeTexture>`, :ref:`VisualShaderNodeTextureSDF<class_VisualShaderNodeTextureSDF>`, :ref:`VisualShaderNodeTextureSDFNormal<class_VisualShaderNodeTextureSDFNormal>`, :ref:`VisualShaderNodeTransformCompose<class_VisualShaderNodeTransformCompose>`, :ref:`VisualShaderNodeTransformDecompose<class_VisualShaderNodeTransformDecompose>`, :ref:`VisualShaderNodeTransformFunc<class_VisualShaderNodeTransformFunc>`, :ref:`VisualShaderNodeTransformOp<class_VisualShaderNodeTransformOp>`, :ref:`VisualShaderNodeTransformVecMult<class_VisualShaderNodeTransformVecMult>`, :ref:`VisualShaderNodeUVFunc<class_VisualShaderNodeUVFunc>`, :ref:`VisualShaderNodeUniform<class_VisualShaderNodeUniform>`, :ref:`VisualShaderNodeUniformRef<class_VisualShaderNodeUniformRef>`, :ref:`VisualShaderNodeVarying<class_VisualShaderNodeVarying>`, :ref:`VisualShaderNodeVectorBase<class_VisualShaderNodeVectorBase>`, :ref:`VisualShaderNodeVectorRefract<class_VisualShaderNodeVectorRefract>`
    16. 

  16. 

  17. Base class for nodes in a visual shader graph.
    18. 

  18. 

  19. Description
    20. 

  20. -----------
    21. 

  21. 

  22. Visual shader graphs consist of various nodes. Each node in the graph is a separate object and they are represented as a rectangular boxes with title and a set of properties. Each node has also connection ports that allow to connect it to another nodes and control the flow of the shader.
    23. 

  23. 

  24. Tutorials
    25. 

  25. ---------
    26. 

  26. 

  27. - :doc:`VisualShaders <../tutorials/shaders/visual_shaders>`
    28. 

  28. 

  29. Properties
    30. 

  30. ----------
    31. 

  31. 

  32. +-----------------------+-----------------------------------------------------------------------------------------+--------+
    33. 

  33. | :ref:`int<class_int>` | :ref:`output_port_for_preview<class_VisualShaderNode_property_output_port_for_preview>` | ``-1`` |
    34. 

  34. +-----------------------+-----------------------------------------------------------------------------------------+--------+
    35. 

  35. 

  36. Methods
    37. 

  37. -------
    38. 

  38. 

  39. +-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    40. 

  40. | void                          | :ref:`clear_default_input_values<class_VisualShaderNode_method_clear_default_input_values>` **(** **)**                                                                                                                    |
    41. 

  41. +-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    42. 

  42. | :ref:`Array<class_Array>`     | :ref:`get_default_input_values<class_VisualShaderNode_method_get_default_input_values>` **(** **)** |const|                                                                                                                |
    43. 

  43. +-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    44. 

  44. | :ref:`Variant<class_Variant>` | :ref:`get_input_port_default_value<class_VisualShaderNode_method_get_input_port_default_value>` **(** :ref:`int<class_int>` port **)** |const|                                                                             |
    45. 

  45. +-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    46. 

  46. | void                          | :ref:`remove_input_port_default_value<class_VisualShaderNode_method_remove_input_port_default_value>` **(** :ref:`int<class_int>` port **)**                                                                               |
    47. 

  47. +-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    48. 

  48. | void                          | :ref:`set_default_input_values<class_VisualShaderNode_method_set_default_input_values>` **(** :ref:`Array<class_Array>` values **)**                                                                                       |
    49. 

  49. +-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    50. 

  50. | void                          | :ref:`set_input_port_default_value<class_VisualShaderNode_method_set_input_port_default_value>` **(** :ref:`int<class_int>` port, :ref:`Variant<class_Variant>` value, :ref:`Variant<class_Variant>` prev_value=null **)** |
    51. 

  51. +-------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    52. 

  52. 

  53. Signals
    54. 

  54. -------
    55. 

  55. 

  56. .. _class_VisualShaderNode_signal_editor_refresh_request:
    57. 

  57. 

  58. - **editor_refresh_request** **(** **)**
    59. 

  59. 

  60. Emitted when the node requests an editor refresh. Currently called only in setter of :ref:`VisualShaderNodeTexture.source<class_VisualShaderNodeTexture_property_source>`, :ref:`VisualShaderNodeTexture<class_VisualShaderNodeTexture>`, and :ref:`VisualShaderNodeCubemap<class_VisualShaderNodeCubemap>` (and their derivatives).
    61. 

  61. 

  62. Enumerations
    63. 

  63. ------------
    64. 

  64. 

  65. .. _enum_VisualShaderNode_PortType:
    66. 

  66. 

  67. .. _class_VisualShaderNode_constant_PORT_TYPE_SCALAR:
    68. 

  68. 

  69. .. _class_VisualShaderNode_constant_PORT_TYPE_SCALAR_INT:
    70. 

  70. 

  71. .. _class_VisualShaderNode_constant_PORT_TYPE_VECTOR_2D:
    72. 

  72. 

  73. .. _class_VisualShaderNode_constant_PORT_TYPE_VECTOR_3D:
    74. 

  74. 

  75. .. _class_VisualShaderNode_constant_PORT_TYPE_VECTOR_4D:
    76. 

  76. 

  77. .. _class_VisualShaderNode_constant_PORT_TYPE_BOOLEAN:
    78. 

  78. 

  79. .. _class_VisualShaderNode_constant_PORT_TYPE_TRANSFORM:
    80. 

  80. 

  81. .. _class_VisualShaderNode_constant_PORT_TYPE_SAMPLER:
    82. 

  82. 

  83. .. _class_VisualShaderNode_constant_PORT_TYPE_MAX:
    84. 

  84. 

  85. enum **PortType**:
    86. 

  86. 

  87. - **PORT_TYPE_SCALAR** = **0** --- Floating-point scalar. Translated to ``float`` type in shader code.
    88. 

  88. 

  89. - **PORT_TYPE_SCALAR_INT** = **1** --- Integer scalar. Translated to ``int`` type in shader code.
    90. 

  90. 

  91. - **PORT_TYPE_VECTOR_2D** = **2** --- 2D vector of floating-point values. Translated to ``vec2`` type in shader code.
    92. 

  92. 

  93. - **PORT_TYPE_VECTOR_3D** = **3** --- 3D vector of floating-point values. Translated to ``vec3`` type in shader code.
    94. 

  94. 

  95. - **PORT_TYPE_VECTOR_4D** = **4** --- 4D vector of floating-point values. Translated to ``vec4`` type in shader code.
    96. 

  96. 

  97. - **PORT_TYPE_BOOLEAN** = **5** --- Boolean type. Translated to ``bool`` type in shader code.
    98. 

  98. 

  99. - **PORT_TYPE_TRANSFORM** = **6** --- Transform type. Translated to ``mat4`` type in shader code.
    100. 

  100. 

  101. - **PORT_TYPE_SAMPLER** = **7** --- Sampler type. Translated to reference of sampler uniform in shader code. Can only be used for input ports in non-uniform nodes.
    102. 

  102. 

  103. - **PORT_TYPE_MAX** = **8** --- Represents the size of the :ref:`PortType<enum_VisualShaderNode_PortType>` enum.
    104. 

  104. 

  105. Property Descriptions
    106. 

  106. ---------------------
    107. 

  107. 

  108. .. _class_VisualShaderNode_property_output_port_for_preview:
    109. 

  109. 

  110. - :ref:`int<class_int>` **output_port_for_preview**
    111. 

  111. 

  112. +-----------+------------------------------------+
    113. 

  113. | *Default* | ``-1``                             |
    114. 

  114. +-----------+------------------------------------+
    115. 

  115. | *Setter*  | set_output_port_for_preview(value) |
    116. 

  116. +-----------+------------------------------------+
    117. 

  117. | *Getter*  | get_output_port_for_preview()      |
    118. 

  118. +-----------+------------------------------------+
    119. 

  119. 

  120. Sets the output port index which will be showed for preview. If set to ``-1`` no port will be open for preview.
    121. 

  121. 

  122. Method Descriptions
    123. 

  123. -------------------
    124. 

  124. 

  125. .. _class_VisualShaderNode_method_clear_default_input_values:
    126. 

  126. 

  127. - void **clear_default_input_values** **(** **)**
    128. 

  128. 

  129. Clears the default input ports value.
    130. 

  130. 

  131. ----
    132. 

  132. 

  133. .. _class_VisualShaderNode_method_get_default_input_values:
    134. 

  134. 

  135. - :ref:`Array<class_Array>` **get_default_input_values** **(** **)** |const|
    136. 

  136. 

  137. Returns an :ref:`Array<class_Array>` containing default values for all of the input ports of the node in the form ``[index0, value0, index1, value1, ...]``.
    138. 

  138. 

  139. ----
    140. 

  140. 

  141. .. _class_VisualShaderNode_method_get_input_port_default_value:
    142. 

  142. 

  143. - :ref:`Variant<class_Variant>` **get_input_port_default_value** **(** :ref:`int<class_int>` port **)** |const|
    144. 

  144. 

  145. Returns the default value of the input ``port``.
    146. 

  146. 

  147. ----
    148. 

  148. 

  149. .. _class_VisualShaderNode_method_remove_input_port_default_value:
    150. 

  150. 

  151. - void **remove_input_port_default_value** **(** :ref:`int<class_int>` port **)**
    152. 

  152. 

  153. Removes the default value of the input ``port``.
    154. 

  154. 

  155. ----
    156. 

  156. 

  157. .. _class_VisualShaderNode_method_set_default_input_values:
    158. 

  158. 

  159. - void **set_default_input_values** **(** :ref:`Array<class_Array>` values **)**
    160. 

  160. 

  161. Sets the default input ports values using an :ref:`Array<class_Array>` of the form ``[index0, value0, index1, value1, ...]``. For example: ``[0, Vector3(0, 0, 0), 1, Vector3(0, 0, 0)]``.
    162. 

  162. 

  163. ----
    164. 

  164. 

  165. .. _class_VisualShaderNode_method_set_input_port_default_value:
    166. 

  166. 

  167. - void **set_input_port_default_value** **(** :ref:`int<class_int>` port, :ref:`Variant<class_Variant>` value, :ref:`Variant<class_Variant>` prev_value=null **)**
    168. 

  168. 

  169. Sets the default value for the selected input ``port``.
    170. 

  170. 

  171. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
    172. 

  172. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
    173. 

  173. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
    174. 

  174. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
    175. 

  175. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
    176. 

  176. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
    177.