display_config.h

/*
 * \file IMP/display/display_config.h
 * \brief Provide macros to mark functions and classes as exported
 *        from a DLL/.so, and to set up namespaces
 *
 * When building the module, IMPDISPLAY_EXPORTS should be defined, and when
 * using the module externally, it should not be. Classes and functions
 * declared in the module's headers should then be marked with
 * IMPDISPLAYEXPORT if they are intended to be part of the API and
 * they are not defined entirely in a header.
 *
 * The Windows build environment requires applications to mark exports in
 * this way; we use the same markings to set the visibility of ELF symbols
 * if we have compiler support.
 *
 * All code in this module should live in the IMP::display namespace.
 * This is simply achieved by wrapping things with the
 * IMPDISPLAY_BEGIN_NAMESPACE and IMPDISPLAY_END_NAMESPACE macros.
 * There are similar macros for module code that is designed to be for
 * internal use only.
 *
 * This header is auto-generated by tools/build/setup_module.py;
 * it should not be edited manually.
 *
 * Copyright 2007-2014 IMP Inventors. All rights reserved.
 *
 */

#ifndef IMPDISPLAY_CONFIG_H
#define IMPDISPLAY_CONFIG_H

#include <IMP/base/base_config.h>
#include <string>

#ifdef _MSC_VER

#ifdef IMPDISPLAY_EXPORTS
#define IMPDISPLAYEXPORT __declspec(dllexport)
#else  // EXPORTS
#define IMPDISPLAYEXPORT __declspec(dllimport)
#endif  // EXPORTS

#else  // _MSC_VER

#ifdef GCC_VISIBILITY
#define IMPDISPLAYEXPORT __attribute__((visibility("default")))
#else  // GCC_VISIBILITY
#define IMPDISPLAYEXPORT
#endif  // GCC_VISIBILITY

#endif  // _MSC_VER

#if defined(_MSC_VER) && !defined(SWIG)
#ifdef IMPDISPLAY_EXPORTS

#define IMPDISPLAY_EXPORT_TEMPLATE(name)     \
  template class __declspec(dllexport) name

#else  //EXPORTS

#define IMPDISPLAY_EXPORT_TEMPLATE(name)     \
  template class __declspec(dllimport) name

#endif  // EXPORTS

#else  // MSC and SWIG
#define IMPDISPLAY_EXPORT_TEMPLATE(name) IMP_REQUIRE_SEMICOLON_NAMESPACE

#endif  // MSC and SWIG

#if !defined(SWIG) && !defined(IMP_DOXYGEN)

#define IMPDISPLAY_BEGIN_NAMESPACE \
  IMP_COMPILER_ENABLE_WARNINGS namespace IMP{namespace display {

#define IMPDISPLAY_END_NAMESPACE } } \
IMP_COMPILER_DISABLE_WARNINGS

#define IMPDISPLAY_BEGIN_INTERNAL_NAMESPACE IMPDISPLAY_BEGIN_NAMESPACE \
  namespace internal {

#define IMPDISPLAY_END_INTERNAL_NAMESPACE } IMPDISPLAY_END_NAMESPACE

#else  // SWIG and DOXYGEN
#define IMPDISPLAY_BEGIN_NAMESPACE namespace IMP{namespace display {

#define IMPDISPLAY_END_NAMESPACE } }

#define IMPDISPLAY_BEGIN_INTERNAL_NAMESPACE IMPDISPLAY_BEGIN_NAMESPACE\
  namespace internal {

#define IMPDISPLAY_END_INTERNAL_NAMESPACE } IMPDISPLAY_END_NAMESPACE

#endif  // SWIG AND DOXYGEN

#define IMP_DISPLAY_USE_IMP_BASE
#define IMP_DISPLAY_HAS_IMP_BASE 1
#define IMP_DISPLAY_USE_IMP_CGAL
#define IMP_DISPLAY_HAS_IMP_CGAL 1
#define IMP_DISPLAY_USE_BOOST_FILESYSTEM
#define IMP_DISPLAY_HAS_BOOST_FILESYSTEM 1
#define IMP_DISPLAY_USE_BOOST_PROGRAMOPTIONS
#define IMP_DISPLAY_HAS_BOOST_PROGRAMOPTIONS 1
#define IMP_DISPLAY_USE_BOOST_RANDOM
#define IMP_DISPLAY_HAS_BOOST_RANDOM 1
#define IMP_DISPLAY_USE_BOOST_SYSTEM
#define IMP_DISPLAY_HAS_BOOST_SYSTEM 1
#define IMP_DISPLAY_USE_CGAL
#define IMP_DISPLAY_HAS_CGAL 1

    //  functions are defined explicitly for SWIG
    namespace IMP {
  namespace display {
/** \name Standard module methods
  All \imp modules have a set of standard methods to help get information
  about the module and about files associated with the module.
  @{
  */
#if !defined(SWIG)
    IMPDISPLAYEXPORT std::string get_module_version();
#endif

#if !defined(SWIG)
    // SWIG will whine about duplicate definitions of function
    inline std::string get_module_name() { return "IMP::display"; }
#endif

  }
}  //namespace

#if !defined(IMP_DOXYGEN) && !defined(SWIG)

#include <IMP/base/Showable.h>
#include <IMP/base/hash.h>

namespace IMP { namespace display {
using ::IMP::base::Showable;
using ::IMP::base::operator<<;
using ::IMP::base::hash_value;
} } // namespace
namespace IMP { namespace display { namespace internal {
using ::IMP::base::Showable;
using ::IMP::base::operator<<;
using ::IMP::base::hash_value;
} } } // namespace

#endif // !defined(SWIG) && !defined(IMP_DOXYGEN)


#if !defined(SWIG)
    namespace IMP {
  namespace display {

    //! Return the full path to installed data
    /** Each module has its own data directory, so be sure to use
        the version of this function in the correct module. To read
        the data file "data_library" that was placed in the \c data
        directory of module "mymodule", do something like
        \code
        std::ifstream in(IMP::mymodule::get_data_path("data_library"));
        \endcode
        This will ensure that the code works when \imp is installed or
        used via the \c setup_environment.sh script.
    */
    IMPDISPLAYEXPORT std::string get_data_path(std::string file_name);

    //! Return the path to installed example data for this module
    /** Each module has its own example directory, so be sure to use
        the version of this function in the correct module.  For example
        to read the file \c example_protein.pdb located in the
        \c examples directory of the IMP::atom module, do
        \code
        IMP::atom::read_pdb(IMP::atom::get_example_path("example_protein.pdb",
       model));
        \endcode
        This will ensure that the code works when \imp is installed or
        used via the \c setup_environment.sh script.
    */
    IMPDISPLAYEXPORT std::string get_example_path(std::string file_name);
    /** @} */

  }
}  // namespace

#endif  // SWIG

#include <IMP/base/compiler_macros.h>

#ifdef IMP_DOXYGEN
/** \namespace IMP::display
    \brief See [IMP.display](\ref impdisplay) for more information.
    */
#endif

#endif /* IMPDISPLAY_CONFIG_H */

// Here so it is always parsed

#ifdef IMPDISPLAY_DEPRECATED_HEADER
#undef IMPDISPLAY_DEPRECATED_HEADER
#undef IMPDISPLAY_DEPRECATED_VALUE_DEF
#undef IMPDISPLAY_DEPRECATED_VALUE_DECL
#undef IMPDISPLAY_DEPRECATED_OBJECT_DEF
#undef IMPDISPLAY_DEPRECATED_OBJECT_DECL
#undef IMPDISPLAY_DEPRECATED_FUNCTION_DEF
#undef IMPDISPLAY_DEPRECATED_FUNCTION_DECL
#undef IMPDISPLAY_DEPRECATED_METHOD_DEF
#undef IMPDISPLAY_DEPRECATED_METHOD_DECL
#undef IMPDISPLAY_DEPRECATED_MACRO
#undef IMPDISPLAY_SHOW_WARNINGS
#endif

// the central modules we can update easily, so don't warn in them
#if defined( IMPDISPLAY_COMPILATION)                                 \
  || defined(SWIG) || defined(IMP_SWIG_WRAPPER)                         \
  || defined( IMPDISPLAY_ALL) || defined(IMP_DOXYGEN)                \
  || defined(IMPBASE_COMPILATION) || defined(IMPKERNEL_COMPILATION)     \
  || defined(IMPCORE_COMPILATION) || defined(IMPATOM_COMPILATION)       \
  || defined(IMPSTATISTICS_COMPILATION) || defined(IMPDOMINO_COMPILATION) \
  || defined(IMPCONTAINER_COMPILATION) || defined(IMPDISPLAY_COMPILATION) \
  || defined(IMPSCOREFUNCTOR_COMPILATION) || defined(IMPRMF_COMPILATION) \
  || defined(IMPGSL_COMPILATION)
#define IMPDISPLAY_SHOW_WARNINGS 0
#else
#define IMPDISPLAY_SHOW_WARNINGS 1
#endif

// suppress header warnings with all header, SWIG wrapper and in the module
#if IMPDISPLAY_SHOW_WARNINGS
#define IMPDISPLAY_DEPRECATED_HEADER(version, help_message)          \
    IMP_PRAGMA(message(__FILE__ " is deprecated: " help_message))
#define IMPDISPLAY_DEPRECATED_VALUE_DECL(version)    \
  IMP_DEPRECATED_ATTRIBUTE
#define IMPDISPLAY_DEPRECATED_OBJECT_DECL(version)    \
  IMP_DEPRECATED_ATTRIBUTE
#define IMPDISPLAY_DEPRECATED_FUNCTION_DECL(version) \
  IMP_DEPRECATED_ATTRIBUTE
#define IMPDISPLAY_DEPRECATED_METHOD_DECL(version) \
  IMP_DEPRECATED_ATTRIBUTE

#else //IMPDISPLAY_SHOW_WARNINGS
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPDISPLAY_DEPRECATED_HEADER(version, help_message) \
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPDISPLAY_DEPRECATED_VALUE_DECL(version)
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPDISPLAY_DEPRECATED_OBJECT_DECL(version)
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPDISPLAY_DEPRECATED_FUNCTION_DECL(version)
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPDISPLAY_DEPRECATED_METHOD_DECL(version)

#endif // IMPDISPLAY_SHOW_WARNINGS

// only warn about it in the all inclusion to cut down on copies
#if !defined(IMP_ALL) || defined(SWIG) || defined(IMP_DOXYGEN)          \
  || defined(IMPBASE_COMPILATION) || defined(IMPKERNEL_COMPILATION)     \
  || defined(IMPCORE_COMPILATION) || defined(IMPATOM_COMPILATION)       \
  || defined(IMPSTATISTICS_COMPILATION) || defined(IMPDOMINO_COMPILATION) \
  || defined(IMPCONTAINER_COMPILATION) || defined(IMPDISPLAY_COMPILATION) \
  || defined(IMPSCOREFUNCTOR_COMPILATION)
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPDISPLAY_DEPRECATED_MACRO(version, message)

#else
#define IMPDISPLAY_DEPRECATED_MACRO(version, message)        \
  IMP_DEPRECATED_MACRO(version, message)
#endif

/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPDISPLAY_DEPRECATED_VALUE_DEF(version, message) \
  IMP_DEPRECATED_VALUE_RUNTIME_WARNING(version, message)

/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPDISPLAY_DEPRECATED_OBJECT_DEF(version, message) \
  IMP_DEPRECATED_OBJECT_RUNTIME_WARNING(version, message)

/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPDISPLAY_DEPRECATED_FUNCTION_DEF(version, message) \
  IMP_DEPRECATED_FUNCTION_RUNTIME_WARNING(version, message)

/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPDISPLAY_DEPRECATED_METHOD_DEF(version, message) \
  IMP_DEPRECATED_METHOD_RUNTIME_WARNING(version, message)


#include <IMP/base/compiler_macros.h>

#if defined(IMP_EXECUTABLE) && !defined(IMP_EXECUTABLE_WARNINGS)
IMP_COMPILER_ENABLE_WARNINGS
#define IMP_EXECUTABLE_WARNINGS
#endif