lib.point.draw.DrawLines - tooll3/t3 GitHub Wiki

DrawLines

in lib.point.draw


Draws a point buffer as lines. The lines will be aligned to the camera, but their width will shrink with distance to the camera. You can override this with the ScaleWithDistance parameter. We use the point’s W attribute as a scale factor for the line width. If the W attribute of a point is NaN (Not a Number), that point is not being drawn and acts as a separator between the adjacent line segments. This allows a point buffer to contain multiple disconnected line segments. DrawLines ignores the orientation defined by the points. Consider using [DrawRibbons] if you need consistent orientation.

Some caveats:

Long line segments that intersect the camera plane (i.e., one point is in front of the camera and the other behind the camera) will not be rendered correctly. Please consider using [DrawRaypoints] for this.

Performance considerations:

Drawing lines is fast. Depending on your graphics card, you can draw millions of lines per frame. Performance will be impacted by the length of your lines rather than the point count. This is directly related to your render target’s resolution and multi-sampling level (MSAA).


Input Parameters

Name (Relevancy & Type) Description
GPoints (BufferWithViewsRequired) -
Color (Vector4) -
Size (Single) -
ShrinkWithDistance (Single) -
TransitionProgress (Single) -
UseWForWidth (Single) -
UseWAsTexCoordV (Boolean) -
Texture_ (Texture2D) -
EnableTest (Boolean) -
EnableDepthWrite (Boolean) -
BlendMod (Int32) -
UvScale (Single) -
AddressU (TextureAddressMode) -

Outputs

Name Type
Output T3.Core.DataTypes.Command

Please help use to improve this documentation. Feel free to improve the description.

⚠ Everything else is automatically generated and will be overwritten regularly.

⚠️ **GitHub.com Fallback** ⚠️