Click or drag to resize
AB4D logo

DXSceneRenderConnectedLinesAsDisconnected Property

Gets or sets a boolean that specifies if all connected 3D lines (polylines, line arc, rectangle, etc.) are rendered as disconnected 3D lines (separate lines). Default value is false.

Namespace:  Ab3d.DirectX
Assembly:  Ab3d.DXEngine (in Ab3d.DXEngine.dll) Version: 5.1.8147.1045
Syntax
C#
public bool RenderConnectedLinesAsDisconnected { get; set; }

Property Value

Type: Boolean
Remarks

RenderConnectedLinesAsDisconnected gets or sets a boolean that specifies if all connected 3D lines (polylines, line arc, rectangle, etc.) are rendered as disconnected 3D lines (separate lines). Default value is false.

Connected 3D lines are 3D lines where the end point of one line is the start point of the next line and where the connection between the lines is "smoothed". In Ab3d.PowerToys library the connected 3D lines are created with the following objects: PolyLineVisual3D, LineArcVisual3D, RectangleVisual3D, MultiPolyLineVisual3D, TextVisual3D, LineWithTextVisual3D, CenteredTextVisual3D.

Disconnected 3D lines are simple 3D lines are not connected to each other. In Ab3d.PowerToys library the connected 3D lines are created with the following objects: LineVisual3D, MultiLineVisual3D, WireBoxVisual3D, WireCrossVisual3D, WireGridVisual3D, WireframeVisual3D.

This property was used before DXEngine v2.3 where connected 3D lines were not hardware accelerated and with using this property connected lines can be rendered as disconnected and hardware accelerated. From this version on, the DXEngine supports full hardware rendering of connected 3D lines and therefore this property can be used only to achieve some special effects.

NOTE:
RenderConnectedLinesAsDisconnected property must be set before the 3D lines are initialized and after the DXScene object is created and. This can be done in the DXSceneDeviceCreated event (here the DXScene and DXDevice are already created).

Examples
MainDXViewportView.DXSceneDeviceCreated += delegate(object sender, EventArgs args)
{
   if (DXViewportView1.DXScene != null) // DXScene is null in case of WPF 3D rendering
   {
       // Here the values are set to the default values - you can change them if you want.
       DXViewportView1.DXScene.RenderConnectedLinesAsDisconnected = false;
   }
};
See Also