Line2D.xml 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138
  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <class name="Line2D" inherits="Node2D" version="3.2">
  3. <brief_description>
  4. A 2D line.
  5. </brief_description>
  6. <description>
  7. A line through several points in 2D space.
  8. </description>
  9. <tutorials>
  10. </tutorials>
  11. <methods>
  12. <method name="add_point">
  13. <return type="void">
  14. </return>
  15. <argument index="0" name="position" type="Vector2">
  16. </argument>
  17. <argument index="1" name="at_position" type="int" default="-1">
  18. </argument>
  19. <description>
  20. Adds a point at the [code]position[/code]. Appends the point at the end of the line.
  21. If [code]at_position[/code] is given, the point is inserted before the point number [code]at_position[/code], moving that point (and every point after) after the inserted point. If [code]at_position[/code] is not given, or is an illegal value ([code]at_position &lt; 0[/code] or [code]at_position &gt;= [method get_point_count][/code]), the point will be appended at the end of the point list.
  22. </description>
  23. </method>
  24. <method name="clear_points">
  25. <return type="void">
  26. </return>
  27. <description>
  28. Removes all points from the line.
  29. </description>
  30. </method>
  31. <method name="get_point_count" qualifiers="const">
  32. <return type="int">
  33. </return>
  34. <description>
  35. Returns the Line2D's amount of points.
  36. </description>
  37. </method>
  38. <method name="get_point_position" qualifiers="const">
  39. <return type="Vector2">
  40. </return>
  41. <argument index="0" name="i" type="int">
  42. </argument>
  43. <description>
  44. Returns point [code]i[/code]'s position.
  45. </description>
  46. </method>
  47. <method name="remove_point">
  48. <return type="void">
  49. </return>
  50. <argument index="0" name="i" type="int">
  51. </argument>
  52. <description>
  53. Removes the point at index [code]i[/code] from the line.
  54. </description>
  55. </method>
  56. <method name="set_point_position">
  57. <return type="void">
  58. </return>
  59. <argument index="0" name="i" type="int">
  60. </argument>
  61. <argument index="1" name="position" type="Vector2">
  62. </argument>
  63. <description>
  64. Overwrites the position in point [code]i[/code] with the supplied [code]position[/code].
  65. </description>
  66. </method>
  67. </methods>
  68. <members>
  69. <member name="antialiased" type="bool" setter="set_antialiased" getter="get_antialiased" default="false">
  70. If [code]true[/code], the line's border will be anti-aliased.
  71. </member>
  72. <member name="begin_cap_mode" type="int" setter="set_begin_cap_mode" getter="get_begin_cap_mode" enum="Line2D.LineCapMode" default="0">
  73. Controls the style of the line's first point. Use [enum LineCapMode] constants.
  74. </member>
  75. <member name="default_color" type="Color" setter="set_default_color" getter="get_default_color" default="Color( 0.4, 0.5, 1, 1 )">
  76. The line's color. Will not be used if a gradient is set.
  77. </member>
  78. <member name="end_cap_mode" type="int" setter="set_end_cap_mode" getter="get_end_cap_mode" enum="Line2D.LineCapMode" default="0">
  79. Controls the style of the line's last point. Use [enum LineCapMode] constants.
  80. </member>
  81. <member name="gradient" type="Gradient" setter="set_gradient" getter="get_gradient">
  82. The gradient is drawn through the whole line from start to finish. The default color will not be used if a gradient is set.
  83. </member>
  84. <member name="joint_mode" type="int" setter="set_joint_mode" getter="get_joint_mode" enum="Line2D.LineJointMode" default="0">
  85. The style for the points between the start and the end.
  86. </member>
  87. <member name="points" type="PoolVector2Array" setter="set_points" getter="get_points" default="PoolVector2Array( )">
  88. The points that form the lines. The line is drawn between every point set in this array.
  89. </member>
  90. <member name="round_precision" type="int" setter="set_round_precision" getter="get_round_precision" default="8">
  91. The smoothness of the rounded joints and caps. This is only used if a cap or joint is set as round.
  92. </member>
  93. <member name="sharp_limit" type="float" setter="set_sharp_limit" getter="get_sharp_limit" default="2.0">
  94. The direction difference in radians between vector points. This value is only used if [code]joint mode[/code] is set to [constant LINE_JOINT_SHARP].
  95. </member>
  96. <member name="texture" type="Texture" setter="set_texture" getter="get_texture">
  97. The texture used for the line's texture. Uses [code]texture_mode[/code] for drawing style.
  98. </member>
  99. <member name="texture_mode" type="int" setter="set_texture_mode" getter="get_texture_mode" enum="Line2D.LineTextureMode" default="0">
  100. The style to render the [code]texture[/code] on the line. Use [enum LineTextureMode] constants.
  101. </member>
  102. <member name="width" type="float" setter="set_width" getter="get_width" default="10.0">
  103. The line's width.
  104. </member>
  105. <member name="width_curve" type="Curve" setter="set_curve" getter="get_curve">
  106. The line's width varies with the curve. The original width is simply multiply by the value of the Curve.
  107. </member>
  108. </members>
  109. <constants>
  110. <constant name="LINE_JOINT_SHARP" value="0" enum="LineJointMode">
  111. The line's joints will be pointy. If [code]sharp_limit[/code] is greater than the rotation of a joint, it becomes a bevel joint instead.
  112. </constant>
  113. <constant name="LINE_JOINT_BEVEL" value="1" enum="LineJointMode">
  114. The line's joints will be bevelled/chamfered.
  115. </constant>
  116. <constant name="LINE_JOINT_ROUND" value="2" enum="LineJointMode">
  117. The line's joints will be rounded.
  118. </constant>
  119. <constant name="LINE_CAP_NONE" value="0" enum="LineCapMode">
  120. Don't draw a line cap.
  121. </constant>
  122. <constant name="LINE_CAP_BOX" value="1" enum="LineCapMode">
  123. Draws the line cap as a box.
  124. </constant>
  125. <constant name="LINE_CAP_ROUND" value="2" enum="LineCapMode">
  126. Draws the line cap as a circle.
  127. </constant>
  128. <constant name="LINE_TEXTURE_NONE" value="0" enum="LineTextureMode">
  129. Takes the left pixels of the texture and renders it over the whole line.
  130. </constant>
  131. <constant name="LINE_TEXTURE_TILE" value="1" enum="LineTextureMode">
  132. Tiles the texture over the line. The texture must be imported with [b]Repeat[/b] enabled for it to work properly.
  133. </constant>
  134. <constant name="LINE_TEXTURE_STRETCH" value="2" enum="LineTextureMode">
  135. Stretches the texture across the line. Import the texture with [b]Repeat[/b] disabled for best results.
  136. </constant>
  137. </constants>
  138. </class>