RemoteViz::Rendering::ServiceSettings Class Reference
[RemoteViz]

#include <RemoteViz/Rendering/ServiceSettings.h>

Public Member Functions
	ServiceSettings ()
	ServiceSettings (const ServiceSettings &obj)
ServiceSettings &	operator= (const ServiceSettings &obj)
virtual	~ServiceSettings ()
const std::string &	getPublicCertificateFile () const
const std::string &	getPrivateKeyFile () const

enum	RunMode { INVENTOR_SERVICE, INVENTOR_APPLICATION, INDEPENDENT_SERVICE }
enum	Extensions { VOLUMEVIZ = 0x1, VOLUMEVIZLDM = 0x2, MESHVIZ = 0x4, MESHVIZXLM = 0x8, IMAGEVIZ = 0x10, HARDCOPY = 0x20, CATIA5READER = 0x40, CATIA6READER = 0x80, DWGREADER = 0x100, IGESREADER = 0x200, JTREADER = 0x400, PROEREADER = 0x800, SOLIDEDGEREADER = 0x1000, STEPREADER = 0x2000, SOLIDWORKSREADER = 0x4000, UGREADER = 0x8000, VDAREADER = 0x10000, XMTREADER = 0x20000 }
enum	SecurityProtocols { SSLv2 = 0x1, SSLv3 = 0x2, TLSv1 = 0x4, TLSv1_1 = 0x8, TLSv1_2 = 0x10 }
void	setIP (const std::string &ip)
const std::string &	getIP () const
void	setPort (unsigned short port)
unsigned short	getPort () const
void	setRunMode (ServiceSettings::RunMode runmode)
ServiceSettings::RunMode	getRunMode () const
std::string	getHostname () const
void	setUsedExtensions (unsigned int extensions)
unsigned int	getUsedExtensions () const
void	enableSecureConnection (const std::string &publicCertificateFilePath, const std::string &privateKeyFilePath, unsigned int enabledSecurityProtocols=TLSv1\|TLSv1_1\|TLSv1_2)
bool	isSecureConnection () const
unsigned int	getEnabledSecurityProtocols () const

Detailed Description

Settings that define the rendering Service.

Member Enumeration Documentation

enum RemoteViz::Rendering::ServiceSettings::Extensions

Each enumeration represents an Open Inventor extension.

Use setUsedExtensions to activate them.

Enumerator:

VOLUMEVIZ
VOLUMEVIZLDM
MESHVIZ
MESHVIZXLM
IMAGEVIZ
HARDCOPY
CATIA5READER
CATIA6READER
DWGREADER
IGESREADER
JTREADER
PROEREADER
SOLIDEDGEREADER
STEPREADER
SOLIDWORKSREADER
UGREADER
VDAREADER
XMTREADER

enum RemoteViz::Rendering::ServiceSettings::RunMode

The run mode is used to change the behaviour of the RemoteViz execution in three environments.

INVENTOR_SERVICE mode is used to run a RemoteViz application based on the Open Inventor render engine. This is the default mode. This mode requires a main loop.
INVENTOR_APPLICATION is used to share the rendering of a scene graph between an OIV application and a RemoteViz application. This mode uses the main loop of an Open Inventor component (SoWinExaminerViewer, SoXtRenderArea, ...).
INDEPENDENT_SERVICE mode is used to run a RemoteViz application based on its own render engine. In this mode, the Open Inventor render engine is disabled. This mode requires a main loop.

Enumerator:

INVENTOR_SERVICE
INVENTOR_APPLICATION
INDEPENDENT_SERVICE

enum RemoteViz::Rendering::ServiceSettings::SecurityProtocols

Each enumeration represents a security protocol.

Use enableSecureConnection to enable them.

Enumerator:

SSLv2
SSLv3
TLSv1
TLSv1_1
TLSv1_2

Constructor & Destructor Documentation

RemoteViz::Rendering::ServiceSettings::ServiceSettings ( )

Constructor.

RemoteViz::Rendering::ServiceSettings::ServiceSettings ( const ServiceSettings & obj )

Copy constructor.

virtual RemoteViz::Rendering::ServiceSettings::~ServiceSettings ( ) [virtual]

Destructor.

Member Function Documentation

void RemoteViz::Rendering::ServiceSettings::enableSecureConnection	(	const std::string &	publicCertificateFilePath,
		const std::string &	privateKeyFilePath,
		unsigned int	enabledSecurityProtocols = `TLSv1\|TLSv1_1\|TLSv1_2`
	)

Secures the connection between the server and the clients.

Parameters:

	publicCertificateFilePath	: Path to a file containing the public certificate used to authenticate the server to the clients. The certificate has to be a PEM ("Privacy Enhanced Mail") encoded certificate.
	privateKeyFilePath	: Path to a file containing the private key used to sign the server key exchange between the client and the server. If the private key is protected by a passphrase, set the passphrase into the ServiceListener::onRequestedPrivateKeyPassphrase callback.
	enabledSecurityProtocols	: Defines the security protocols used to secure the exchange between the client and the server. By default, the TLSv1, TLSv1.1 and TLSv1.2 protocols are enabled. A bitmask of the security protocols is used. Many security protocols can be enabled by using the logical OR operator.

unsigned int RemoteViz::Rendering::ServiceSettings::getEnabledSecurityProtocols ( ) const

Gets the security procotols used in RemoteViz.

Returns:: the bitmask of used security protocols.

std::string RemoteViz::Rendering::ServiceSettings::getHostname ( ) const

Gets the current host name.

Returns:: the current host name

const std::string& RemoteViz::Rendering::ServiceSettings::getIP ( ) const

Gets the IP address.

Default value is "auto".

Returns:: the IP address used by the instance

unsigned short RemoteViz::Rendering::ServiceSettings::getPort ( ) const

Gets the port of the service.

Default value is 8080.

Returns:: the port used by the instance

const std::string& RemoteViz::Rendering::ServiceSettings::getPrivateKeyFile ( ) const

Gets the private key used to sign the server key exchange between the client and the server.

Returns:: the path to the file containing the private key.

const std::string& RemoteViz::Rendering::ServiceSettings::getPublicCertificateFile ( ) const

Gets the public certificate authenticating the server to the clients.

Returns:: the path to the file containing the certificate.

ServiceSettings::RunMode RemoteViz::Rendering::ServiceSettings::getRunMode ( ) const

Gets the run mode of the service.

Default value is INVENTOR_SERVICE.

Returns:: the run mode used by the instance

unsigned int RemoteViz::Rendering::ServiceSettings::getUsedExtensions ( ) const

Gets the used Open Inventor extensions.

Returns:: the bitmask of used Open Inventor extensions.

bool RemoteViz::Rendering::ServiceSettings::isSecureConnection ( ) const

Gets the SSL engine activation.

Returns:: true if the secure connection is enabled.

ServiceSettings& RemoteViz::Rendering::ServiceSettings::operator= ( const ServiceSettings & obj )

Copy assignment operator.

void RemoteViz::Rendering::ServiceSettings::setIP ( const std::string & ip )

Sets the IP address.

IP version 4 (IPv4: X.X.X.X) and IP version 6 (IPv6: X::X::X::X::X::X::X::X) are supported. Default value is "auto"
If you set the value to "auto", an IPv4 address will be automatically selected among the available interfaces.

Parameters:

ip

: the IP address used by the instance

void RemoteViz::Rendering::ServiceSettings::setPort ( unsigned short port )

Sets the port of the service.

Default value is 8080.
In case you are behind a firewall, please ensure your IT department configured the firewall to accommodate the selected port.

Parameters:

port

: the port used by the instance

void RemoteViz::Rendering::ServiceSettings::setRunMode ( ServiceSettings::RunMode runmode )

Sets the run mode of the service.

Default value is INVENTOR_SERVICE.

Parameters:

runmode

: the type of run mode used by the instance

void RemoteViz::Rendering::ServiceSettings::setUsedExtensions ( unsigned int extensions )

Sets the Open Inventor extensions used in RemoteViz.

In addition to one Open Inventor and one RemoteViz license, a license of each used extension will be required to start the service and will be checked out for each connected client.
The activation of VolumeVizLDM extension will lead to the activation of VolumeViz extension.

In C++, this method also calls the init() methods for Open Inventor and all specified extensions (e.g. SoDB::init()). The corresponding finish() methods will be automatically called when the Service is stopped. Alternatively, the application can explicitly call init methods before creating any Open Inventor nodes. In that case, the application should also call the corresponding finish() methods when the Service is stopped.

Parameters:

extensions

: the bitmask of the Open Inventor extensions used in RemoteViz. Many extensions can be activated by using the logical OR operator.
For example : setUsedExtensions(VOLUMEVIZ | MESHVIZ)

The documentation for this class was generated from the following file:

RemoteViz/Rendering/ServiceSettings.h

RemoteViz::Rendering::ServiceSettings Class Reference [RemoteViz]

Public Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

RemoteViz::Rendering::ServiceSettings Class Reference
[RemoteViz]