interface-descriptor.h

Go to the documentation of this file.

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

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

  **Lumiera** 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. See the file COPYING for further details.

*/


#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:
*/