Tous les produits
Search
Centre de documentation

PolarDB:ST_3DRemoveDuplicateVertex

Dernière mise à jour :Oct 10, 2026

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)

image.png

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

image.png

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

image.png

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

image.png