Initialize.h

Go to the documentation of this file.

//============================================================================
//  The contents of this file are covered by the Viskores license. See
//  LICENSE.txt for details.
//
//  By contributing to this file, all contributors agree to the Developer
//  Certificate of Origin Version 1.1 (DCO 1.1) as stated in DCO.txt.
//============================================================================
 
//============================================================================
//  Copyright (c) Kitware, Inc.
//  All rights reserved.
//  See LICENSE.txt for details.
//
//  This software is distributed WITHOUT ANY WARRANTY; without even
//  the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
//  PURPOSE.  See the above copyright notice for more information.
//============================================================================
#ifndef viskores_cont_Initialize_h
#define viskores_cont_Initialize_h
 
#include <viskores/cont/DeviceAdapterTag.h>
#include <viskores/cont/viskores_cont_export.h>
#include <viskores/internal/ExportMacros.h>
 
#include <string>
#include <type_traits>
#include <vector>
 
namespace viskores
{
namespace cont
{
 
struct InitializeResult
{
  DeviceAdapterId Device = DeviceAdapterTagUndefined{};
 
  std::string Usage;
};
 
enum class InitializeOptions
{
  None = 0x00,
 
  RequireDevice = 0x01,
 
  DefaultAnyDevice = 0x02,
 
  AddHelp = 0x04,
 
  ErrorOnBadOption = 0x08,
 
  ErrorOnBadArgument = 0x10,
 
  Strict = ErrorOnBadOption | ErrorOnBadArgument | AddHelp
};
 
// Allow options to be used as a bitfield
inline InitializeOptions operator|(const InitializeOptions& lhs, const InitializeOptions& rhs)
{
  using T = std::underlying_type<InitializeOptions>::type;
  return static_cast<InitializeOptions>(static_cast<T>(lhs) | static_cast<T>(rhs));
}
inline InitializeOptions operator&(const InitializeOptions& lhs, const InitializeOptions& rhs)
{
  using T = std::underlying_type<InitializeOptions>::type;
  return static_cast<InitializeOptions>(static_cast<T>(lhs) & static_cast<T>(rhs));
}
 
VISKORES_CONT_EXPORT
VISKORES_CONT
InitializeResult Initialize(int& argc,
                            char* argv[],
                            InitializeOptions opts = InitializeOptions::None);
VISKORES_CONT_EXPORT
VISKORES_CONT
InitializeResult Initialize();
}
} // end namespace viskores::cont
 
 
#endif // viskores_cont_Initialize_h