class-description NEWS COMMUNITY STORE TUTORIALS SIGN UP LOGIN LOGOUT ROKOJORI NEWSLETTER SIGN UP LOGIN LOGOUT NEWS COMMUNITY STORE TUTORIALS TOGGLE FULLSCREEN VOLLBILD AN/AUS ObjectNodeCanvasItemNode2D Line2D
A 2D polyline that can optionally be textured.

This node draws a 2D polyline, i.e. a shape consisting of several points connected by segments. Line2D is not a mathematical polyline, i.e. the segments are not infinitely thin. It is intended for rendering and it can be colored and optionally textured.

Warning: Certain configurations may be impossible to draw nicely, such as very sharp angles. In these situations, the node uses fallback drawing logic to look decent.

 Enum LineJointMode<>():Enum

LINE_JOINT_SHARP = 0

Makes the polyline's joints pointy, connecting the sides of the two segments by extending them until they intersect. If the rotation of a joint is too big (based on sharp_limit), the joint falls back to LINE_JOINT_BEVEL to prevent very long miters.


LINE_JOINT_BEVEL = 1

Makes the polyline's joints bevelled/chamfered, connecting the sides of the two segments with a simple line.


LINE_JOINT_ROUND = 2

Makes the polyline's joints rounded, connecting the sides of the two segments with an arc. The detail of this arc depends on round_precision.

 Enum LineCapMode<>():Enum

LINE_CAP_NONE = 0

Draws no line cap.


LINE_CAP_BOX = 1

Draws the line cap as a box, slightly extending the first/last segment.


LINE_CAP_ROUND = 2

Draws the line cap as a semicircle attached to the first/last segment.

 Enum LineTextureMode<>():Enum

LINE_TEXTURE_NONE = 0

Takes the left pixels of the texture and renders them over the whole polyline.


LINE_TEXTURE_TILE = 1

Tiles the texture over the polyline. CanvasItem.texture_repeat of the Line2D node must be CanvasItem.TEXTURE_REPEAT_ENABLED or CanvasItem.TEXTURE_REPEAT_MIRROR for it to work properly.


LINE_TEXTURE_STRETCH = 2

Stretches the texture across the polyline. CanvasItem.texture_repeat of the Line2D node must be CanvasItem.TEXTURE_REPEAT_DISABLED for best results.

 bool antialiased<>():bool

If true, the polyline's border will be anti-aliased.

Note: Line2D is not accelerated by batching when being anti-aliased.

 LineCapMode begin_cap_mode<>():LineCapMode

The style of the beginning of the polyline, if closed is false. Use LineCapMode constants.

 bool closed<>():bool

If true and the polyline has more than 2 points, the last point and the first one will be connected by a segment.

Note: The shape of the closing segment is not guaranteed to be seamless if a width_curve is provided.

Note: The joint between the closing segment and the first segment is drawn first and it samples the gradient and the width_curve at the beginning. This is an implementation detail that might change in a future version.

 Color default_color<>():Color

The color of the polyline. Will not be used if a gradient is set.

 LineCapMode end_cap_mode<>():LineCapMode

The style of the end of the polyline, if closed is false. Use LineCapMode constants.

 Gradient gradient<>():Gradient

The gradient is drawn through the whole line from start to finish. The default_color will not be used if this property is set.

 LineJointMode joint_mode<>():LineJointMode

The style of the connections between segments of the polyline. Use LineJointMode constants.

 PackedVector2Array points<>():PackedVector2Array

The points of the polyline, interpreted in local 2D coordinates. Segments are drawn between the adjacent points in this array.

Note: The returned array is copied and any changes to it will not update the original property value. See PackedVector2Array for more details.

 int round_precision<>():int

The smoothness used for rounded joints and caps. Higher values result in smoother corners, but are more demanding to render and update.

 float sharp_limit<>():float

Determines the miter limit of the polyline. Normally, when joint_mode is set to LINE_JOINT_SHARP, sharp angles fall back to using the logic of LINE_JOINT_BEVEL joints to prevent very long miters. Higher values of this property mean that the fallback to a bevel joint will happen at sharper angles.

 Texture2D texture<>():Texture2D

The texture used for the polyline. Uses texture_mode for drawing style.

 LineTextureMode texture_mode<>():LineTextureMode

The style to render the texture of the polyline. Use LineTextureMode constants.

 float width<>():float

The polyline's width.

 Curve width_curve<>():Curve

The polyline's width curve. The width of the polyline over its length will be equivalent to the value of the width curve over its domain. The width curve should be a unit Curve.

 void add_point<>( Vector2 position=, position:Vector2=, int index=-1, index:int=-1, ):void

Adds a point with the specified position relative to the polyline's own position. If no index is provided, the new point will be added to the end of the points array.

If index is given, the new point is inserted before the existing point identified by index index. The indices of the points after the new point get increased by 1. The provided index must not exceed the number of existing points in the polyline. See get_point_count().

 void clear_points<>():void

Removes all points from the polyline, making it empty.

 int get_point_count<>():int

Returns the number of points in the polyline.

 Vector2 get_point_position<>( int index=, index:int=, ):Vector2

Returns the position of the point at index index.

 void remove_point<>( int index=, index:int=, ):void

Removes the point at index index from the polyline.

 void set_point_position<>( int index=, index:int=, Vector2 position=, position:Vector2=, ):void

Overwrites the position of the point at the given index with the supplied position.


All social media brands are registrated trademarks and belong to their respective owners.





CONTACT IMPRINT TERMS OF USE PRIVACY © ROKOROJI ® 2021 rokojori.com CONTACT IMPRINT TERMS OF USE PRIVACY © ROKOROJI ® 2021 rokojori.com We are using cookies on this site. Read more... Wir benutzen Cookies auf dieser Seite. Mehr lesen...