med_err MEDfilterEntityCr ( const med_idt  fid,
const med_int  nentity,
const med_int  nvaluesperentity,
const med_int  nconstituentpervalue,
const med_int  constituentselect,
const med_switch_mode  switchmode,
const med_storage_mode  storagemode,
const char *const   profilename,
const med_int  filterarraysize,
const med_int filterarray,
med_filter *const   filter 
)

Crée un filtre élémentaire en selectionnant les entités pour lesquelles on veut lire/écrire des valeurs. Le tableau filterarray contient des index croissants d'un tableau de profil. Cette sélection permet une lecture/écriture avancée vers/depuis les emplacements mémoire sélectionnés. Elle s'utilise uniquement en mode séquentiel (un seul processus).

Paramètres:
fid Identificateur du fichier.
nentity Nombre de correspondance. Ce paramètre ne prend pas en compte nvaluesperentity et nconstituentpervalue.
nvaluesperentity Nombre de valeurs par entité. Utiliser la valeur 1 pour un filtre d'éléments de maillage. Cela peut être le nombre de points d'intégration utilisé dans un champ résultat.
nconstituentpervalue Nombre de constituants par valeur. Cela peut être le nombre de coordonnées des noeuds, le nombre de noeuds d'une connectivité, le nombre de composantes d'un champ résultat.
constituentselect Numéro de constituant des valeurs à filtrer (commence à 1). Le mot clé MED_ALL_CONSTITUENT permet de selectionner tous les constituants. Cela peut être le numéro de coordonnées des noeuds, le numéro de noeuds d'une connectivité, le numéro de composantes d'un champ résultat.
switchmode Mode d'entrelacement utilisé pour le stockage de valeurs med_switch_mode.
storagemode Indique le mode de stockage en mémoire med_storage_mode des valeurs associées au profil utilisé.
profilename Nom du profil utilisé (de taille maximum MED_NAME_SIZE ) ou (MED_NO_PROFILE | MED_ALLENTITIES_PROFILE ) s'il n'y a pas de profil.
filterarraysize Nombre d'entités à filtrer et taille du tableau filterarray. Ne prend pas en compte nvaluesperentity et nconstituentpervalue.
filterarray Tableau d'index du profil des numéros d'entités associées aux valeurs à sélectionner.
Valeurs retournées:
filter Filtre sur entités (med_filter) appliqué en lecture/écriture de valeurs. La déallocation est à la charge de l'utilisateur (cf. MEDfilterClose MEDfilterDeAllocate).
Renvoie:
retour négatif en cas d'erreur, Zéro sinon.

La sélection des emplacements mémoire lus/écrits s'opère dans l'espace mémoire d'un seul processus. Les entités sélectionnées le sont avec toutes leurs valeurs (nvaluesperentity). Il est possible de sélectionner l'ensemble des constituants par valeur ( MED_ALL_CONSTITUENT ) ou uniquement les constituants n° constituentselect . Les constituants sont lus/écrits en mode MED_FULL_INTERLACE|MED_NO_INTERLACE (med_switch_mode). Le mode de stockage peut être MED_GLOBAL ou MED_COMPACT (med_storage_mode). Les index définis dans le tableau de filtre (filterarray) sont des index relatifs à un tableau profil (eventuellement le tableau virtuel MED_ALLENTITIES_PROFILE ou MED_NO_PROFILE ). La numérotation des index commence à 1. Les index se définissent de la façon suivante :

  • Si le filtre opère sur un tableau de valeurs sans profil, les index sont les numéros d'entités utilisées selon la numérotation MED relative au type géométrique de l'entité (équivaut aux index d'un profil MED_ALLENTITIES_PROFILE).
  • Si le filtre opère sur un tableau de valeurs avec profil en mode MED_GLOBAL, les index du tableau filterarray indiquent les numéros d'entités à selectionner dans le tableau profil.
  • Si le filtre opère sur un tableau de valeurs avec profil en mode MED_COMPACT, les index du tableau filterarray indiquent les numéros d'entités à selectionner dans le tableau profil.
Remarques:
Le filtre crée prend en compte les paramètres nvaluesperentity et nconstituentpervalue pour selectionner les emplacements en mémoire en fonction du mode de stockage utilisé (med_storage_mode).

Définition à la ligne 49 du fichier MEDfilterEntityCr.c.


Généré le Mon Nov 19 15:43:46 2012 pour MED fichier par  doxygen 1.6.1