BaseCameraLine3DTo2D Method (Point3D, Point3D, Size, Point, Point)

public bool Line3DTo2D(
	Point3D startPositionWorld,
	Point3D endPositionWorld,
	Size viewportSize,
	out Point startPositionScreen,
	out Point endPositionScreen
)

Parameters

startPositionWorld

Type: System.Windows.Media.Media3DPoint3D
start position of the 3D line

endPositionWorld

Type: System.Windows.Media.Media3DPoint3D
end position of the 3D line

viewportSize

Type: System.WindowsSize
Size of the Viewport3D

startPositionScreen

Type: System.WindowsPoint
start position of the 2D line on the screen

endPositionScreen

Type: System.WindowsPoint
end position of the 2D line on the screen

Return Value

Converts a 3D line that is defined by startPositionWorld and endPositionWorld to a line on the screen that is defined by startPositionScreen and endPositionScreen.

The method takes a custom Viewport3D size and does not require that this Camera class is connected to real Viewport3D.

This method correctly handles the case when the 3D line crosses the camera near plane (goes behind the camera). In this case the line needs to be cropped at the camera near plane.

The matrix to convert 3D point to 2D point is calculated from the used Ab3d.Camera. The matrix value is cached and is only recalculated when the camera is changed.

If the matrix to convert 3D point to 2D point cannot be calculated (for example if TargetViewport3D is not set), the calculated points will be Point(double.NaN, double.NaN) and the method will return false as a result.

With this method you can convert 3D coordinates to 2D space without creating read Viewport3D and attaching the camera to it. The following example shows how to do that:

Examples

var targetPositionCamera = new Ab3d.Cameras.TargetPositionCamera()
{
    Heading = 30,
    Attitude = -20,
    Distance = 200
};

Point startPositionScreen, endPositionScreen;
bool success = targetPositionCamera.Line3DTo2D(new Point3D(100, 100, 100), new Point3D(200, 100, 100), new Size(200, 100), out startPositionScreen, out endPositionScreen);

Reference