diff options
Diffstat (limited to 'doc/classes/RenderingServer.xml')
| -rw-r--r-- | doc/classes/RenderingServer.xml | 4606 |
1 files changed, 2656 insertions, 1950 deletions
diff --git a/doc/classes/RenderingServer.xml b/doc/classes/RenderingServer.xml index d8be6d4bd7..009e9d3df4 100644 --- a/doc/classes/RenderingServer.xml +++ b/doc/classes/RenderingServer.xml @@ -10,1189 +10,1351 @@ Resources are created using the [code]*_create[/code] functions. All objects are drawn to a viewport. You can use the [Viewport] attached to the [SceneTree] or you can create one yourself with [method viewport_create]. When using a custom scenario or canvas, the scenario or canvas needs to be attached to the viewport using [method viewport_set_scenario] or [method viewport_attach_canvas]. In 3D, all visual objects must be associated with a scenario. The scenario is a visual representation of the world. If accessing the rendering server from a running game, the scenario can be accessed from the scene tree from any [Node3D] node with [method Node3D.get_world_3d]. Otherwise, a scenario can be created with [method scenario_create]. - Similarly in 2D, a canvas is needed to draw all canvas items. + Similarly, in 2D, a canvas is needed to draw all canvas items. In 3D, all visible objects are comprised of a resource and an instance. A resource can be a mesh, a particle system, a light, or any other 3D object. In order to be visible resources must be attached to an instance using [method instance_set_base]. The instance must also be attached to the scenario using [method instance_set_scenario] in order to be visible. In 2D, all visible objects are some form of canvas item. In order to be visible, a canvas item needs to be the child of a canvas attached to a viewport, or it needs to be the child of another canvas item that is eventually attached to the canvas. </description> <tutorials> - <link>https://docs.godotengine.org/en/latest/tutorials/optimization/using_servers.html</link> + <link title="Optimization using Servers">$DOCS_URL/tutorials/performance/using_servers.html</link> </tutorials> <methods> - <method name="black_bars_set_images"> - <return type="void"> - </return> - <argument index="0" name="left" type="RID"> - </argument> - <argument index="1" name="top" type="RID"> - </argument> - <argument index="2" name="right" type="RID"> - </argument> - <argument index="3" name="bottom" type="RID"> - </argument> - <description> - Sets images to be rendered in the window margin. - </description> - </method> - <method name="black_bars_set_margins"> - <return type="void"> - </return> - <argument index="0" name="left" type="int"> - </argument> - <argument index="1" name="top" type="int"> - </argument> - <argument index="2" name="right" type="int"> - </argument> - <argument index="3" name="bottom" type="int"> - </argument> - <description> - Sets margin size, where black bars (or images, if [method black_bars_set_images] was used) are rendered. + <method name="bake_render_uv2"> + <return type="Image[]" /> + <argument index="0" name="base" type="RID" /> + <argument index="1" name="material_overrides" type="Array" /> + <argument index="2" name="image_size" type="Vector2i" /> + <description> </description> </method> <method name="camera_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a camera and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]camera_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> + <method name="camera_effects_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="camera_effects_set_custom_exposure"> + <return type="void" /> + <argument index="0" name="camera_effects" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <argument index="2" name="exposure" type="float" /> + <description> + </description> + </method> + <method name="camera_effects_set_dof_blur"> + <return type="void" /> + <argument index="0" name="camera_effects" type="RID" /> + <argument index="1" name="far_enable" type="bool" /> + <argument index="2" name="far_distance" type="float" /> + <argument index="3" name="far_transition" type="float" /> + <argument index="4" name="near_enable" type="bool" /> + <argument index="5" name="near_distance" type="float" /> + <argument index="6" name="near_transition" type="float" /> + <argument index="7" name="amount" type="float" /> + <description> + </description> + </method> + <method name="camera_effects_set_dof_blur_bokeh_shape"> + <return type="void" /> + <argument index="0" name="shape" type="int" enum="RenderingServer.DOFBokehShape" /> + <description> + </description> + </method> + <method name="camera_effects_set_dof_blur_quality"> + <return type="void" /> + <argument index="0" name="quality" type="int" enum="RenderingServer.DOFBlurQuality" /> + <argument index="1" name="use_jitter" type="bool" /> + <description> + </description> + </method> + <method name="camera_set_camera_effects"> + <return type="void" /> + <argument index="0" name="camera" type="RID" /> + <argument index="1" name="effects" type="RID" /> + <description> + </description> + </method> <method name="camera_set_cull_mask"> - <return type="void"> - </return> - <argument index="0" name="camera" type="RID"> - </argument> - <argument index="1" name="layers" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="camera" type="RID" /> + <argument index="1" name="layers" type="int" /> <description> Sets the cull mask associated with this camera. The cull mask describes which 3D layers are rendered by this camera. Equivalent to [member Camera3D.cull_mask]. </description> </method> <method name="camera_set_environment"> - <return type="void"> - </return> - <argument index="0" name="camera" type="RID"> - </argument> - <argument index="1" name="env" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="camera" type="RID" /> + <argument index="1" name="env" type="RID" /> <description> Sets the environment used by this camera. Equivalent to [member Camera3D.environment]. </description> </method> <method name="camera_set_frustum"> - <return type="void"> - </return> - <argument index="0" name="camera" type="RID"> - </argument> - <argument index="1" name="size" type="float"> - </argument> - <argument index="2" name="offset" type="Vector2"> - </argument> - <argument index="3" name="z_near" type="float"> - </argument> - <argument index="4" name="z_far" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="camera" type="RID" /> + <argument index="1" name="size" type="float" /> + <argument index="2" name="offset" type="Vector2" /> + <argument index="3" name="z_near" type="float" /> + <argument index="4" name="z_far" type="float" /> <description> Sets camera to use frustum projection. This mode allows adjusting the [code]offset[/code] argument to create "tilted frustum" effects. </description> </method> <method name="camera_set_orthogonal"> - <return type="void"> - </return> - <argument index="0" name="camera" type="RID"> - </argument> - <argument index="1" name="size" type="float"> - </argument> - <argument index="2" name="z_near" type="float"> - </argument> - <argument index="3" name="z_far" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="camera" type="RID" /> + <argument index="1" name="size" type="float" /> + <argument index="2" name="z_near" type="float" /> + <argument index="3" name="z_far" type="float" /> <description> Sets camera to use orthogonal projection, also known as orthographic projection. Objects remain the same size on the screen no matter how far away they are. </description> </method> <method name="camera_set_perspective"> - <return type="void"> - </return> - <argument index="0" name="camera" type="RID"> - </argument> - <argument index="1" name="fovy_degrees" type="float"> - </argument> - <argument index="2" name="z_near" type="float"> - </argument> - <argument index="3" name="z_far" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="camera" type="RID" /> + <argument index="1" name="fovy_degrees" type="float" /> + <argument index="2" name="z_near" type="float" /> + <argument index="3" name="z_far" type="float" /> <description> Sets camera to use perspective projection. Objects on the screen becomes smaller when they are far away. </description> </method> <method name="camera_set_transform"> - <return type="void"> - </return> - <argument index="0" name="camera" type="RID"> - </argument> - <argument index="1" name="transform" type="Transform"> - </argument> + <return type="void" /> + <argument index="0" name="camera" type="RID" /> + <argument index="1" name="transform" type="Transform3D" /> <description> - Sets [Transform] of camera. + Sets [Transform3D] of camera. </description> </method> <method name="camera_set_use_vertical_aspect"> - <return type="void"> - </return> - <argument index="0" name="camera" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="camera" type="RID" /> + <argument index="1" name="enable" type="bool" /> <description> If [code]true[/code], preserves the horizontal aspect ratio which is equivalent to [constant Camera3D.KEEP_WIDTH]. If [code]false[/code], preserves the vertical aspect ratio which is equivalent to [constant Camera3D.KEEP_HEIGHT]. </description> </method> <method name="canvas_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a canvas and returns the assigned [RID]. It can be accessed with the RID that is returned. This RID will be used in all [code]canvas_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> + <method name="canvas_item_add_circle"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="pos" type="Vector2" /> + <argument index="2" name="radius" type="float" /> + <argument index="3" name="color" type="Color" /> + <description> + </description> + </method> + <method name="canvas_item_add_clip_ignore"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="ignore" type="bool" /> + <description> + </description> + </method> + <method name="canvas_item_add_line"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="from" type="Vector2" /> + <argument index="2" name="to" type="Vector2" /> + <argument index="3" name="color" type="Color" /> + <argument index="4" name="width" type="float" default="1.0" /> + <description> + </description> + </method> + <method name="canvas_item_add_mesh"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="mesh" type="RID" /> + <argument index="2" name="transform" type="Transform2D" default="Transform2D(1, 0, 0, 1, 0, 0)" /> + <argument index="3" name="modulate" type="Color" default="Color(1, 1, 1, 1)" /> + <argument index="4" name="texture" type="RID" /> + <description> + </description> + </method> + <method name="canvas_item_add_msdf_texture_rect_region"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="rect" type="Rect2" /> + <argument index="2" name="texture" type="RID" /> + <argument index="3" name="src_rect" type="Rect2" /> + <argument index="4" name="modulate" type="Color" default="Color(1, 1, 1, 1)" /> + <argument index="5" name="outline_size" type="int" default="0" /> + <argument index="6" name="px_range" type="float" default="1.0" /> + <description> + </description> + </method> + <method name="canvas_item_add_multimesh"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="mesh" type="RID" /> + <argument index="2" name="texture" type="RID" /> + <description> + </description> + </method> + <method name="canvas_item_add_nine_patch"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="rect" type="Rect2" /> + <argument index="2" name="source" type="Rect2" /> + <argument index="3" name="texture" type="RID" /> + <argument index="4" name="topleft" type="Vector2" /> + <argument index="5" name="bottomright" type="Vector2" /> + <argument index="6" name="x_axis_mode" type="int" enum="RenderingServer.NinePatchAxisMode" default="0" /> + <argument index="7" name="y_axis_mode" type="int" enum="RenderingServer.NinePatchAxisMode" default="0" /> + <argument index="8" name="draw_center" type="bool" default="true" /> + <argument index="9" name="modulate" type="Color" default="Color(1, 1, 1, 1)" /> + <description> + </description> + </method> + <method name="canvas_item_add_particles"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="particles" type="RID" /> + <argument index="2" name="texture" type="RID" /> + <description> + </description> + </method> + <method name="canvas_item_add_polygon"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="points" type="PackedVector2Array" /> + <argument index="2" name="colors" type="PackedColorArray" /> + <argument index="3" name="uvs" type="PackedVector2Array" default="PackedVector2Array()" /> + <argument index="4" name="texture" type="RID" /> + <description> + </description> + </method> + <method name="canvas_item_add_polyline"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="points" type="PackedVector2Array" /> + <argument index="2" name="colors" type="PackedColorArray" /> + <argument index="3" name="width" type="float" default="1.0" /> + <argument index="4" name="antialiased" type="bool" default="false" /> + <description> + </description> + </method> + <method name="canvas_item_add_primitive"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="points" type="PackedVector2Array" /> + <argument index="2" name="colors" type="PackedColorArray" /> + <argument index="3" name="uvs" type="PackedVector2Array" /> + <argument index="4" name="texture" type="RID" /> + <argument index="5" name="width" type="float" default="1.0" /> + <description> + </description> + </method> + <method name="canvas_item_add_rect"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="rect" type="Rect2" /> + <argument index="2" name="color" type="Color" /> + <description> + </description> + </method> + <method name="canvas_item_add_set_transform"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="transform" type="Transform2D" /> + <description> + </description> + </method> + <method name="canvas_item_add_texture_rect"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="rect" type="Rect2" /> + <argument index="2" name="texture" type="RID" /> + <argument index="3" name="tile" type="bool" default="false" /> + <argument index="4" name="modulate" type="Color" default="Color(1, 1, 1, 1)" /> + <argument index="5" name="transpose" type="bool" default="false" /> + <description> + </description> + </method> + <method name="canvas_item_add_texture_rect_region"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="rect" type="Rect2" /> + <argument index="2" name="texture" type="RID" /> + <argument index="3" name="src_rect" type="Rect2" /> + <argument index="4" name="modulate" type="Color" default="Color(1, 1, 1, 1)" /> + <argument index="5" name="transpose" type="bool" default="false" /> + <argument index="6" name="clip_uv" type="bool" default="true" /> + <description> + </description> + </method> + <method name="canvas_item_add_triangle_array"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="indices" type="PackedInt32Array" /> + <argument index="2" name="points" type="PackedVector2Array" /> + <argument index="3" name="colors" type="PackedColorArray" /> + <argument index="4" name="uvs" type="PackedVector2Array" default="PackedVector2Array()" /> + <argument index="5" name="bones" type="PackedInt32Array" default="PackedInt32Array()" /> + <argument index="6" name="weights" type="PackedFloat32Array" default="PackedFloat32Array()" /> + <argument index="7" name="texture" type="RID" /> + <argument index="8" name="count" type="int" default="-1" /> + <description> + </description> + </method> <method name="canvas_item_clear"> - <return type="void"> - </return> - <argument index="0" name="item" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="item" type="RID" /> <description> Clears the [CanvasItem] and removes all commands in it. </description> </method> + <method name="canvas_item_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="canvas_item_set_canvas_group_mode"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.CanvasGroupMode" /> + <argument index="2" name="clear_margin" type="float" default="5.0" /> + <argument index="3" name="fit_empty" type="bool" default="false" /> + <argument index="4" name="fit_margin" type="float" default="0.0" /> + <argument index="5" name="blur_mipmaps" type="bool" default="false" /> + <description> + </description> + </method> + <method name="canvas_item_set_clip"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="clip" type="bool" /> + <description> + </description> + </method> <method name="canvas_item_set_copy_to_backbuffer"> - <return type="void"> - </return> - <argument index="0" name="item" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> - <argument index="2" name="rect" type="Rect2"> - </argument> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="enabled" type="bool" /> + <argument index="2" name="rect" type="Rect2" /> <description> Sets the [CanvasItem] to copy a rect to the backbuffer. </description> </method> + <method name="canvas_item_set_custom_rect"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="use_custom_rect" type="bool" /> + <argument index="2" name="rect" type="Rect2" default="Rect2(0, 0, 0, 0)" /> + <description> + </description> + </method> + <method name="canvas_item_set_default_texture_filter"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="filter" type="int" enum="RenderingServer.CanvasItemTextureFilter" /> + <description> + </description> + </method> + <method name="canvas_item_set_default_texture_repeat"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="repeat" type="int" enum="RenderingServer.CanvasItemTextureRepeat" /> + <description> + </description> + </method> + <method name="canvas_item_set_distance_field_mode"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="enabled" type="bool" /> + <description> + </description> + </method> + <method name="canvas_item_set_draw_behind_parent"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="enabled" type="bool" /> + <description> + </description> + </method> <method name="canvas_item_set_draw_index"> - <return type="void"> - </return> - <argument index="0" name="item" type="RID"> - </argument> - <argument index="1" name="index" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="index" type="int" /> <description> Sets the index for the [CanvasItem]. </description> </method> + <method name="canvas_item_set_light_mask"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="mask" type="int" /> + <description> + </description> + </method> <method name="canvas_item_set_material"> - <return type="void"> - </return> - <argument index="0" name="item" type="RID"> - </argument> - <argument index="1" name="material" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="material" type="RID" /> <description> Sets a new material to the [CanvasItem]. </description> </method> + <method name="canvas_item_set_modulate"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="color" type="Color" /> + <description> + </description> + </method> + <method name="canvas_item_set_parent"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="parent" type="RID" /> + <description> + </description> + </method> + <method name="canvas_item_set_self_modulate"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="color" type="Color" /> + <description> + </description> + </method> + <method name="canvas_item_set_sort_children_by_y"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="enabled" type="bool" /> + <description> + </description> + </method> + <method name="canvas_item_set_transform"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="transform" type="Transform2D" /> + <description> + </description> + </method> <method name="canvas_item_set_use_parent_material"> - <return type="void"> - </return> - <argument index="0" name="item" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="enabled" type="bool" /> <description> Sets if the [CanvasItem] uses its parent's material. </description> </method> + <method name="canvas_item_set_visibility_notifier"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <argument index="2" name="area" type="Rect2" /> + <argument index="3" name="enter_callable" type="Callable" /> + <argument index="4" name="exit_callable" type="Callable" /> + <description> + </description> + </method> + <method name="canvas_item_set_visible"> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="visible" type="bool" /> + <description> + </description> + </method> <method name="canvas_item_set_z_as_relative_to_parent"> - <return type="void"> - </return> - <argument index="0" name="item" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="enabled" type="bool" /> <description> If this is enabled, the Z index of the parent will be added to the children's Z index. </description> </method> <method name="canvas_item_set_z_index"> - <return type="void"> - </return> - <argument index="0" name="item" type="RID"> - </argument> - <argument index="1" name="z_index" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="item" type="RID" /> + <argument index="1" name="z_index" type="int" /> <description> Sets the [CanvasItem]'s Z index, i.e. its draw order (lower indexes are drawn first). </description> </method> <method name="canvas_light_attach_to_canvas"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="canvas" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="canvas" type="RID" /> <description> Attaches the canvas light to the canvas. Removes it from its previous canvas. </description> </method> <method name="canvas_light_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a canvas light and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]canvas_light_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> <method name="canvas_light_occluder_attach_to_canvas"> - <return type="void"> - </return> - <argument index="0" name="occluder" type="RID"> - </argument> - <argument index="1" name="canvas" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="occluder" type="RID" /> + <argument index="1" name="canvas" type="RID" /> <description> Attaches a light occluder to the canvas. Removes it from its previous canvas. </description> </method> <method name="canvas_light_occluder_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a light occluder and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]canvas_light_ocluder_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> + <method name="canvas_light_occluder_set_as_sdf_collision"> + <return type="void" /> + <argument index="0" name="occluder" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <description> + </description> + </method> <method name="canvas_light_occluder_set_enabled"> - <return type="void"> - </return> - <argument index="0" name="occluder" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="occluder" type="RID" /> + <argument index="1" name="enabled" type="bool" /> <description> Enables or disables light occluder. </description> </method> <method name="canvas_light_occluder_set_light_mask"> - <return type="void"> - </return> - <argument index="0" name="occluder" type="RID"> - </argument> - <argument index="1" name="mask" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="occluder" type="RID" /> + <argument index="1" name="mask" type="int" /> <description> The light mask. See [LightOccluder2D] for more information on light masks. </description> </method> <method name="canvas_light_occluder_set_polygon"> - <return type="void"> - </return> - <argument index="0" name="occluder" type="RID"> - </argument> - <argument index="1" name="polygon" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="occluder" type="RID" /> + <argument index="1" name="polygon" type="RID" /> <description> Sets a light occluder's polygon. </description> </method> <method name="canvas_light_occluder_set_transform"> - <return type="void"> - </return> - <argument index="0" name="occluder" type="RID"> - </argument> - <argument index="1" name="transform" type="Transform2D"> - </argument> + <return type="void" /> + <argument index="0" name="occluder" type="RID" /> + <argument index="1" name="transform" type="Transform2D" /> <description> Sets a light occluder's [Transform2D]. </description> </method> <method name="canvas_light_set_color"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="color" type="Color"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="color" type="Color" /> <description> Sets the color for a light. </description> </method> <method name="canvas_light_set_enabled"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="enabled" type="bool" /> <description> Enables or disables a canvas light. </description> </method> <method name="canvas_light_set_energy"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="energy" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="energy" type="float" /> <description> Sets a canvas light's energy. </description> </method> <method name="canvas_light_set_height"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="height" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="height" type="float" /> <description> Sets a canvas light's height. </description> </method> <method name="canvas_light_set_item_cull_mask"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="mask" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="mask" type="int" /> <description> The light mask. See [LightOccluder2D] for more information on light masks. </description> </method> <method name="canvas_light_set_item_shadow_cull_mask"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="mask" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="mask" type="int" /> <description> The binary mask used to determine which layers this canvas light's shadows affects. See [LightOccluder2D] for more information on light masks. </description> </method> <method name="canvas_light_set_layer_range"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="min_layer" type="int"> - </argument> - <argument index="2" name="max_layer" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="min_layer" type="int" /> + <argument index="2" name="max_layer" type="int" /> <description> The layer range that gets rendered with this light. </description> </method> <method name="canvas_light_set_mode"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="mode" type="int" enum="RenderingServer.CanvasLightMode"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.CanvasLightMode" /> <description> The mode of the light, see [enum CanvasLightMode] constants. </description> </method> - <method name="canvas_light_set_scale"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="scale" type="float"> - </argument> - <description> - Sets the texture's scale factor of the light. Equivalent to [member Light2D.texture_scale]. - </description> - </method> - <method name="canvas_light_set_shadow_buffer_size"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="size" type="int"> - </argument> - <description> - Sets the width of the shadow buffer, size gets scaled to the next power of two for this. - </description> - </method> <method name="canvas_light_set_shadow_color"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="color" type="Color"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="color" type="Color" /> <description> Sets the color of the canvas light's shadow. </description> </method> <method name="canvas_light_set_shadow_enabled"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="enabled" type="bool" /> <description> Enables or disables the canvas light's shadow. </description> </method> <method name="canvas_light_set_shadow_filter"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="filter" type="int" enum="RenderingServer.CanvasLightShadowFilter"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="filter" type="int" enum="RenderingServer.CanvasLightShadowFilter" /> <description> Sets the canvas light's shadow's filter, see [enum CanvasLightShadowFilter] constants. </description> </method> <method name="canvas_light_set_shadow_smooth"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="smooth" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="smooth" type="float" /> <description> Smoothens the shadow. The lower, the smoother. </description> </method> <method name="canvas_light_set_texture"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="texture" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="texture" type="RID" /> <description> - Sets texture to be used by light. Equivalent to [member Light2D.texture]. + Sets the texture to be used by a [PointLight2D]. Equivalent to [member PointLight2D.texture]. </description> </method> <method name="canvas_light_set_texture_offset"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="offset" type="Vector2"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="offset" type="Vector2" /> <description> - Sets the offset of the light's texture. Equivalent to [member Light2D.offset]. + Sets the offset of a [PointLight2D]'s texture. Equivalent to [member PointLight2D.offset]. + </description> + </method> + <method name="canvas_light_set_texture_scale"> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="scale" type="float" /> + <description> + Sets the scale factor of a [PointLight2D]'s texture. Equivalent to [member PointLight2D.texture_scale]. </description> </method> <method name="canvas_light_set_transform"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="transform" type="Transform2D"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="transform" type="Transform2D" /> <description> Sets the canvas light's [Transform2D]. </description> </method> <method name="canvas_light_set_z_range"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="min_z" type="int"> - </argument> - <argument index="2" name="max_z" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="min_z" type="int" /> + <argument index="2" name="max_z" type="int" /> <description> Sets the Z range of objects that will be affected by this light. Equivalent to [member Light2D.range_z_min] and [member Light2D.range_z_max]. </description> </method> <method name="canvas_occluder_polygon_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a new light occluder polygon and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]canvas_occluder_polygon_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> <method name="canvas_occluder_polygon_set_cull_mode"> - <return type="void"> - </return> - <argument index="0" name="occluder_polygon" type="RID"> - </argument> - <argument index="1" name="mode" type="int" enum="RenderingServer.CanvasOccluderPolygonCullMode"> - </argument> + <return type="void" /> + <argument index="0" name="occluder_polygon" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.CanvasOccluderPolygonCullMode" /> <description> Sets an occluder polygons cull mode. See [enum CanvasOccluderPolygonCullMode] constants. </description> </method> <method name="canvas_occluder_polygon_set_shape"> - <return type="void"> - </return> - <argument index="0" name="occluder_polygon" type="RID"> - </argument> - <argument index="1" name="shape" type="PackedVector2Array"> - </argument> - <argument index="2" name="closed" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="occluder_polygon" type="RID" /> + <argument index="1" name="shape" type="PackedVector2Array" /> + <argument index="2" name="closed" type="bool" /> <description> Sets the shape of the occluder polygon. </description> </method> - <method name="canvas_occluder_polygon_set_shape_as_lines"> - <return type="void"> - </return> - <argument index="0" name="occluder_polygon" type="RID"> - </argument> - <argument index="1" name="shape" type="PackedVector2Array"> - </argument> + <method name="canvas_set_disable_scale"> + <return type="void" /> + <argument index="0" name="disable" type="bool" /> <description> - Sets the shape of the occluder polygon as lines. </description> </method> <method name="canvas_set_item_mirroring"> - <return type="void"> - </return> - <argument index="0" name="canvas" type="RID"> - </argument> - <argument index="1" name="item" type="RID"> - </argument> - <argument index="2" name="mirroring" type="Vector2"> - </argument> + <return type="void" /> + <argument index="0" name="canvas" type="RID" /> + <argument index="1" name="item" type="RID" /> + <argument index="2" name="mirroring" type="Vector2" /> <description> A copy of the canvas item will be drawn with a local offset of the mirroring [Vector2]. </description> </method> <method name="canvas_set_modulate"> - <return type="void"> - </return> - <argument index="0" name="canvas" type="RID"> - </argument> - <argument index="1" name="color" type="Color"> - </argument> + <return type="void" /> + <argument index="0" name="canvas" type="RID" /> + <argument index="1" name="color" type="Color" /> <description> Modulates all colors in the given canvas. </description> </method> + <method name="canvas_set_shadow_texture_size"> + <return type="void" /> + <argument index="0" name="size" type="int" /> + <description> + </description> + </method> + <method name="canvas_texture_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="canvas_texture_set_channel"> + <return type="void" /> + <argument index="0" name="canvas_texture" type="RID" /> + <argument index="1" name="channel" type="int" enum="RenderingServer.CanvasTextureChannel" /> + <argument index="2" name="texture" type="RID" /> + <description> + </description> + </method> + <method name="canvas_texture_set_shading_parameters"> + <return type="void" /> + <argument index="0" name="canvas_texture" type="RID" /> + <argument index="1" name="base_color" type="Color" /> + <argument index="2" name="shininess" type="float" /> + <description> + </description> + </method> + <method name="canvas_texture_set_texture_filter"> + <return type="void" /> + <argument index="0" name="canvas_texture" type="RID" /> + <argument index="1" name="filter" type="int" enum="RenderingServer.CanvasItemTextureFilter" /> + <description> + </description> + </method> + <method name="canvas_texture_set_texture_repeat"> + <return type="void" /> + <argument index="0" name="canvas_texture" type="RID" /> + <argument index="1" name="repeat" type="int" enum="RenderingServer.CanvasItemTextureRepeat" /> + <description> + </description> + </method> + <method name="create_local_rendering_device" qualifiers="const"> + <return type="RenderingDevice" /> + <description> + </description> + </method> + <method name="decal_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="decal_set_albedo_mix"> + <return type="void" /> + <argument index="0" name="decal" type="RID" /> + <argument index="1" name="albedo_mix" type="float" /> + <description> + </description> + </method> + <method name="decal_set_cull_mask"> + <return type="void" /> + <argument index="0" name="decal" type="RID" /> + <argument index="1" name="mask" type="int" /> + <description> + </description> + </method> + <method name="decal_set_distance_fade"> + <return type="void" /> + <argument index="0" name="decal" type="RID" /> + <argument index="1" name="enabled" type="bool" /> + <argument index="2" name="begin" type="float" /> + <argument index="3" name="length" type="float" /> + <description> + </description> + </method> + <method name="decal_set_emission_energy"> + <return type="void" /> + <argument index="0" name="decal" type="RID" /> + <argument index="1" name="energy" type="float" /> + <description> + </description> + </method> + <method name="decal_set_extents"> + <return type="void" /> + <argument index="0" name="decal" type="RID" /> + <argument index="1" name="extents" type="Vector3" /> + <description> + </description> + </method> + <method name="decal_set_fade"> + <return type="void" /> + <argument index="0" name="decal" type="RID" /> + <argument index="1" name="above" type="float" /> + <argument index="2" name="below" type="float" /> + <description> + </description> + </method> + <method name="decal_set_modulate"> + <return type="void" /> + <argument index="0" name="decal" type="RID" /> + <argument index="1" name="color" type="Color" /> + <description> + </description> + </method> + <method name="decal_set_normal_fade"> + <return type="void" /> + <argument index="0" name="decal" type="RID" /> + <argument index="1" name="fade" type="float" /> + <description> + </description> + </method> + <method name="decal_set_texture"> + <return type="void" /> + <argument index="0" name="decal" type="RID" /> + <argument index="1" name="type" type="int" enum="RenderingServer.DecalTexture" /> + <argument index="2" name="texture" type="RID" /> + <description> + </description> + </method> + <method name="decals_set_filter"> + <return type="void" /> + <argument index="0" name="filter" type="int" enum="RenderingServer.DecalFilter" /> + <description> + </description> + </method> <method name="directional_light_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a directional light and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID can be used in most [code]light_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. To place in a scene, attach this directional light to an instance using [method instance_set_base] using the returned RID. </description> </method> + <method name="directional_shadow_atlas_set_size"> + <return type="void" /> + <argument index="0" name="size" type="int" /> + <argument index="1" name="is_16bits" type="bool" /> + <description> + </description> + </method> + <method name="directional_shadow_quality_set"> + <return type="void" /> + <argument index="0" name="quality" type="int" enum="RenderingServer.ShadowQuality" /> + <description> + </description> + </method> + <method name="environment_bake_panorama"> + <return type="Image" /> + <argument index="0" name="environment" type="RID" /> + <argument index="1" name="bake_irradiance" type="bool" /> + <argument index="2" name="size" type="Vector2i" /> + <description> + </description> + </method> <method name="environment_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates an environment and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]environment_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> + <method name="environment_glow_set_use_bicubic_upscale"> + <return type="void" /> + <argument index="0" name="enable" type="bool" /> + <description> + </description> + </method> + <method name="environment_glow_set_use_high_quality"> + <return type="void" /> + <argument index="0" name="enable" type="bool" /> + <description> + </description> + </method> <method name="environment_set_adjustment"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> - <argument index="2" name="brightness" type="float"> - </argument> - <argument index="3" name="contrast" type="float"> - </argument> - <argument index="4" name="saturation" type="float"> - </argument> - <argument index="5" name="ramp" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <argument index="2" name="brightness" type="float" /> + <argument index="3" name="contrast" type="float" /> + <argument index="4" name="saturation" type="float" /> + <argument index="5" name="use_1d_color_correction" type="bool" /> + <argument index="6" name="color_correction" type="RID" /> <description> Sets the values to be used with the "Adjustment" post-process effect. See [Environment] for more details. </description> </method> <method name="environment_set_ambient_light"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="color" type="Color"> - </argument> - <argument index="2" name="ambient" type="int" enum="RenderingServer.EnvironmentAmbientSource" default="0"> - </argument> - <argument index="3" name="energy" type="float" default="1.0"> - </argument> - <argument index="4" name="sky_contibution" type="float" default="0.0"> - </argument> - <argument index="5" name="reflection_source" type="int" enum="RenderingServer.EnvironmentReflectionSource" default="0"> - </argument> - <argument index="6" name="ao_color" type="Color" default="Color( 0, 0, 0, 1 )"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="color" type="Color" /> + <argument index="2" name="ambient" type="int" enum="RenderingServer.EnvironmentAmbientSource" default="0" /> + <argument index="3" name="energy" type="float" default="1.0" /> + <argument index="4" name="sky_contibution" type="float" default="0.0" /> + <argument index="5" name="reflection_source" type="int" enum="RenderingServer.EnvironmentReflectionSource" default="0" /> <description> </description> </method> <method name="environment_set_background"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="bg" type="int" enum="RenderingServer.EnvironmentBG"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="bg" type="int" enum="RenderingServer.EnvironmentBG" /> <description> Sets the [i]BGMode[/i] of the environment. Equivalent to [member Environment.background_mode]. </description> </method> <method name="environment_set_bg_color"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="color" type="Color"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="color" type="Color" /> <description> Color displayed for clear areas of the scene (if using Custom color or Color+Sky background modes). </description> </method> <method name="environment_set_bg_energy"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="energy" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="energy" type="float" /> <description> Sets the intensity of the background color. </description> </method> <method name="environment_set_canvas_max_layer"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="max_layer" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="max_layer" type="int" /> <description> Sets the maximum layer to use if using Canvas background mode. </description> </method> <method name="environment_set_fog"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> - <argument index="2" name="color" type="Color"> - </argument> - <argument index="3" name="sun_color" type="Color"> - </argument> - <argument index="4" name="sun_amount" type="float"> - </argument> - <description> - Sets the variables to be used with the scene fog. See [Environment] for more details. - </description> - </method> - <method name="environment_set_fog_depth"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> - <argument index="2" name="depth_begin" type="float"> - </argument> - <argument index="3" name="depth_end" type="float"> - </argument> - <argument index="4" name="depth_curve" type="float"> - </argument> - <argument index="5" name="transmit" type="bool"> - </argument> - <argument index="6" name="transmit_curve" type="float"> - </argument> - <description> - Sets the variables to be used with the fog depth effect. See [Environment] for more details. - </description> - </method> - <method name="environment_set_fog_height"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> - <argument index="2" name="min_height" type="float"> - </argument> - <argument index="3" name="max_height" type="float"> - </argument> - <argument index="4" name="height_curve" type="float"> - </argument> - <description> - Sets the variables to be used with the fog height effect. See [Environment] for more details. + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <argument index="2" name="light_color" type="Color" /> + <argument index="3" name="light_energy" type="float" /> + <argument index="4" name="sun_scatter" type="float" /> + <argument index="5" name="density" type="float" /> + <argument index="6" name="height" type="float" /> + <argument index="7" name="height_density" type="float" /> + <argument index="8" name="aerial_perspective" type="float" /> + <description> </description> </method> <method name="environment_set_glow"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> - <argument index="2" name="level_flags" type="int"> - </argument> - <argument index="3" name="intensity" type="float"> - </argument> - <argument index="4" name="strength" type="float"> - </argument> - <argument index="5" name="mix" type="float"> - </argument> - <argument index="6" name="bloom_threshold" type="float"> - </argument> - <argument index="7" name="blend_mode" type="int" enum="RenderingServer.EnvironmentGlowBlendMode"> - </argument> - <argument index="8" name="hdr_bleed_threshold" type="float"> - </argument> - <argument index="9" name="hdr_bleed_scale" type="float"> - </argument> - <argument index="10" name="hdr_luminance_cap" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <argument index="2" name="levels" type="PackedFloat32Array" /> + <argument index="3" name="intensity" type="float" /> + <argument index="4" name="strength" type="float" /> + <argument index="5" name="mix" type="float" /> + <argument index="6" name="bloom_threshold" type="float" /> + <argument index="7" name="blend_mode" type="int" enum="RenderingServer.EnvironmentGlowBlendMode" /> + <argument index="8" name="hdr_bleed_threshold" type="float" /> + <argument index="9" name="hdr_bleed_scale" type="float" /> + <argument index="10" name="hdr_luminance_cap" type="float" /> + <description> + </description> + </method> + <method name="environment_set_sdfgi"> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <argument index="2" name="cascades" type="int" enum="RenderingServer.EnvironmentSDFGICascades" /> + <argument index="3" name="min_cell_size" type="float" /> + <argument index="4" name="y_scale" type="int" enum="RenderingServer.EnvironmentSDFGIYScale" /> + <argument index="5" name="use_occlusion" type="bool" /> + <argument index="6" name="bounce_feedback" type="float" /> + <argument index="7" name="read_sky" type="bool" /> + <argument index="8" name="energy" type="float" /> + <argument index="9" name="normal_bias" type="float" /> + <argument index="10" name="probe_bias" type="float" /> + <description> + </description> + </method> + <method name="environment_set_sdfgi_frames_to_converge"> + <return type="void" /> + <argument index="0" name="frames" type="int" enum="RenderingServer.EnvironmentSDFGIFramesToConverge" /> + <description> + </description> + </method> + <method name="environment_set_sdfgi_frames_to_update_light"> + <return type="void" /> + <argument index="0" name="frames" type="int" enum="RenderingServer.EnvironmentSDFGIFramesToUpdateLight" /> + <description> + </description> + </method> + <method name="environment_set_sdfgi_ray_count"> + <return type="void" /> + <argument index="0" name="ray_count" type="int" enum="RenderingServer.EnvironmentSDFGIRayCount" /> <description> </description> </method> <method name="environment_set_sky"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="sky" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="sky" type="RID" /> <description> Sets the [Sky] to be used as the environment's background when using [i]BGMode[/i] sky. Equivalent to [member Environment.sky]. </description> </method> <method name="environment_set_sky_custom_fov"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="scale" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="scale" type="float" /> <description> Sets a custom field of view for the background [Sky]. Equivalent to [member Environment.sky_custom_fov]. </description> </method> <method name="environment_set_sky_orientation"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="orientation" type="Basis"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="orientation" type="Basis" /> <description> Sets the rotation of the background [Sky] expressed as a [Basis]. Equivalent to [member Environment.sky_rotation], where the rotation vector is used to construct the [Basis]. </description> </method> <method name="environment_set_ssao"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> - <argument index="2" name="radius" type="float"> - </argument> - <argument index="3" name="intensity" type="float"> - </argument> - <argument index="4" name="bias" type="float"> - </argument> - <argument index="5" name="light_affect" type="float"> - </argument> - <argument index="6" name="ao_channel_affect" type="float"> - </argument> - <argument index="7" name="blur" type="int" enum="RenderingServer.EnvironmentSSAOBlur"> - </argument> - <argument index="8" name="bilateral_sharpness" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <argument index="2" name="radius" type="float" /> + <argument index="3" name="intensity" type="float" /> + <argument index="4" name="power" type="float" /> + <argument index="5" name="detail" type="float" /> + <argument index="6" name="horizon" type="float" /> + <argument index="7" name="sharpness" type="float" /> + <argument index="8" name="light_affect" type="float" /> + <argument index="9" name="ao_channel_affect" type="float" /> <description> + Sets the variables to be used with the screen-space ambient occlusion (SSAO) post-process effect. See [Environment] for more details. </description> </method> - <method name="environment_set_ssr"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> - <argument index="2" name="max_steps" type="int"> - </argument> - <argument index="3" name="fade_in" type="float"> - </argument> - <argument index="4" name="fade_out" type="float"> - </argument> - <argument index="5" name="depth_tolerance" type="float"> - </argument> + <method name="environment_set_ssao_quality"> + <return type="void" /> + <argument index="0" name="quality" type="int" enum="RenderingServer.EnvironmentSSAOQuality" /> + <argument index="1" name="half_size" type="bool" /> + <argument index="2" name="adaptive_target" type="float" /> + <argument index="3" name="blur_passes" type="int" /> + <argument index="4" name="fadeout_from" type="float" /> + <argument index="5" name="fadeout_to" type="float" /> <description> - Sets the variables to be used with the "screen space reflections" post-process effect. See [Environment] for more details. + Sets the quality level of the screen-space ambient occlusion (SSAO) post-process effect. See [Environment] for more details. </description> </method> - <method name="environment_set_tonemap"> - <return type="void"> - </return> - <argument index="0" name="env" type="RID"> - </argument> - <argument index="1" name="tone_mapper" type="int" enum="RenderingServer.EnvironmentToneMapper"> - </argument> - <argument index="2" name="exposure" type="float"> - </argument> - <argument index="3" name="white" type="float"> - </argument> - <argument index="4" name="auto_exposure" type="bool"> - </argument> - <argument index="5" name="min_luminance" type="float"> - </argument> - <argument index="6" name="max_luminance" type="float"> - </argument> - <argument index="7" name="auto_exp_speed" type="float"> - </argument> - <argument index="8" name="auto_exp_grey" type="float"> - </argument> + <method name="environment_set_ssil_quality"> + <return type="void" /> + <argument index="0" name="quality" type="int" enum="RenderingServer.EnvironmentSSILQuality" /> + <argument index="1" name="half_size" type="bool" /> + <argument index="2" name="adaptive_target" type="float" /> + <argument index="3" name="blur_passes" type="int" /> + <argument index="4" name="fadeout_from" type="float" /> + <argument index="5" name="fadeout_to" type="float" /> <description> - Sets the variables to be used with the "tonemap" post-process effect. See [Environment] for more details. + Sets the quality level of the screen-space indirect lighting (SSIL) post-process effect. See [Environment] for more details. </description> </method> - <method name="finish"> - <return type="void"> - </return> + <method name="environment_set_ssr"> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <argument index="2" name="max_steps" type="int" /> + <argument index="3" name="fade_in" type="float" /> + <argument index="4" name="fade_out" type="float" /> + <argument index="5" name="depth_tolerance" type="float" /> <description> - Removes buffers and clears testcubes. + Sets the variables to be used with the "screen space reflections" post-process effect. See [Environment] for more details. </description> </method> - <method name="force_draw"> - <return type="void"> - </return> - <argument index="0" name="swap_buffers" type="bool" default="true"> - </argument> - <argument index="1" name="frame_step" type="float" default="0.0"> - </argument> + <method name="environment_set_ssr_roughness_quality"> + <return type="void" /> + <argument index="0" name="quality" type="int" enum="RenderingServer.EnvironmentSSRRoughnessQuality" /> <description> - Forces a frame to be drawn when the function is called. Drawing a frame updates all [Viewport]s that are set to update. Use with extreme caution. </description> </method> - <method name="force_sync"> - <return type="void"> - </return> + <method name="environment_set_tonemap"> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="tone_mapper" type="int" enum="RenderingServer.EnvironmentToneMapper" /> + <argument index="2" name="exposure" type="float" /> + <argument index="3" name="white" type="float" /> + <argument index="4" name="auto_exposure" type="bool" /> + <argument index="5" name="min_luminance" type="float" /> + <argument index="6" name="max_luminance" type="float" /> + <argument index="7" name="auto_exp_speed" type="float" /> + <argument index="8" name="auto_exp_grey" type="float" /> <description> - Synchronizes threads. + Sets the variables to be used with the "tonemap" post-process effect. See [Environment] for more details. </description> </method> - <method name="free_rid"> - <return type="void"> - </return> - <argument index="0" name="rid" type="RID"> - </argument> + <method name="environment_set_volumetric_fog"> + <return type="void" /> + <argument index="0" name="env" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <argument index="2" name="density" type="float" /> + <argument index="3" name="albedo" type="Color" /> + <argument index="4" name="emission" type="Color" /> + <argument index="5" name="emission_energy" type="float" /> + <argument index="6" name="anisotropy" type="float" /> + <argument index="7" name="length" type="float" /> + <argument index="8" name="p_detail_spread" type="float" /> + <argument index="9" name="gi_inject" type="float" /> + <argument index="10" name="temporal_reprojection" type="bool" /> + <argument index="11" name="temporal_reprojection_amount" type="float" /> + <argument index="12" name="ambient_inject" type="float" /> <description> - Tries to free an object in the RenderingServer. </description> </method> - <method name="get_render_info"> - <return type="int"> - </return> - <argument index="0" name="info" type="int" enum="RenderingServer.RenderInfo"> - </argument> + <method name="environment_set_volumetric_fog_filter_active"> + <return type="void" /> + <argument index="0" name="active" type="bool" /> <description> - Returns a certain information, see [enum RenderInfo] for options. + Enables filtering of the volumetric fog scattering buffer. This results in much smoother volumes with very few under-sampling artifacts. </description> </method> - <method name="get_test_cube"> - <return type="RID"> - </return> + <method name="environment_set_volumetric_fog_volume_size"> + <return type="void" /> + <argument index="0" name="size" type="int" /> + <argument index="1" name="depth" type="int" /> <description> - Returns the id of the test cube. Creates one if none exists. + Sets the resolution of the volumetric fog's froxel buffer. [code]size[/code] is modified by the screen's aspect ratio and then used to set the width and height of the buffer. While [code]depth[/code] is directly used to set the depth of the buffer. </description> </method> - <method name="get_test_texture"> - <return type="RID"> - </return> + <method name="fog_volume_create"> + <return type="RID" /> <description> - Returns the id of the test texture. Creates one if none exists. + Creates a new fog volume and allocates an RID. </description> </method> - <method name="get_video_adapter_name" qualifiers="const"> - <return type="String"> - </return> + <method name="fog_volume_set_extents"> + <return type="void" /> + <argument index="0" name="fog_volume" type="RID" /> + <argument index="1" name="extents" type="Vector3" /> <description> - Returns the name of the video adapter (e.g. "GeForce GTX 1080/PCIe/SSE2"). - [b]Note:[/b] When running a headless or server binary, this function returns an empty string. + Sets the size of the fog volume when shape is [constant FOG_VOLUME_SHAPE_ELLIPSOID] or [constant FOG_VOLUME_SHAPE_BOX]. </description> </method> - <method name="get_video_adapter_vendor" qualifiers="const"> - <return type="String"> - </return> + <method name="fog_volume_set_material"> + <return type="void" /> + <argument index="0" name="fog_volume" type="RID" /> + <argument index="1" name="material" type="RID" /> <description> - Returns the vendor of the video adapter (e.g. "NVIDIA Corporation"). - [b]Note:[/b] When running a headless or server binary, this function returns an empty string. + Sets the [Material] of the fog volume. Can be either a [FogMaterial] or a custom [ShaderMaterial]. </description> </method> - <method name="get_white_texture"> - <return type="RID"> - </return> + <method name="fog_volume_set_shape"> + <return type="void" /> + <argument index="0" name="fog_volume" type="RID" /> + <argument index="1" name="shape" type="int" enum="RenderingServer.FogVolumeShape" /> <description> - Returns the id of a white texture. Creates one if none exists. + Sets the shape of the fog volume to either [constant RenderingServer.FOG_VOLUME_SHAPE_ELLIPSOID], [constant RenderingServer.FOG_VOLUME_SHAPE_BOX], or [constant RenderingServer.FOG_VOLUME_SHAPE_ELLIPSOID] or [constant RenderingServer.FOG_VOLUME_SHAPE_WORLD]. </description> </method> - <method name="global_variable_add"> - <return type="void"> - </return> - <argument index="0" name="name" type="StringName"> - </argument> - <argument index="1" name="type" type="int" enum="RenderingServer.GlobalVariableType"> - </argument> - <argument index="2" name="default_value" type="Variant"> - </argument> + <method name="force_draw"> + <return type="void" /> + <argument index="0" name="swap_buffers" type="bool" default="true" /> + <argument index="1" name="frame_step" type="float" default="0.0" /> <description> </description> </method> - <method name="global_variable_get" qualifiers="const"> - <return type="Variant"> - </return> - <argument index="0" name="name" type="StringName"> - </argument> + <method name="force_sync"> + <return type="void" /> <description> </description> </method> - <method name="global_variable_get_list" qualifiers="const"> - <return type="PackedStringArray"> - </return> + <method name="free_rid"> + <return type="void" /> + <argument index="0" name="rid" type="RID" /> <description> + Tries to free an object in the RenderingServer. </description> </method> - <method name="global_variable_get_type" qualifiers="const"> - <return type="int" enum="RenderingServer.GlobalVariableType"> - </return> - <argument index="0" name="name" type="StringName"> - </argument> + <method name="get_frame_setup_time_cpu" qualifiers="const"> + <return type="float" /> <description> </description> </method> - <method name="global_variable_remove"> - <return type="void"> - </return> - <argument index="0" name="name" type="StringName"> - </argument> + <method name="get_rendering_device" qualifiers="const"> + <return type="RenderingDevice" /> <description> </description> </method> - <method name="global_variable_set"> - <return type="void"> - </return> - <argument index="0" name="name" type="StringName"> - </argument> - <argument index="1" name="value" type="Variant"> - </argument> + <method name="get_rendering_info"> + <return type="int" /> + <argument index="0" name="info" type="int" enum="RenderingServer.RenderingInfo" /> <description> </description> </method> - <method name="has_changed" qualifiers="const"> - <return type="bool"> - </return> + <method name="get_test_cube"> + <return type="RID" /> <description> - Returns [code]true[/code] if changes have been made to the RenderingServer's data. [method force_draw] is usually called if this happens. + Returns the id of the test cube. Creates one if none exists. </description> </method> - <method name="has_feature" qualifiers="const"> - <return type="bool"> - </return> - <argument index="0" name="feature" type="int" enum="RenderingServer.Features"> - </argument> + <method name="get_test_texture"> + <return type="RID" /> <description> - Not yet implemented. Always returns [code]false[/code]. + Returns the id of the test texture. Creates one if none exists. </description> </method> - <method name="has_os_feature" qualifiers="const"> - <return type="bool"> - </return> - <argument index="0" name="feature" type="String"> - </argument> + <method name="get_video_adapter_name" qualifiers="const"> + <return type="String" /> <description> - Returns [code]true[/code] if the OS supports a certain feature. Features might be [code]s3tc[/code], [code]etc[/code], [code]etc2[/code] and [code]pvrtc[/code]. + Returns the name of the video adapter (e.g. "GeForce GTX 1080/PCIe/SSE2"). + [b]Note:[/b] When running a headless or server binary, this function returns an empty string. </description> </method> - <method name="immediate_begin"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> - <argument index="1" name="primitive" type="int" enum="RenderingServer.PrimitiveType"> - </argument> - <argument index="2" name="texture" type="RID"> - </argument> + <method name="get_video_adapter_type" qualifiers="const"> + <return type="int" enum="RenderingDevice.DeviceType" /> <description> - Sets up [ImmediateGeometry3D] internals to prepare for drawing. Equivalent to [method ImmediateGeometry3D.begin]. + Returns the type of the video adapter. Since dedicated graphics cards from a given generation will [i]usually[/i] be significantly faster than integrated graphics made in the same generation, the device type can be used as a basis for automatic graphics settings adjustment. However, this is not always true, so make sure to provide users with a way to manually override graphics settings. + [b]Note:[/b] When using the OpenGL backend or when running in headless mode, this function always returns [constant RenderingDevice.DEVICE_TYPE_OTHER]. </description> </method> - <method name="immediate_clear"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> + <method name="get_video_adapter_vendor" qualifiers="const"> + <return type="String" /> <description> - Clears everything that was set up between [method immediate_begin] and [method immediate_end]. Equivalent to [method ImmediateGeometry3D.clear]. + Returns the vendor of the video adapter (e.g. "NVIDIA Corporation"). + [b]Note:[/b] When running a headless or server binary, this function returns an empty string. </description> </method> - <method name="immediate_color"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> - <argument index="1" name="color" type="Color"> - </argument> + <method name="get_white_texture"> + <return type="RID" /> <description> - Sets the color to be used with next vertex. Equivalent to [method ImmediateGeometry3D.set_color]. + Returns the id of a white texture. Creates one if none exists. </description> </method> - <method name="immediate_create"> - <return type="RID"> - </return> + <method name="gi_set_use_half_resolution"> + <return type="void" /> + <argument index="0" name="half_resolution" type="bool" /> <description> - Creates an immediate geometry and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]immediate_*[/code] RenderingServer functions. - Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. - To place in a scene, attach this immediate geometry to an instance using [method instance_set_base] using the returned RID. + If [code]half_resolution[/code] is [code]true[/code], renders [VoxelGI] and SDFGI ([member Environment.sdfgi_enabled]) buffers at halved resolution (e.g. 960×540 when the viewport size is 1920×1080). This improves performance significantly when VoxelGI or SDFGI is enabled, at the cost of artifacts that may be visible on polygon edges. The loss in quality becomes less noticeable as the viewport resolution increases. [LightmapGI] rendering is not affected by this setting. See also [member ProjectSettings.rendering/global_illumination/gi/use_half_resolution]. </description> </method> - <method name="immediate_end"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> + <method name="global_variable_add"> + <return type="void" /> + <argument index="0" name="name" type="StringName" /> + <argument index="1" name="type" type="int" enum="RenderingServer.GlobalVariableType" /> + <argument index="2" name="default_value" type="Variant" /> <description> - Ends drawing the [ImmediateGeometry3D] and displays it. Equivalent to [method ImmediateGeometry3D.end]. </description> </method> - <method name="immediate_get_material" qualifiers="const"> - <return type="RID"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> + <method name="global_variable_get" qualifiers="const"> + <return type="Variant" /> + <argument index="0" name="name" type="StringName" /> <description> - Returns the material assigned to the [ImmediateGeometry3D]. </description> </method> - <method name="immediate_normal"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> - <argument index="1" name="normal" type="Vector3"> - </argument> + <method name="global_variable_get_list" qualifiers="const"> + <return type="PackedStringArray" /> <description> - Sets the normal to be used with next vertex. Equivalent to [method ImmediateGeometry3D.set_normal]. </description> </method> - <method name="immediate_set_material"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> - <argument index="1" name="material" type="RID"> - </argument> + <method name="global_variable_get_type" qualifiers="const"> + <return type="int" enum="RenderingServer.GlobalVariableType" /> + <argument index="0" name="name" type="StringName" /> <description> - Sets the material to be used to draw the [ImmediateGeometry3D]. </description> </method> - <method name="immediate_tangent"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> - <argument index="1" name="tangent" type="Plane"> - </argument> + <method name="global_variable_remove"> + <return type="void" /> + <argument index="0" name="name" type="StringName" /> <description> - Sets the tangent to be used with next vertex. Equivalent to [method ImmediateGeometry3D.set_tangent]. </description> </method> - <method name="immediate_uv"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> - <argument index="1" name="tex_uv" type="Vector2"> - </argument> + <method name="global_variable_set"> + <return type="void" /> + <argument index="0" name="name" type="StringName" /> + <argument index="1" name="value" type="Variant" /> <description> - Sets the UV to be used with next vertex. Equivalent to [method ImmediateGeometry3D.set_uv]. </description> </method> - <method name="immediate_uv2"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> - <argument index="1" name="tex_uv" type="Vector2"> - </argument> + <method name="global_variable_set_override"> + <return type="void" /> + <argument index="0" name="name" type="StringName" /> + <argument index="1" name="value" type="Variant" /> <description> - Sets the UV2 to be used with next vertex. Equivalent to [method ImmediateGeometry3D.set_uv2]. </description> </method> - <method name="immediate_vertex"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> - <argument index="1" name="vertex" type="Vector3"> - </argument> + <method name="has_changed" qualifiers="const"> + <return type="bool" /> <description> - Adds the next vertex using the information provided in advance. Equivalent to [method ImmediateGeometry3D.add_vertex]. + Returns [code]true[/code] if changes have been made to the RenderingServer's data. [method force_draw] is usually called if this happens. </description> </method> - <method name="immediate_vertex_2d"> - <return type="void"> - </return> - <argument index="0" name="immediate" type="RID"> - </argument> - <argument index="1" name="vertex" type="Vector2"> - </argument> + <method name="has_feature" qualifiers="const"> + <return type="bool" /> + <argument index="0" name="feature" type="int" enum="RenderingServer.Features" /> <description> - Adds the next vertex using the information provided in advance. This is a helper class that calls [method immediate_vertex] under the hood. Equivalent to [method ImmediateGeometry3D.add_vertex]. + Not yet implemented. Always returns [code]false[/code]. </description> </method> - <method name="init"> - <return type="void"> - </return> + <method name="has_os_feature" qualifiers="const"> + <return type="bool" /> + <argument index="0" name="feature" type="String" /> <description> - Initializes the rendering server. This function is called internally by platform-dependent code during engine initialization. If called from a running game, it will not do anything. + Returns [code]true[/code] if the OS supports a certain feature. Features might be [code]s3tc[/code], [code]etc[/code], [code]etc2[/code] and [code]pvrtc[/code]. </description> </method> <method name="instance_attach_object_instance_id"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="id" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="id" type="int" /> <description> Attaches a unique Object ID to instance. Object ID must be attached to instance for proper culling with [method instances_cull_aabb], [method instances_cull_convex], and [method instances_cull_ray]. </description> </method> <method name="instance_attach_skeleton"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="skeleton" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="skeleton" type="RID" /> <description> Attaches a skeleton to an instance. Removes the previous skeleton from the instance. </description> </method> <method name="instance_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a visual instance and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]instance_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. @@ -1200,659 +1362,669 @@ </description> </method> <method name="instance_create2"> - <return type="RID"> - </return> - <argument index="0" name="base" type="RID"> - </argument> - <argument index="1" name="scenario" type="RID"> - </argument> + <return type="RID" /> + <argument index="0" name="base" type="RID" /> + <argument index="1" name="scenario" type="RID" /> <description> Creates a visual instance, adds it to the RenderingServer, and sets both base and scenario. It can be accessed with the RID that is returned. This RID will be used in all [code]instance_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> - <method name="instance_geometry_set_as_instance_lod"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="as_lod_of_instance" type="RID"> - </argument> + <method name="instance_geometry_get_shader_parameter" qualifiers="const"> + <return type="Variant" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="parameter" type="StringName" /> <description> - Not implemented in Godot 3.x. </description> </method> - <method name="instance_geometry_set_cast_shadows_setting"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="shadow_casting_setting" type="int" enum="RenderingServer.ShadowCastingSetting"> - </argument> + <method name="instance_geometry_get_shader_parameter_default_value" qualifiers="const"> + <return type="Variant" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="parameter" type="StringName" /> <description> - Sets the shadow casting setting to one of [enum ShadowCastingSetting]. Equivalent to [member GeometryInstance3D.cast_shadow]. </description> </method> - <method name="instance_geometry_set_draw_range"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="min" type="float"> - </argument> - <argument index="2" name="max" type="float"> - </argument> - <argument index="3" name="min_margin" type="float"> - </argument> - <argument index="4" name="max_margin" type="float"> - </argument> + <method name="instance_geometry_get_shader_parameter_list" qualifiers="const"> + <return type="Array" /> + <argument index="0" name="instance" type="RID" /> <description> - Not implemented in Godot 3.x. + </description> + </method> + <method name="instance_geometry_set_cast_shadows_setting"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="shadow_casting_setting" type="int" enum="RenderingServer.ShadowCastingSetting" /> + <description> + Sets the shadow casting setting to one of [enum ShadowCastingSetting]. Equivalent to [member GeometryInstance3D.cast_shadow]. </description> </method> <method name="instance_geometry_set_flag"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="flag" type="int" enum="RenderingServer.InstanceFlags"> - </argument> - <argument index="2" name="enabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="flag" type="int" enum="RenderingServer.InstanceFlags" /> + <argument index="2" name="enabled" type="bool" /> <description> Sets the flag for a given [enum InstanceFlags]. See [enum InstanceFlags] for more details. </description> </method> + <method name="instance_geometry_set_lightmap"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="lightmap" type="RID" /> + <argument index="2" name="lightmap_uv_scale" type="Rect2" /> + <argument index="3" name="lightmap_slice" type="int" /> + <description> + </description> + </method> + <method name="instance_geometry_set_lod_bias"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="lod_bias" type="float" /> + <description> + </description> + </method> + <method name="instance_geometry_set_material_overlay"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="material" type="RID" /> + <description> + Sets a material that will be rendered for all surfaces on top of active materials for the mesh associated with this instance. Equivalent to [member GeometryInstance3D.material_overlay]. + </description> + </method> <method name="instance_geometry_set_material_override"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="material" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="material" type="RID" /> <description> Sets a material that will override the material for all surfaces on the mesh associated with this instance. Equivalent to [member GeometryInstance3D.material_override]. </description> </method> + <method name="instance_geometry_set_shader_parameter"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="parameter" type="StringName" /> + <argument index="2" name="value" type="Variant" /> + <description> + </description> + </method> + <method name="instance_geometry_set_transparency"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="transparency" type="float" /> + <description> + Sets the transparency for the given geometry instance. Equivalent to [member GeometryInstance3D.transparency]. + </description> + </method> + <method name="instance_geometry_set_visibility_range"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="min" type="float" /> + <argument index="2" name="max" type="float" /> + <argument index="3" name="min_margin" type="float" /> + <argument index="4" name="max_margin" type="float" /> + <argument index="5" name="fade_mode" type="int" enum="RenderingServer.VisibilityRangeFadeMode" /> + <description> + Sets the visibility range values for the given geometry instance. Equivalent to [member GeometryInstance3D.visibility_range_begin] and related properties. + </description> + </method> <method name="instance_set_base"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="base" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="base" type="RID" /> <description> Sets the base of the instance. A base can be any of the 3D objects that are created in the RenderingServer that can be displayed. For example, any of the light types, mesh, multimesh, immediate geometry, particle system, reflection probe, lightmap, and the GI probe are all types that can be set as the base of an instance in order to be displayed in the scenario. </description> </method> <method name="instance_set_blend_shape_weight"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="shape" type="int"> - </argument> - <argument index="2" name="weight" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="shape" type="int" /> + <argument index="2" name="weight" type="float" /> <description> Sets the weight for a given blend shape associated with this instance. </description> </method> <method name="instance_set_custom_aabb"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="aabb" type="AABB"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="aabb" type="AABB" /> <description> Sets a custom AABB to use when culling objects from the view frustum. Equivalent to [method GeometryInstance3D.set_custom_aabb]. </description> </method> - <method name="instance_set_exterior"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <method name="instance_set_extra_visibility_margin"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="margin" type="float" /> <description> - Function not implemented in Godot 3.x. + Sets a margin to increase the size of the AABB when culling objects from the view frustum. This allows you to avoid culling objects that fall outside the view frustum. Equivalent to [member GeometryInstance3D.extra_cull_margin]. </description> </method> - <method name="instance_set_extra_visibility_margin"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="margin" type="float"> - </argument> + <method name="instance_set_ignore_culling"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="enabled" type="bool" /> <description> - Sets a margin to increase the size of the AABB when culling objects from the view frustum. This allows you avoid culling objects that fall outside the view frustum. Equivalent to [member GeometryInstance3D.extra_cull_margin]. </description> </method> <method name="instance_set_layer_mask"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="mask" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="mask" type="int" /> <description> Sets the render layers that this instance will be drawn to. Equivalent to [member VisualInstance3D.layers]. </description> </method> <method name="instance_set_scenario"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="scenario" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="scenario" type="RID" /> <description> Sets the scenario that the instance is in. The scenario is the 3D world that the objects will be displayed in. </description> </method> - <method name="instance_set_surface_material"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="surface" type="int"> - </argument> - <argument index="2" name="material" type="RID"> - </argument> + <method name="instance_set_surface_override_material"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="surface" type="int" /> + <argument index="2" name="material" type="RID" /> <description> - Sets the material of a specific surface. Equivalent to [method MeshInstance3D.set_surface_material]. + Sets the override material of a specific surface. Equivalent to [method MeshInstance3D.set_surface_override_material]. </description> </method> <method name="instance_set_transform"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="transform" type="Transform"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="transform" type="Transform3D" /> <description> Sets the world space transform of the instance. Equivalent to [member Node3D.transform]. </description> </method> + <method name="instance_set_visibility_parent"> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="parent" type="RID" /> + <description> + Sets the visibility parent for the given instance. Equivalent to [member Node3D.visibility_parent]. + </description> + </method> <method name="instance_set_visible"> - <return type="void"> - </return> - <argument index="0" name="instance" type="RID"> - </argument> - <argument index="1" name="visible" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="instance" type="RID" /> + <argument index="1" name="visible" type="bool" /> <description> Sets whether an instance is drawn or not. Equivalent to [member Node3D.visible]. </description> </method> <method name="instances_cull_aabb" qualifiers="const"> - <return type="Array"> - </return> - <argument index="0" name="aabb" type="AABB"> - </argument> - <argument index="1" name="scenario" type="RID"> - </argument> - <description> - Returns an array of object IDs intersecting with the provided AABB. Only visual 3D nodes are considered, such as [MeshInstance3D] or [DirectionalLight3D]. Use [method @GDScript.instance_from_id] to obtain the actual nodes. A scenario RID must be provided, which is available in the [World3D] you want to query. This forces an update for all resources queued to update. + <return type="Array" /> + <argument index="0" name="aabb" type="AABB" /> + <argument index="1" name="scenario" type="RID" /> + <description> + Returns an array of object IDs intersecting with the provided AABB. Only visual 3D nodes are considered, such as [MeshInstance3D] or [DirectionalLight3D]. Use [method @GlobalScope.instance_from_id] to obtain the actual nodes. A scenario RID must be provided, which is available in the [World3D] you want to query. This forces an update for all resources queued to update. [b]Warning:[/b] This function is primarily intended for editor usage. For in-game use cases, prefer physics collision. </description> </method> <method name="instances_cull_convex" qualifiers="const"> - <return type="Array"> - </return> - <argument index="0" name="convex" type="Array"> - </argument> - <argument index="1" name="scenario" type="RID"> - </argument> - <description> - Returns an array of object IDs intersecting with the provided convex shape. Only visual 3D nodes are considered, such as [MeshInstance3D] or [DirectionalLight3D]. Use [method @GDScript.instance_from_id] to obtain the actual nodes. A scenario RID must be provided, which is available in the [World3D] you want to query. This forces an update for all resources queued to update. + <return type="Array" /> + <argument index="0" name="convex" type="Array" /> + <argument index="1" name="scenario" type="RID" /> + <description> + Returns an array of object IDs intersecting with the provided convex shape. Only visual 3D nodes are considered, such as [MeshInstance3D] or [DirectionalLight3D]. Use [method @GlobalScope.instance_from_id] to obtain the actual nodes. A scenario RID must be provided, which is available in the [World3D] you want to query. This forces an update for all resources queued to update. [b]Warning:[/b] This function is primarily intended for editor usage. For in-game use cases, prefer physics collision. </description> </method> <method name="instances_cull_ray" qualifiers="const"> - <return type="Array"> - </return> - <argument index="0" name="from" type="Vector3"> - </argument> - <argument index="1" name="to" type="Vector3"> - </argument> - <argument index="2" name="scenario" type="RID"> - </argument> - <description> - Returns an array of object IDs intersecting with the provided 3D ray. Only visual 3D nodes are considered, such as [MeshInstance3D] or [DirectionalLight3D]. Use [method @GDScript.instance_from_id] to obtain the actual nodes. A scenario RID must be provided, which is available in the [World3D] you want to query. This forces an update for all resources queued to update. + <return type="Array" /> + <argument index="0" name="from" type="Vector3" /> + <argument index="1" name="to" type="Vector3" /> + <argument index="2" name="scenario" type="RID" /> + <description> + Returns an array of object IDs intersecting with the provided 3D ray. Only visual 3D nodes are considered, such as [MeshInstance3D] or [DirectionalLight3D]. Use [method @GlobalScope.instance_from_id] to obtain the actual nodes. A scenario RID must be provided, which is available in the [World3D] you want to query. This forces an update for all resources queued to update. [b]Warning:[/b] This function is primarily intended for editor usage. For in-game use cases, prefer physics collision. </description> </method> <method name="light_directional_set_blend_splits"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="enable" type="bool" /> <description> If [code]true[/code], this directional light will blend between shadow map splits resulting in a smoother transition between them. Equivalent to [member DirectionalLight3D.directional_shadow_blend_splits]. </description> </method> - <method name="light_directional_set_shadow_depth_range_mode"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="range_mode" type="int" enum="RenderingServer.LightDirectionalShadowDepthRangeMode"> - </argument> + <method name="light_directional_set_shadow_mode"> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.LightDirectionalShadowMode" /> <description> - Sets the shadow depth range mode for this directional light. Equivalent to [member DirectionalLight3D.directional_shadow_depth_range]. See [enum LightDirectionalShadowDepthRangeMode] for options. + Sets the shadow mode for this directional light. Equivalent to [member DirectionalLight3D.directional_shadow_mode]. See [enum LightDirectionalShadowMode] for options. </description> </method> - <method name="light_directional_set_shadow_mode"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="mode" type="int" enum="RenderingServer.LightDirectionalShadowMode"> - </argument> + <method name="light_directional_set_sky_only"> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="enable" type="bool" /> <description> - Sets the shadow mode for this directional light. Equivalent to [member DirectionalLight3D.directional_shadow_mode]. See [enum LightDirectionalShadowMode] for options. + If [code]true[/code], this light will not be used for anything except sky shaders. Use this for lights that impact your sky shader that you may want to hide from affecting the rest of the scene. For example, you may want to enable this when the sun in your sky shader falls below the horizon. </description> </method> <method name="light_omni_set_shadow_mode"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="mode" type="int" enum="RenderingServer.LightOmniShadowMode"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.LightOmniShadowMode" /> <description> Sets whether to use a dual paraboloid or a cubemap for the shadow map. Dual paraboloid is faster but may suffer from artifacts. Equivalent to [member OmniLight3D.omni_shadow_mode]. </description> </method> + <method name="light_projectors_set_filter"> + <return type="void" /> + <argument index="0" name="filter" type="int" enum="RenderingServer.LightProjectorFilter" /> + <description> + </description> + </method> + <method name="light_set_bake_mode"> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="bake_mode" type="int" enum="RenderingServer.LightBakeMode" /> + <description> + </description> + </method> <method name="light_set_color"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="color" type="Color"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="color" type="Color" /> <description> Sets the color of the light. Equivalent to [member Light3D.light_color]. </description> </method> <method name="light_set_cull_mask"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="mask" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="mask" type="int" /> <description> Sets the cull mask for this Light3D. Lights only affect objects in the selected layers. Equivalent to [member Light3D.light_cull_mask]. </description> </method> + <method name="light_set_max_sdfgi_cascade"> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="cascade" type="int" /> + <description> + </description> + </method> <method name="light_set_negative"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="enable" type="bool" /> <description> If [code]true[/code], light will subtract light instead of adding light. Equivalent to [member Light3D.light_negative]. </description> </method> <method name="light_set_param"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="param" type="int" enum="RenderingServer.LightParam"> - </argument> - <argument index="2" name="value" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="param" type="int" enum="RenderingServer.LightParam" /> + <argument index="2" name="value" type="float" /> <description> Sets the specified light parameter. See [enum LightParam] for options. Equivalent to [method Light3D.set_param]. </description> </method> <method name="light_set_projector"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="texture" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="texture" type="RID" /> <description> Not implemented in Godot 3.x. </description> </method> <method name="light_set_reverse_cull_face_mode"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="enabled" type="bool" /> <description> - If [code]true[/code], reverses the backface culling of the mesh. This can be useful when you have a flat mesh that has a light behind it. If you need to cast a shadow on both sides of the mesh, set the mesh to use double sided shadows with [method instance_geometry_set_cast_shadows_setting]. Equivalent to [member Light3D.shadow_reverse_cull_face]. + If [code]true[/code], reverses the backface culling of the mesh. This can be useful when you have a flat mesh that has a light behind it. If you need to cast a shadow on both sides of the mesh, set the mesh to use double-sided shadows with [method instance_geometry_set_cast_shadows_setting]. Equivalent to [member Light3D.shadow_reverse_cull_face]. </description> </method> <method name="light_set_shadow"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="enabled" type="bool" /> <description> If [code]true[/code], light will cast shadows. Equivalent to [member Light3D.shadow_enabled]. </description> </method> <method name="light_set_shadow_color"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="color" type="Color"> - </argument> + <return type="void" /> + <argument index="0" name="light" type="RID" /> + <argument index="1" name="color" type="Color" /> <description> Sets the color of the shadow cast by the light. Equivalent to [member Light3D.shadow_color]. </description> </method> - <method name="light_set_use_gi"> - <return type="void"> - </return> - <argument index="0" name="light" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <method name="lightmap_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="lightmap_get_probe_capture_bsp_tree" qualifiers="const"> + <return type="PackedInt32Array" /> + <argument index="0" name="lightmap" type="RID" /> + <description> + </description> + </method> + <method name="lightmap_get_probe_capture_points" qualifiers="const"> + <return type="PackedVector3Array" /> + <argument index="0" name="lightmap" type="RID" /> + <description> + </description> + </method> + <method name="lightmap_get_probe_capture_sh" qualifiers="const"> + <return type="PackedColorArray" /> + <argument index="0" name="lightmap" type="RID" /> + <description> + </description> + </method> + <method name="lightmap_get_probe_capture_tetrahedra" qualifiers="const"> + <return type="PackedInt32Array" /> + <argument index="0" name="lightmap" type="RID" /> + <description> + </description> + </method> + <method name="lightmap_set_probe_bounds"> + <return type="void" /> + <argument index="0" name="lightmap" type="RID" /> + <argument index="1" name="bounds" type="AABB" /> + <description> + </description> + </method> + <method name="lightmap_set_probe_capture_data"> + <return type="void" /> + <argument index="0" name="lightmap" type="RID" /> + <argument index="1" name="points" type="PackedVector3Array" /> + <argument index="2" name="point_sh" type="PackedColorArray" /> + <argument index="3" name="tetrahedra" type="PackedInt32Array" /> + <argument index="4" name="bsp_tree" type="PackedInt32Array" /> + <description> + </description> + </method> + <method name="lightmap_set_probe_capture_update_speed"> + <return type="void" /> + <argument index="0" name="speed" type="float" /> + <description> + </description> + </method> + <method name="lightmap_set_probe_interior"> + <return type="void" /> + <argument index="0" name="lightmap" type="RID" /> + <argument index="1" name="interior" type="bool" /> + <description> + </description> + </method> + <method name="lightmap_set_textures"> + <return type="void" /> + <argument index="0" name="lightmap" type="RID" /> + <argument index="1" name="light" type="RID" /> + <argument index="2" name="uses_sh" type="bool" /> <description> - Sets whether GI probes capture light information from this light. </description> </method> <method name="make_sphere_mesh"> - <return type="RID"> - </return> - <argument index="0" name="latitudes" type="int"> - </argument> - <argument index="1" name="longitudes" type="int"> - </argument> - <argument index="2" name="radius" type="float"> - </argument> + <return type="RID" /> + <argument index="0" name="latitudes" type="int" /> + <argument index="1" name="longitudes" type="int" /> + <argument index="2" name="radius" type="float" /> <description> Returns a mesh of a sphere with the given amount of horizontal and vertical subdivisions. </description> </method> <method name="material_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates an empty material and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]material_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> <method name="material_get_param" qualifiers="const"> - <return type="Variant"> - </return> - <argument index="0" name="material" type="RID"> - </argument> - <argument index="1" name="parameter" type="StringName"> - </argument> + <return type="Variant" /> + <argument index="0" name="material" type="RID" /> + <argument index="1" name="parameter" type="StringName" /> <description> Returns the value of a certain material's parameter. </description> </method> <method name="material_set_next_pass"> - <return type="void"> - </return> - <argument index="0" name="material" type="RID"> - </argument> - <argument index="1" name="next_material" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="material" type="RID" /> + <argument index="1" name="next_material" type="RID" /> <description> Sets an object's next material. </description> </method> <method name="material_set_param"> - <return type="void"> - </return> - <argument index="0" name="material" type="RID"> - </argument> - <argument index="1" name="parameter" type="StringName"> - </argument> - <argument index="2" name="value" type="Variant"> - </argument> + <return type="void" /> + <argument index="0" name="material" type="RID" /> + <argument index="1" name="parameter" type="StringName" /> + <argument index="2" name="value" type="Variant" /> <description> Sets a material's parameter. </description> </method> <method name="material_set_render_priority"> - <return type="void"> - </return> - <argument index="0" name="material" type="RID"> - </argument> - <argument index="1" name="priority" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="material" type="RID" /> + <argument index="1" name="priority" type="int" /> <description> Sets a material's render priority. </description> </method> <method name="material_set_shader"> - <return type="void"> - </return> - <argument index="0" name="shader_material" type="RID"> - </argument> - <argument index="1" name="shader" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="shader_material" type="RID" /> + <argument index="1" name="shader" type="RID" /> <description> Sets a shader material's shader. </description> </method> + <method name="mesh_add_surface"> + <return type="void" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="surface" type="Dictionary" /> + <description> + </description> + </method> <method name="mesh_add_surface_from_arrays"> - <return type="void"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> - <argument index="1" name="primitive" type="int" enum="RenderingServer.PrimitiveType"> - </argument> - <argument index="2" name="arrays" type="Array"> - </argument> - <argument index="3" name="blend_shapes" type="Array" default="[ ]"> - </argument> + <return type="void" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="primitive" type="int" enum="RenderingServer.PrimitiveType" /> + <argument index="2" name="arrays" type="Array" /> + <argument index="3" name="blend_shapes" type="Array" default="[]" /> <argument index="4" name="lods" type="Dictionary" default="{ - -}"> - </argument> - <argument index="5" name="compress_format" type="int" default="31744"> - </argument> +}" /> + <argument index="5" name="compress_format" type="int" default="0" /> <description> </description> </method> <method name="mesh_clear"> - <return type="void"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="mesh" type="RID" /> <description> Removes all surfaces from a mesh. </description> </method> <method name="mesh_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a new mesh and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]mesh_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. To place in a scene, attach this mesh to an instance using [method instance_set_base] using the returned RID. </description> </method> + <method name="mesh_create_from_surfaces"> + <return type="RID" /> + <argument index="0" name="surfaces" type="Dictionary[]" /> + <argument index="1" name="blend_shape_count" type="int" default="0" /> + <description> + </description> + </method> <method name="mesh_get_blend_shape_count" qualifiers="const"> - <return type="int"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> + <return type="int" /> + <argument index="0" name="mesh" type="RID" /> <description> Returns a mesh's blend shape count. </description> </method> <method name="mesh_get_blend_shape_mode" qualifiers="const"> - <return type="int" enum="RenderingServer.BlendShapeMode"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> + <return type="int" enum="RenderingServer.BlendShapeMode" /> + <argument index="0" name="mesh" type="RID" /> <description> Returns a mesh's blend shape mode. </description> </method> <method name="mesh_get_custom_aabb" qualifiers="const"> - <return type="AABB"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> + <return type="AABB" /> + <argument index="0" name="mesh" type="RID" /> <description> Returns a mesh's custom aabb. </description> </method> + <method name="mesh_get_surface"> + <return type="Dictionary" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="surface" type="int" /> + <description> + </description> + </method> <method name="mesh_get_surface_count" qualifiers="const"> - <return type="int"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> + <return type="int" /> + <argument index="0" name="mesh" type="RID" /> <description> Returns a mesh's number of surfaces. </description> </method> <method name="mesh_set_blend_shape_mode"> - <return type="void"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> - <argument index="1" name="mode" type="int" enum="RenderingServer.BlendShapeMode"> - </argument> + <return type="void" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.BlendShapeMode" /> <description> Sets a mesh's blend shape mode. </description> </method> <method name="mesh_set_custom_aabb"> - <return type="void"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> - <argument index="1" name="aabb" type="AABB"> - </argument> + <return type="void" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="aabb" type="AABB" /> <description> Sets a mesh's custom aabb. </description> </method> + <method name="mesh_set_shadow_mesh"> + <return type="void" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="shadow_mesh" type="RID" /> + <description> + </description> + </method> <method name="mesh_surface_get_arrays" qualifiers="const"> - <return type="Array"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> - <argument index="1" name="surface" type="int"> - </argument> + <return type="Array" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="surface" type="int" /> <description> Returns a mesh's surface's buffer arrays. </description> </method> <method name="mesh_surface_get_blend_shape_arrays" qualifiers="const"> - <return type="Array"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> - <argument index="1" name="surface" type="int"> - </argument> + <return type="Array" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="surface" type="int" /> <description> Returns a mesh's surface's arrays for blend shapes. </description> </method> + <method name="mesh_surface_get_format_attribute_stride" qualifiers="const"> + <return type="int" /> + <argument index="0" name="format" type="int" /> + <argument index="1" name="vertex_count" type="int" /> + <description> + </description> + </method> <method name="mesh_surface_get_format_offset" qualifiers="const"> - <return type="int"> - </return> - <argument index="0" name="format" type="int"> - </argument> - <argument index="1" name="vertex_len" type="int"> - </argument> - <argument index="2" name="index_len" type="int"> - </argument> - <argument index="3" name="array_index" type="int"> - </argument> + <return type="int" /> + <argument index="0" name="format" type="int" /> + <argument index="1" name="vertex_count" type="int" /> + <argument index="2" name="array_index" type="int" /> + <description> + </description> + </method> + <method name="mesh_surface_get_format_skin_stride" qualifiers="const"> + <return type="int" /> + <argument index="0" name="format" type="int" /> + <argument index="1" name="vertex_count" type="int" /> <description> - Function is unused in Godot 3.x. </description> </method> - <method name="mesh_surface_get_format_stride" qualifiers="const"> - <return type="int"> - </return> - <argument index="0" name="format" type="int"> - </argument> - <argument index="1" name="vertex_len" type="int"> - </argument> - <argument index="2" name="index_len" type="int"> - </argument> + <method name="mesh_surface_get_format_vertex_stride" qualifiers="const"> + <return type="int" /> + <argument index="0" name="format" type="int" /> + <argument index="1" name="vertex_count" type="int" /> <description> - Function is unused in Godot 3.x. </description> </method> <method name="mesh_surface_get_material" qualifiers="const"> - <return type="RID"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> - <argument index="1" name="surface" type="int"> - </argument> + <return type="RID" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="surface" type="int" /> <description> Returns a mesh's surface's material. </description> </method> <method name="mesh_surface_set_material"> - <return type="void"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> - <argument index="1" name="surface" type="int"> - </argument> - <argument index="2" name="material" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="surface" type="int" /> + <argument index="2" name="material" type="RID" /> <description> Sets a mesh's surface's material. </description> </method> - <method name="mesh_surface_update_region"> - <return type="void"> - </return> - <argument index="0" name="mesh" type="RID"> - </argument> - <argument index="1" name="surface" type="int"> - </argument> - <argument index="2" name="offset" type="int"> - </argument> - <argument index="3" name="data" type="PackedByteArray"> - </argument> + <method name="mesh_surface_update_attribute_region"> + <return type="void" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="surface" type="int" /> + <argument index="2" name="offset" type="int" /> + <argument index="3" name="data" type="PackedByteArray" /> <description> - Updates a specific region of a vertex buffer for the specified surface. Warning: this function alters the vertex buffer directly with no safety mechanisms, you can easily corrupt your mesh. </description> </method> - <method name="multimesh_allocate"> - <return type="void"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="instances" type="int"> - </argument> - <argument index="2" name="transform_format" type="int" enum="RenderingServer.MultimeshTransformFormat"> - </argument> - <argument index="3" name="color_format" type="bool" default="false"> - </argument> - <argument index="4" name="custom_data_format" type="bool" default="false"> - </argument> + <method name="mesh_surface_update_skin_region"> + <return type="void" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="surface" type="int" /> + <argument index="2" name="offset" type="int" /> + <argument index="3" name="data" type="PackedByteArray" /> + <description> + </description> + </method> + <method name="mesh_surface_update_vertex_region"> + <return type="void" /> + <argument index="0" name="mesh" type="RID" /> + <argument index="1" name="surface" type="int" /> + <argument index="2" name="offset" type="int" /> + <argument index="3" name="data" type="PackedByteArray" /> + <description> + </description> + </method> + <method name="multimesh_allocate_data"> + <return type="void" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="instances" type="int" /> + <argument index="2" name="transform_format" type="int" enum="RenderingServer.MultimeshTransformFormat" /> + <argument index="3" name="color_format" type="bool" default="false" /> + <argument index="4" name="custom_data_format" type="bool" default="false" /> <description> </description> </method> <method name="multimesh_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a new multimesh on the RenderingServer and returns an [RID] handle. This RID will be used in all [code]multimesh_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. @@ -1860,1155 +2032,1431 @@ </description> </method> <method name="multimesh_get_aabb" qualifiers="const"> - <return type="AABB"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> + <return type="AABB" /> + <argument index="0" name="multimesh" type="RID" /> <description> Calculates and returns the axis-aligned bounding box that encloses all instances within the multimesh. </description> </method> <method name="multimesh_get_buffer" qualifiers="const"> - <return type="PackedFloat32Array"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> + <return type="PackedFloat32Array" /> + <argument index="0" name="multimesh" type="RID" /> <description> </description> </method> <method name="multimesh_get_instance_count" qualifiers="const"> - <return type="int"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> + <return type="int" /> + <argument index="0" name="multimesh" type="RID" /> <description> Returns the number of instances allocated for this multimesh. </description> </method> <method name="multimesh_get_mesh" qualifiers="const"> - <return type="RID"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> + <return type="RID" /> + <argument index="0" name="multimesh" type="RID" /> <description> Returns the RID of the mesh that will be used in drawing this multimesh. </description> </method> <method name="multimesh_get_visible_instances" qualifiers="const"> - <return type="int"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> + <return type="int" /> + <argument index="0" name="multimesh" type="RID" /> <description> Returns the number of visible instances for this multimesh. </description> </method> <method name="multimesh_instance_get_color" qualifiers="const"> - <return type="Color"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="index" type="int"> - </argument> + <return type="Color" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="index" type="int" /> <description> Returns the color by which the specified instance will be modulated. </description> </method> <method name="multimesh_instance_get_custom_data" qualifiers="const"> - <return type="Color"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="index" type="int"> - </argument> + <return type="Color" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="index" type="int" /> <description> Returns the custom data associated with the specified instance. </description> </method> <method name="multimesh_instance_get_transform" qualifiers="const"> - <return type="Transform"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="index" type="int"> - </argument> + <return type="Transform3D" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="index" type="int" /> <description> - Returns the [Transform] of the specified instance. + Returns the [Transform3D] of the specified instance. </description> </method> <method name="multimesh_instance_get_transform_2d" qualifiers="const"> - <return type="Transform2D"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="index" type="int"> - </argument> + <return type="Transform2D" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="index" type="int" /> <description> Returns the [Transform2D] of the specified instance. For use when the multimesh is set to use 2D transforms. </description> </method> <method name="multimesh_instance_set_color"> - <return type="void"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="index" type="int"> - </argument> - <argument index="2" name="color" type="Color"> - </argument> + <return type="void" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="index" type="int" /> + <argument index="2" name="color" type="Color" /> <description> Sets the color by which this instance will be modulated. Equivalent to [method MultiMesh.set_instance_color]. </description> </method> <method name="multimesh_instance_set_custom_data"> - <return type="void"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="index" type="int"> - </argument> - <argument index="2" name="custom_data" type="Color"> - </argument> + <return type="void" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="index" type="int" /> + <argument index="2" name="custom_data" type="Color" /> <description> Sets the custom data for this instance. Custom data is passed as a [Color], but is interpreted as a [code]vec4[/code] in the shader. Equivalent to [method MultiMesh.set_instance_custom_data]. </description> </method> <method name="multimesh_instance_set_transform"> - <return type="void"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="index" type="int"> - </argument> - <argument index="2" name="transform" type="Transform"> - </argument> + <return type="void" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="index" type="int" /> + <argument index="2" name="transform" type="Transform3D" /> <description> - Sets the [Transform] for this instance. Equivalent to [method MultiMesh.set_instance_transform]. + Sets the [Transform3D] for this instance. Equivalent to [method MultiMesh.set_instance_transform]. </description> </method> <method name="multimesh_instance_set_transform_2d"> - <return type="void"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="index" type="int"> - </argument> - <argument index="2" name="transform" type="Transform2D"> - </argument> + <return type="void" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="index" type="int" /> + <argument index="2" name="transform" type="Transform2D" /> <description> Sets the [Transform2D] for this instance. For use when multimesh is used in 2D. Equivalent to [method MultiMesh.set_instance_transform_2d]. </description> </method> <method name="multimesh_set_buffer"> - <return type="void"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="buffer" type="PackedFloat32Array"> - </argument> + <return type="void" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="buffer" type="PackedFloat32Array" /> <description> </description> </method> <method name="multimesh_set_mesh"> - <return type="void"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="mesh" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="mesh" type="RID" /> <description> Sets the mesh to be drawn by the multimesh. Equivalent to [member MultiMesh.mesh]. </description> </method> <method name="multimesh_set_visible_instances"> - <return type="void"> - </return> - <argument index="0" name="multimesh" type="RID"> - </argument> - <argument index="1" name="visible" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="multimesh" type="RID" /> + <argument index="1" name="visible" type="int" /> <description> Sets the number of instances visible at a given time. If -1, all instances that have been allocated are drawn. Equivalent to [member MultiMesh.visible_instance_count]. </description> </method> + <method name="occluder_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="occluder_set_mesh"> + <return type="void" /> + <argument index="0" name="occluder" type="RID" /> + <argument index="1" name="vertices" type="PackedVector3Array" /> + <argument index="2" name="indices" type="PackedInt32Array" /> + <description> + </description> + </method> <method name="omni_light_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a new omni light and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID can be used in most [code]light_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. To place in a scene, attach this omni light to an instance using [method instance_set_base] using the returned RID. </description> </method> + <method name="particles_collision_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="particles_collision_height_field_update"> + <return type="void" /> + <argument index="0" name="particles_collision" type="RID" /> + <description> + </description> + </method> + <method name="particles_collision_set_attractor_attenuation"> + <return type="void" /> + <argument index="0" name="particles_collision" type="RID" /> + <argument index="1" name="curve" type="float" /> + <description> + </description> + </method> + <method name="particles_collision_set_attractor_directionality"> + <return type="void" /> + <argument index="0" name="particles_collision" type="RID" /> + <argument index="1" name="amount" type="float" /> + <description> + </description> + </method> + <method name="particles_collision_set_attractor_strength"> + <return type="void" /> + <argument index="0" name="particles_collision" type="RID" /> + <argument index="1" name="setrngth" type="float" /> + <description> + </description> + </method> + <method name="particles_collision_set_box_extents"> + <return type="void" /> + <argument index="0" name="particles_collision" type="RID" /> + <argument index="1" name="extents" type="Vector3" /> + <description> + </description> + </method> + <method name="particles_collision_set_collision_type"> + <return type="void" /> + <argument index="0" name="particles_collision" type="RID" /> + <argument index="1" name="type" type="int" enum="RenderingServer.ParticlesCollisionType" /> + <description> + </description> + </method> + <method name="particles_collision_set_cull_mask"> + <return type="void" /> + <argument index="0" name="particles_collision" type="RID" /> + <argument index="1" name="mask" type="int" /> + <description> + </description> + </method> + <method name="particles_collision_set_field_texture"> + <return type="void" /> + <argument index="0" name="particles_collision" type="RID" /> + <argument index="1" name="texture" type="RID" /> + <description> + </description> + </method> + <method name="particles_collision_set_height_field_resolution"> + <return type="void" /> + <argument index="0" name="particles_collision" type="RID" /> + <argument index="1" name="resolution" type="int" enum="RenderingServer.ParticlesCollisionHeightfieldResolution" /> + <description> + </description> + </method> + <method name="particles_collision_set_sphere_radius"> + <return type="void" /> + <argument index="0" name="particles_collision" type="RID" /> + <argument index="1" name="radius" type="float" /> + <description> + </description> + </method> <method name="particles_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a particle system and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]particles_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. To place in a scene, attach these particles to an instance using [method instance_set_base] using the returned RID. </description> </method> + <method name="particles_emit"> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="transform" type="Transform3D" /> + <argument index="2" name="velocity" type="Vector3" /> + <argument index="3" name="color" type="Color" /> + <argument index="4" name="custom" type="Color" /> + <argument index="5" name="emit_flags" type="int" /> + <description> + </description> + </method> <method name="particles_get_current_aabb"> - <return type="AABB"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> + <return type="AABB" /> + <argument index="0" name="particles" type="RID" /> <description> Calculates and returns the axis-aligned bounding box that contains all the particles. Equivalent to [method GPUParticles3D.capture_aabb]. </description> </method> <method name="particles_get_emitting"> - <return type="bool"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> + <return type="bool" /> + <argument index="0" name="particles" type="RID" /> <description> Returns [code]true[/code] if particles are currently set to emitting. </description> </method> <method name="particles_is_inactive"> - <return type="bool"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> + <return type="bool" /> + <argument index="0" name="particles" type="RID" /> <description> Returns [code]true[/code] if particles are not emitting and particles are set to inactive. </description> </method> <method name="particles_request_process"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> <description> Add particle system to list of particle systems that need to be updated. Update will take place on the next frame, or on the next call to [method instances_cull_aabb], [method instances_cull_convex], or [method instances_cull_ray]. </description> </method> <method name="particles_restart"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> <description> Reset the particles on the next update. Equivalent to [method GPUParticles3D.restart]. </description> </method> <method name="particles_set_amount"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="amount" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="amount" type="int" /> <description> Sets the number of particles to be drawn and allocates the memory for them. Equivalent to [member GPUParticles3D.amount]. </description> </method> + <method name="particles_set_collision_base_size"> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="size" type="float" /> + <description> + </description> + </method> <method name="particles_set_custom_aabb"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="aabb" type="AABB"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="aabb" type="AABB" /> <description> Sets a custom axis-aligned bounding box for the particle system. Equivalent to [member GPUParticles3D.visibility_aabb]. </description> </method> <method name="particles_set_draw_order"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="order" type="int" enum="RenderingServer.ParticlesDrawOrder"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="order" type="int" enum="RenderingServer.ParticlesDrawOrder" /> <description> Sets the draw order of the particles to one of the named enums from [enum ParticlesDrawOrder]. See [enum ParticlesDrawOrder] for options. Equivalent to [member GPUParticles3D.draw_order]. </description> </method> <method name="particles_set_draw_pass_mesh"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="pass" type="int"> - </argument> - <argument index="2" name="mesh" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="pass" type="int" /> + <argument index="2" name="mesh" type="RID" /> <description> Sets the mesh to be used for the specified draw pass. Equivalent to [member GPUParticles3D.draw_pass_1], [member GPUParticles3D.draw_pass_2], [member GPUParticles3D.draw_pass_3], and [member GPUParticles3D.draw_pass_4]. </description> </method> <method name="particles_set_draw_passes"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="count" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="count" type="int" /> <description> Sets the number of draw passes to use. Equivalent to [member GPUParticles3D.draw_passes]. </description> </method> <method name="particles_set_emission_transform"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="transform" type="Transform"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="transform" type="Transform3D" /> <description> - Sets the [Transform] that will be used by the particles when they first emit. + Sets the [Transform3D] that will be used by the particles when they first emit. </description> </method> <method name="particles_set_emitting"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="emitting" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="emitting" type="bool" /> <description> If [code]true[/code], particles will emit over time. Setting to false does not reset the particles, but only stops their emission. Equivalent to [member GPUParticles3D.emitting]. </description> </method> <method name="particles_set_explosiveness_ratio"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="ratio" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="ratio" type="float" /> <description> Sets the explosiveness ratio. Equivalent to [member GPUParticles3D.explosiveness]. </description> </method> <method name="particles_set_fixed_fps"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="fps" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="fps" type="int" /> <description> Sets the frame rate that the particle system rendering will be fixed to. Equivalent to [member GPUParticles3D.fixed_fps]. </description> </method> <method name="particles_set_fractional_delta"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="enable" type="bool" /> <description> If [code]true[/code], uses fractional delta which smooths the movement of the particles. Equivalent to [member GPUParticles3D.fract_delta]. </description> </method> + <method name="particles_set_interpolate"> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <description> + </description> + </method> <method name="particles_set_lifetime"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="lifetime" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="lifetime" type="float" /> <description> Sets the lifetime of each particle in the system. Equivalent to [member GPUParticles3D.lifetime]. </description> </method> + <method name="particles_set_mode"> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.ParticlesMode" /> + <description> + </description> + </method> <method name="particles_set_one_shot"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="one_shot" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="one_shot" type="bool" /> <description> If [code]true[/code], particles will emit once and then stop. Equivalent to [member GPUParticles3D.one_shot]. </description> </method> <method name="particles_set_pre_process_time"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="time" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="time" type="float" /> <description> - Sets the preprocess time for the particles animation. This lets you delay starting an animation until after the particles have begun emitting. Equivalent to [member GPUParticles3D.preprocess]. + Sets the preprocess time for the particles' animation. This lets you delay starting an animation until after the particles have begun emitting. Equivalent to [member GPUParticles3D.preprocess]. </description> </method> <method name="particles_set_process_material"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="material" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="material" type="RID" /> <description> - Sets the material for processing the particles. Note: this is not the material used to draw the materials. Equivalent to [member GPUParticles3D.process_material]. + Sets the material for processing the particles. + [b]Note:[/b] This is not the material used to draw the materials. Equivalent to [member GPUParticles3D.process_material]. </description> </method> <method name="particles_set_randomness_ratio"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="ratio" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="ratio" type="float" /> <description> Sets the emission randomness ratio. This randomizes the emission of particles within their phase. Equivalent to [member GPUParticles3D.randomness]. </description> </method> <method name="particles_set_speed_scale"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="scale" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="scale" type="float" /> <description> Sets the speed scale of the particle system. Equivalent to [member GPUParticles3D.speed_scale]. </description> </method> + <method name="particles_set_subemitter"> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="subemitter_particles" type="RID" /> + <description> + </description> + </method> + <method name="particles_set_trail_bind_poses"> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="bind_poses" type="Transform3D[]" /> + <description> + </description> + </method> + <method name="particles_set_trails"> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <argument index="2" name="length_sec" type="float" /> + <description> + </description> + </method> + <method name="particles_set_transform_align"> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="align" type="int" enum="RenderingServer.ParticlesTransformAlign" /> + <description> + </description> + </method> <method name="particles_set_use_local_coordinates"> - <return type="void"> - </return> - <argument index="0" name="particles" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="particles" type="RID" /> + <argument index="1" name="enable" type="bool" /> <description> If [code]true[/code], particles use local coordinates. If [code]false[/code] they use global coordinates. Equivalent to [member GPUParticles3D.local_coords]. </description> </method> <method name="reflection_probe_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a reflection probe and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]reflection_probe_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. To place in a scene, attach this reflection probe to an instance using [method instance_set_base] using the returned RID. </description> </method> + <method name="reflection_probe_set_ambient_color"> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="color" type="Color" /> + <description> + </description> + </method> + <method name="reflection_probe_set_ambient_energy"> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="energy" type="float" /> + <description> + </description> + </method> + <method name="reflection_probe_set_ambient_mode"> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.ReflectionProbeAmbientMode" /> + <description> + </description> + </method> <method name="reflection_probe_set_as_interior"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="enable" type="bool" /> <description> - If [code]true[/code], reflections will ignore sky contribution. Equivalent to [member ReflectionProbe.interior_enable]. + If [code]true[/code], reflections will ignore sky contribution. Equivalent to [member ReflectionProbe.interior]. </description> </method> <method name="reflection_probe_set_cull_mask"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="layers" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="layers" type="int" /> <description> Sets the render cull mask for this reflection probe. Only instances with a matching cull mask will be rendered by this probe. Equivalent to [member ReflectionProbe.cull_mask]. </description> </method> <method name="reflection_probe_set_enable_box_projection"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="enable" type="bool" /> <description> If [code]true[/code], uses box projection. This can make reflections look more correct in certain situations. Equivalent to [member ReflectionProbe.box_projection]. </description> </method> <method name="reflection_probe_set_enable_shadows"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="enable" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="enable" type="bool" /> <description> If [code]true[/code], computes shadows in the reflection probe. This makes the reflection much slower to compute. Equivalent to [member ReflectionProbe.enable_shadows]. </description> </method> <method name="reflection_probe_set_extents"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="extents" type="Vector3"> - </argument> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="extents" type="Vector3" /> <description> Sets the size of the area that the reflection probe will capture. Equivalent to [member ReflectionProbe.extents]. </description> </method> <method name="reflection_probe_set_intensity"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="intensity" type="float"> - </argument> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="intensity" type="float" /> <description> Sets the intensity of the reflection probe. Intensity modulates the strength of the reflection. Equivalent to [member ReflectionProbe.intensity]. </description> </method> - <method name="reflection_probe_set_interior_ambient"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="color" type="Color"> - </argument> - <description> - Sets the ambient light color for this reflection probe when set to interior mode. Equivalent to [member ReflectionProbe.interior_ambient_color]. - </description> - </method> - <method name="reflection_probe_set_interior_ambient_energy"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="energy" type="float"> - </argument> + <method name="reflection_probe_set_max_distance"> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="distance" type="float" /> <description> - Sets the energy multiplier for this reflection probes ambient light contribution when set to interior mode. Equivalent to [member ReflectionProbe.interior_ambient_energy]. + Sets the max distance away from the probe an object can be before it is culled. Equivalent to [member ReflectionProbe.max_distance]. </description> </method> - <method name="reflection_probe_set_interior_ambient_probe_contribution"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="contrib" type="float"> - </argument> + <method name="reflection_probe_set_mesh_lod_threshold"> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="pixels" type="float" /> <description> - Sets the contribution value for how much the reflection affects the ambient light for this reflection probe when set to interior mode. Useful so that ambient light matches the color of the room. Equivalent to [member ReflectionProbe.interior_ambient_contrib]. </description> </method> - <method name="reflection_probe_set_max_distance"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="distance" type="float"> - </argument> + <method name="reflection_probe_set_origin_offset"> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="offset" type="Vector3" /> <description> - Sets the max distance away from the probe an object can be before it is culled. Equivalent to [member ReflectionProbe.max_distance]. + Sets the origin offset to be used when this reflection probe is in box project mode. Equivalent to [member ReflectionProbe.origin_offset]. </description> </method> - <method name="reflection_probe_set_origin_offset"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="offset" type="Vector3"> - </argument> + <method name="reflection_probe_set_resolution"> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="resolution" type="int" /> <description> - Sets the origin offset to be used when this reflection probe is in box project mode. Equivalent to [member ReflectionProbe.origin_offset]. </description> </method> <method name="reflection_probe_set_update_mode"> - <return type="void"> - </return> - <argument index="0" name="probe" type="RID"> - </argument> - <argument index="1" name="mode" type="int" enum="RenderingServer.ReflectionProbeUpdateMode"> - </argument> + <return type="void" /> + <argument index="0" name="probe" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.ReflectionProbeUpdateMode" /> <description> Sets how often the reflection probe updates. Can either be once or every frame. See [enum ReflectionProbeUpdateMode] for options. </description> </method> <method name="request_frame_drawn_callback"> - <return type="void"> - </return> - <argument index="0" name="where" type="Object"> - </argument> - <argument index="1" name="method" type="StringName"> - </argument> - <argument index="2" name="userdata" type="Variant"> - </argument> + <return type="void" /> + <argument index="0" name="callable" type="Callable" /> <description> - Schedules a callback to the corresponding named [code]method[/code] on [code]where[/code] after a frame has been drawn. - The callback method must use only 1 argument which will be called with [code]userdata[/code]. + Schedules a callback to the given callable after a frame has been drawn. </description> </method> <method name="scenario_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a scenario and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]scenario_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. The scenario is the 3D world that all the visual instances exist in. </description> </method> - <method name="scenario_set_debug"> - <return type="void"> - </return> - <argument index="0" name="scenario" type="RID"> - </argument> - <argument index="1" name="debug_mode" type="int" enum="RenderingServer.ScenarioDebugMode"> - </argument> + <method name="scenario_set_camera_effects"> + <return type="void" /> + <argument index="0" name="scenario" type="RID" /> + <argument index="1" name="effects" type="RID" /> <description> - Sets the [enum ScenarioDebugMode] for this scenario. See [enum ScenarioDebugMode] for options. </description> </method> <method name="scenario_set_environment"> - <return type="void"> - </return> - <argument index="0" name="scenario" type="RID"> - </argument> - <argument index="1" name="environment" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="scenario" type="RID" /> + <argument index="1" name="environment" type="RID" /> <description> Sets the environment that will be used with this scenario. </description> </method> <method name="scenario_set_fallback_environment"> - <return type="void"> - </return> - <argument index="0" name="scenario" type="RID"> - </argument> - <argument index="1" name="environment" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="scenario" type="RID" /> + <argument index="1" name="environment" type="RID" /> <description> Sets the fallback environment to be used by this scenario. The fallback environment is used if no environment is set. Internally, this is used by the editor to provide a default environment. </description> </method> + <method name="screen_space_roughness_limiter_set_active"> + <return type="void" /> + <argument index="0" name="enable" type="bool" /> + <argument index="1" name="amount" type="float" /> + <argument index="2" name="limit" type="float" /> + <description> + </description> + </method> <method name="set_boot_image"> - <return type="void"> - </return> - <argument index="0" name="image" type="Image"> - </argument> - <argument index="1" name="color" type="Color"> - </argument> - <argument index="2" name="scale" type="bool"> - </argument> - <argument index="3" name="use_filter" type="bool" default="true"> - </argument> + <return type="void" /> + <argument index="0" name="image" type="Image" /> + <argument index="1" name="color" type="Color" /> + <argument index="2" name="scale" type="bool" /> + <argument index="3" name="use_filter" type="bool" default="true" /> <description> Sets a boot image. The color defines the background color. If [code]scale[/code] is [code]true[/code], the image will be scaled to fit the screen size. If [code]use_filter[/code] is [code]true[/code], the image will be scaled with linear interpolation. If [code]use_filter[/code] is [code]false[/code], the image will be scaled with nearest-neighbor interpolation. </description> </method> <method name="set_debug_generate_wireframes"> - <return type="void"> - </return> - <argument index="0" name="generate" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="generate" type="bool" /> <description> If [code]true[/code], the engine will generate wireframes for use with the wireframe debug mode. </description> </method> <method name="set_default_clear_color"> - <return type="void"> - </return> - <argument index="0" name="color" type="Color"> - </argument> + <return type="void" /> + <argument index="0" name="color" type="Color" /> <description> Sets the default clear color which is used when a specific clear color has not been selected. </description> </method> <method name="shader_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates an empty shader and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]shader_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> <method name="shader_get_code" qualifiers="const"> - <return type="String"> - </return> - <argument index="0" name="shader" type="RID"> - </argument> + <return type="String" /> + <argument index="0" name="shader" type="RID" /> <description> Returns a shader's code. </description> </method> <method name="shader_get_default_texture_param" qualifiers="const"> - <return type="RID"> - </return> - <argument index="0" name="shader" type="RID"> - </argument> - <argument index="1" name="name" type="StringName"> - </argument> + <return type="RID" /> + <argument index="0" name="shader" type="RID" /> + <argument index="1" name="param" type="StringName" /> + <argument index="2" name="index" type="int" default="0" /> <description> Returns a default texture from a shader searched by name. + [b]Note:[/b] If the sampler array is used use [code]index[/code] to access the specified texture. </description> </method> <method name="shader_get_param_default" qualifiers="const"> - <return type="Variant"> - </return> - <argument index="0" name="material" type="RID"> - </argument> - <argument index="1" name="parameter" type="StringName"> - </argument> + <return type="Variant" /> + <argument index="0" name="shader" type="RID" /> + <argument index="1" name="param" type="StringName" /> <description> </description> </method> <method name="shader_get_param_list" qualifiers="const"> - <return type="Array"> - </return> - <argument index="0" name="shader" type="RID"> - </argument> + <return type="Dictionary[]" /> + <argument index="0" name="shader" type="RID" /> <description> Returns the parameters of a shader. </description> </method> - <method name="shader_set_code"> - <return type="void"> - </return> - <argument index="0" name="shader" type="RID"> - </argument> - <argument index="1" name="code" type="String"> - </argument> + <method name="shader_set_default_texture_param"> + <return type="void" /> + <argument index="0" name="shader" type="RID" /> + <argument index="1" name="param" type="StringName" /> + <argument index="2" name="texture" type="RID" /> + <argument index="3" name="index" type="int" default="0" /> <description> - Sets a shader's code. + Sets a shader's default texture. Overwrites the texture given by name. + [b]Note:[/b] If the sampler array is used use [code]index[/code] to access the specified texture. </description> </method> - <method name="shader_set_default_texture_param"> - <return type="void"> - </return> - <argument index="0" name="shader" type="RID"> - </argument> - <argument index="1" name="name" type="StringName"> - </argument> - <argument index="2" name="texture" type="RID"> - </argument> + <method name="shadows_quality_set"> + <return type="void" /> + <argument index="0" name="quality" type="int" enum="RenderingServer.ShadowQuality" /> <description> - Sets a shader's default texture. Overwrites the texture given by name. </description> </method> - <method name="skeleton_allocate"> - <return type="void"> - </return> - <argument index="0" name="skeleton" type="RID"> - </argument> - <argument index="1" name="bones" type="int"> - </argument> - <argument index="2" name="is_2d_skeleton" type="bool" default="false"> - </argument> + <method name="skeleton_allocate_data"> + <return type="void" /> + <argument index="0" name="skeleton" type="RID" /> + <argument index="1" name="bones" type="int" /> + <argument index="2" name="is_2d_skeleton" type="bool" default="false" /> <description> - Allocates the GPU buffers for this skeleton. </description> </method> <method name="skeleton_bone_get_transform" qualifiers="const"> - <return type="Transform"> - </return> - <argument index="0" name="skeleton" type="RID"> - </argument> - <argument index="1" name="bone" type="int"> - </argument> + <return type="Transform3D" /> + <argument index="0" name="skeleton" type="RID" /> + <argument index="1" name="bone" type="int" /> <description> - Returns the [Transform] set for a specific bone of this skeleton. + Returns the [Transform3D] set for a specific bone of this skeleton. </description> </method> <method name="skeleton_bone_get_transform_2d" qualifiers="const"> - <return type="Transform2D"> - </return> - <argument index="0" name="skeleton" type="RID"> - </argument> - <argument index="1" name="bone" type="int"> - </argument> + <return type="Transform2D" /> + <argument index="0" name="skeleton" type="RID" /> + <argument index="1" name="bone" type="int" /> <description> Returns the [Transform2D] set for a specific bone of this skeleton. </description> </method> <method name="skeleton_bone_set_transform"> - <return type="void"> - </return> - <argument index="0" name="skeleton" type="RID"> - </argument> - <argument index="1" name="bone" type="int"> - </argument> - <argument index="2" name="transform" type="Transform"> - </argument> + <return type="void" /> + <argument index="0" name="skeleton" type="RID" /> + <argument index="1" name="bone" type="int" /> + <argument index="2" name="transform" type="Transform3D" /> <description> - Sets the [Transform] for a specific bone of this skeleton. + Sets the [Transform3D] for a specific bone of this skeleton. </description> </method> <method name="skeleton_bone_set_transform_2d"> - <return type="void"> - </return> - <argument index="0" name="skeleton" type="RID"> - </argument> - <argument index="1" name="bone" type="int"> - </argument> - <argument index="2" name="transform" type="Transform2D"> - </argument> + <return type="void" /> + <argument index="0" name="skeleton" type="RID" /> + <argument index="1" name="bone" type="int" /> + <argument index="2" name="transform" type="Transform2D" /> <description> Sets the [Transform2D] for a specific bone of this skeleton. </description> </method> <method name="skeleton_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a skeleton and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]skeleton_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> <method name="skeleton_get_bone_count" qualifiers="const"> - <return type="int"> - </return> - <argument index="0" name="skeleton" type="RID"> - </argument> + <return type="int" /> + <argument index="0" name="skeleton" type="RID" /> <description> Returns the number of bones allocated for this skeleton. </description> </method> + <method name="skeleton_set_base_transform_2d"> + <return type="void" /> + <argument index="0" name="skeleton" type="RID" /> + <argument index="1" name="base_transform" type="Transform2D" /> + <description> + </description> + </method> + <method name="sky_bake_panorama"> + <return type="Image" /> + <argument index="0" name="sky" type="RID" /> + <argument index="1" name="energy" type="float" /> + <argument index="2" name="bake_irradiance" type="bool" /> + <argument index="3" name="size" type="Vector2i" /> + <description> + </description> + </method> <method name="sky_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates an empty sky and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]sky_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> <method name="sky_set_material"> - <return type="void"> - </return> - <argument index="0" name="sky" type="RID"> - </argument> - <argument index="1" name="material" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="sky" type="RID" /> + <argument index="1" name="material" type="RID" /> <description> Sets the material that the sky uses to render the background and reflection maps. </description> </method> + <method name="sky_set_mode"> + <return type="void" /> + <argument index="0" name="sky" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.SkyMode" /> + <description> + </description> + </method> + <method name="sky_set_radiance_size"> + <return type="void" /> + <argument index="0" name="sky" type="RID" /> + <argument index="1" name="radiance_size" type="int" /> + <description> + </description> + </method> <method name="spot_light_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates a spot light and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID can be used in most [code]light_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. To place in a scene, attach this spot light to an instance using [method instance_set_base] using the returned RID. </description> </method> + <method name="sub_surface_scattering_set_quality"> + <return type="void" /> + <argument index="0" name="quality" type="int" enum="RenderingServer.SubSurfaceScatteringQuality" /> + <description> + </description> + </method> + <method name="sub_surface_scattering_set_scale"> + <return type="void" /> + <argument index="0" name="scale" type="float" /> + <argument index="1" name="depth_scale" type="float" /> + <description> + </description> + </method> <method name="texture_2d_create"> - <return type="RID"> - </return> - <argument index="0" name="image" type="Image"> - </argument> + <return type="RID" /> + <argument index="0" name="image" type="Image" /> <description> </description> </method> <method name="texture_2d_get" qualifiers="const"> - <return type="Image"> - </return> - <argument index="0" name="texture" type="RID"> - </argument> + <return type="Image" /> + <argument index="0" name="texture" type="RID" /> + <description> + </description> + </method> + <method name="texture_2d_layer_get" qualifiers="const"> + <return type="Image" /> + <argument index="0" name="texture" type="RID" /> + <argument index="1" name="layer" type="int" /> + <description> + </description> + </method> + <method name="texture_2d_layered_create"> + <return type="RID" /> + <argument index="0" name="layers" type="Image[]" /> + <argument index="1" name="layered_type" type="int" enum="RenderingServer.TextureLayeredType" /> + <description> + </description> + </method> + <method name="texture_2d_layered_placeholder_create"> + <return type="RID" /> + <argument index="0" name="layered_type" type="int" enum="RenderingServer.TextureLayeredType" /> + <description> + </description> + </method> + <method name="texture_2d_placeholder_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="texture_2d_update"> + <return type="void" /> + <argument index="0" name="texture" type="RID" /> + <argument index="1" name="image" type="Image" /> + <argument index="2" name="layer" type="int" /> + <description> + </description> + </method> + <method name="texture_3d_create"> + <return type="RID" /> + <argument index="0" name="format" type="int" enum="Image.Format" /> + <argument index="1" name="width" type="int" /> + <argument index="2" name="height" type="int" /> + <argument index="3" name="depth" type="int" /> + <argument index="4" name="mipmaps" type="bool" /> + <argument index="5" name="data" type="Image[]" /> + <description> + </description> + </method> + <method name="texture_3d_get" qualifiers="const"> + <return type="Image[]" /> + <argument index="0" name="texture" type="RID" /> + <description> + </description> + </method> + <method name="texture_3d_placeholder_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="texture_3d_update"> + <return type="void" /> + <argument index="0" name="texture" type="RID" /> + <argument index="1" name="data" type="Image[]" /> + <description> + </description> + </method> + <method name="texture_get_path" qualifiers="const"> + <return type="String" /> + <argument index="0" name="texture" type="RID" /> + <description> + </description> + </method> + <method name="texture_proxy_create"> + <return type="RID" /> + <argument index="0" name="base" type="RID" /> + <description> + </description> + </method> + <method name="texture_proxy_update"> + <return type="void" /> + <argument index="0" name="texture" type="RID" /> + <argument index="1" name="proxy_to" type="RID" /> + <description> + </description> + </method> + <method name="texture_replace"> + <return type="void" /> + <argument index="0" name="texture" type="RID" /> + <argument index="1" name="by_texture" type="RID" /> + <description> + </description> + </method> + <method name="texture_set_force_redraw_if_visible"> + <return type="void" /> + <argument index="0" name="texture" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <description> + </description> + </method> + <method name="texture_set_path"> + <return type="void" /> + <argument index="0" name="texture" type="RID" /> + <argument index="1" name="path" type="String" /> + <description> + </description> + </method> + <method name="texture_set_size_override"> + <return type="void" /> + <argument index="0" name="texture" type="RID" /> + <argument index="1" name="width" type="int" /> + <argument index="2" name="height" type="int" /> <description> </description> </method> <method name="viewport_attach_camera"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="camera" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="camera" type="RID" /> <description> Sets a viewport's camera. </description> </method> <method name="viewport_attach_canvas"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="canvas" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="canvas" type="RID" /> <description> Sets a viewport's canvas. </description> </method> <method name="viewport_attach_to_screen"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="rect" type="Rect2" default="Rect2( 0, 0, 0, 0 )"> - </argument> - <argument index="2" name="screen" type="int" default="0"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="rect" type="Rect2" default="Rect2(0, 0, 0, 0)" /> + <argument index="2" name="screen" type="int" default="0" /> <description> Copies the viewport to a region of the screen specified by [code]rect[/code]. If [method viewport_set_render_direct_to_screen] is [code]true[/code], then the viewport does not use a framebuffer and the contents of the viewport are rendered directly to screen. However, note that the root viewport is drawn last, therefore it will draw over the screen. Accordingly, you must set the root viewport to an area that does not cover the area that you have attached this viewport to. For example, you can set the root viewport to not render at all with the following code: - [codeblock] + FIXME: The method seems to be non-existent. + [codeblocks] + [gdscript] func _ready(): get_viewport().set_attach_to_screen_rect(Rect2()) $Viewport.set_attach_to_screen_rect(Rect2(0, 0, 600, 600)) - [/codeblock] + [/gdscript] + [/codeblocks] Using this can result in significant optimization, especially on lower-end devices. However, it comes at the cost of having to manage your viewports manually. For a further optimization see, [method viewport_set_render_direct_to_screen]. </description> </method> <method name="viewport_create"> - <return type="RID"> - </return> + <return type="RID" /> <description> Creates an empty viewport and adds it to the RenderingServer. It can be accessed with the RID that is returned. This RID will be used in all [code]viewport_*[/code] RenderingServer functions. Once finished with your RID, you will want to free the RID using the RenderingServer's [method free_rid] static method. </description> </method> + <method name="viewport_get_measured_render_time_cpu" qualifiers="const"> + <return type="float" /> + <argument index="0" name="viewport" type="RID" /> + <description> + </description> + </method> + <method name="viewport_get_measured_render_time_gpu" qualifiers="const"> + <return type="float" /> + <argument index="0" name="viewport" type="RID" /> + <description> + </description> + </method> <method name="viewport_get_render_info"> - <return type="int"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="info" type="int" enum="RenderingServer.ViewportRenderInfo"> - </argument> + <return type="int" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="type" type="int" enum="RenderingServer.ViewportRenderInfoType" /> + <argument index="2" name="info" type="int" enum="RenderingServer.ViewportRenderInfo" /> <description> - Returns a viewport's render information. For options, see the [enum ViewportRenderInfo] constants. </description> </method> <method name="viewport_get_texture" qualifiers="const"> - <return type="RID"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> + <return type="RID" /> + <argument index="0" name="viewport" type="RID" /> <description> Returns the viewport's last rendered frame. </description> </method> <method name="viewport_remove_canvas"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="canvas" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="canvas" type="RID" /> <description> Detaches a viewport from a canvas and vice versa. </description> </method> <method name="viewport_set_active"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="active" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="active" type="bool" /> <description> If [code]true[/code], sets the viewport active, else sets it inactive. </description> </method> <method name="viewport_set_canvas_stacking"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="canvas" type="RID"> - </argument> - <argument index="2" name="layer" type="int"> - </argument> - <argument index="3" name="sublayer" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="canvas" type="RID" /> + <argument index="2" name="layer" type="int" /> + <argument index="3" name="sublayer" type="int" /> <description> Sets the stacking order for a viewport's canvas. [code]layer[/code] is the actual canvas layer, while [code]sublayer[/code] specifies the stacking order of the canvas among those in the same layer. </description> </method> <method name="viewport_set_canvas_transform"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="canvas" type="RID"> - </argument> - <argument index="2" name="offset" type="Transform2D"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="canvas" type="RID" /> + <argument index="2" name="offset" type="Transform2D" /> <description> Sets the transformation of a viewport's canvas. </description> </method> <method name="viewport_set_clear_mode"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="clear_mode" type="int" enum="RenderingServer.ViewportClearMode"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="clear_mode" type="int" enum="RenderingServer.ViewportClearMode" /> <description> Sets the clear mode of a viewport. See [enum ViewportClearMode] for options. </description> </method> <method name="viewport_set_debug_draw"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="draw" type="int" enum="RenderingServer.ViewportDebugDraw"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="draw" type="int" enum="RenderingServer.ViewportDebugDraw" /> <description> Sets the debug draw mode of a viewport. See [enum ViewportDebugDraw] for options. </description> </method> + <method name="viewport_set_default_canvas_item_texture_filter"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="filter" type="int" enum="RenderingServer.CanvasItemTextureFilter" /> + <description> + </description> + </method> + <method name="viewport_set_default_canvas_item_texture_repeat"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="repeat" type="int" enum="RenderingServer.CanvasItemTextureRepeat" /> + <description> + </description> + </method> + <method name="viewport_set_disable_2d"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="disable" type="bool" /> + <description> + If [code]true[/code], the viewport's canvas is not rendered. + </description> + </method> + <method name="viewport_set_disable_3d"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="disable" type="bool" /> + <description> + </description> + </method> <method name="viewport_set_disable_environment"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="disabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="disabled" type="bool" /> <description> If [code]true[/code], rendering of a viewport's environment is disabled. </description> </method> - <method name="viewport_set_global_canvas_transform"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="transform" type="Transform2D"> - </argument> + <method name="viewport_set_fsr_mipmap_bias"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="mipmap_bias" type="float" /> <description> - Sets the viewport's global transformation matrix. + Affects the final texture sharpness by reading from a lower or higher mipmap. Negative values make textures sharper, while positive values make textures blurrier. When using FSR, this value is used to adjust the mipmap bias calculated internally which is based on the selected quality. The formula for this is [code]-log2(1.0 / scale) + mipmap_bias[/code] </description> </method> - <method name="viewport_set_hide_canvas"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="hidden" type="bool"> - </argument> + <method name="viewport_set_fsr_sharpness"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="sharpness" type="float" /> <description> - If [code]true[/code], the viewport's canvas is not rendered. + Determines how sharp the upscaled image will be when using the FSR upscaling mode. Sharpness halves with every whole number. Values go from 0.0 (sharpest) to 2.0. Values above 2.0 won't make a visible difference. </description> </method> - <method name="viewport_set_hide_scenario"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="hidden" type="bool"> - </argument> + <method name="viewport_set_global_canvas_transform"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="transform" type="Transform2D" /> + <description> + Sets the viewport's global transformation matrix. + </description> + </method> + <method name="viewport_set_measure_render_time"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="enable" type="bool" /> <description> - Currently unimplemented in Godot 3.x. </description> </method> <method name="viewport_set_msaa"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="msaa" type="int" enum="RenderingServer.ViewportMSAA"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="msaa" type="int" enum="RenderingServer.ViewportMSAA" /> <description> Sets the anti-aliasing mode. See [enum ViewportMSAA] for options. </description> </method> + <method name="viewport_set_occlusion_culling_build_quality"> + <return type="void" /> + <argument index="0" name="quality" type="int" enum="RenderingServer.ViewportOcclusionCullingBuildQuality" /> + <description> + </description> + </method> + <method name="viewport_set_occlusion_rays_per_thread"> + <return type="void" /> + <argument index="0" name="rays_per_thread" type="int" /> + <description> + </description> + </method> <method name="viewport_set_parent_viewport"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="parent_viewport" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="parent_viewport" type="RID" /> <description> Sets the viewport's parent to another viewport. </description> </method> <method name="viewport_set_render_direct_to_screen"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="enabled" type="bool" /> <description> If [code]true[/code], render the contents of the viewport directly to screen. This allows a low-level optimization where you can skip drawing a viewport to the root viewport. While this optimization can result in a significant increase in speed (especially on older devices), it comes at a cost of usability. When this is enabled, you cannot read from the viewport or from the [code]SCREEN_TEXTURE[/code]. You also lose the benefit of certain window settings, such as the various stretch modes. Another consequence to be aware of is that in 2D the rendering happens in window coordinates, so if you have a viewport that is double the size of the window, and you set this, then only the portion that fits within the window will be drawn, no automatic scaling is possible, even if your game scene is significantly larger than the window size. </description> </method> + <method name="viewport_set_scaling_3d_mode"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="scaling_3d_mode" type="int" enum="RenderingServer.ViewportScaling3DMode" /> + <description> + Sets scaling 3d mode. Bilinear scaling renders at different resolution to either undersample or supersample the viewport. FidelityFX Super Resolution 1.0, abbreviated to FSR, is an upscaling technology that produces high quality images at fast framerates by using a spatially aware upscaling algorithm. FSR is slightly more expensive than bilinear, but it produces significantly higher image quality. FSR should be used where possible. + </description> + </method> + <method name="viewport_set_scaling_3d_scale"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="scale" type="float" /> + <description> + Scales the 3D render buffer based on the viewport size uses an image filter specified in [enum ViewportScaling3DMode] to scale the output image to the full viewport size. Values lower than [code]1.0[/code] can be used to speed up 3D rendering at the cost of quality (undersampling). Values greater than [code]1.0[/code] are only valid for bilinear mode and can be used to improve 3D rendering quality at a high performance cost (supersampling). See also [enum ViewportMSAA] for multi-sample antialiasing, which is significantly cheaper but only smoothens the edges of polygons. + When using FSR upscaling, AMD recommends exposing the following values as preset options to users "Ultra Quality: 0.77", "Quality: 0.67", "Balanced: 0.59", "Performance: 0.5" instead of exposing the entire scale. + </description> + </method> <method name="viewport_set_scenario"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="scenario" type="RID"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="scenario" type="RID" /> <description> Sets a viewport's scenario. - The scenario contains information about the [enum ScenarioDebugMode], environment information, reflection atlas etc. + The scenario contains information about environment information, reflection atlas etc. + </description> + </method> + <method name="viewport_set_screen_space_aa"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="mode" type="int" enum="RenderingServer.ViewportScreenSpaceAA" /> + <description> + </description> + </method> + <method name="viewport_set_sdf_oversize_and_scale"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="oversize" type="int" enum="RenderingServer.ViewportSDFOversize" /> + <argument index="2" name="scale" type="int" enum="RenderingServer.ViewportSDFScale" /> + <description> </description> </method> <method name="viewport_set_shadow_atlas_quadrant_subdivision"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="quadrant" type="int"> - </argument> - <argument index="2" name="subdivision" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="quadrant" type="int" /> + <argument index="2" name="subdivision" type="int" /> <description> Sets the shadow atlas quadrant's subdivision. </description> </method> <method name="viewport_set_shadow_atlas_size"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="size" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="size" type="int" /> + <argument index="2" name="use_16_bits" type="bool" default="false" /> <description> Sets the size of the shadow atlas's images (used for omni and spot lights). The value will be rounded up to the nearest power of 2. </description> </method> <method name="viewport_set_size"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="width" type="int"> - </argument> - <argument index="2" name="height" type="int"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="width" type="int" /> + <argument index="2" name="height" type="int" /> <description> Sets the viewport's width and height. </description> </method> + <method name="viewport_set_snap_2d_transforms_to_pixel"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="enabled" type="bool" /> + <description> + </description> + </method> + <method name="viewport_set_snap_2d_vertices_to_pixel"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="enabled" type="bool" /> + <description> + </description> + </method> <method name="viewport_set_transparent_background"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="enabled" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="enabled" type="bool" /> <description> If [code]true[/code], the viewport renders its background as transparent. </description> </method> <method name="viewport_set_update_mode"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="update_mode" type="int" enum="RenderingServer.ViewportUpdateMode"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="update_mode" type="int" enum="RenderingServer.ViewportUpdateMode" /> <description> Sets when the viewport should be updated. See [enum ViewportUpdateMode] constants for options. </description> </method> + <method name="viewport_set_use_debanding"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <description> + </description> + </method> + <method name="viewport_set_use_occlusion_culling"> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <description> + </description> + </method> <method name="viewport_set_use_xr"> - <return type="void"> - </return> - <argument index="0" name="viewport" type="RID"> - </argument> - <argument index="1" name="use_xr" type="bool"> - </argument> + <return type="void" /> + <argument index="0" name="viewport" type="RID" /> + <argument index="1" name="use_xr" type="bool" /> <description> If [code]true[/code], the viewport uses augmented or virtual reality technologies. See [XRInterface]. </description> </method> + <method name="visibility_notifier_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="visibility_notifier_set_aabb"> + <return type="void" /> + <argument index="0" name="notifier" type="RID" /> + <argument index="1" name="aabb" type="AABB" /> + <description> + </description> + </method> + <method name="visibility_notifier_set_callbacks"> + <return type="void" /> + <argument index="0" name="notifier" type="RID" /> + <argument index="1" name="enter_callable" type="Callable" /> + <argument index="2" name="exit_callable" type="Callable" /> + <description> + </description> + </method> + <method name="voxel_gi_allocate_data"> + <return type="void" /> + <argument index="0" name="voxel_gi" type="RID" /> + <argument index="1" name="to_cell_xform" type="Transform3D" /> + <argument index="2" name="aabb" type="AABB" /> + <argument index="3" name="octree_size" type="Vector3i" /> + <argument index="4" name="octree_cells" type="PackedByteArray" /> + <argument index="5" name="data_cells" type="PackedByteArray" /> + <argument index="6" name="distance_field" type="PackedByteArray" /> + <argument index="7" name="level_counts" type="PackedInt32Array" /> + <description> + </description> + </method> + <method name="voxel_gi_create"> + <return type="RID" /> + <description> + </description> + </method> + <method name="voxel_gi_get_data_cells" qualifiers="const"> + <return type="PackedByteArray" /> + <argument index="0" name="voxel_gi" type="RID" /> + <description> + </description> + </method> + <method name="voxel_gi_get_distance_field" qualifiers="const"> + <return type="PackedByteArray" /> + <argument index="0" name="voxel_gi" type="RID" /> + <description> + </description> + </method> + <method name="voxel_gi_get_level_counts" qualifiers="const"> + <return type="PackedInt32Array" /> + <argument index="0" name="voxel_gi" type="RID" /> + <description> + </description> + </method> + <method name="voxel_gi_get_octree_cells" qualifiers="const"> + <return type="PackedByteArray" /> + <argument index="0" name="voxel_gi" type="RID" /> + <description> + </description> + </method> + <method name="voxel_gi_get_octree_size" qualifiers="const"> + <return type="Vector3i" /> + <argument index="0" name="voxel_gi" type="RID" /> + <description> + </description> + </method> + <method name="voxel_gi_get_to_cell_xform" qualifiers="const"> + <return type="Transform3D" /> + <argument index="0" name="voxel_gi" type="RID" /> + <description> + </description> + </method> + <method name="voxel_gi_set_bias"> + <return type="void" /> + <argument index="0" name="voxel_gi" type="RID" /> + <argument index="1" name="bias" type="float" /> + <description> + </description> + </method> + <method name="voxel_gi_set_dynamic_range"> + <return type="void" /> + <argument index="0" name="voxel_gi" type="RID" /> + <argument index="1" name="range" type="float" /> + <description> + </description> + </method> + <method name="voxel_gi_set_energy"> + <return type="void" /> + <argument index="0" name="voxel_gi" type="RID" /> + <argument index="1" name="energy" type="float" /> + <description> + </description> + </method> + <method name="voxel_gi_set_interior"> + <return type="void" /> + <argument index="0" name="voxel_gi" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <description> + </description> + </method> + <method name="voxel_gi_set_normal_bias"> + <return type="void" /> + <argument index="0" name="voxel_gi" type="RID" /> + <argument index="1" name="bias" type="float" /> + <description> + </description> + </method> + <method name="voxel_gi_set_propagation"> + <return type="void" /> + <argument index="0" name="voxel_gi" type="RID" /> + <argument index="1" name="amount" type="float" /> + <description> + </description> + </method> + <method name="voxel_gi_set_quality"> + <return type="void" /> + <argument index="0" name="quality" type="int" enum="RenderingServer.VoxelGIQuality" /> + <description> + </description> + </method> + <method name="voxel_gi_set_use_two_bounces"> + <return type="void" /> + <argument index="0" name="voxel_gi" type="RID" /> + <argument index="1" name="enable" type="bool" /> + <description> + </description> + </method> </methods> + <members> + <member name="render_loop_enabled" type="bool" setter="set_render_loop_enabled" getter="is_render_loop_enabled"> + If [code]false[/code], disables rendering completely, but the engine logic is still being processed. You can call [method force_draw] to draw a frame even with rendering disabled. + </member> + </members> <signals> <signal name="frame_post_draw"> <description> @@ -3040,6 +3488,8 @@ <constant name="MAX_CURSORS" value="8"> Unused enum in Godot 3.x. </constant> + <constant name="MAX_2D_DIRECTIONAL_LIGHTS" value="8"> + </constant> <constant name="TEXTURE_LAYERED_2D_ARRAY" value="0" enum="TextureLayeredType"> </constant> <constant name="TEXTURE_LAYERED_CUBEMAP" value="1" enum="TextureLayeredType"> @@ -3070,7 +3520,10 @@ <constant name="SHADER_SKY" value="3" enum="ShaderMode"> Shader is a sky shader. </constant> - <constant name="SHADER_MAX" value="4" enum="ShaderMode"> + <constant name="SHADER_FOG" value="4" enum="ShaderMode"> + Shader is a fog shader. + </constant> + <constant name="SHADER_MAX" value="5" enum="ShaderMode"> Represents the size of the [enum ShaderMode] enum. </constant> <constant name="MATERIAL_RENDER_PRIORITY_MIN" value="-128"> @@ -3097,18 +3550,46 @@ <constant name="ARRAY_TEX_UV2" value="5" enum="ArrayType"> Array is an UV coordinates array for the second UV coordinates. </constant> - <constant name="ARRAY_BONES" value="6" enum="ArrayType"> + <constant name="ARRAY_CUSTOM0" value="6" enum="ArrayType"> + </constant> + <constant name="ARRAY_CUSTOM1" value="7" enum="ArrayType"> + </constant> + <constant name="ARRAY_CUSTOM2" value="8" enum="ArrayType"> + </constant> + <constant name="ARRAY_CUSTOM3" value="9" enum="ArrayType"> + </constant> + <constant name="ARRAY_BONES" value="10" enum="ArrayType"> Array contains bone information. </constant> - <constant name="ARRAY_WEIGHTS" value="7" enum="ArrayType"> + <constant name="ARRAY_WEIGHTS" value="11" enum="ArrayType"> Array is weight information. </constant> - <constant name="ARRAY_INDEX" value="8" enum="ArrayType"> + <constant name="ARRAY_INDEX" value="12" enum="ArrayType"> Array is index array. </constant> - <constant name="ARRAY_MAX" value="9" enum="ArrayType"> + <constant name="ARRAY_MAX" value="13" enum="ArrayType"> Represents the size of the [enum ArrayType] enum. </constant> + <constant name="ARRAY_CUSTOM_COUNT" value="4"> + </constant> + <constant name="ARRAY_CUSTOM_RGBA8_UNORM" value="0" enum="ArrayCustomFormat"> + </constant> + <constant name="ARRAY_CUSTOM_RGBA8_SNORM" value="1" enum="ArrayCustomFormat"> + </constant> + <constant name="ARRAY_CUSTOM_RG_HALF" value="2" enum="ArrayCustomFormat"> + </constant> + <constant name="ARRAY_CUSTOM_RGBA_HALF" value="3" enum="ArrayCustomFormat"> + </constant> + <constant name="ARRAY_CUSTOM_R_FLOAT" value="4" enum="ArrayCustomFormat"> + </constant> + <constant name="ARRAY_CUSTOM_RG_FLOAT" value="5" enum="ArrayCustomFormat"> + </constant> + <constant name="ARRAY_CUSTOM_RGB_FLOAT" value="6" enum="ArrayCustomFormat"> + </constant> + <constant name="ARRAY_CUSTOM_RGBA_FLOAT" value="7" enum="ArrayCustomFormat"> + </constant> + <constant name="ARRAY_CUSTOM_MAX" value="8" enum="ArrayCustomFormat"> + </constant> <constant name="ARRAY_FORMAT_VERTEX" value="1" enum="ArrayFormat"> Flag used to mark a vertex array. </constant> @@ -3127,40 +3608,47 @@ <constant name="ARRAY_FORMAT_TEX_UV2" value="32" enum="ArrayFormat"> Flag used to mark an UV coordinates array for the second UV coordinates. </constant> - <constant name="ARRAY_FORMAT_BONES" value="64" enum="ArrayFormat"> + <constant name="ARRAY_FORMAT_CUSTOM0" value="64" enum="ArrayFormat"> + </constant> + <constant name="ARRAY_FORMAT_CUSTOM1" value="128" enum="ArrayFormat"> + </constant> + <constant name="ARRAY_FORMAT_CUSTOM2" value="256" enum="ArrayFormat"> + </constant> + <constant name="ARRAY_FORMAT_CUSTOM3" value="512" enum="ArrayFormat"> + </constant> + <constant name="ARRAY_FORMAT_BONES" value="1024" enum="ArrayFormat"> Flag used to mark a bone information array. </constant> - <constant name="ARRAY_FORMAT_WEIGHTS" value="128" enum="ArrayFormat"> + <constant name="ARRAY_FORMAT_WEIGHTS" value="2048" enum="ArrayFormat"> Flag used to mark a weights array. </constant> - <constant name="ARRAY_FORMAT_INDEX" value="256" enum="ArrayFormat"> + <constant name="ARRAY_FORMAT_INDEX" value="4096" enum="ArrayFormat"> Flag used to mark an index array. </constant> - <constant name="ARRAY_COMPRESS_NORMAL" value="1024" enum="ArrayFormat"> - Flag used to mark a compressed (half float) normal array. + <constant name="ARRAY_FORMAT_BLEND_SHAPE_MASK" value="2147475463" enum="ArrayFormat"> + </constant> + <constant name="ARRAY_FORMAT_CUSTOM_BASE" value="13" enum="ArrayFormat"> </constant> - <constant name="ARRAY_COMPRESS_TANGENT" value="2048" enum="ArrayFormat"> - Flag used to mark a compressed (half float) tangent array. + <constant name="ARRAY_FORMAT_CUSTOM_BITS" value="3" enum="ArrayFormat"> </constant> - <constant name="ARRAY_COMPRESS_COLOR" value="4096" enum="ArrayFormat"> - Flag used to mark a compressed (half float) color array. + <constant name="ARRAY_FORMAT_CUSTOM0_SHIFT" value="13" enum="ArrayFormat"> </constant> - <constant name="ARRAY_COMPRESS_TEX_UV" value="8192" enum="ArrayFormat"> - Flag used to mark a compressed (half float) UV coordinates array. + <constant name="ARRAY_FORMAT_CUSTOM1_SHIFT" value="16" enum="ArrayFormat"> </constant> - <constant name="ARRAY_COMPRESS_TEX_UV2" value="16384" enum="ArrayFormat"> - Flag used to mark a compressed (half float) UV coordinates array for the second UV coordinates. + <constant name="ARRAY_FORMAT_CUSTOM2_SHIFT" value="19" enum="ArrayFormat"> </constant> - <constant name="ARRAY_COMPRESS_INDEX" value="131072" enum="ArrayFormat"> - Flag used to mark a compressed index array. + <constant name="ARRAY_FORMAT_CUSTOM3_SHIFT" value="22" enum="ArrayFormat"> </constant> - <constant name="ARRAY_COMPRESS_DEFAULT" value="31744" enum="ArrayFormat"> - Used to set flags [constant ARRAY_COMPRESS_NORMAL], [constant ARRAY_COMPRESS_TANGENT], [constant ARRAY_COMPRESS_COLOR], [constant ARRAY_COMPRESS_TEX_UV] and [constant ARRAY_COMPRESS_TEX_UV2] quickly. + <constant name="ARRAY_FORMAT_CUSTOM_MASK" value="7" enum="ArrayFormat"> </constant> - <constant name="ARRAY_FLAG_USE_2D_VERTICES" value="262144" enum="ArrayFormat"> + <constant name="ARRAY_COMPRESS_FLAGS_BASE" value="25" enum="ArrayFormat"> + </constant> + <constant name="ARRAY_FLAG_USE_2D_VERTICES" value="33554432" enum="ArrayFormat"> Flag used to mark that the array contains 2D vertices. </constant> - <constant name="ARRAY_FLAG_USE_DYNAMIC_UPDATE" value="1048576" enum="ArrayFormat"> + <constant name="ARRAY_FLAG_USE_DYNAMIC_UPDATE" value="67108864" enum="ArrayFormat"> + </constant> + <constant name="ARRAY_FLAG_USE_8_BONE_WEIGHTS" value="134217728" enum="ArrayFormat"> </constant> <constant name="PRIMITIVE_POINTS" value="0" enum="PrimitiveType"> Primitive to draw consists of points. @@ -3190,7 +3678,17 @@ Use [Transform2D] to store MultiMesh transform. </constant> <constant name="MULTIMESH_TRANSFORM_3D" value="1" enum="MultimeshTransformFormat"> - Use [Transform] to store MultiMesh transform. + Use [Transform3D] to store MultiMesh transform. + </constant> + <constant name="LIGHT_PROJECTOR_FILTER_NEAREST" value="0" enum="LightProjectorFilter"> + </constant> + <constant name="LIGHT_PROJECTOR_FILTER_NEAREST_MIPMAPS" value="1" enum="LightProjectorFilter"> + </constant> + <constant name="LIGHT_PROJECTOR_FILTER_LINEAR" value="2" enum="LightProjectorFilter"> + </constant> + <constant name="LIGHT_PROJECTOR_FILTER_LINEAR_MIPMAPS" value="3" enum="LightProjectorFilter"> + </constant> + <constant name="LIGHT_PROJECTOR_FILTER_LINEAR_MIPMAPS_ANISOTROPIC" value="4" enum="LightProjectorFilter"> </constant> <constant name="LIGHT_DIRECTIONAL" value="0" enum="LightType"> Is a directional (sun) light. @@ -3251,11 +3749,19 @@ <constant name="LIGHT_PARAM_SHADOW_BLUR" value="16" enum="LightParam"> Blurs the edges of the shadow. Can be used to hide pixel artifacts in low resolution shadow maps. A high value can make shadows appear grainy and can cause other unwanted artifacts. Try to keep as near default as possible. </constant> - <constant name="LIGHT_PARAM_TRANSMITTANCE_BIAS" value="17" enum="LightParam"> + <constant name="LIGHT_PARAM_SHADOW_VOLUMETRIC_FOG_FADE" value="17" enum="LightParam"> </constant> - <constant name="LIGHT_PARAM_MAX" value="18" enum="LightParam"> + <constant name="LIGHT_PARAM_TRANSMITTANCE_BIAS" value="18" enum="LightParam"> + </constant> + <constant name="LIGHT_PARAM_MAX" value="19" enum="LightParam"> Represents the size of the [enum LightParam] enum. </constant> + <constant name="LIGHT_BAKE_DISABLED" value="0" enum="LightBakeMode"> + </constant> + <constant name="LIGHT_BAKE_DYNAMIC" value="1" enum="LightBakeMode"> + </constant> + <constant name="LIGHT_BAKE_STATIC" value="2" enum="LightBakeMode"> + </constant> <constant name="LIGHT_OMNI_SHADOW_DUAL_PARABOLOID" value="0" enum="LightOmniShadowMode"> Use a dual paraboloid shadow map for omni lights. </constant> @@ -3271,11 +3777,26 @@ <constant name="LIGHT_DIRECTIONAL_SHADOW_PARALLEL_4_SPLITS" value="2" enum="LightDirectionalShadowMode"> Use 4 splits for shadow projection when using directional light. </constant> - <constant name="LIGHT_DIRECTIONAL_SHADOW_DEPTH_RANGE_STABLE" value="0" enum="LightDirectionalShadowDepthRangeMode"> - Keeps shadows stable as camera moves but has lower effective resolution. + <constant name="SHADOW_QUALITY_HARD" value="0" enum="ShadowQuality"> + Lowest shadow filtering quality (fastest). Soft shadows are not available with this quality setting, which means the [member Light3D.shadow_blur] property is ignored if [member Light3D.light_size] and [member Light3D.light_angular_distance] is [code]0.0[/code]. + [b]Note:[/b] The variable shadow blur performed by [member Light3D.light_size] and [member Light3D.light_angular_distance] is still effective when using hard shadow filtering. In this case, [member Light3D.shadow_blur] [i]is[/i] taken into account. However, the results will not be blurred, instead the blur amount is treated as a maximum radius for the penumbra. + </constant> + <constant name="SHADOW_QUALITY_SOFT_VERY_LOW" value="1" enum="ShadowQuality"> + Very low shadow filtering quality (faster). When using this quality setting, [member Light3D.shadow_blur] is automatically multiplied by 0.75× to avoid introducing too much noise. This division only applies to lights whose [member Light3D.light_size] or [member Light3D.light_angular_distance] is [code]0.0[/code]). </constant> - <constant name="LIGHT_DIRECTIONAL_SHADOW_DEPTH_RANGE_OPTIMIZED" value="1" enum="LightDirectionalShadowDepthRangeMode"> - Optimize use of shadow maps, increasing the effective resolution. But may result in shadows moving or flickering slightly. + <constant name="SHADOW_QUALITY_SOFT_LOW" value="2" enum="ShadowQuality"> + Low shadow filtering quality (fast). + </constant> + <constant name="SHADOW_QUALITY_SOFT_MEDIUM" value="3" enum="ShadowQuality"> + Medium low shadow filtering quality (average). + </constant> + <constant name="SHADOW_QUALITY_SOFT_HIGH" value="4" enum="ShadowQuality"> + High low shadow filtering quality (slow). When using this quality setting, [member Light3D.shadow_blur] is automatically multiplied by 1.5× to better make use of the high sample count. This increased blur also improves the stability of dynamic object shadows. This multiplier only applies to lights whose [member Light3D.light_size] or [member Light3D.light_angular_distance] is [code]0.0[/code]). + </constant> + <constant name="SHADOW_QUALITY_SOFT_ULTRA" value="5" enum="ShadowQuality"> + Highest low shadow filtering quality (slowest). When using this quality setting, [member Light3D.shadow_blur] is automatically multiplied by 2× to better make use of the high sample count. This increased blur also improves the stability of dynamic object shadows. This multiplier only applies to lights whose [member Light3D.light_size] or [member Light3D.light_angular_distance] is [code]0.0[/code]). + </constant> + <constant name="SHADOW_QUALITY_MAX" value="6" enum="ShadowQuality"> </constant> <constant name="REFLECTION_PROBE_UPDATE_ONCE" value="0" enum="ReflectionProbeUpdateMode"> Reflection probe will update reflections once and then stop. @@ -3283,6 +3804,12 @@ <constant name="REFLECTION_PROBE_UPDATE_ALWAYS" value="1" enum="ReflectionProbeUpdateMode"> Reflection probe will update each frame. This mode is necessary to capture moving objects. </constant> + <constant name="REFLECTION_PROBE_AMBIENT_DISABLED" value="0" enum="ReflectionProbeAmbientMode"> + </constant> + <constant name="REFLECTION_PROBE_AMBIENT_ENVIRONMENT" value="1" enum="ReflectionProbeAmbientMode"> + </constant> + <constant name="REFLECTION_PROBE_AMBIENT_COLOR" value="2" enum="ReflectionProbeAmbientMode"> + </constant> <constant name="DECAL_TEXTURE_ALBEDO" value="0" enum="DecalTexture"> </constant> <constant name="DECAL_TEXTURE_NORMAL" value="1" enum="DecalTexture"> @@ -3293,15 +3820,98 @@ </constant> <constant name="DECAL_TEXTURE_MAX" value="4" enum="DecalTexture"> </constant> + <constant name="DECAL_FILTER_NEAREST" value="0" enum="DecalFilter"> + </constant> + <constant name="DECAL_FILTER_NEAREST_MIPMAPS" value="1" enum="DecalFilter"> + </constant> + <constant name="DECAL_FILTER_LINEAR" value="2" enum="DecalFilter"> + </constant> + <constant name="DECAL_FILTER_LINEAR_MIPMAPS" value="3" enum="DecalFilter"> + </constant> + <constant name="DECAL_FILTER_LINEAR_MIPMAPS_ANISOTROPIC" value="4" enum="DecalFilter"> + </constant> + <constant name="VOXEL_GI_QUALITY_LOW" value="0" enum="VoxelGIQuality"> + </constant> + <constant name="VOXEL_GI_QUALITY_HIGH" value="1" enum="VoxelGIQuality"> + </constant> + <constant name="PARTICLES_MODE_2D" value="0" enum="ParticlesMode"> + </constant> + <constant name="PARTICLES_MODE_3D" value="1" enum="ParticlesMode"> + </constant> + <constant name="PARTICLES_TRANSFORM_ALIGN_DISABLED" value="0" enum="ParticlesTransformAlign"> + </constant> + <constant name="PARTICLES_TRANSFORM_ALIGN_Z_BILLBOARD" value="1" enum="ParticlesTransformAlign"> + </constant> + <constant name="PARTICLES_TRANSFORM_ALIGN_Y_TO_VELOCITY" value="2" enum="ParticlesTransformAlign"> + </constant> + <constant name="PARTICLES_TRANSFORM_ALIGN_Z_BILLBOARD_Y_TO_VELOCITY" value="3" enum="ParticlesTransformAlign"> + </constant> + <constant name="PARTICLES_EMIT_FLAG_POSITION" value="1"> + </constant> + <constant name="PARTICLES_EMIT_FLAG_ROTATION_SCALE" value="2"> + </constant> + <constant name="PARTICLES_EMIT_FLAG_VELOCITY" value="4"> + </constant> + <constant name="PARTICLES_EMIT_FLAG_COLOR" value="8"> + </constant> + <constant name="PARTICLES_EMIT_FLAG_CUSTOM" value="16"> + </constant> <constant name="PARTICLES_DRAW_ORDER_INDEX" value="0" enum="ParticlesDrawOrder"> Draw particles in the order that they appear in the particles array. </constant> <constant name="PARTICLES_DRAW_ORDER_LIFETIME" value="1" enum="ParticlesDrawOrder"> Sort particles based on their lifetime. </constant> - <constant name="PARTICLES_DRAW_ORDER_VIEW_DEPTH" value="2" enum="ParticlesDrawOrder"> + <constant name="PARTICLES_DRAW_ORDER_REVERSE_LIFETIME" value="2" enum="ParticlesDrawOrder"> + </constant> + <constant name="PARTICLES_DRAW_ORDER_VIEW_DEPTH" value="3" enum="ParticlesDrawOrder"> Sort particles based on their distance to the camera. </constant> + <constant name="PARTICLES_COLLISION_TYPE_SPHERE_ATTRACT" value="0" enum="ParticlesCollisionType"> + </constant> + <constant name="PARTICLES_COLLISION_TYPE_BOX_ATTRACT" value="1" enum="ParticlesCollisionType"> + </constant> + <constant name="PARTICLES_COLLISION_TYPE_VECTOR_FIELD_ATTRACT" value="2" enum="ParticlesCollisionType"> + </constant> + <constant name="PARTICLES_COLLISION_TYPE_SPHERE_COLLIDE" value="3" enum="ParticlesCollisionType"> + </constant> + <constant name="PARTICLES_COLLISION_TYPE_BOX_COLLIDE" value="4" enum="ParticlesCollisionType"> + </constant> + <constant name="PARTICLES_COLLISION_TYPE_SDF_COLLIDE" value="5" enum="ParticlesCollisionType"> + </constant> + <constant name="PARTICLES_COLLISION_TYPE_HEIGHTFIELD_COLLIDE" value="6" enum="ParticlesCollisionType"> + </constant> + <constant name="PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_256" value="0" enum="ParticlesCollisionHeightfieldResolution"> + </constant> + <constant name="PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_512" value="1" enum="ParticlesCollisionHeightfieldResolution"> + </constant> + <constant name="PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_1024" value="2" enum="ParticlesCollisionHeightfieldResolution"> + </constant> + <constant name="PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_2048" value="3" enum="ParticlesCollisionHeightfieldResolution"> + </constant> + <constant name="PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_4096" value="4" enum="ParticlesCollisionHeightfieldResolution"> + </constant> + <constant name="PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_8192" value="5" enum="ParticlesCollisionHeightfieldResolution"> + </constant> + <constant name="PARTICLES_COLLISION_HEIGHTFIELD_RESOLUTION_MAX" value="6" enum="ParticlesCollisionHeightfieldResolution"> + </constant> + <constant name="FOG_VOLUME_SHAPE_ELLIPSOID" value="0" enum="FogVolumeShape"> + [FogVolume] will be shaped like an ellipsoid. + </constant> + <constant name="FOG_VOLUME_SHAPE_BOX" value="1" enum="FogVolumeShape"> + [FogVolume] will be shaped like a box. + </constant> + <constant name="FOG_VOLUME_SHAPE_WORLD" value="2" enum="FogVolumeShape"> + [FogVolume] will have no shape, will cover the whole world and will not be culled. + </constant> + <constant name="VIEWPORT_SCALING_3D_MODE_BILINEAR" value="0" enum="ViewportScaling3DMode"> + Enables bilinear scaling on 3D viewports. The amount of scaling can be set using [member Viewport.scaling_3d_scale]. Values less then [code]1.0[/code] will result in undersampling while values greater than [code]1.0[/code] will result in supersampling. A value of [code]1.0[/code] disables scaling. + </constant> + <constant name="VIEWPORT_SCALING_3D_MODE_FSR" value="1" enum="ViewportScaling3DMode"> + Enables FSR upscaling on 3D viewports. The amount of scaling can be set using [member Viewport.scaling_3d_scale]. Values less then [code]1.0[/code] will be result in the viewport being upscaled using FSR. Values greater than [code]1.0[/code] are not supported and bilinear supersampling will be used instead. A value of [code]1.0[/code] disables scaling. + </constant> + <constant name="VIEWPORT_SCALING_3D_MODE_MAX" value="2" enum="ViewportScaling3DMode"> + </constant> <constant name="VIEWPORT_UPDATE_DISABLED" value="0" enum="ViewportUpdateMode"> Do not update the viewport. </constant> @@ -3325,22 +3935,37 @@ <constant name="VIEWPORT_CLEAR_ONLY_NEXT_FRAME" value="2" enum="ViewportClearMode"> The viewport is cleared once, then the clear mode is set to [constant VIEWPORT_CLEAR_NEVER]. </constant> + <constant name="VIEWPORT_SDF_OVERSIZE_100_PERCENT" value="0" enum="ViewportSDFOversize"> + </constant> + <constant name="VIEWPORT_SDF_OVERSIZE_120_PERCENT" value="1" enum="ViewportSDFOversize"> + </constant> + <constant name="VIEWPORT_SDF_OVERSIZE_150_PERCENT" value="2" enum="ViewportSDFOversize"> + </constant> + <constant name="VIEWPORT_SDF_OVERSIZE_200_PERCENT" value="3" enum="ViewportSDFOversize"> + </constant> + <constant name="VIEWPORT_SDF_OVERSIZE_MAX" value="4" enum="ViewportSDFOversize"> + </constant> + <constant name="VIEWPORT_SDF_SCALE_100_PERCENT" value="0" enum="ViewportSDFScale"> + </constant> + <constant name="VIEWPORT_SDF_SCALE_50_PERCENT" value="1" enum="ViewportSDFScale"> + </constant> + <constant name="VIEWPORT_SDF_SCALE_25_PERCENT" value="2" enum="ViewportSDFScale"> + </constant> + <constant name="VIEWPORT_SDF_SCALE_MAX" value="3" enum="ViewportSDFScale"> + </constant> <constant name="VIEWPORT_MSAA_DISABLED" value="0" enum="ViewportMSAA"> - Multisample antialiasing is disabled. + Multisample antialiasing for 3D is disabled. This is the default value, and also the fastest setting. </constant> <constant name="VIEWPORT_MSAA_2X" value="1" enum="ViewportMSAA"> - Multisample antialiasing uses 2 samples per pixel. + Multisample antialiasing uses 2 samples per pixel for 3D. This has a moderate impact on performance. </constant> <constant name="VIEWPORT_MSAA_4X" value="2" enum="ViewportMSAA"> - Multisample antialiasing uses 4 samples per pixel. + Multisample antialiasing uses 4 samples per pixel for 3D. This has a high impact on performance. </constant> <constant name="VIEWPORT_MSAA_8X" value="3" enum="ViewportMSAA"> - Multisample antialiasing uses 8 samples per pixel. - </constant> - <constant name="VIEWPORT_MSAA_16X" value="4" enum="ViewportMSAA"> - Multisample antialiasing uses 16 samples per pixel. + Multisample antialiasing uses 8 samples per pixel for 3D. This has a very high impact on performance. Likely unsupported on low-end and older hardware. </constant> - <constant name="VIEWPORT_MSAA_MAX" value="5" enum="ViewportMSAA"> + <constant name="VIEWPORT_MSAA_MAX" value="4" enum="ViewportMSAA"> </constant> <constant name="VIEWPORT_SCREEN_SPACE_AA_DISABLED" value="0" enum="ViewportScreenSpaceAA"> </constant> @@ -3348,26 +3973,29 @@ </constant> <constant name="VIEWPORT_SCREEN_SPACE_AA_MAX" value="2" enum="ViewportScreenSpaceAA"> </constant> + <constant name="VIEWPORT_OCCLUSION_BUILD_QUALITY_LOW" value="0" enum="ViewportOcclusionCullingBuildQuality"> + </constant> + <constant name="VIEWPORT_OCCLUSION_BUILD_QUALITY_MEDIUM" value="1" enum="ViewportOcclusionCullingBuildQuality"> + </constant> + <constant name="VIEWPORT_OCCLUSION_BUILD_QUALITY_HIGH" value="2" enum="ViewportOcclusionCullingBuildQuality"> + </constant> <constant name="VIEWPORT_RENDER_INFO_OBJECTS_IN_FRAME" value="0" enum="ViewportRenderInfo"> Number of objects drawn in a single frame. </constant> - <constant name="VIEWPORT_RENDER_INFO_VERTICES_IN_FRAME" value="1" enum="ViewportRenderInfo"> + <constant name="VIEWPORT_RENDER_INFO_PRIMITIVES_IN_FRAME" value="1" enum="ViewportRenderInfo"> Number of vertices drawn in a single frame. </constant> - <constant name="VIEWPORT_RENDER_INFO_MATERIAL_CHANGES_IN_FRAME" value="2" enum="ViewportRenderInfo"> - Number of material changes during this frame. + <constant name="VIEWPORT_RENDER_INFO_DRAW_CALLS_IN_FRAME" value="2" enum="ViewportRenderInfo"> + Number of draw calls during this frame. </constant> - <constant name="VIEWPORT_RENDER_INFO_SHADER_CHANGES_IN_FRAME" value="3" enum="ViewportRenderInfo"> - Number of shader changes during this frame. + <constant name="VIEWPORT_RENDER_INFO_MAX" value="3" enum="ViewportRenderInfo"> + Represents the size of the [enum ViewportRenderInfo] enum. </constant> - <constant name="VIEWPORT_RENDER_INFO_SURFACE_CHANGES_IN_FRAME" value="4" enum="ViewportRenderInfo"> - Number of surface changes during this frame. + <constant name="VIEWPORT_RENDER_INFO_TYPE_VISIBLE" value="0" enum="ViewportRenderInfoType"> </constant> - <constant name="VIEWPORT_RENDER_INFO_DRAW_CALLS_IN_FRAME" value="5" enum="ViewportRenderInfo"> - Number of draw calls during this frame. + <constant name="VIEWPORT_RENDER_INFO_TYPE_SHADOW" value="1" enum="ViewportRenderInfoType"> </constant> - <constant name="VIEWPORT_RENDER_INFO_MAX" value="6" enum="ViewportRenderInfo"> - Represents the size of the [enum ViewportRenderInfo] enum. + <constant name="VIEWPORT_RENDER_INFO_TYPE_MAX" value="2" enum="ViewportRenderInfoType"> </constant> <constant name="VIEWPORT_DEBUG_DRAW_DISABLED" value="0" enum="ViewportDebugDraw"> Debug draw is disabled. Default setting. @@ -3379,7 +4007,8 @@ Objects are displayed with only light information. </constant> <constant name="VIEWPORT_DEBUG_DRAW_OVERDRAW" value="3" enum="ViewportDebugDraw"> - Objects are displayed semi-transparent with additive blending so you can see where they are drawing over top of one another. A higher overdraw means you are wasting performance on drawing pixels that are being hidden behind others. + Objects are displayed semi-transparent with additive blending so you can see where they are drawing over top of one another. A higher overdraw (represented by brighter colors) means you are wasting performance on drawing pixels that are being hidden behind others. + [b]Note:[/b] When using this debug draw mode, custom shaders will be ignored. This means vertex displacement won't be visible anymore. </constant> <constant name="VIEWPORT_DEBUG_DRAW_WIREFRAME" value="4" enum="ViewportDebugDraw"> Debug draw draws objects in wireframe. @@ -3387,14 +4016,14 @@ <constant name="VIEWPORT_DEBUG_DRAW_NORMAL_BUFFER" value="5" enum="ViewportDebugDraw"> Normal buffer is drawn instead of regular scene so you can see the per-pixel normals that will be used by post-processing effects. </constant> - <constant name="VIEWPORT_DEBUG_DRAW_GI_PROBE_ALBEDO" value="6" enum="ViewportDebugDraw"> - Objects are displayed with only the albedo value from [GIProbe]s. + <constant name="VIEWPORT_DEBUG_DRAW_VOXEL_GI_ALBEDO" value="6" enum="ViewportDebugDraw"> + Objects are displayed with only the albedo value from [VoxelGI]s. </constant> - <constant name="VIEWPORT_DEBUG_DRAW_GI_PROBE_LIGHTING" value="7" enum="ViewportDebugDraw"> - Objects are displayed with only the lighting value from [GIProbe]s. + <constant name="VIEWPORT_DEBUG_DRAW_VOXEL_GI_LIGHTING" value="7" enum="ViewportDebugDraw"> + Objects are displayed with only the lighting value from [VoxelGI]s. </constant> - <constant name="VIEWPORT_DEBUG_DRAW_GI_PROBE_EMISSION" value="8" enum="ViewportDebugDraw"> - Objects are displayed with only the emission color from [GIProbe]s. + <constant name="VIEWPORT_DEBUG_DRAW_VOXEL_GI_EMISSION" value="8" enum="ViewportDebugDraw"> + Objects are displayed with only the emission color from [VoxelGI]s. </constant> <constant name="VIEWPORT_DEBUG_DRAW_SHADOW_ATLAS" value="9" enum="ViewportDebugDraw"> Draws the shadow atlas that stores shadows from [OmniLight3D]s and [SpotLight3D]s in the upper left quadrant of the [Viewport]. @@ -3407,18 +4036,40 @@ <constant name="VIEWPORT_DEBUG_DRAW_SSAO" value="12" enum="ViewportDebugDraw"> Draws the screen space ambient occlusion texture instead of the scene so that you can clearly see how it is affecting objects. In order for this display mode to work, you must have [member Environment.ssao_enabled] set in your [WorldEnvironment]. </constant> - <constant name="VIEWPORT_DEBUG_DRAW_ROUGHNESS_LIMITER" value="13" enum="ViewportDebugDraw"> - Draws the roughness limiter post process over the Viewport so you can see where it has an effect. It must be enabled in [member ProjectSettings.rendering/quality/screen_filters/screen_space_roughness_limiter] to work. + <constant name="VIEWPORT_DEBUG_DRAW_SSIL" value="13" enum="ViewportDebugDraw"> + Draws the screen space indirect lighting texture instead of the scene so that you can clearly see how it is affecting objects. In order for this display mode to work, you must have [member Environment.ssil_enabled] set in your [WorldEnvironment]. </constant> <constant name="VIEWPORT_DEBUG_DRAW_PSSM_SPLITS" value="14" enum="ViewportDebugDraw"> Colors each PSSM split for the [DirectionalLight3D]s in the scene a different color so you can see where the splits are. In order they will be colored red, green, blue, yellow. </constant> <constant name="VIEWPORT_DEBUG_DRAW_DECAL_ATLAS" value="15" enum="ViewportDebugDraw"> </constant> - <constant name="SKY_MODE_QUALITY" value="0" enum="SkyMode"> - Uses high quality importance sampling to process the radiance map. In general, this results in much higher quality than [constant Sky.PROCESS_MODE_REALTIME] but takes much longer to generate. This should not be used if you plan on changing the sky at runtime. If you are finding that the reflection is not blurry enough and is showing sparkles or fireflies, try increasing [member ProjectSettings.rendering/quality/reflections/ggx_samples]. + <constant name="VIEWPORT_DEBUG_DRAW_SDFGI" value="16" enum="ViewportDebugDraw"> + </constant> + <constant name="VIEWPORT_DEBUG_DRAW_SDFGI_PROBES" value="17" enum="ViewportDebugDraw"> + </constant> + <constant name="VIEWPORT_DEBUG_DRAW_GI_BUFFER" value="18" enum="ViewportDebugDraw"> </constant> - <constant name="SKY_MODE_REALTIME" value="1" enum="SkyMode"> + <constant name="VIEWPORT_DEBUG_DRAW_DISABLE_LOD" value="19" enum="ViewportDebugDraw"> + </constant> + <constant name="VIEWPORT_DEBUG_DRAW_CLUSTER_OMNI_LIGHTS" value="20" enum="ViewportDebugDraw"> + </constant> + <constant name="VIEWPORT_DEBUG_DRAW_CLUSTER_SPOT_LIGHTS" value="21" enum="ViewportDebugDraw"> + </constant> + <constant name="VIEWPORT_DEBUG_DRAW_CLUSTER_DECALS" value="22" enum="ViewportDebugDraw"> + </constant> + <constant name="VIEWPORT_DEBUG_DRAW_CLUSTER_REFLECTION_PROBES" value="23" enum="ViewportDebugDraw"> + </constant> + <constant name="VIEWPORT_DEBUG_DRAW_OCCLUDERS" value="24" enum="ViewportDebugDraw"> + </constant> + <constant name="SKY_MODE_AUTOMATIC" value="0" enum="SkyMode"> + </constant> + <constant name="SKY_MODE_QUALITY" value="1" enum="SkyMode"> + Uses high quality importance sampling to process the radiance map. In general, this results in much higher quality than [constant Sky.PROCESS_MODE_REALTIME] but takes much longer to generate. This should not be used if you plan on changing the sky at runtime. If you are finding that the reflection is not blurry enough and is showing sparkles or fireflies, try increasing [member ProjectSettings.rendering/reflections/sky_reflections/ggx_samples]. + </constant> + <constant name="SKY_MODE_INCREMENTAL" value="2" enum="SkyMode"> + </constant> + <constant name="SKY_MODE_REALTIME" value="3" enum="SkyMode"> Uses the fast filtering algorithm to process the radiance map. In general this results in lower quality, but substantially faster run times. [b]Note:[/b] The fast filtering algorithm is limited to 256x256 cubemaps, so [member Sky.radiance_size] must be set to [constant Sky.RADIANCE_SIZE_256]. </constant> @@ -3499,82 +4150,118 @@ </constant> <constant name="ENV_SSR_ROUGNESS_QUALITY_HIGH" value="3" enum="EnvironmentSSRRoughnessQuality"> </constant> - <constant name="ENV_SSAO_BLUR_DISABLED" value="0" enum="EnvironmentSSAOBlur"> - Disables the blur set for SSAO. Will make SSAO look noisier. + <constant name="ENV_SSAO_QUALITY_VERY_LOW" value="0" enum="EnvironmentSSAOQuality"> + Lowest quality of screen-space ambient occlusion. </constant> - <constant name="ENV_SSAO_BLUR_1x1" value="1" enum="EnvironmentSSAOBlur"> - Perform a 1x1 blur on the SSAO output. + <constant name="ENV_SSAO_QUALITY_LOW" value="1" enum="EnvironmentSSAOQuality"> + Low quality screen-space ambient occlusion. </constant> - <constant name="ENV_SSAO_BLUR_2x2" value="2" enum="EnvironmentSSAOBlur"> - Performs a 2x2 blur on the SSAO output. + <constant name="ENV_SSAO_QUALITY_MEDIUM" value="2" enum="EnvironmentSSAOQuality"> + Medium quality screen-space ambient occlusion. </constant> - <constant name="ENV_SSAO_BLUR_3x3" value="3" enum="EnvironmentSSAOBlur"> - Performs a 3x3 blur on the SSAO output. Use this for smoothest SSAO. + <constant name="ENV_SSAO_QUALITY_HIGH" value="3" enum="EnvironmentSSAOQuality"> + High quality screen-space ambient occlusion. </constant> - <constant name="ENV_SSAO_QUALITY_LOW" value="0" enum="EnvironmentSSAOQuality"> - Lowest quality of screen space ambient occlusion. + <constant name="ENV_SSAO_QUALITY_ULTRA" value="4" enum="EnvironmentSSAOQuality"> + Highest quality screen-space ambient occlusion. Uses the adaptive target setting which can be dynamically adjusted to smoothly balance performance and visual quality. </constant> - <constant name="ENV_SSAO_QUALITY_MEDIUM" value="1" enum="EnvironmentSSAOQuality"> - Medium quality screen space ambient occlusion. + <constant name="ENV_SSIL_QUALITY_VERY_LOW" value="0" enum="EnvironmentSSILQuality"> + Lowest quality of screen-space indirect lighting. </constant> - <constant name="ENV_SSAO_QUALITY_HIGH" value="2" enum="EnvironmentSSAOQuality"> - High quality screen space ambient occlusion. + <constant name="ENV_SSIL_QUALITY_LOW" value="1" enum="EnvironmentSSILQuality"> + Low quality screen-space indirect lighting. </constant> - <constant name="ENV_SSAO_QUALITY_ULTRA" value="3" enum="EnvironmentSSAOQuality"> - Highest quality screen space ambient occlusion. + <constant name="ENV_SSIL_QUALITY_MEDIUM" value="2" enum="EnvironmentSSILQuality"> + High quality screen-space indirect lighting. </constant> - <constant name="SUB_SURFACE_SCATTERING_QUALITY_DISABLED" value="0" enum="SubSurfaceScatteringQuality"> + <constant name="ENV_SSIL_QUALITY_HIGH" value="3" enum="EnvironmentSSILQuality"> + High quality screen-space indirect lighting. </constant> - <constant name="SUB_SURFACE_SCATTERING_QUALITY_LOW" value="1" enum="SubSurfaceScatteringQuality"> + <constant name="ENV_SSIL_QUALITY_ULTRA" value="4" enum="EnvironmentSSILQuality"> + Highest quality screen-space indirect lighting. Uses the adaptive target setting which can be dynamically adjusted to smoothly balance performance and visual quality. </constant> - <constant name="SUB_SURFACE_SCATTERING_QUALITY_MEDIUM" value="2" enum="SubSurfaceScatteringQuality"> + <constant name="ENV_SDFGI_CASCADES_4" value="0" enum="EnvironmentSDFGICascades"> </constant> - <constant name="SUB_SURFACE_SCATTERING_QUALITY_HIGH" value="3" enum="SubSurfaceScatteringQuality"> + <constant name="ENV_SDFGI_CASCADES_6" value="1" enum="EnvironmentSDFGICascades"> </constant> - <constant name="DOF_BLUR_QUALITY_VERY_LOW" value="0" enum="DOFBlurQuality"> - Lowest quality DOF blur. This is the fastest setting, but you may be able to see filtering artifacts. + <constant name="ENV_SDFGI_CASCADES_8" value="2" enum="EnvironmentSDFGICascades"> </constant> - <constant name="DOF_BLUR_QUALITY_LOW" value="1" enum="DOFBlurQuality"> - Low quality DOF blur. + <constant name="ENV_SDFGI_Y_SCALE_DISABLED" value="0" enum="EnvironmentSDFGIYScale"> </constant> - <constant name="DOF_BLUR_QUALITY_MEDIUM" value="2" enum="DOFBlurQuality"> - Medium quality DOF blur. + <constant name="ENV_SDFGI_Y_SCALE_75_PERCENT" value="1" enum="EnvironmentSDFGIYScale"> </constant> - <constant name="DOF_BLUR_QUALITY_HIGH" value="3" enum="DOFBlurQuality"> - Highest quality DOF blur. Results in the smoothest looking blur by taking the most samples, but is also significantly slower. + <constant name="ENV_SDFGI_Y_SCALE_50_PERCENT" value="2" enum="EnvironmentSDFGIYScale"> </constant> - <constant name="DOF_BOKEH_BOX" value="0" enum="DOFBokehShape"> - Calculate the DOF blur using a box filter. The fastest option, but results in obvious lines in blur pattern. + <constant name="ENV_SDFGI_RAY_COUNT_4" value="0" enum="EnvironmentSDFGIRayCount"> </constant> - <constant name="DOF_BOKEH_HEXAGON" value="1" enum="DOFBokehShape"> - Calculates DOF blur using a hexagon shaped filter. + <constant name="ENV_SDFGI_RAY_COUNT_8" value="1" enum="EnvironmentSDFGIRayCount"> </constant> - <constant name="DOF_BOKEH_CIRCLE" value="2" enum="DOFBokehShape"> - Calculates DOF blur using a circle shaped filter. Best quality and most realistic, but slowest. Use only for areas where a lot of performance can be dedicated to post-processing (e.g. cutscenes). + <constant name="ENV_SDFGI_RAY_COUNT_16" value="2" enum="EnvironmentSDFGIRayCount"> </constant> - <constant name="SHADOW_QUALITY_HARD" value="0" enum="ShadowQuality"> + <constant name="ENV_SDFGI_RAY_COUNT_32" value="3" enum="EnvironmentSDFGIRayCount"> + </constant> + <constant name="ENV_SDFGI_RAY_COUNT_64" value="4" enum="EnvironmentSDFGIRayCount"> + </constant> + <constant name="ENV_SDFGI_RAY_COUNT_96" value="5" enum="EnvironmentSDFGIRayCount"> + </constant> + <constant name="ENV_SDFGI_RAY_COUNT_128" value="6" enum="EnvironmentSDFGIRayCount"> + </constant> + <constant name="ENV_SDFGI_RAY_COUNT_MAX" value="7" enum="EnvironmentSDFGIRayCount"> + </constant> + <constant name="ENV_SDFGI_CONVERGE_IN_5_FRAMES" value="0" enum="EnvironmentSDFGIFramesToConverge"> + </constant> + <constant name="ENV_SDFGI_CONVERGE_IN_10_FRAMES" value="1" enum="EnvironmentSDFGIFramesToConverge"> + </constant> + <constant name="ENV_SDFGI_CONVERGE_IN_15_FRAMES" value="2" enum="EnvironmentSDFGIFramesToConverge"> + </constant> + <constant name="ENV_SDFGI_CONVERGE_IN_20_FRAMES" value="3" enum="EnvironmentSDFGIFramesToConverge"> + </constant> + <constant name="ENV_SDFGI_CONVERGE_IN_25_FRAMES" value="4" enum="EnvironmentSDFGIFramesToConverge"> + </constant> + <constant name="ENV_SDFGI_CONVERGE_IN_30_FRAMES" value="5" enum="EnvironmentSDFGIFramesToConverge"> + </constant> + <constant name="ENV_SDFGI_CONVERGE_MAX" value="6" enum="EnvironmentSDFGIFramesToConverge"> </constant> - <constant name="SHADOW_QUALITY_SOFT_LOW" value="1" enum="ShadowQuality"> + <constant name="ENV_SDFGI_UPDATE_LIGHT_IN_1_FRAME" value="0" enum="EnvironmentSDFGIFramesToUpdateLight"> </constant> - <constant name="SHADOW_QUALITY_SOFT_MEDIUM" value="2" enum="ShadowQuality"> + <constant name="ENV_SDFGI_UPDATE_LIGHT_IN_2_FRAMES" value="1" enum="EnvironmentSDFGIFramesToUpdateLight"> </constant> - <constant name="SHADOW_QUALITY_SOFT_HIGH" value="3" enum="ShadowQuality"> + <constant name="ENV_SDFGI_UPDATE_LIGHT_IN_4_FRAMES" value="2" enum="EnvironmentSDFGIFramesToUpdateLight"> </constant> - <constant name="SHADOW_QUALITY_SOFT_ULTRA" value="4" enum="ShadowQuality"> + <constant name="ENV_SDFGI_UPDATE_LIGHT_IN_8_FRAMES" value="3" enum="EnvironmentSDFGIFramesToUpdateLight"> </constant> - <constant name="SHADOW_QUALITY_MAX" value="5" enum="ShadowQuality"> + <constant name="ENV_SDFGI_UPDATE_LIGHT_IN_16_FRAMES" value="4" enum="EnvironmentSDFGIFramesToUpdateLight"> </constant> - <constant name="SCENARIO_DEBUG_DISABLED" value="0" enum="ScenarioDebugMode"> - Do not use a debug mode. + <constant name="ENV_SDFGI_UPDATE_LIGHT_MAX" value="5" enum="EnvironmentSDFGIFramesToUpdateLight"> </constant> - <constant name="SCENARIO_DEBUG_WIREFRAME" value="1" enum="ScenarioDebugMode"> - Draw all objects as wireframe models. + <constant name="SUB_SURFACE_SCATTERING_QUALITY_DISABLED" value="0" enum="SubSurfaceScatteringQuality"> + </constant> + <constant name="SUB_SURFACE_SCATTERING_QUALITY_LOW" value="1" enum="SubSurfaceScatteringQuality"> + </constant> + <constant name="SUB_SURFACE_SCATTERING_QUALITY_MEDIUM" value="2" enum="SubSurfaceScatteringQuality"> + </constant> + <constant name="SUB_SURFACE_SCATTERING_QUALITY_HIGH" value="3" enum="SubSurfaceScatteringQuality"> + </constant> + <constant name="DOF_BOKEH_BOX" value="0" enum="DOFBokehShape"> + Calculate the DOF blur using a box filter. The fastest option, but results in obvious lines in blur pattern. + </constant> + <constant name="DOF_BOKEH_HEXAGON" value="1" enum="DOFBokehShape"> + Calculates DOF blur using a hexagon shaped filter. </constant> - <constant name="SCENARIO_DEBUG_OVERDRAW" value="2" enum="ScenarioDebugMode"> - Draw all objects in a way that displays how much overdraw is occurring. Overdraw occurs when a section of pixels is drawn and shaded and then another object covers it up. To optimize a scene, you should reduce overdraw. + <constant name="DOF_BOKEH_CIRCLE" value="2" enum="DOFBokehShape"> + Calculates DOF blur using a circle shaped filter. Best quality and most realistic, but slowest. Use only for areas where a lot of performance can be dedicated to post-processing (e.g. cutscenes). </constant> - <constant name="SCENARIO_DEBUG_SHADELESS" value="3" enum="ScenarioDebugMode"> - Draw all objects without shading. Equivalent to setting all objects shaders to [code]unshaded[/code]. + <constant name="DOF_BLUR_QUALITY_VERY_LOW" value="0" enum="DOFBlurQuality"> + Lowest quality DOF blur. This is the fastest setting, but you may be able to see filtering artifacts. + </constant> + <constant name="DOF_BLUR_QUALITY_LOW" value="1" enum="DOFBlurQuality"> + Low quality DOF blur. + </constant> + <constant name="DOF_BLUR_QUALITY_MEDIUM" value="2" enum="DOFBlurQuality"> + Medium quality DOF blur. + </constant> + <constant name="DOF_BLUR_QUALITY_HIGH" value="3" enum="DOFBlurQuality"> + Highest quality DOF blur. Results in the smoothest looking blur by taking the most samples, but is also significantly slower. </constant> <constant name="INSTANCE_NONE" value="0" enum="InstanceType"> The instance does not have a type. @@ -3585,12 +4272,11 @@ <constant name="INSTANCE_MULTIMESH" value="2" enum="InstanceType"> The instance is a multimesh. </constant> - <constant name="INSTANCE_IMMEDIATE" value="3" enum="InstanceType"> - The instance is an immediate geometry. - </constant> - <constant name="INSTANCE_PARTICLES" value="4" enum="InstanceType"> + <constant name="INSTANCE_PARTICLES" value="3" enum="InstanceType"> The instance is a particle emitter. </constant> + <constant name="INSTANCE_PARTICLES_COLLISION" value="4" enum="InstanceType"> + </constant> <constant name="INSTANCE_LIGHT" value="5" enum="InstanceType"> The instance is a light. </constant> @@ -3600,16 +4286,22 @@ <constant name="INSTANCE_DECAL" value="7" enum="InstanceType"> The instance is a decal. </constant> - <constant name="INSTANCE_GI_PROBE" value="8" enum="InstanceType"> - The instance is a GI probe. + <constant name="INSTANCE_VOXEL_GI" value="8" enum="InstanceType"> + The instance is a VoxelGI. </constant> <constant name="INSTANCE_LIGHTMAP" value="9" enum="InstanceType"> The instance is a lightmap. </constant> - <constant name="INSTANCE_MAX" value="10" enum="InstanceType"> + <constant name="INSTANCE_OCCLUDER" value="10" enum="InstanceType"> + </constant> + <constant name="INSTANCE_VISIBLITY_NOTIFIER" value="11" enum="InstanceType"> + </constant> + <constant name="INSTANCE_FOG_VOLUME" value="12" enum="InstanceType"> + </constant> + <constant name="INSTANCE_MAX" value="13" enum="InstanceType"> Represents the size of the [enum InstanceType] enum. </constant> - <constant name="INSTANCE_GEOMETRY_MASK" value="30" enum="InstanceType"> + <constant name="INSTANCE_GEOMETRY_MASK" value="14" enum="InstanceType"> A combination of the flags of geometry instances (mesh, multimesh, immediate and particles). </constant> <constant name="INSTANCE_FLAG_USE_BAKED_LIGHT" value="0" enum="InstanceFlags"> @@ -3621,7 +4313,9 @@ <constant name="INSTANCE_FLAG_DRAW_NEXT_FRAME_IF_VISIBLE" value="2" enum="InstanceFlags"> When set, manually requests to draw geometry on next frame. </constant> - <constant name="INSTANCE_FLAG_MAX" value="3" enum="InstanceFlags"> + <constant name="INSTANCE_FLAG_IGNORE_OCCLUSION_CULLING" value="3" enum="InstanceFlags"> + </constant> + <constant name="INSTANCE_FLAG_MAX" value="4" enum="InstanceFlags"> Represents the size of the [enum InstanceFlags] enum. </constant> <constant name="SHADOW_CASTING_SETTING_OFF" value="0" enum="ShadowCastingSetting"> @@ -3636,6 +4330,29 @@ <constant name="SHADOW_CASTING_SETTING_SHADOWS_ONLY" value="3" enum="ShadowCastingSetting"> Only render the shadows from the object. The object itself will not be drawn. </constant> + <constant name="VISIBILITY_RANGE_FADE_DISABLED" value="0" enum="VisibilityRangeFadeMode"> + Disable visibility range fading for the given instance. + </constant> + <constant name="VISIBILITY_RANGE_FADE_SELF" value="1" enum="VisibilityRangeFadeMode"> + Fade-out the given instance when it approaches its visibility range limits. + </constant> + <constant name="VISIBILITY_RANGE_FADE_DEPENDENCIES" value="2" enum="VisibilityRangeFadeMode"> + Fade-in the given instance's dependencies when reaching its visibility range limits. + </constant> + <constant name="BAKE_CHANNEL_ALBEDO_ALPHA" value="0" enum="BakeChannels"> + </constant> + <constant name="BAKE_CHANNEL_NORMAL" value="1" enum="BakeChannels"> + </constant> + <constant name="BAKE_CHANNEL_ORM" value="2" enum="BakeChannels"> + </constant> + <constant name="BAKE_CHANNEL_EMISSION" value="3" enum="BakeChannels"> + </constant> + <constant name="CANVAS_TEXTURE_CHANNEL_DIFFUSE" value="0" enum="CanvasTextureChannel"> + </constant> + <constant name="CANVAS_TEXTURE_CHANNEL_NORMAL" value="1" enum="CanvasTextureChannel"> + </constant> + <constant name="CANVAS_TEXTURE_CHANNEL_SPECULAR" value="2" enum="CanvasTextureChannel"> + </constant> <constant name="NINE_PATCH_STRETCH" value="0" enum="NinePatchAxisMode"> The nine patch gets stretched where needed. </constant> @@ -3684,18 +4401,25 @@ <constant name="CANVAS_ITEM_TEXTURE_REPEAT_MAX" value="4" enum="CanvasItemTextureRepeat"> Max value for [enum CanvasItemTextureRepeat] enum. </constant> - <constant name="CANVAS_LIGHT_MODE_ADD" value="0" enum="CanvasLightMode"> + <constant name="CANVAS_GROUP_MODE_DISABLED" value="0" enum="CanvasGroupMode"> + </constant> + <constant name="CANVAS_GROUP_MODE_OPAQUE" value="1" enum="CanvasGroupMode"> + </constant> + <constant name="CANVAS_GROUP_MODE_TRANSPARENT" value="2" enum="CanvasGroupMode"> + </constant> + <constant name="CANVAS_LIGHT_MODE_POINT" value="0" enum="CanvasLightMode"> + </constant> + <constant name="CANVAS_LIGHT_MODE_DIRECTIONAL" value="1" enum="CanvasLightMode"> + </constant> + <constant name="CANVAS_LIGHT_BLEND_MODE_ADD" value="0" enum="CanvasLightBlendMode"> Adds light color additive to the canvas. </constant> - <constant name="CANVAS_LIGHT_MODE_SUB" value="1" enum="CanvasLightMode"> + <constant name="CANVAS_LIGHT_BLEND_MODE_SUB" value="1" enum="CanvasLightBlendMode"> Adds light color subtractive to the canvas. </constant> - <constant name="CANVAS_LIGHT_MODE_MIX" value="2" enum="CanvasLightMode"> + <constant name="CANVAS_LIGHT_BLEND_MODE_MIX" value="2" enum="CanvasLightBlendMode"> The light adds color depending on transparency. </constant> - <constant name="CANVAS_LIGHT_MODE_MASK" value="3" enum="CanvasLightMode"> - The light adds color depending on mask. - </constant> <constant name="CANVAS_LIGHT_FILTER_NONE" value="0" enum="CanvasLightShadowFilter"> Do not apply a filter to canvas light shadows. </constant> @@ -3775,35 +4499,17 @@ </constant> <constant name="GLOBAL_VAR_TYPE_MAX" value="28" enum="GlobalVariableType"> </constant> - <constant name="INFO_OBJECTS_IN_FRAME" value="0" enum="RenderInfo"> - The amount of objects in the frame. - </constant> - <constant name="INFO_VERTICES_IN_FRAME" value="1" enum="RenderInfo"> - The amount of vertices in the frame. - </constant> - <constant name="INFO_MATERIAL_CHANGES_IN_FRAME" value="2" enum="RenderInfo"> - The amount of modified materials in the frame. - </constant> - <constant name="INFO_SHADER_CHANGES_IN_FRAME" value="3" enum="RenderInfo"> - The amount of shader rebinds in the frame. - </constant> - <constant name="INFO_SURFACE_CHANGES_IN_FRAME" value="4" enum="RenderInfo"> - The amount of surface changes in the frame. + <constant name="RENDERING_INFO_TOTAL_OBJECTS_IN_FRAME" value="0" enum="RenderingInfo"> </constant> - <constant name="INFO_DRAW_CALLS_IN_FRAME" value="5" enum="RenderInfo"> - The amount of draw calls in frame. + <constant name="RENDERING_INFO_TOTAL_PRIMITIVES_IN_FRAME" value="1" enum="RenderingInfo"> </constant> - <constant name="INFO_USAGE_VIDEO_MEM_TOTAL" value="6" enum="RenderInfo"> - Unimplemented in the GLES2 rendering backend, always returns 0. + <constant name="RENDERING_INFO_TOTAL_DRAW_CALLS_IN_FRAME" value="2" enum="RenderingInfo"> </constant> - <constant name="INFO_VIDEO_MEM_USED" value="7" enum="RenderInfo"> - The amount of video memory used, i.e. texture and vertex memory combined. + <constant name="RENDERING_INFO_TEXTURE_MEM_USED" value="3" enum="RenderingInfo"> </constant> - <constant name="INFO_TEXTURE_MEM_USED" value="8" enum="RenderInfo"> - The amount of texture memory used. + <constant name="RENDERING_INFO_BUFFER_MEM_USED" value="4" enum="RenderingInfo"> </constant> - <constant name="INFO_VERTEX_MEM_USED" value="9" enum="RenderInfo"> - The amount of vertex memory used. + <constant name="RENDERING_INFO_VIDEO_MEM_USED" value="5" enum="RenderingInfo"> </constant> <constant name="FEATURE_SHADERS" value="0" enum="Features"> Hardware supports shaders. This enum is currently unused in Godot 3.x. |