AppearanceSetter

Ce port d'entrée est facultatif. Si ce port d'entrée n'est pas utilisé, seules les valeurs spécifiées dans les paramètres de ce Transformer seront utilisées.

Les entités de style d'apparence qui entrent par ce port seront appliquées aux faces avant et/ou arrière des géométries. Le format de cette entité doit correspondre précisément à ce qui sort des Transformers AppearanceExtractor ou AppearanceStyler.

Il peut avoir de nombreux attributs facultatifs qui expriment les paramètres de couleur et/ou de texture de l'apparence. Il doit également avoir soit une géométrie Raster (qui s'entend comme étant la texture Raster à utiliser), soit une géométrie nulle. Les paramètres Style de ce Transformer, s'ils sont utilisés, remplaceront toutes les valeurs de ces entités d'entrée.

Entités contenant une géométrie sur laquelle une apparence peut être appliquée.

L'utilisation de ce port d'entrée est optionnelle.

Toutes les entités qui entrent dans ce port sont retenues jusqu'à ce que ce Transformer ait terminé son traitement, et sont ensuite sorties par le port Holder à la toute fin. Ces entités ne seront pas directement modifiées de quelque manière que ce soit par ce Transformer, mais peuvent avoir été indirectement modifiées. Veuillez lire la documentation relative à la valeur "Remplacer les définitions existantes" de l'option "Stockage des apparences" pour savoir comment cela peut se produire.

La raison pour laquelle ces ports Holder sont utiles est que, dans certaines situations, il est important de contrôler le temps de passage des entités dans le traitement. En retenant certaines entités, vous vous assurez que ce Transformer a une chance de terminer sa tache avant de permettre à d'autres entités de continuer plus loin dans le traitement.

Exemples

Il y a 100 entités qui traversent le traitement, et elles contiennent toutes des surfaces qui font référence à une apparence de "brique rouge". Leur flux naturel serait de sortir directement vers un Writer. Cependant, dans une section séparée de l'espace de travail, il existe un AppearanceSetter qui utilise l'option Remplacer les définitions existantes du paramètre Stockage de l'apparence. Il remplace la définition de l'apparence "brique rouge" par "brique brune", en utilisant évidemment une couleur différente.

Dans cette situation, s'il n'y a pas de contrôle explicite de l'ordre des entités, les 50 premières entités pourraient être envoyées par inadvertance au Writer, suivies du traitement par AppearanceSetter, puis des 50 dernières entités envoyées au Writer. Ici, la sortie contiendrait 50 entités "brique rouge" et 50 entités "brique brune". Vous ne seriez pas en mesure de contrôler l'ordre arbitraire des entités qui circulent dans le traitement.

Si, toutefois, les 100 entités sont acheminées par le port Holder, il est garanti que l'AppearanceSetter effectuera son traitement avant qu'aucune des 100 entités ne soit envoyée au Writer. Dans ce cas, la sortie contiendrait 100 entités de type "brique brune". C'est probablement le résultat souhaité : modifier la définition d'une apparence, s'assurer que cette définition est reflétée dans l'ensemble du jeu de données (sans avoir à localiser chaque référence à cette apparence modifiée), et avoir la garantie que toutes les entités reflètent ce changement quel que soit l'ordre du flux des entités d'entrée.

Toutes les entités Géométrie ressortent, modifiées ou non.

All features that came in through the Holder input port will be output through this port. See the Holder input port for more details on correct usage of these ports.

Entités qui ne sont pas requêtées.

Seules les entités de style d'apparence avec des types de géométrie null ou raster sont acceptées. Toutes les autres entités de style d'apparence sont rejetées.

Si les paramètres de jonction (décrits ci-dessous) ne sont pas utilisés, seul le premier style d'apparence entré par groupe est utilisé. Tous les autres styles d'apparence supplémentaires sont rejetés et émis par ce port.

Les entités rejetées ont un attribut fme_rejection_code avec une des valeurs suivantes : EXTRA_APPEARANCE_FEATURE, INVALID_APPEARANCE_GEOMETRY_TYPE, INVALID_GEOMETRY_GEOMETRY_TYPE.

Notez que seuls les premiers styles d'apparence de chaque groupe sont utilisés.

Lorsque toutes les entités sont reçues : comportement par défaut. Le traitement n'aura lieu qu'une fois que toutes les entités en entrée seront présente.

Quand le groupe change (avancé) : ce Transformer traitera les groupes en entrée dans l'ordre. Les changements de la valeur du paramètre Regrouper par sur le flux d'entrée déclencheront le traitement du groupe en cours de regroupement. Cela peut améliorer la vitesse globale (en particulier avec plusieurs groupes de taille égale), mais peut provoquer un comportement indésirable si les groupes en entrée ne sont pas ordonnés.

Considérations sur l'utilisation de Regrouper par

Il y a deux raisons typiques d'utiliser Quand le groupe change (avancé). La première concerne les données entrantes qui sont destinées à être traitées en groupes (et qui sont déjà classées ainsi). Dans ce cas, c'est la structure qui dicte l'utilisation de Regrouper par - et non des considérations de performance.

La seconde raison possible est le potentiel gain de performances.

Les gains de performance sont plus visibles quand les données sont déjà triées (ou lues en utilisant une déclaration SQL ORDER BY) puisque moins de travail est requis de la part de FME. Si les données doivent être ordonnées, elles peuvent être triées dans le traitement (bien que la surcharge de traitement supplémentaire puisse annuler tout gain).

Le tri devient plus difficile en fonction du nombre de flux de données. Il peut être quasiment impossible de trier des flux de données multiples dans l'ordre correct, car toutes les entités correspondant à une valeur Regrouper par doivent arriver avant toute entité (de tout type d'entité ou jeu de données) appartenant au groupe suivant. Dans ce cas, l'utilisation de Regrouper par avec Lorsque toutes les entités sont reçues peut être une approche équivalente et plus simple.

Note: De multiples types d'entités et entités de multiples jeux de données ne vont généralement pas arriver dans l'ordre correct.

Comme pour beaucoup de scénarios, tester différentes approches dans votre projet avec vos données est le seul moyen sûr d'identifier le gain de performance.

Utilisez ce paramètre si vous souhaitez isoler uniquement une partie de la géométrie transmise au Transformer. Si aucun critère n'est spécifié, l'action s'appliquera à l'ensemble de la géométrie à tous les niveaux.

La sélection peut être basée sur l'emplacement structurel, le nom de la géométrie, le type, les informations sur l'apparence, les traits, les types de stockage des traits ou la référence de la définition. La syntaxe utilisée est un ensemble restreint de XQuery, où la clause de retour est fixe.

La boîte de dialogue XQuery de Géométrie de base vous permet de construire des requêtes de sélection simples en écrivant automatiquement la requête nécessaire en fonction des clauses de test spécifiées. En cliquant sur le bouton "Avancé", vous ouvrez l'éditeur avancé, qui vous permet de saisir une requête en forme libre, pour des requêtes plus expressives.

Note: Une fois passé au mode avancé, vous devrez effacer tous les paramètres avant de pouvoir retourner au mode basique.

Une géométrie hiérarchique est représentée par des nœuds, avec des attributs contenant de l'information sur les traits, types et nom de chaque géométrie.

Vous pouvez spécifier sur quelle(s) face(s) de la géométrie appliquer l'apparence.

Face avant : la texture est uniquement appliquée à la face avant de la géométrie.

Face arrière : la texture n'est appliquée que sur la face arrière de la géométrie.

Faces avant et arrière : la texture est appliquée sur les deux faces des parties de géométrie.

Ces deux paramètres doivent être utilisés ensemble.

Si ces paramètres ne sont pas utilisés, le Transformer utilise seulement un style d'apparence (par groupe) et l'applique à toutes les parties de géométries sélectionnées.

Si ces paramètres de jonction sont spécifiés, toutes les entités de style d'apparence (par groupe) sont conservées comme correspondances possibles pour chaque partie géométrique sélectionnée. Dans chaque cas, la valeur du Trait spécifié sur la partie géométrique correspond à la valeur de l'attribut spécifié sur les entités de style d'apparence. (S'il y a plus d'une correspondance, une entité de style d'apparence arbitraire est choisie. S'il n'y a pas de correspondance, aucun traitement n'est effectué pour cette partie géométrique). Le style d'apparence correspondant est alors utilisé pour le traitement de cette partie de la géométrie.

Note: Notez qu'un Trait manquant sur la partie géométrique, ou un Attribut manquant sur les entités de style d'apparence sont équivalents à des traits ou attributs vides. Les traits dont les valeurs sont vides correspondent aux attributs dont les valeurs sont vides. Cela vous permettra, par exemple, d'envoyer intentionnellement une entité de style d'apparence "par défaut" sans l'attribut de jonction et de l'utiliser pour toutes les pièces géométriques pour lesquelles le trait n'est pas présent. Ceci est utile si toutes les pièces géométriques ne sont pas censées avoir le trait de jonction.

Lorsque vous passez des entités de style Apparence, ce Transformer crée des définitions d'Apparence. Cependant, il existe deux façons de stocker et d'utiliser ces nouvelles apparences :

• Créer de nouvelles définitions : Il s'agit de l'approche la plus simple. Avec cette option, une nouvelle définition d'apparence est créée et stockée dans la bibliothèque interne de FMELibrary. Cette nouvelle définition est référencée par les parties de géométrie sélectionnées ; les références aux définitions précédentes sont supprimées, laissant ces définitions inchangées dans la bibliothèque interne FMELibrary.
• Remplacer les définitions existantes : Cette approche est puissante et peut changer beaucoup de choses dans le jeu de données très efficacement. Avec cette option, une nouvelle définition d'apparence n'est pas créée, mais le lien vers chaque définition d'apparence référencée par les parties géométriques sélectionnées est suivi, et chacune de ces définitions est remplacée dans la bibliothèque interne FMELibrary.

Cela se traduit de deux manières : Premièrement, toutes les parties géométriques choisies reflètent les nouvelles propriétés de style d'apparence, même si elles ne changent pas la façon dont elles font référence aux apparences. Deuxièmement, un effet plus subtil est que toutes les parties géométriques, sur toutes les entités actives (même celles qui ne passent pas par cette usine) qui font référence aux définitions d'apparence écrasées verront immédiatement les nouvelles valeurs également.

Ce Transformer peut donc modifier la nature effective de certaines entités qui ne le traversent jamais. Consulter la documentation des ports Holder d'entrée et de sortie pour la gestion de ces effets.

Un nom qui vous aidera à vous rappeler à quoi sert l'apparence, par exemple "mur de château" ou "toit de maison". Notez qu'il n'est pas nécessaire qu'il soit unique.

Nom de l'attribut :  fme_appearance_style_name

La signification la plus instinctive de la couleur d'un objet, la couleur essentielle qui se révèle sous une lumière blanche pure. Elle est perçue comme la couleur de l'objet plutôt que comme un reflet de la lumière.

Nom de l'attribut :  fme_appearance_style_diffuse_color

La couleur que reflète l'objet lorsqu'il est éclairé par la couleur du milieu ambiant plutôt que la lumière directe.

Nom de l'attribut :  fme_appearance_style_ambient_color

La couleur de la lumière réfléchie par l'objet à travers une réflexion spéculaire (le type de réflexion qui est caractéristique de la lumière réfléchie par une surface brillante).

Nom de l'attribut :  fme_appearance_style_specular_color

Couleur de la lumière que l'objet émet lui-même.

Nom de l'attribut :  fme_appearance_style_emissive_color

Une valeur de 0 à 1 qui spécifie l'éclat de la réflexion spéculaire. 0 signifie mat et 1 extrêmement brillant.

Nom de l'attribut :  fme_appearance_style_shininess

Spécifie le niveau de transparence du style. 0 signifie complètement transparent et 1 complètement opaque.

Nom de l'attribut :  fme_appearance_style_alpha

Utilisé pour spécifier l'origine du système de coordonnées de la texture. Il n'est utilisé qu'en conjonction avec la mise à l'échelle et la rotation.

Nom de l'attribut :  fme_texture_style_center_u

Utilisé pour spécifier l'origine du système de coordonnées de la texture. Il n'est utilisé qu'en conjonction avec la mise à l'échelle et la rotation.

Nom de l'attribut :  fme_texture_style_center_v

Spécifie la rotation de l’angle de la texture, en degrés dans le sens inverse des aiguilles d'une montre, autour du centre de la texture (à partir d'une ligne parallèle à l'axe u, en passant par le centre de la texture).

Nom de l'attribut :  fme_texture_style_rotation_angle

Utilisé pour spécifier la valeur de la découpe le long de l'axe u des coordonnées de la texture par rapport au centre.

Nom de l'attribut :  fme_texture_style_u_shearing_factor

Utilisé pour spécifier la valeur de la découpe le long de l'axe v des coordonnées de la texture par rapport au centre.

Nom de l'attribut :  fme_texture_style_v_shearing_factor

Utilisé pour spécifier la valeur de la réduction que la texture peut subir le long de l'axe u.

Nom de l'attribut :  fme_texture_style_u_scaling_factor

Utilisé pour spécifier la valeur de la réduction que la texture peut subir le long de l'axe v.

Nom de l'attribut :  fme_texture_style_v_scaling_factor

Utilisé pour spécifier la compensation appliquée à la texture après toutes les autres modifications.

Nom de l'attribut :  fme_texture_style_u_offset

Utilisé pour spécifier la compensation appliquée à la texture après toutes les autres modifications.

Nom de l'attribut :  fme_texture_style_v_offset

N'affecte que la zone située en dehors de la plage U et V de 0 à 1. Notez que tous les styles d'habillage de texture ne sont pas pris en charge par tous les formats de sortie, auquel cas le style d'habillage de texture sera défini par défaut comme un style individuel pris en charge par les données destination.

Aucun : signifie qu'aucun style d'habillage n'est donné et que le comportement en dehors de la plage de 0-1 est indéterminé.

Répéter en U et V : copie la texture dans les deux directions.

Plaquer en U et V : le même pixel en bordure de la texture est répété sur l'axe de v et sur l'axe des u.

Plaquer en U et répéter en V : le même pixel est utilisé sur l'axe des u mais la texture est répétée sur l'axe des y.

Répéter en U et plaquer en V : le même pixel est utilisé sur l'axe des V mais la texture est répétée sur l'axe des U.

Miroir : la texture est répétée et retournée dans les deux directions (effet miroir).

Remplissage des bords : utilise une couleur de bordure constante pour remplir les valeurs en dehors de la plage 0 à 1 pour U et V.

Nom de l'attribut :  fme_texture_style_wrap

Ce paramètre est utilisé uniquement avec le style d'habillage Remplissage des bords et n'est pris en charge que par certains formats. Il spécifie la couleur qui doit "déborder" dans l'espace entourant la trame de texture.

Nom de l'attribut :  fme_texture_style_border_color

Lorsqu'une apparence avec une texture raster est définie, chaque partie de la géométrie qui est affectée nécessite également des coordonnées de texture. Lorsque ce paramètre a pour valeur Non, de nouvelles coordonnées de texture sont toujours calculées pour chaque partie de la géométrie qui est affectée par l'apparence qui est définie. Lorsque ce paramètre a pour valeur Oui, de nouvelles coordonnées de texture sont calculées uniquement sur les parties de la géométrie affectées où elles n'existent pas encore. Les coordonnées de texture existantes restent inchangées.

Ce paramètre indique comment la texture définie dans un style d'apparence sera mappée sur la surface. Ceci n'est applicable qu'aux textures qui ont des images rasters.

• Normale de surface : Les textures sont projetées sur les surfaces selon leurs normales. Pour les surfaces composées, chaque partie est traitée séparément, car elles peuvent avoir des normales différentes.
• Vue d'en haut : les textures sont projetées sur les surfaces le long d'une normale unique - celle perpendiculaire au plan x-y. Dans ce mode, une surface composite est considérée comme une géométrie unique lorsque les coordonnées de la texture sont appliquées.

Vous pouvez spécifier comment la texture est décalée dans la direction u.

Vous pouvez spécifier comment la texture est décalée dans la direction v.

Le facteur de répétition de la texture en u peut être utilisé pour spécifier le nombre de fois où la texture est répétée en lignes.

Le facteur de répétition de la texture en v peut être utilisé pour spécifier le nombre de fois où la texture est répétée en colonnes.

Utilisation de l'éditeur de texte

L'éditeur de texte fournit un moyen efficace de construire des chaînes de textes (dont les expressions régulières) à partir de données source diverses, telles que des attributs, des paramètres et des constantes, et le résultat est directement utilisé dans le paramètre.

Editeur de texte

Utilisation de l'éditeur arithmétique

L'éditeur arithmétique fournit un moyen simple de construire des expressions mathématiques à partir de plusieurs données source, telles que des attributs et des fonctions, et le résultat est directement utilisé dans un paramètre.

Éditeur arithmétique

Valeur conditionnelle

Définit des valeurs selon un ou plusieurs tests.

Fenêtre de définition de conditions

Contenu

Les expressions et chaînes de caractères peuvent inclure des fonctions, caractères, paramètres et plus.

Lors du paramétrage des valeurs - qu'elles soient entrées directement dans un paramètre ou construites en utilisant l'un des éditeurs - les chaînes de caractères et les expressions contenant des fonctions Chaîne de caractères, Math, Date et heure ou Entité FME auront ces fonctions évaluées. Par conséquent, les noms de ces fonctions (sous la forme @<nom_de_fonction>) ne doivent pas être utilisés comme valeurs littérales de chaîne de caractères.

Types de contenu

Fonctions chaînes de caractères	Ces fonctions manipulent les chaînes de caractères.
Caractères spéciaux	Un ensemble de caractères de contrôle est disponible dans l'éditeur de texte.
Fonctions mathématiques	Plusieurs fonctions sont disponibles dans les deux éditeurs.
Fonctions Date/heure	Les fonctions de dates et heures sont disponibles dans l'Editeur texte.
Opérateurs mathématiques	Ces opérateur sont disponibles dans l'éditeur arithmétique.
Fonctions d'entités	Elles retournent des valeurs spécifiques aux entités.
Paramètres FME	Les paramètres FME et spécifiques au projet peuvent être utilisés.
Créer et modifier un paramètre publié	Créer ses propres paramètres éditables.

Note : Tous les outils ne sont pas disponibles dans tous les Transformers.