Réalise la découpe de la géométrie des entités en utilisant un emporte-pièce.

Les entités arrivant dans le Transformer via le port CLIPPER (EMPORTE-PIÈCE) définissent les zones de découpe des entités arrivant par le port CLIPPEE (A_DÉCOUPER). Les entités en sorties sont divisées en 4 groupes :

Port d'entrée

• Les entités arrivant dans le Transformer via le port CLIPPER (EMPORTE-PIÈCE) définissent les zones de découpe des entités arrivant par le port CLIPPEE (A_DÉCOUPER). Les emporte-pièces (CLIPPER) peuvent être de n'importe quel type surfacique (polygone, polygone troué ou aggrégat). La présence d'une entité non surfacique parmi les emporte-pièces sera supprimée et entraînera la production d'un message d'avertissement.
• CLIPPEE : Les entités à découper entrent dans le Transformer via le port CLIPPEE (A_DÉCOUPER).

Port de sortie

• CLIPPED_INSIDE : Les parties des objets à découper qui se trouvent à l'intérieur de l'emporte-pièce sont découpées et ressortent par le port CLIPPED_INSIDE (DECOUPE_INTERIEUR). CLIPPED_OUTSIDE : Les parties des objets à découper qui se trouvent à l'extérieur de l'emporte-pièce sont découpées et ressortent par le port CLIPPED_OUTSIDE (DECOUPE_EXTERIEUR).
• CLIPPED_INSIDE : Les parties qui intersectent l'emporte pièces et qui se trouvent à l'intérieur sont découpées et ressortent par le port CLIPPED_INSIDE (DECOUPE_INTERIEUR).CLIPPED_OUTSIDE : Les parties qui intersectent l'emporte pièces et qui se trouvent à l'extérieur sont découpés et ressortent par le port CLIPPED_OUTSIDE (DECOUPE_EXTERIEUR). Quand une entité intersecte plusieurs fois l'emporte pièce des agrégats sont alors générés, et ressortent par les ports appropriés.
• CLIPPED_INSIDE (raster) : Pour les entités raster à découper, chaque emporte-pièce qui l'intersecte produira une entité sortant par le port CLIPPED_INSIDE (DECOUPE_INTERIEUR). Si l'option 'Non' est choisie pour le paramètre PRESERVER L'ETENDUE, l'étendue du raster sortant par CLIPPED_INSIDE (DECOUPE_INTERIEUR) sera égale au rectangle englobant de la portion de l'emporte-pièce contenue dans l'entité à découper, et le nombre de lignes et de colonnes sera réduit. Sinon, la résolution et l'étendue des rasters sortant par CLIPPED_INSIDE (DECOUPE_INTERIEUR) seront les mêmes que celles des rasters à découper en entrée. D'autre part, les surfaces du raster en entrée qui sont complètement disjointes des emporte-pièces sortiront par le port CLIPPED_OUTSIDE (DECOUPE_EXTERIEUR). La résolution et l'étendue des rasters sortants par CLIPPED_INSIDE (DECOUPE_INTERIEUR) sont les mêmes que celles des rasters à découper en entrée.
• OUTSIDE : Les entités qui se trouvent complètement à l'exterieur du CLIPPER ressortent par le port OUTSIDE.
• INSIDE ou OUTSIDE : Les entités ponctuelles à découper qui se trouvent sur la bordure d'un emporte-pièce ressortent par le port intérieur ou extérieur en fonction de la valeur du paramètre TRAITEMENT DES BORDURES COMMUNES.Les entités linéaires qui sont colinéaires (se superposent) avec la bordure d'un emporte pièce ressortent par le port intérieur ou extérieur en fonction de la valeur du paramètre TRAITEMENT DES BORDURES COMMUNES.Si une entité linéaire à découper a une portion colinéaire avec la bordure d'un emporte-pièce, l'entité sera découpée uniquement lorsqu'elle traverse la limite de l'emporte-pièce.

Paramètres

Regrouper par

Si des attributs sont sélectionnés dans le paramètre REGROUPER PAR, les entités sont découpées par groupes d'entités ayant les mêmes valeurs pour les attributs regroupés.

Type de découpe

• Clipper unique : Seulement une entité CLIPPER est utilsée.
• Clippers multiples : Toutes les entités CLIPPER sont utilisées.  
• Emporte pièces d'abors : Si 'Emporte-pièces d'abord' est sélectionné, CLIPPER considère que toutes les entités emporte-pièces doivent entrer dans le Transformer avant les entités à découper.

Toute entité emporte-pièces entrant après la première entité à découper sera supprimée et entraînera la production d'un message d'avertissement.

Fusionner les attributs, Préfixe des attributs

Si le paramètre FUSIONNER LES ATTRIBUTS est activé, toutes les entités découpées reçoivent les attributs de l'emporte-pièce qui a servi à leur découpe. Dans ce cas, le paramètre PREFIXE DES ATTRIBUTS peut être utilisé pour préfixer les attributs de l'emporte-pièce qui sont ajoutés aux entités découpées.

Traitement des bordures communes

Le paramètre TRAITEMENT DES BORDURES COMMUNES permet de définir la façon dont gérer les entités à découper dont les bordures correspondent exactement à celles de l'emporte-pièces.

• Traiter comme inférieur : Si la valeur 'Traiter comme intérieur' est choisie, alors ces entités sortent par le port INSIDE (INTERIEUR).
• Traiter comme extérieur : Les entités à découper qui se trouvent entièrement à l'extérieur de l'aire de l'emporte-pièce ressortent par le port OUTSIDE (EXTÉRIEUR).
• Traiter comme inférieur et extérieur : Si 'Traiter comme intérieur et extérieur' est choisi, les points et segments de lignes qui sont sur les bordures de l'emporte-pièces sont dupliquées et sortent par les deux ports INSIDE (INTERIEUR) et OUTSIDE (EXTERIEUR). Par défaut, ces entités sortent par le port INSIDE (INTERIEUR).

Créer des agrégats

Si l'option 'Non' est choisie pour le paramètre CREER DES AGREGATS, les entités qui sont découpées en plusieurs parties ne seront pas agrégées. Chaque partie sortira comme une entité séparée.

Préserver l'étendue

Sinon, la résolution et l'étendue des rasters sortant par CLIPPED_INSIDE (DECOUPE_INTERIEUR) seront les mêmes que celles des rasters à découper en entrée. Sinon, la résolution et l'étendue des rasters sortant par CLIPPED_INSIDE (DECOUPE_INTERIEUR) seront les mêmes que celles des rasters à découper en entrée.

Gestion de la géométrie

Si le paramètre avancé 'Support de la géométrie' du workbench est défini à 'Riche', les ellipses peuvent être découpées sans vectorisation. Par exemple, le découpage d'une ellipse en deux produira un arc et une ligne connectant les deux extrêmités de l'arc. Sinon, toutes les ellipses seront vectorisées avant d'être découpées.

Notes

• Ce Transformer fonctionne avec des données Raster et des données vecteur.
• Ce Transformer n'est pas affecté par la sélection des canaux et des palettes.

Exemple

Implémentation

Fonction(s) de bas niveau utilisée(s) (Function ou Factory): ClippingFactory, RasterClippingFactory