doc/lfun/GroupName

GroupName()
***********


FUNKTION
========

   string GroupName(string grp)


DEFINIERT IN
============

   /p/daemon/materialdb.c (MATERIALDB)


ARGUMENTE
=========

   string grp - ein Gruppenname


BESCHREIBUNG
============

   Gibt die Langbeschreibung des Gruppennamens zurueck.


RUECKGABEWERT
=============

   Die Gruppenbeschreibung oder "Unbekanntes"


BEISPIELE
=========

   // simpel
   tmp=m_indices(ob->QueryProp(P_MATERIAL));
   write("Dieses Objekt gehoert u.a. zur Gruppe "+
         MATERIALDB->GroupName(MATERIALDB->GetMatMembership(tmp[0])[0])+
         ".\n");
   // gibt die erste Gruppenzugehoerigkeit des erste Materials in
   // P_MATERIAL zurueck (bei MATGROUP_METAL z.B. "... zur Gruppe Metalle.")

   // ein weiser Schmied:
   int i;
   string *mat, mname, mgroup;
   mat=m_indices(ob->QueryProp(P_MATERIAL));
   i=sizeof(mat);

   write("Der Schmied sagt: "+ob->Name(WER)+" besteht aus ...\n");
   while(i--) {
    // den Namen erkennen/aussprechen:
    // Materialien werden allgemein ganz schlecht erkannt (zu 5%), aber
    // alles aus Metall wird zu +100% gut erkannt ...
    mname=MATERIALDB->MaterialName(mat[i], WER,
           ({5, ([MATERIAL_SYMMETRIC_RECOGNIZABILITY:
                      ({MATGROUP_METAL, 100})])}));

    // und nur Metalle analysieren ...
    if(MATERIALDB->MaterialGroup(([mat[i]:100]),MATGROUP_METAL)>=100) {
     int j;
     string *mgr;
     mgr=MATERIALDB->GetMatMembership(mat[i]);
     j=sizeof(mgr);
     mgroup=" gehoert zu ";
     while(j--) {
      mgroup+=MATERIALDB->GroupName(mgr[j]);
      if(j>0) mgroup+=", ";
     }
    } else mgroup=" kenne ich nicht";
    printf("%-12.12s: %s\n",mname, mgroup);
   }


SIEHE AUCH
==========

   Konzepte:    material, materialerkennung
   Grundlegend: P_MATERIAL, /sys/thing/material.h
   Master:      AddMaterial(), ConvMaterialList(), MaterialGroup(),
                MaterialName(),
                GetGroupMembers(), GetMatMembership()

7. Mai 2004 Gloinson