SqlGeometry.BufferWithTolerance Method

Returns a geometric object that represents the union of all point values whose distance from a SqlGeometry instance is less than or equal to a specified value, allowing for a specified tolerance.

Namespace:  Microsoft.SqlServer.Types
Assembly:  Microsoft.SqlServer.Types (in Microsoft.SqlServer.Types.dll)

Syntax

'Declaration
<SqlMethodAttribute(IsDeterministic := True, IsPrecise := False)> _
Public Function BufferWithTolerance ( _
    distance As Double, _
    tolerance As Double, _
    relative As Boolean _
) As SqlGeometry
'Usage
Dim instance As SqlGeometry
Dim distance As Double
Dim tolerance As Double
Dim relative As Boolean
Dim returnValue As SqlGeometry

returnValue = instance.BufferWithTolerance(distance, _
    tolerance, relative)
[SqlMethodAttribute(IsDeterministic = true, IsPrecise = false)]
public SqlGeometry BufferWithTolerance(
    double distance,
    double tolerance,
    bool relative
)
[SqlMethodAttribute(IsDeterministic = true, IsPrecise = false)]
public:
SqlGeometry^ BufferWithTolerance(
    double distance, 
    double tolerance, 
    bool relative
)
[<SqlMethodAttribute(IsDeterministic = true, IsPrecise = false)>]
member BufferWithTolerance : 
        distance:float * 
        tolerance:float * 
        relative:bool -> SqlGeometry 
public function BufferWithTolerance(
    distance : double, 
    tolerance : double, 
    relative : boolean
) : SqlGeometry

Parameters

  • distance
    Type: System.Double
    A double that specifies the distance from the SqlGeometry instance around which to calculate the buffer.
  • tolerance
    Type: System.Double
    A double that specifies the tolerance of the buffer distance.
    Tolerance refers to the maximum variation in the ideal buffer distance for the returned linear approximation.
    For example, the ideal buffer distance of a point is a circle, but this must be approximated by a polygon. The smaller the tolerance, the more points the polygon will have, which increases the complexity of the result, but decreases the error.
  • relative
    Type: System.Boolean
    A bool that specifies whether the tolerance value is relative or absolute. If true, then tolerance is relative and is calculated as the product of the tolerance parameter and the diameter of the bounding box of the instance. If false, tolerance is absolute and the tolerance value is the absolute maximum variation in the ideal buffer distance for the returned linear approximation.

Return Value

Type: Microsoft.SqlServer.Types.SqlGeometry
A SqlGeometry value that represents the union of all points whose distance from the calling SqlGeometry is less than or equal to the specified values.

Remarks

A negative buffer removes all points within the given distance of the boundary of the SqlGeometry instance.