Ichthyostega
7a3e4098c8
Relying on random numbers for verification and measurements is known to be problematic. At some point we are bound to control the seed values -- and in the actual application usage we want to record sequence seeding in the event log. Some initial thoughts regarding this intricate topic. * a low-ceremony drop-in replacement for rand() is required * we want the ability to pick-up and control each and every usage eventually * however, some usages explicitly require true randomness * the ability to use separate streams of random-number generation is desirable
108 lines
3.2 KiB
C++
108 lines
3.2 KiB
C++
/*
|
|
OPTION.hpp - handle cmdline for starting the Lumiera application
|
|
|
|
Copyright (C) Lumiera.org
|
|
2008, Hermann Vosseler <Ichthyostega@web.de>
|
|
|
|
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.
|
|
|
|
*/
|
|
|
|
|
|
/** @file option.hpp
|
|
** front-end for handling the commandline arguments.
|
|
** Lumiera uses the [Boost program options library] for commandline parsing
|
|
** and handling of a `setup.ini` file. After checking the commandline arguments
|
|
** syntactically, the internal options representation is passed to the various
|
|
** [Subsystems](\ref subsys.hpp) of the application. This mechanism allows
|
|
** individual subsystems to decide if they want and need to start up at all.
|
|
** Obviously, starting a subsystem also pulls up its prerequisites.
|
|
**
|
|
** The idea behind this structure is to allow operating the application in
|
|
** various _alternative modes,_ like starting "headless" (without UI), script
|
|
** driven or as node in a renderfarm network.
|
|
**
|
|
** [Boost program options library] : http://www.boost.org/doc/libs/1_55_0/doc/html/program_options.html
|
|
**
|
|
** @see basic-setup.hpp
|
|
** @see lumiera::AppState
|
|
** @see lumiera::Config
|
|
**
|
|
*/
|
|
|
|
|
|
#ifndef LUMIERA_OPTION_H
|
|
#define LUMIERA_OPTION_H
|
|
|
|
#include "lib/nocopy.hpp"
|
|
#include "lib/cmdline.hpp"
|
|
#include "lib/format-cout.hpp"
|
|
|
|
#include <string>
|
|
#include <boost/program_options.hpp>
|
|
#include <boost/utility.hpp>
|
|
|
|
|
|
|
|
namespace lumiera {
|
|
|
|
using std::string;
|
|
using std::ostream;
|
|
using lib::VectS;
|
|
|
|
|
|
|
|
/**
|
|
* Frontend for handling the Lumiera application
|
|
* commandline arguments. A preconfigured wrapper
|
|
* around boost::program_options, with the ability
|
|
* to tolerate unknown options. The commandline
|
|
* to be parsed is taken wrapped into a Cmdline
|
|
* instance; after parsing this commandline
|
|
* vector will contain only the remaining
|
|
* unrecognised parts.
|
|
*/
|
|
class Option
|
|
: util::NonCopyable
|
|
{
|
|
public:
|
|
Option (lib::Cmdline& cmdline);
|
|
|
|
const string getSessName();
|
|
const VectS getScripts();
|
|
const VectS getConfigDefs();
|
|
int getPort();
|
|
|
|
bool isOpenSession ();
|
|
bool isConfigDefs();
|
|
bool isHeadless();
|
|
bool isHelp();
|
|
|
|
|
|
private:
|
|
boost::program_options::options_description syntax;
|
|
boost::program_options::variables_map parameters;
|
|
|
|
friend ostream& operator<< (ostream&, const Option&);
|
|
};
|
|
|
|
|
|
/** for outputting the help messages. Forward accumulated
|
|
* help messages from all contained option definitions */
|
|
ostream& operator<< (ostream& os, const Option& to);
|
|
|
|
|
|
} // namespace lumiera
|
|
#endif
|