interface-descriptor.h

Go to the documentation of this file.

/*
  INTERFACE-DESCRIPTOR.h  -  Metadata interface for Lumiera interfaces

  Copyright (C)         Lumiera.org
    2008,               Christian Thaeter <ct@pipapo.org>

  This program is free software; you can redistribute it and/or
  modify it under the terms of the GNU General Public License as
  published by the Free Software Foundation; either version 2 of
  the License, or (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

*/


#ifndef COMMON_INTERFACEDESCRIPTOR_H
#define COMMON_INTERFACEDESCRIPTOR_H

#include "common/interface.h"


enum lumiera_interface_state {
  LUMIERA_INTERFACE_BROKEN = -1,
  LUMIERA_INTERFACE_EXPERIMENTAL = 0,
  LUMIERA_INTERFACE_DEPRECATED = 1,
  LUMIERA_INTERFACE_BETA = 2,
  LUMIERA_INTERFACE_STABLE = 3
};


LUMIERA_INTERFACE_DECLARE (lumieraorg_interfacedescriptor, 0,
                           /* The following slots are some human-readable descriptions of certain properties */
                           LUMIERA_INTERFACE_SLOT (const char*, name, (LumieraInterface)),
                           LUMIERA_INTERFACE_SLOT (const char*, brief, (LumieraInterface)),
                           LUMIERA_INTERFACE_SLOT (const char*, homepage, (LumieraInterface)),
                           LUMIERA_INTERFACE_SLOT (const char*, version, (LumieraInterface)),
                           LUMIERA_INTERFACE_SLOT (const char*, author, (LumieraInterface)),
                           LUMIERA_INTERFACE_SLOT (const char*, email, (LumieraInterface)),
                           LUMIERA_INTERFACE_SLOT (const char*, copyright, (LumieraInterface)),
                           LUMIERA_INTERFACE_SLOT (const char*, license, (LumieraInterface)),

                           /* some flags for properties */
                           LUMIERA_INTERFACE_SLOT (int, state, (LumieraInterface)),

                           /* compare 2 version strings in a custom way */
                           LUMIERA_INTERFACE_SLOT (int, versioncmp, (const char*, const char*))
                           );


#if 0

LUMIERA_INTERFACE_INSTANCE (lumieraorg_interfacedescriptor, 0,
                            /*IDENTIFIER*/,
                            NULL, NULL, NULL,
                            LUMIERA_INTERFACE_INLINE (name, LUIDGEN,
                                                      const char*, (LumieraInterface iface),
                                                      {return /*NAME*/;}
                                                      ),
                            LUMIERA_INTERFACE_INLINE (brief, LUIDGEN,
                                                      const char*, (LumieraInterface iface),
                                                      {return /*BRIEF*/;}
                                                      ),
                            LUMIERA_INTERFACE_INLINE (homepage, LUIDGEN,
                                                      const char*, (LumieraInterface iface),
                                                      {return /*HOMEPAGE*/;}
                                                      ),
                            LUMIERA_INTERFACE_INLINE (version, LUIDGEN,
                                                      const char*, (LumieraInterface iface),
                                                      {return /*VERSION*/;}
                                                      ),
                            LUMIERA_INTERFACE_INLINE (author, LUIDGEN,
                                                      const char*, (LumieraInterface iface),
                                                      {return /*AUTHOR*/;}
                                                      ),
                            LUMIERA_INTERFACE_INLINE (email, LUIDGEN,
                                                      const char*, (LumieraInterface iface),
                                                      {return /*EMAIL*/;}
                                                      ),
                            LUMIERA_INTERFACE_INLINE (copyright, LUIDGEN,
                                                      const char*, (LumieraInterface iface),
                                                      {
                                                        return
                                                          "Copyright (C)        "/*ORGANIZATION*/"\n"
                                                          "  "/*YEARS*/"               "/*AUTHOR*/" <"/*EMAIL*/">";
                                                      }
                                                      ),
                            LUMIERA_INTERFACE_INLINE (license, LUIDGEN,
                                                      const char*, (LumieraInterface iface),
                                                      {
                                                        return
                                                          /*LICENSE*/;
                                                      }
                                                      ),

                            LUMIERA_INTERFACE_INLINE (state, LUIDGEN,
                                                      int, (LumieraInterface iface),
                                                      {return /*LUMIERA_INTERFACE_EXPERIMENTAL*/;}
                                                      ),

                            LUMIERA_INTERFACE_INLINE (versioncmp, LUIDGEN,
                                                      int, (const char* a, const char* b),
                                                      {return /*COMPARERESULT*/;}
                                                      )
                            );
#endif


#endif /* COMMON_INTERFACEDESCRIPTOR_H */
/*
// Local Variables:
// mode: C
// c-file-style: "gnu"
// indent-tabs-mode: nil
// End:
*/