diff options
Diffstat (limited to 'doc/classes/CanvasItem.xml')
| -rw-r--r-- | doc/classes/CanvasItem.xml | 178 |
1 files changed, 118 insertions, 60 deletions
diff --git a/doc/classes/CanvasItem.xml b/doc/classes/CanvasItem.xml index b8e09708e3..7f50587e66 100644 --- a/doc/classes/CanvasItem.xml +++ b/doc/classes/CanvasItem.xml @@ -39,8 +39,6 @@ </argument> <argument index="6" name="width" type="float" default="1.0"> </argument> - <argument index="7" name="antialiased" type="bool" default="false"> - </argument> <description> Draws an arc between the given angles. The larger the value of [code]point_count[/code], the smoother the curve. </description> @@ -84,11 +82,17 @@ </argument> <argument index="2" name="uvs" type="PoolVector2Array" default="PoolVector2Array( )"> </argument> - <argument index="3" name="texture" type="Texture" default="null"> + <argument index="3" name="texture" type="Texture2D" default="null"> + </argument> + <argument index="4" name="normal_map" type="Texture2D" default="null"> + </argument> + <argument index="5" name="specular_map" type="Texture2D" default="null"> + </argument> + <argument index="6" name="specular_shinness" type="Color" default="Color( 1, 1, 1, 1 )"> </argument> - <argument index="4" name="normal_map" type="Texture" default="null"> + <argument index="7" name="texture_filter" type="int" enum="CanvasItem.TextureFilter" default="0"> </argument> - <argument index="5" name="antialiased" type="bool" default="false"> + <argument index="8" name="texture_repeat" type="int" enum="CanvasItem.TextureRepeat" default="0"> </argument> <description> Draws a colored polygon of any amount of points, convex or concave. @@ -105,10 +109,8 @@ </argument> <argument index="3" name="width" type="float" default="1.0"> </argument> - <argument index="4" name="antialiased" type="bool" default="false"> - </argument> <description> - Draws a line from a 2D point to another, with a given color and width. It can be optionally antialiased. + Draws a line from a 2D point to another, with a given color and width. </description> </method> <method name="draw_mesh"> @@ -116,13 +118,21 @@ </return> <argument index="0" name="mesh" type="Mesh"> </argument> - <argument index="1" name="texture" type="Texture"> + <argument index="1" name="texture" type="Texture2D" default="null"> </argument> - <argument index="2" name="normal_map" type="Texture" default="null"> + <argument index="2" name="normal_map" type="Texture2D" default="null"> </argument> - <argument index="3" name="transform" type="Transform2D" default="Transform2D( 1, 0, 0, 1, 0, 0 )"> + <argument index="3" name="specular_map" type="Texture2D" default="Color( 1, 1, 1, 1 )"> </argument> - <argument index="4" name="modulate" type="Color" default="Color( 1, 1, 1, 1 )"> + <argument index="4" name="transform" type="Color" default="Transform2D( 1, 0, 0, 1, 0, 0 )"> + </argument> + <argument index="5" name="modulate" type="Transform2D" default="Color( 1, 1, 1, 1 )"> + </argument> + <argument index="6" name="specular_shinness" type="Color" default="Color( 1, 1, 1, 1 )"> + </argument> + <argument index="7" name="texture_filter" type="int" enum="CanvasItem.TextureFilter" default="0"> + </argument> + <argument index="8" name="texture_repeat" type="int" enum="CanvasItem.TextureRepeat" default="0"> </argument> <description> Draws a [Mesh] in 2D, using the provided texture. See [MeshInstance2D] for related documentation. @@ -137,10 +147,8 @@ </argument> <argument index="2" name="width" type="float" default="1.0"> </argument> - <argument index="3" name="antialiased" type="bool" default="false"> - </argument> <description> - Draws multiple, parallel lines with a uniform [code]color[/code]. [code]width[/code] and [code]antialiased[/code] are currently not implemented and have no effect. + Draws multiple, parallel lines with a uniform [code]color[/code]. </description> </method> <method name="draw_multiline_colors"> @@ -152,10 +160,8 @@ </argument> <argument index="2" name="width" type="float" default="1.0"> </argument> - <argument index="3" name="antialiased" type="bool" default="false"> - </argument> <description> - Draws multiple, parallel lines with a uniform [code]width[/code], segment-by-segment coloring, and optional antialiasing. Colors assigned to line segments match by index between [code]points[/code] and [code]colors[/code]. + Draws multiple, parallel lines with a uniform [code]width[/code] and segment-by-segment coloring. Colors assigned to line segments match by index between [code]points[/code] and [code]colors[/code]. </description> </method> <method name="draw_multimesh"> @@ -163,9 +169,17 @@ </return> <argument index="0" name="multimesh" type="MultiMesh"> </argument> - <argument index="1" name="texture" type="Texture"> + <argument index="1" name="texture" type="Texture2D" default="null"> + </argument> + <argument index="2" name="normal_map" type="Texture2D" default="null"> + </argument> + <argument index="3" name="specular_map" type="Texture2D" default="null"> + </argument> + <argument index="4" name="specular_shinness" type="Color" default="Color( 1, 1, 1, 1 )"> </argument> - <argument index="2" name="normal_map" type="Texture" default="null"> + <argument index="5" name="texture_filter" type="int" enum="CanvasItem.TextureFilter" default="0"> + </argument> + <argument index="6" name="texture_repeat" type="int" enum="CanvasItem.TextureRepeat" default="0"> </argument> <description> Draws a [MultiMesh] in 2D with the provided texture. See [MultiMeshInstance2D] for related documentation. @@ -180,11 +194,17 @@ </argument> <argument index="2" name="uvs" type="PoolVector2Array" default="PoolVector2Array( )"> </argument> - <argument index="3" name="texture" type="Texture" default="null"> + <argument index="3" name="texture" type="Texture2D" default="null"> + </argument> + <argument index="4" name="normal_map" type="Texture2D" default="null"> + </argument> + <argument index="5" name="specular_map" type="Texture2D" default="null"> + </argument> + <argument index="6" name="specular_shinness" type="Color" default="Color( 1, 1, 1, 1 )"> </argument> - <argument index="4" name="normal_map" type="Texture" default="null"> + <argument index="7" name="texture_filter" type="int" enum="CanvasItem.TextureFilter" default="0"> </argument> - <argument index="5" name="antialiased" type="bool" default="false"> + <argument index="8" name="texture_repeat" type="int" enum="CanvasItem.TextureRepeat" default="0"> </argument> <description> Draws a polygon of any amount of points, convex or concave. @@ -199,10 +219,8 @@ </argument> <argument index="2" name="width" type="float" default="1.0"> </argument> - <argument index="3" name="antialiased" type="bool" default="false"> - </argument> <description> - Draws interconnected line segments with a uniform [code]color[/code] and [code]width[/code] and optional antialiasing. + Draws interconnected line segments with a uniform [code]color[/code] and [code]width[/code]. </description> </method> <method name="draw_polyline_colors"> @@ -214,10 +232,8 @@ </argument> <argument index="2" name="width" type="float" default="1.0"> </argument> - <argument index="3" name="antialiased" type="bool" default="false"> - </argument> <description> - Draws interconnected line segments with a uniform [code]width[/code], segment-by-segment coloring, and optional antialiasing. Colors assigned to line segments match by index between [code]points[/code] and [code]colors[/code]. + Draws interconnected line segments with a uniform [code]width[/code] and segment-by-segment coloring. Colors assigned to line segments match by index between [code]points[/code] and [code]colors[/code]. </description> </method> <method name="draw_primitive"> @@ -229,11 +245,19 @@ </argument> <argument index="2" name="uvs" type="PoolVector2Array"> </argument> - <argument index="3" name="texture" type="Texture" default="null"> + <argument index="3" name="texture" type="Texture2D" default="null"> </argument> <argument index="4" name="width" type="float" default="1.0"> </argument> - <argument index="5" name="normal_map" type="Texture" default="null"> + <argument index="5" name="normal_map" type="Texture2D" default="null"> + </argument> + <argument index="6" name="specular_map" type="Texture2D" default="null"> + </argument> + <argument index="7" name="specular_shinness" type="Color" default="Color( 1, 1, 1, 1 )"> + </argument> + <argument index="8" name="texture_filter" type="int" enum="CanvasItem.TextureFilter" default="0"> + </argument> + <argument index="9" name="texture_repeat" type="int" enum="CanvasItem.TextureRepeat" default="0"> </argument> <description> Draws a custom primitive. 1 point for a point, 2 points for a line, 3 points for a triangle and 4 points for a quad. @@ -250,11 +274,9 @@ </argument> <argument index="3" name="width" type="float" default="1.0"> </argument> - <argument index="4" name="antialiased" type="bool" default="false"> - </argument> <description> - Draws a rectangle. If [code]filled[/code] is [code]true[/code], the rectangle will be filled with the [code]color[/code] specified. If [code]filled[/code] is [code]false[/code], the rectangle will be drawn as a stroke with the [code]color[/code] and [code]width[/code] specified. If [code]antialiased[/code] is [code]true[/code], the lines will be antialiased. - [b]Note:[/b] [code]width[/code] and [code]antialiased[/code] are only effective if [code]filled[/code] is [code]false[/code]. + Draws a rectangle. If [code]filled[/code] is [code]true[/code], the rectangle will be filled with the [code]color[/code] specified. If [code]filled[/code] is [code]false[/code], the rectangle will be drawn as a stroke with the [code]color[/code] and [code]width[/code] specified. + [b]Note:[/b] [code]width[/code] is only effective if [code]filled[/code] is [code]false[/code]. </description> </method> <method name="draw_set_transform"> @@ -310,13 +332,21 @@ <method name="draw_texture"> <return type="void"> </return> - <argument index="0" name="texture" type="Texture"> + <argument index="0" name="texture" type="Texture2D"> </argument> <argument index="1" name="position" type="Vector2"> </argument> <argument index="2" name="modulate" type="Color" default="Color( 1, 1, 1, 1 )"> </argument> - <argument index="3" name="normal_map" type="Texture" default="null"> + <argument index="3" name="normal_map" type="Texture2D" default="null"> + </argument> + <argument index="4" name="specular_map" type="Texture2D" default="null"> + </argument> + <argument index="5" name="specular_shinness" type="Color" default="Color( 1, 1, 1, 1 )"> + </argument> + <argument index="6" name="texture_filter" type="int" enum="CanvasItem.TextureFilter" default="0"> + </argument> + <argument index="7" name="texture_repeat" type="int" enum="CanvasItem.TextureRepeat" default="0"> </argument> <description> Draws a texture at a given position. @@ -325,7 +355,7 @@ <method name="draw_texture_rect"> <return type="void"> </return> - <argument index="0" name="texture" type="Texture"> + <argument index="0" name="texture" type="Texture2D"> </argument> <argument index="1" name="rect" type="Rect2"> </argument> @@ -335,7 +365,15 @@ </argument> <argument index="4" name="transpose" type="bool" default="false"> </argument> - <argument index="5" name="normal_map" type="Texture" default="null"> + <argument index="5" name="normal_map" type="Texture2D" default="null"> + </argument> + <argument index="6" name="specular_map" type="Texture2D" default="null"> + </argument> + <argument index="7" name="specular_shinness" type="Color" default="Color( 1, 1, 1, 1 )"> + </argument> + <argument index="8" name="texture_filter" type="int" enum="CanvasItem.TextureFilter" default="0"> + </argument> + <argument index="9" name="texture_repeat" type="int" enum="CanvasItem.TextureRepeat" default="0"> </argument> <description> Draws a textured rectangle at a given position, optionally modulated by a color. If [code]transpose[/code] is [code]true[/code], the texture will have its X and Y coordinates swapped. @@ -344,7 +382,7 @@ <method name="draw_texture_rect_region"> <return type="void"> </return> - <argument index="0" name="texture" type="Texture"> + <argument index="0" name="texture" type="Texture2D"> </argument> <argument index="1" name="rect" type="Rect2"> </argument> @@ -354,9 +392,17 @@ </argument> <argument index="4" name="transpose" type="bool" default="false"> </argument> - <argument index="5" name="normal_map" type="Texture" default="null"> + <argument index="5" name="normal_map" type="Texture2D" default="null"> + </argument> + <argument index="6" name="specular_map" type="Texture2D" default="null"> + </argument> + <argument index="7" name="clip_uv" type="Color" default="true"> + </argument> + <argument index="8" name="specular_shinness" type="bool" default="Color( 1, 1, 1, 1 )"> + </argument> + <argument index="9" name="texture_filter" type="int" enum="CanvasItem.TextureFilter" default="0"> </argument> - <argument index="6" name="clip_uv" type="bool" default="true"> + <argument index="10" name="texture_repeat" type="int" enum="CanvasItem.TextureRepeat" default="0"> </argument> <description> Draws a textured rectangle region at a given position, optionally modulated by a color. If [code]transpose[/code] is [code]true[/code], the texture will have its X and Y coordinates swapped. @@ -560,6 +606,10 @@ <member name="show_on_top" type="bool" setter="_set_on_top" getter="_is_on_top"> If [code]true[/code], the object draws on top of its parent. </member> + <member name="texture_filter" type="int" setter="set_texture_filter" getter="get_texture_filter" enum="CanvasItem.TextureFilter" default="0"> + </member> + <member name="texture_repeat" type="int" setter="set_texture_repeat" getter="get_texture_repeat" enum="CanvasItem.TextureRepeat" default="0"> + </member> <member name="use_parent_material" type="bool" setter="set_use_parent_material" getter="get_use_parent_material" default="false"> If [code]true[/code], the parent [CanvasItem]'s [member material] property is used as this one's material. </member> @@ -590,24 +640,6 @@ </signal> </signals> <constants> - <constant name="BLEND_MODE_MIX" value="0" enum="BlendMode"> - Mix blending mode. Colors are assumed to be independent of the alpha (opacity) value. - </constant> - <constant name="BLEND_MODE_ADD" value="1" enum="BlendMode"> - Additive blending mode. - </constant> - <constant name="BLEND_MODE_SUB" value="2" enum="BlendMode"> - Subtractive blending mode. - </constant> - <constant name="BLEND_MODE_MUL" value="3" enum="BlendMode"> - Multiplicative blending mode. - </constant> - <constant name="BLEND_MODE_PREMULT_ALPHA" value="4" enum="BlendMode"> - Mix blending mode. Colors are assumed to be premultiplied by the alpha (opacity) value. - </constant> - <constant name="BLEND_MODE_DISABLED" value="5" enum="BlendMode"> - Disables blending mode. Colors including alpha are written as-is. Only applicable for render targets with a transparent background. No lighting will be applied. - </constant> <constant name="NOTIFICATION_TRANSFORM_CHANGED" value="2000"> The [CanvasItem]'s transform has changed. This notification is only received if enabled by [method set_notify_transform] or [method set_notify_local_transform]. </constant> @@ -623,5 +655,31 @@ <constant name="NOTIFICATION_EXIT_CANVAS" value="33"> The [CanvasItem] has exited the canvas. </constant> + <constant name="TEXTURE_FILTER_PARENT_NODE" value="0" enum="TextureFilter"> + </constant> + <constant name="TEXTURE_FILTER_NEAREST" value="1" enum="TextureFilter"> + </constant> + <constant name="TEXTURE_FILTER_LINEAR" value="2" enum="TextureFilter"> + </constant> + <constant name="TEXTURE_FILTER_NEAREST_WITH_MIMPAMPS" value="3" enum="TextureFilter"> + </constant> + <constant name="TEXTURE_FILTER_LINEAR_WITH_MIPMAPS" value="4" enum="TextureFilter"> + </constant> + <constant name="TEXTURE_FILTER_NEAREST_WITH_MIMPAMPS_ANISOTROPIC" value="5" enum="TextureFilter"> + </constant> + <constant name="TEXTURE_FILTER_LINEAR_WITH_MIPMAPS_ANISOTROPIC" value="6" enum="TextureFilter"> + </constant> + <constant name="TEXTURE_FILTER_MAX" value="7" enum="TextureFilter"> + </constant> + <constant name="TEXTURE_REPEAT_PARENT_NODE" value="0" enum="TextureRepeat"> + </constant> + <constant name="TEXTURE_REPEAT_DISABLED" value="1" enum="TextureRepeat"> + </constant> + <constant name="TEXTURE_REPEAT_ENABLED" value="2" enum="TextureRepeat"> + </constant> + <constant name="TEXTURE_REPEAT_MIRROR" value="3" enum="TextureRepeat"> + </constant> + <constant name="TEXTURE_REPEAT_MAX" value="4" enum="TextureRepeat"> + </constant> </constants> </class> |