MEDfilterAllocate
MEDfilterBlockOfEntityCr
MEDfilterClose
MEDfilterDeAllocate
MEDfilterEntityCr

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.