You are here: Start » FIL.NET » Function Reference » Computer Vision » Shape Fitting 3D » FIL.FitCircleToEdges3D_Direct
Performs a series of 1D edge detections in 3D and finds a circle that best matches the detected points.
Namespace: | FilNet |
---|---|
Assembly: | FIL.NET.dll |
Syntax
C++
C#
public static void FitCircleToEdges3D_Direct ( FilNet.Surface inSurface, FilNet.CircleFittingField inFittingField, int inScanCount, int inScanWidth, FilNet.InterpolationMethod inSurfaceInterpolation, FilNet.EdgeScanParams3D inEdgeScanParams, FilNet.Selection inEdgeSelection, float inMaxIncompleteness, FilNet.CircleFittingMethod inFittingMethod, INullable<FilNet.Circle3D> outCircle )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
![]() | inSurface | FilNet.Surface | Surface to fit the circle to. | ||
![]() | inFittingField | FilNet.CircleFittingField | Circle fitting field. | ||
![]() | inScanCount | int | <3, INF> | 10 | The number of points that will be searched to estimate the position of the circle. Default value: 10. |
![]() | inScanWidth | int | <1, INF> | 5 | The width of each scan field (in pixels). Default value: 5. |
![]() | inSurfaceInterpolation | FilNet.InterpolationMethod | Bilinear | Interpolation method used for extraction of surface points. Default value: Bilinear. | |
![]() | inEdgeScanParams | FilNet.EdgeScanParams3D | EdgeScanParams3D ( ProfileInterpolation: Quadratic4 SmoothingStdDev: 1.0f MinMagnitude: 5.0f EdgeTransition: LowToHigh ) | Parameters controlling the edge extraction process. Default value: EdgeScanParams3D ( ProfileInterpolation: Quadratic4 SmoothingStdDev: 1.0f MinMagnitude: 5.0f EdgeTransition: LowToHigh ). | |
![]() | inEdgeSelection | FilNet.Selection | Selection mode of edges. | ||
![]() | inMaxIncompleteness | float | <0.0f, 0.999f> | 0.1f | Maximal fraction of edge points not found. Default value: 0.1f. |
![]() | inFittingMethod | FilNet.CircleFittingMethod | AlgebraicTaubin | Method used to fit a circle. Default value: AlgebraicTaubin. | |
![]() | outCircle | FilNet.INullable<FilNet.Circle3D> | Fitted circle or nothing if the fitting fails. This parameter cannot be null. |
Hardware Acceleration
This operation supports automatic parallelization for multicore and multiprocessor systems.
Hardware acceleration settings may be manipulated with Settings class.
Errors
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Sampling step set to zero in FitCircleToEdges3D. |
Function Overrides
- FitCircleToEdges3D_Direct(Surface, CircleFittingField, Nullable<CoordinateSystem2D>, Int32, Nullable<Single>, Int32, InterpolationMethod, EdgeScanParams3D, Selection, Nullable<LocalBlindness>, Nullable<Int32>, Single, CircleFittingMethod, Nullable<MEstimator>, INullable<Circle3D>)
- FitCircleToEdges3D_Direct(Surface, CircleFittingField, Nullable<CoordinateSystem2D>, Int32, Nullable<Single>, Int32, InterpolationMethod, EdgeScanParams3D, Selection, Nullable<LocalBlindness>, Nullable<Int32>, Single, CircleFittingMethod, Nullable<MEstimator>, INullable<Circle3D>, NullableRef<List<Nullable<SurfaceEdge1D>>>, NullableRef<NullableRef<Profile>>, NullableValue<CircleFittingField>, NullableRef<List<Point3D>>, NullableRef<SafeList<Profile>>, NullableRef<SafeList<Profile>>)
- FitCircleToEdges3D_Direct(Surface, CircleFittingField, Nullable<CoordinateSystem2D>, Int32, Nullable<Single>, Int32, InterpolationMethod, EdgeScanParams3D, Selection, Nullable<LocalBlindness>, Nullable<Int32>, Single, CircleFittingMethod, Nullable<MEstimator>, INullable<Circle3D>, IList<Nullable<SurfaceEdge1D>>, INullable<Profile>, CircleFittingField, IList<Point3D>, IList<Profile>, IList<Profile>, IList<Segment2D>, IList<Rectangle2D>)
- FitCircleToEdges3D_Direct(Surface, CircleFittingField, Nullable<CoordinateSystem2D>, Int32, Nullable<Single>, Int32, InterpolationMethod, EdgeScanParams3D, Selection, Nullable<LocalBlindness>, Nullable<Int32>, Single, CircleFittingMethod, Nullable<MEstimator>, INullable<Circle3D>, NullableRef<List<Nullable<SurfaceEdge1D>>>, NullableRef<NullableRef<Profile>>, NullableValue<CircleFittingField>, NullableRef<List<Point3D>>, NullableRef<SafeList<Profile>>, NullableRef<SafeList<Profile>>, IList<Segment2D>, IList<Rectangle2D>)