ArcGIS Pro 3.8 API Reference Guide
ArcGIS.Desktop.Mapping Namespace / VoxelLayer Class / GetNormal Method
Orientation angle in degrees.
Tilt angle in degrees.
Example

In This Topic
    GetNormal Method (VoxelLayer)
    In This Topic
    Gets the normal unit vector for the provided orientation and tilt. This method must be called on the MCT. Use QueuedTask.Run.
    Syntax
    public Coordinate3D GetNormal( 
       double orientation,
       double tilt
    )
    Public Function GetNormal( _
       ByVal orientation As Double, _
       ByVal tilt As Double _
    ) As Coordinate3D

    Parameters

    orientation
    Orientation angle in degrees.
    tilt
    Tilt angle in degrees.

    Return Value

    A ArcGIS.Core.Geometry.Coordinate3D representing the normal unit vector
    Exceptions
    ExceptionDescription
    This method or property must be called within the lambda passed to QueuedTask.Run
    Example
    Create a Slice
    {
      await QueuedTask.Run(() =>
      {
        if (voxelLayer.Visualization != VoxelVisualization.Volume)
        {
          voxelLayer.SetVisualization(VoxelVisualization.Volume);
        }
    
        voxelLayer.SetSliceContainerExpanded(true);
        voxelLayer.SetSliceContainerVisibility(true);
    
        //To stop the Voxel Exploration Dockpane activating use:
        voxelLayer.AutoShowExploreDockPane = false;
        //This is useful if u have your own dockpane currently activated...
    
        //Use the SelectedVariableProfile to get the slices currently in the TOC
        //via its associated volume
        var volume = voxelLayer.SelectedVariableProfile.Volume;
        var volumeSize = volume.GetVolumeSize();
    
        //Orientation 90 degrees (West), Tilt 0.0 (vertical)
        //Convert to a normal
        var normal = voxelLayer.GetNormal(90, 0.0);
    
        //Create the slice at the voxel mid-point. VoxelPosition
        //is specified in voxel-space coordinates
    
        //Create the slice on the respective volume
        volume.CreateSlice(new SliceDefinition()
        {
          Name = "Middle Slice",
          VoxelPosition = new Coordinate3D(volumeSize.X / 2, volumeSize.Y / 2, volumeSize.Z / 2),
          Normal = normal,
          IsVisible = true
        });
    
        //reset if needed...
        voxelLayer.AutoShowExploreDockPane = true;
      });
    }
    Change Tilt on a Slice
    {
      await QueuedTask.Run(() =>
      {
        //To stop the Voxel Exploration Dockpane activating use:
        voxelLayer.AutoShowExploreDockPane = false;
        //This is useful if u have your own dockpane currently activated...
        //Normally, it would be set in your dockpane
    
        if (voxelLayer.Visualization != VoxelVisualization.Volume)
        {
          voxelLayer.SetVisualization(VoxelVisualization.Volume);
        }
    
        voxelLayer.SetSliceContainerVisibility(true);
    
        //Use the SelectedVariableProfile to get the slices currently in the TOC
        //via its associated volume
        var volume = voxelLayer.SelectedVariableProfile.Volume;
        var slice = volume.GetSlices().First(s => s.Name == "Change Tilt Slice");
    
        (double orientation, double tilt) = voxelLayer.GetOrientationAndTilt(slice.Normal);
    
        //Convert orientation and tilt to a normal
        slice.Normal = voxelLayer.GetNormal(orientation, 45.0);
        volume.UpdateSlice(slice);
    
        //reset if needed...Normally this might be when your dockpane
        //was de-activated (ie "closed")
        voxelLayer.AutoShowExploreDockPane = true;
      });
    }
    Create a Section at the Voxel MidPoint
    {
      await QueuedTask.Run(() =>
      {
        if (voxelLayer.Visualization != VoxelVisualization.Surface)
        {
          voxelLayer.SetVisualization(VoxelVisualization.Surface);
        }
    
        voxelLayer.SetSectionContainerExpanded(true);
        voxelLayer.SetSectionContainerVisibility(true);
    
        //To stop the Voxel Exploration Dockpane activating use:
        voxelLayer.AutoShowExploreDockPane = false;
        //This is useful if u have your own dockpane currently activated...
        //Normally, it would be set in your dockpane
    
        //Create a section that cuts the volume in two on the vertical plane
    
        //Use the SelectedVariableProfile to get the sections
        //via its associated volume
        var volume = voxelLayer.SelectedVariableProfile.Volume;
        var volumeSize = volume.GetVolumeSize();
    
        //Orientation 90 degrees (due West), Tilt 0 degrees
        var normal = voxelLayer.GetNormal(90, 0.0);
    
        //Position must be specified in voxel space
    
        volume.CreateSection(new SectionDefinition()
        {
          Name = "Middle Section",
          VoxelPosition = new Coordinate3D(volumeSize.X / 2, volumeSize.Y / 2, volumeSize.Z / 2),
          Normal = normal,
          IsVisible = true
        });
    
        //reset if needed...Normally this might be when your dockpane
        //was de-activated (ie "closed")
        voxelLayer.AutoShowExploreDockPane = true;
      });
    }
    Create Sections in a Circle Pattern
    {
      await QueuedTask.Run(() =>
      {
        if (voxelLayer.Visualization != VoxelVisualization.Surface)
        {
          voxelLayer.SetVisualization(VoxelVisualization.Surface);
        }
    
        voxelLayer.SetSectionContainerExpanded(true);
        voxelLayer.SetSectionContainerVisibility(true);
    
        //Use the SelectedVariableProfile to get the sections
        //via its associated volume
        var volume = voxelLayer.SelectedVariableProfile.Volume;
        var volumeSize = volume.GetVolumeSize();
    
        //180 degrees orientation is due South. 90 degrees orientation is due west.
        var south = 180.0;
        var num_sections = 12;
        var spacing = 1 / (double)num_sections;
    
        //Create a section every nth degree of orientation. Each section
        //bisects the middle of the voxel
        for (int s = 0; s < num_sections; s++)
        {
          var orientation = south * (s * spacing);
          volume.CreateSection(new SectionDefinition()
          {
            Name = $"Circle {s + 1}",
            VoxelPosition = new Coordinate3D(volumeSize.X / 2, volumeSize.Y / 2, volumeSize.Z / 2),
            Normal = voxelLayer.GetNormal(orientation, 0.0),
            IsVisible = true
          });
        }
      });
    }
    Create Sections Diagonally across the Voxel
    {
      await QueuedTask.Run(() =>
      {
        if (voxelLayer.Visualization != VoxelVisualization.Surface)
        {
          voxelLayer.SetVisualization(VoxelVisualization.Surface);
        }
    
        voxelLayer.SetSectionContainerExpanded(true);
        voxelLayer.SetSectionContainerVisibility(true);
    
        //Use the SelectedVariableProfile to get the sections
        //via its associated volume
        var volume = voxelLayer.SelectedVariableProfile.Volume;
        var volumeSize = volume.GetVolumeSize();
    
        //make a diagonal across the voxel
        var voxel_pos = new Coordinate3D(0, 0, volumeSize.Z);
        var voxel_pos_ur = new Coordinate3D(volumeSize.X, volumeSize.Y, volumeSize.Z);
    
        var lineBuilder = new LineBuilderEx(voxel_pos, voxel_pos_ur, null);
        var diagonal = PolylineBuilderEx.CreatePolyline(lineBuilder.ToSegment());
    
        var num_sections = 12;
        var spacing = 1 / (double)num_sections;
    
        //change as needed
        var orientation = 20.0; //(approx NNW)
        var tilt = -15.0;
    
        var normal = voxelLayer.GetNormal(orientation, tilt);
    
        for (int s = 0; s < num_sections; s++)
        {
          Coordinate2D end_pt = new Coordinate2D(0, 0);
          if (s > 0)
          {
            //position each section evenly spaced along the diagonal
            var segments = new List<Segment>() as ICollection<Segment>;
            var part = GeometryEngine.Instance.GetSubCurve3D(
                diagonal, 0.0, s * spacing, AsRatioOrLength.AsRatio);
            part.GetAllSegments(ref segments);
            end_pt = segments.First().EndCoordinate;
          }
    
          volume.CreateSection(new SectionDefinition()
          {
            Name = $"Diagonal {s + 1}",
            VoxelPosition = new Coordinate3D(end_pt.X, end_pt.Y, volumeSize.Z),
            Normal = normal,
            IsVisible = true
          });
        }
      });
    }
    Update Section Orientation and Tilt
    {
      await QueuedTask.Run(() =>
      {
        if (voxelLayer.Visualization != VoxelVisualization.Surface)
        {
          voxelLayer.SetVisualization(VoxelVisualization.Surface);
        }
    
        voxelLayer.SetSectionContainerExpanded(true);
        voxelLayer.SetSectionContainerVisibility(true);
    
        //Use the SelectedVariableProfile to get the sections
        //via its associated volume
        var volume = voxelLayer.SelectedVariableProfile.Volume;
    
        foreach (var section in volume.GetSections())
        {
          //set each normal to 45.0 orientation and tilt
          section.Normal = voxelLayer.GetNormal(45.0, 45.0);
          //apply the change
          volume.UpdateSection(section);
        }
      });
    }
    Requirements

    Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

    ArcGIS Pro version: 3.0 or higher.
    See Also