3D PointLines Tutorial

Arction · Mar 11, 2019 · 498e69b · 498e69b
1 parent d651b91
commit 498e69b
Show file tree

Hide file tree

Showing 34 changed files with 2,203 additions and 2 deletions.
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,7 @@
+.vs/
+3DPointLines_WF/bin/
+3DPointLines_WF/obj/
+3DPointLines_WPF_NB/bin/
+3DPointLines_WPF_NB/obj/
+3DPointLines_WPF_SB/bin/
+3DPointLines_WPF_SB/obj/
diff --git a/3DPointLines.sln b/3DPointLines.sln
@@ -0,0 +1,37 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio 15
+VisualStudioVersion = 15.0.28010.2041
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "3DPointLines_WPF_NB", "3DPointLines_WPF_NB\3DPointLines_WPF_NB.csproj", "{69D969D5-54FA-48C6-B893-809D979B4769}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "3DPointLines_WF", "3DPointLines_WF\3DPointLines_WF.csproj", "{D00925EC-D5D4-4981-86FA-F394B7B767B9}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "3DPointLines_WPF_SB", "3DPointLines_WPF_SB\3DPointLines_WPF_SB.csproj", "{4266E400-A808-4885-9760-E78E73B08931}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{69D969D5-54FA-48C6-B893-809D979B4769}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{69D969D5-54FA-48C6-B893-809D979B4769}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{69D969D5-54FA-48C6-B893-809D979B4769}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{69D969D5-54FA-48C6-B893-809D979B4769}.Release|Any CPU.Build.0 = Release|Any CPU
+		{D00925EC-D5D4-4981-86FA-F394B7B767B9}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{D00925EC-D5D4-4981-86FA-F394B7B767B9}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{D00925EC-D5D4-4981-86FA-F394B7B767B9}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{D00925EC-D5D4-4981-86FA-F394B7B767B9}.Release|Any CPU.Build.0 = Release|Any CPU
+		{4266E400-A808-4885-9760-E78E73B08931}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{4266E400-A808-4885-9760-E78E73B08931}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{4266E400-A808-4885-9760-E78E73B08931}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{4266E400-A808-4885-9760-E78E73B08931}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {9CF35063-6CE6-4D03-A17C-F060F335DE83}
+	EndGlobalSection
+EndGlobal
diff --git a/3DPointLines_WF/3DPointLines_WF.csproj b/3DPointLines_WF/3DPointLines_WF.csproj
@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" />
+  <PropertyGroup>
+    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
+    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
+    <ProjectGuid>{D00925EC-D5D4-4981-86FA-F394B7B767B9}</ProjectGuid>
+    <OutputType>WinExe</OutputType>
+    <RootNamespace>_3DPointLines_WF</RootNamespace>
+    <AssemblyName>3DPointLines_WF</AssemblyName>
+    <TargetFrameworkVersion>v4.0</TargetFrameworkVersion>
+    <FileAlignment>512</FileAlignment>
+    <Deterministic>true</Deterministic>
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
+    <PlatformTarget>AnyCPU</PlatformTarget>
+    <DebugSymbols>true</DebugSymbols>
+    <DebugType>full</DebugType>
+    <Optimize>false</Optimize>
+    <OutputPath>bin\Debug\</OutputPath>
+    <DefineConstants>DEBUG;TRACE</DefineConstants>
+    <ErrorReport>prompt</ErrorReport>
+    <WarningLevel>4</WarningLevel>
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
+    <PlatformTarget>AnyCPU</PlatformTarget>
+    <DebugType>pdbonly</DebugType>
+    <Optimize>true</Optimize>
+    <OutputPath>bin\Release\</OutputPath>
+    <DefineConstants>TRACE</DefineConstants>
+    <ErrorReport>prompt</ErrorReport>
+    <WarningLevel>4</WarningLevel>
+  </PropertyGroup>
+  <ItemGroup>
+    <Reference Include="Arction.WinForms.Charting.LightningChartUltimate">
+      <HintPath>..\..\..\..\..\..\LightningChart\Main\v84_main\LibNET4\Arction.WinForms.Charting.LightningChartUltimate.dll</HintPath>
+    </Reference>
+    <Reference Include="System" />
+    <Reference Include="System.Core" />
+    <Reference Include="System.Xml.Linq" />
+    <Reference Include="System.Data.DataSetExtensions" />
+    <Reference Include="Microsoft.CSharp" />
+    <Reference Include="System.Data" />
+    <Reference Include="System.Deployment" />
+    <Reference Include="System.Drawing" />
+    <Reference Include="System.Windows.Forms" />
+    <Reference Include="System.Xml" />
+  </ItemGroup>
+  <ItemGroup>
+    <Compile Include="Form1.cs">
+      <SubType>Form</SubType>
+    </Compile>
+    <Compile Include="Form1.Designer.cs">
+      <DependentUpon>Form1.cs</DependentUpon>
+    </Compile>
+    <Compile Include="Program.cs" />
+    <Compile Include="Properties\AssemblyInfo.cs" />
+    <EmbeddedResource Include="Form1.resx">
+      <DependentUpon>Form1.cs</DependentUpon>
+    </EmbeddedResource>
+    <EmbeddedResource Include="Properties\Resources.resx">
+      <Generator>ResXFileCodeGenerator</Generator>
+      <LastGenOutput>Resources.Designer.cs</LastGenOutput>
+      <SubType>Designer</SubType>
+    </EmbeddedResource>
+    <Compile Include="Properties\Resources.Designer.cs">
+      <AutoGen>True</AutoGen>
+      <DependentUpon>Resources.resx</DependentUpon>
+    </Compile>
+    <None Include="Properties\Settings.settings">
+      <Generator>SettingsSingleFileGenerator</Generator>
+      <LastGenOutput>Settings.Designer.cs</LastGenOutput>
+    </None>
+    <Compile Include="Properties\Settings.Designer.cs">
+      <AutoGen>True</AutoGen>
+      <DependentUpon>Settings.settings</DependentUpon>
+      <DesignTimeSharedInput>True</DesignTimeSharedInput>
+    </Compile>
+  </ItemGroup>
+  <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
+</Project>
diff --git a/3DPointLines_WF/Form1.Designer.cs b/3DPointLines_WF/Form1.Designer.cs
diff --git a/3DPointLines_WF/Form1.cs b/3DPointLines_WF/Form1.cs
@@ -0,0 +1,217 @@
+// ------------------------------------------------------------------------------------------------------
+// LightningChart® example code: 3D Point Lines with mouse tracking.
+//
+// If you need any assistance, or notice error in this example code, please contact [email protected]. 
+//
+// Permission to use this code in your application comes with LightningChart® license. 
+//
+// http://arction.com/ | [email protected] | [email protected]
+//
+// © Arction Ltd 2009-2019. All rights reserved.  
+// ------------------------------------------------------------------------------------------------------
+using System;
+using System.Drawing;
+using System.Windows.Forms;
+
+//Arction namespaces.
+using Arction.WinForms.Charting;             // LightningChartUltimate and general types.
+using Arction.WinForms.Charting.Series3D;    // Series for 3D chart.
+using Arction.WinForms.Charting.Annotations; // Annotations for LightningChart.
+
+namespace _3DPointLines_WF
+{
+    public partial class Form1 : Form
+    {
+        /// <summary>
+        /// LightningChart component.
+        /// </summary>
+        private LightningChartUltimate chart = null;
+
+        /// <summary>
+        /// Random number generator for creating example series data.
+        /// </summary>
+        private Random random = new Random();
+
+        /// <summary>
+        /// Annotation which shows target values when hovering over a point with the mouse.
+        /// </summary>
+        private Annotation3D mouseAnnotation;
+
+        public Form1()
+        {
+            InitializeComponent();
+
+            // Create chart.
+            chart = new LightningChartUltimate();
+
+            // Set chart control into the parent container.
+            chart.Parent = this;
+            chart.Dock = DockStyle.Fill;
+
+            // Disable rendering before updating chart properties to improve performance
+            // and to prevent unnecessary chart redrawing while changing multiple properties.
+            chart.BeginUpdate();
+
+            // 1. Set View3D as active view and set Z-axis range.
+            chart.ActiveView = ActiveView.View3D;
+            chart.View3D.ZAxisPrimary3D.SetRange(0, 80);
+
+            // 2. Add 3D pointlines to the view with different colors.
+            CreatePointLine(0, Color.Red);
+            CreatePointLine(1, Color.Orange);
+            CreatePointLine(2, Color.Yellow);
+            CreatePointLine(3, Color.Green);
+            CreatePointLine(4, Color.Blue);
+            CreatePointLine(5, Color.Indigo);
+            CreatePointLine(6, Color.Violet);
+
+            // 5. Create a new annotation to display target values when hovering over a point with the mouse.
+            mouseAnnotation = new Annotation3D(chart.View3D, Axis3DBinding.Primary, Axis3DBinding.Primary, Axis3DBinding.Primary)
+            {
+                Visible = false,
+                TargetCoordinateSystem = AnnotationTargetCoordinates.AxisValues,
+                LocationCoordinateSystem = CoordinateSystem.RelativeCoordinatesToTarget,
+                MouseInteraction = false
+            };
+
+            // Set offset to annotation.
+            mouseAnnotation.LocationRelativeOffset.SetValues(40, -70);
+
+            // Add annotation to View3D.
+            chart.View3D.Annotations.Add(mouseAnnotation);
+
+            // 6. Add mouse move event handler to chart to enable tracking points with the mouse.
+            chart.MouseMove += _chart_MouseMove;
+
+            // Set chart's title and default camera rotation.
+            chart.Title.Text = "3D Point Lines";
+            chart.View3D.Camera.RotationX = 30;
+            chart.View3D.Camera.RotationY = -50;
+
+            // Call EndUpdate to enable rendering again.
+            chart.EndUpdate();
+
+            // Safe disposal of LC components when the form is closed.
+            FormClosed += new FormClosedEventHandler(Form_Closed);
+
+            #region Hidden polishing
+            // Customize chart.
+            CustomizeChart(chart);
+            #endregion
+        }
+
+        /// <summary>
+        /// Create a PointLineSeries3D with default random data and add it to the chart.
+        /// </summary>
+        /// <param name="i">Index of the series.</param>
+        /// <param name="color">Series' points & line color.</param>
+        private void CreatePointLine(int i, Color color)
+        {
+            // Create a new PointLineSeries3D for displaying data and set axis bindings to primary axes.
+            var series = new PointLineSeries3D(chart.View3D, Axis3DBinding.Primary, Axis3DBinding.Primary, Axis3DBinding.Primary)
+            {
+                // Set this to true to set a color for individual points.
+                IndividualPointColors = true,
+                // Set this to true in order for mouse tracking to work.
+                MouseInteraction = true
+            };
+
+            // 3. Apply styling to the series.
+
+            // Set a title to the series.
+            series.Title.Text = "Series " + (i + 1);
+
+            // Set point shape to a sphere.
+            series.PointStyle.Shape3D = PointShape3D.Sphere;
+
+            // Set individual point size.
+            series.PointStyle.Size3D.SetValues(3, 3, 3);
+
+            // Set the width of the line between points.
+            series.LineStyle.Width = 0.4f;
+
+            // Set the line color.
+            series.LineStyle.Color = color;
+
+            // Draw the line between points with the same color as the points.
+            series.LineStyle.LineOptimization = LineOptimization.NormalWithShading;
+
+            // 4. Create a SeriesPoint3D array for data points.
+            SeriesPoint3D[] points = new SeriesPoint3D[10];
+
+            // Generate sample data to the array.
+            for (int j = 0; j < 10; j++)
+            {
+                points[j].X = 5 + j * 10;
+                points[j].Y = 30 + random.NextDouble() * 25.0;
+                points[j].Z = 10 + i * 10;
+                points[j].Color = color;
+            }
+
+            // Set series points as the newly created array.
+            series.Points = points;
+
+            // Add the series to chart's View3D.
+            chart.View3D.PointLineSeries3D.Add(series);
+        }
+
+        // 7. Create a function for mouse move event handler.
+        private void _chart_MouseMove(object sender, MouseEventArgs e)
+        {
+            // Call BeginUpdate for chart to disable rendering while mouse is moving 
+            // over the chart to improve performance.
+            chart.BeginUpdate();
+
+            // Set label visible when not hovered over by mouse.
+            mouseAnnotation.Visible = false;
+
+            // Check if any object has been found under the mouse.
+            object obj = chart.GetActiveMouseOverObject();
+            if (obj != null)
+            {
+                // Check if the active mouse over object is a PointLineSeries object.
+                if (obj is PointLineSeries3D)
+                {
+                    PointLineSeries3D pointLineSeries3D = obj as PointLineSeries3D;
+
+                    // Get the point last hit by mouse.
+                    int pointIndex = pointLineSeries3D.LastMouseHitTestIndex;
+                    SeriesPoint3D point = pointLineSeries3D.Points[pointIndex];
+
+                    // Set annotation position to the moused over point.
+                    mouseAnnotation.TargetAxisValues.SetValues(point.X, point.Y, point.Z);
+
+                    // Set annotation text to display information about the moused over point.
+                    mouseAnnotation.Text = "Series index: " + chart.View3D.PointLineSeries3D.IndexOf(pointLineSeries3D).ToString()
+                        + "\nPoint index: " + pointIndex.ToString()
+                        + "\nX=" + point.X.ToString("0.0") + " ; Y=" + point.Y.ToString("0.0") + " ; Z=" + point.Z.ToString("0.0");
+
+                    // Set the annotation visible while mouse is hovering over the point.
+                    mouseAnnotation.Visible = true;
+                }
+            }
+
+            // Call EndUpdate to enable rendering again after handling mouse move event.
+            chart.EndUpdate();
+        }
+
+
+        // Safe disposal of LightningChart components when the form is closed.
+        private void Form_Closed(Object sender, FormClosedEventArgs e)
+        {
+            // Dispose Chart.
+            chart.Dispose();
+            chart = null;
+        }
+
+        #region Hidden polishing
+        void CustomizeChart(LightningChartUltimate chart)
+        {
+            chart.Background.Color = Color.FromArgb(255, 30, 30, 30);
+            chart.Background.GradientFill = GradientFill.Solid;
+            chart.Title.Color = Color.FromArgb(255, 249, 202, 3);
+            chart.Title.MouseHighlight = MouseOverHighlight.None;
+        }
+        #endregion
+    }
+}