GeomLine
Inherits: Node3D
A line segment in 3D space.
Drawing it
The code behind the picture above.
GeomDraw.matrix = Transform3D.IDENTITY
GeomDraw.line_end_cap = Geom.CAP_ROUND
GeomDraw.thickness = 0.16
GeomDraw.line_colored(Vector3(-1.1, -0.6, 0), Vector3(1.1, 0.6, 0), ROSE)Properties
| BlendMode | blend_mode | Geom.BLEND_TRANSPARENT |
| Color | color | Color(1, 1, 1, 1) |
| Color | color_end | Color(1, 1, 1, 1) |
| GeomDash | dash | null |
| Vector3 | end | Vector3(0.5, 0, 0) |
| LineEndCap | end_cap | Geom.CAP_ROUND |
| bool | gradient | false |
| Vector3 | start | Vector3(-0.5, 0, 0) |
| float | thickness | 0.05 |
| ThicknessSpace | thickness_space | Geom.SPACE_METERS |
Enumerations
enum Geom.ThicknessSpace
- Geom.SPACE_METERS = 0
- Thickness in world units; shrinks on screen with distance.
- Geom.SPACE_PIXELS = 1
- Thickness in screen pixels; constant on-screen size.
- Geom.SPACE_VIEWPORT = 2
- A fraction of the viewport: 100 span its shorter side, so 1 is one percent of it and about 11 pixels at 1080p. The same idea as CSS
vmin. Radii and sizes here are whole-ish numbers; strokes come out below 1, and a stroke that should stay a fixed pixel width wantsSPACE_PIXELSinstead.
enum Geom.LineEndCap
- Geom.CAP_NONE = 0
- Cut off exactly at each endpoint.
- Geom.CAP_SQUARE = 1
- Extend by half the thickness at each endpoint.
- Geom.CAP_ROUND = 2
- Extend by half the thickness, rounded.
enum Geom.BlendMode
- Geom.BLEND_OPAQUE = 0
- Writes depth and sorts against other geometry; hard edges, no fade.
- Geom.BLEND_TRANSPARENT = 1
- Standard alpha compositing. The default.
- Geom.BLEND_ADDITIVE = 2
- Brightens what is behind. Good for glows.
- Geom.BLEND_MULTIPLY = 3
- Darkens what is behind. Good for tints.
- Geom.BLEND_SUBTRACT = 4
- Subtracts this color from the background.
- Geom.BLEND_TRANSPARENT_DEPTH = 5
- Transparent, but writing depth so shapes occlude by position.
Property descriptions
BlendMode blend_mode = Geom.BLEND_TRANSPARENT
How the shape combines with what is behind it. Transparent Depth is the one that also writes depth, so shapes occlude each other by position rather than by the order they were drawn.
Color color = Color(1, 1, 1, 1)
Fill color, or the wall's color for an outline.
Color color_end = Color(1, 1, 1, 1)
Only used when gradient is on. The far end of the gradient. Ignored unless color_mode is something other than Single.
GeomDash dash = null
Assign a GeomDash to dash this shape; leave empty for solid.
Vector3 end = Vector3(0.5, 0, 0)
The other end, in the node's own space.
LineEndCap end_cap = Geom.CAP_ROUND
How the ends are finished: None, Square, or Round.
bool gradient = false
Run color to color_end along the line's length.
Vector3 start = Vector3(-0.5, 0, 0)
Local to this node, so moving the node moves the line. One end, in the node's own space.
float thickness = 0.05
How wide the line is drawn.
ThicknessSpace thickness_space = Geom.SPACE_METERS
Whether thickness is measured in meters, in pixels, or in viewport units. Meters are world units and shrink with distance; pixels hold their size on screen however far away the camera is. The node's scale multiplies it either way.