Fusionne les sommets d'un objet sfmesh ou IndexSurface dont la distance entre les coordonnées et l'écart des coordonnées de texture sont inférieurs au seuil spécifié, puis renvoie l'objet sfmesh résultant après suppression des sommets en double.
Syntaxe
sfmesh ST_3DRemoveDuplicateVertex(sfmesh sfmesh, float8 dist_threshold);
Paramètres
| Paramètre | Type | Description |
|---|---|---|
sfmesh |
sfmesh | L'objet de modèle sfmesh. |
dist_threshold |
float8 | Le seuil de distance. Les sommets dont la distance entre les coordonnées et l'écart des coordonnées de texture sont inférieurs à ce seuil sont fusionnés. La distance est calculée dans le système de coordonnées cartésiennes. |
Valeur de retour
Renvoie l'objet sfmesh fusionné.
Fonctionnement
La fonction ST_3DRemoveDuplicateVertex analyse les sommets d'un objet sfmesh ou IndexSurface et fusionne deux sommets en un seul lorsque les deux conditions suivantes sont remplies :
Leur distance (dans le système de coordonnées cartésiennes) est inférieure au seuil
dist_threshold.L'écart de leurs coordonnées de texture est inférieur au seuil
dist_threshold.
Un seuil dist_threshold plus faible fusionne moins de sommets et préserve davantage de détails géométriques. Une valeur plus élevée entraîne une fusion plus agressive, ce qui réduit la taille du fichier mais peut provoquer la perte de détails fins.
Exemples
L'exemple suivant fusionne les sommets d'un objet IndexSurface avec un seuil de distance de 0.1. L'entrée contient six sommets ; après la fusion, deux sommets identiques ou quasi identiques sont regroupés, laissant quatre sommets distincts.
SELECT ST_AsText(
ST_3DRemoveDuplicateVertex(
'MESHGEOM(PATCH(INDEXSURFACE(VERTEX(0 0 0, 1 0 0, 0 1 0, 1 0.01 0, 0.01 0 0, 0 -1 0), INDEX((0,1,2),(3,4,5)))))'::meshgeom,
0.1
)
);
Résultat :
{"version" : 1, "root" : 0, "meshgeoms" : ["MESHGEOM(PATCH(INDEXSURFACE Z (VERTEX(0 0 0,1 0 0,0 1 0,0 -1 0),INDEX((0,1,2),(1,0,3)))))"], "primitives" : [{"meshgeom" : 0}], "nodes" : [{"primitive" : 0}]}
Effet de dist_threshold sur la taille du maillage
Les diagrammes suivants illustrent l'impact de différentes valeurs de seuil sur la taille de sortie d'un même maillage.
Données brutes (50,2 Mo)

Résultats après fusion des sommets (20,2 Mo) : dist_threshold = 0,01

Résultats après fusion des sommets (3,3 Mo) : dist_threshold = 0,1

Résultats après fusion des sommets (0,63 Mo) : dist_threshold = 1 (perte de certains détails)
