BufferWithCurves (tipo de dados geometria)
Retorna uma instância de geometry que representa o conjunto de todos os pontos cuja distância de uma instância de geometry é menor ou igual ao parâmetro distance.
Sintaxe
.BufferWithCurves ( distance )
Argumentos
- distance
É um float que indica a distância máxima em que os pontos que formam o buffer podem estar da instância de geometry.
Tipos de retorno
SQL Server tipo de retorno: geometry
Tipo de retorno CLR: SqlGeometry
Exceções
Os critérios a seguir lançarão uma ArgumentException.
Nenhum parâmetro é transmitido ao método como @g.BufferWithCurves()
Um parâmetro não numérico é transmitido ao método como @g.BufferWithCurves('a')
NULL é transmitido ao método, como @g.BufferWithCurves(NULL)
Comentários
A ilustração a seguir mostra um exemplo de uma instância de geometria retornado por este método.
.gif "BufferedCurve")
A tabela a seguir mostra os resultados retornados para obter valores de distância diferentes.
Valor de distância |
Dimensões do tipo |
Tipo espacial retornado |
||
|---|---|---|---|---|
distância < 0 |
Zero ou um |
Instância GeometryCollection vazia |
||
distância < 0 |
Dois ou mais |
Uma instância CurvePolygon ou GeometryCollection com um buffer negativo
|
||
distância = 0 |
Todas as dimensões |
Cópia da instância geometry que está invocando |
||
distância > 0 |
Todas as dimensões |
Uma instância de CurvePolygon ou GeometryCollection |
.gif "Observação") Observação |
|---|
Considerando que a distance é um float, um valor muito pequeno pode ser igualado a zero nos cálculos. Quando isto ocorrer, uma cópia da instância geometry de chamada será retornada. Consulte flutuante e real (Transact-SQL). |
Um buffer negativo remove todos os pontos dentro da distância determinada do limite da geometria. A ilustração a seguir mostra um buffer negativo como a área sombreada mais clara do círculo. A linha pontilhada é o limite do polígono original e a linha sólida é o limite do polígono resultante.
Se um parâmetro string for passado ao método, ele será convertido em um float ou lançará uma ArgumentException.
Exemplos
A.Chamando BufferWithCurves() com um valor de parâmetro < 0 em instância de geometria unidimensional
O exemplo a seguir retorna uma instância GeometryCollection vazia:
DECLARE @g geometry= 'LINESTRING(3 4, 8 11)';
SELECT @g.BufferWithCurves(-1).ToString();
B.Chamando BufferWithCurves() com um valor de parâmetro < 0 em instância de geometria bidimensional
O exemplo a seguir retorna uma instância CurvePolygon com um buffer negativo:
DECLARE @g geometry = 'CURVEPOLYGON(COMPOUNDCURVE(CIRCULARSTRING(0 4, 4 0, 8 4), (8 4, 0 4)))';
SELECT @g.BufferWithCurves(-1).ToString()
C.Chamando BufferWithCurves() com um valor de parâmetro < 0 que retorna uma GeometryCollection vazia
O exemplo a seguir mostra o que ocorre quando o parâmetro distance é igual a -2:
DECLARE @g geometry = 'CURVEPOLYGON(COMPOUNDCURVE(CIRCULARSTRING(0 4, 4 0, 8 4), (8 4, 0 4)))';
SELECT @g.BufferWithCurves(-2).ToString();
Esta instrução SELECT retorna GEOMETRYCOLLECTION EMPTY
D.Chamando BufferWithCurves() com um valor de parâmetro = 0
O exemplo a seguir retorna uma cópia da instância geometry de chamada:
DECLARE @g geometry = 'LINESTRING(3 4, 8 11)';
SELECT @g.BufferWithCurves(0).ToString();
E.Chamando BufferWithCurves() com um valor de parâmetro diferente de zero que é extremamente pequeno
O exemplo a seguir também retorna uma cópia da instância geometry de chamada:
DECLARE @g geometry = 'LINESTRING(3 4, 8 11)';
DECLARE @distance float = 1e-20;
SELECT @g.BufferWithCurves(@distance).ToString();
F.Chamando BufferWithCurves() com um valor de parâmetro > 0
O exemplo a seguir retorna uma instância CurvePolygon:
DECLARE @g geometry= 'LINESTRING(3 4, 8 11)';
SELECT @g.BufferWithCurves(2).ToString();
G.Transmitindo um parâmetro de cadeia de caracteres válido
O exemplo a seguir retorna a mesma instância CurvePolygon como mencionado anteriormente, mas um parâmetro de cadeia de caracteres é transmitido ao método:
DECLARE @g geometry= 'LINESTRING(3 4, 8 11)';
SELECT @g.BufferWithCurves('2').ToString();
H.Transmitindo um parâmetro de cadeia de caracteres inválido
O exemplo a seguir lançará um erro:
DECLARE @g geometry = 'LINESTRING(3 4, 8 11)'
SELECT @g.BufferWithCurves('a').ToString();
Observe que os dois exemplos anteriores transmitiram uma cadeia de caracteres literal ao método BufferWithCurves(). O primeiro exemplo funciona porque a cadeia literal pode ser convertida em um valor numérico. Porém, o segundo exemplo lança uma ArgumentException.
I.Chamando BufferWithCurves() em instância de MultiPoint
O exemplo a seguir retorna duas instâncias GeometryCollection e uma instância CurvePolygon:
DECLARE @g geometry = 'MULTIPOINT((1 1),(1 4))';
SELECT @g.BufferWithCurves(1).ToString();
SELECT @g.BufferWithCurves(1.5).ToString();
SELECT @g.BufferWithCurves(1.6).ToString();
As duas primeiras instruções SELECT retornam uma instância de GeometryCollection porque o parâmetro distance é menor que ou igual à metade da distância entre os dois pontos (1 1) e (1 4). A terceira instrução SELECT retorna uma instância de CurvePolygon porque as instâncias armazenadas em buffer dos dois pontos, (1 1) e (1 4) se sobrepõem.