Public Types | Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
vtkPVServerInformation Class Reference

Gets features of the server. More...

#include <vtkPVServerInformation.h>

Inheritance diagram for vtkPVServerInformation:
Inheritance graph
[legend]
Collaboration diagram for vtkPVServerInformation:
Collaboration graph
[legend]

Public Types

typedef vtkPVInformation Superclass
 
- Public Types inherited from vtkPVInformation
typedef vtkObject Superclass
 

Public Member Functions

virtual const char * GetClassName ()
 
virtual int IsA (const char *type)
 
void PrintSelf (ostream &os, vtkIndent indent) override
 
void DeepCopy (vtkPVServerInformation *info)
 
void CopyFromObject (vtkObject *) override
 Transfer information about a single object into this object. More...
 
void AddInformation (vtkPVInformation *) override
 Merge another information object. More...
 
virtual void SetNVPipeSupport (bool)
 if the server supports compressing images via NVPipe More...
 
virtual bool GetNVPipeSupport ()
 
virtual bool IsMPIInitialized () const
 Return whether MPI is initialized or not. More...
 
virtual void SetRemoteRendering (int)
 This flag indicates whether the server can render remotely. More...
 
virtual int GetRemoteRendering ()
 This flag indicates whether the server can render remotely. More...
 
void CopyToStream (vtkClientServerStream *) override
 Manage a serialized version of the information. More...
 
void CopyFromStream (const vtkClientServerStream *) override
 Manage a serialized version of the information. More...
 
virtual void SetTileDimensions (int, int)
 Variables (command line argurments) set to render to a tiled display. More...
 
void SetTileDimensions (int [2])
 Variables (command line argurments) set to render to a tiled display. More...
 
virtual intGetTileDimensions ()
 Variables (command line argurments) set to render to a tiled display. More...
 
virtual void GetTileDimensions (int &, int &)
 Variables (command line argurments) set to render to a tiled display. More...
 
virtual void GetTileDimensions (int [2])
 Variables (command line argurments) set to render to a tiled display. More...
 
virtual void SetTileMullions (int, int)
 Variables (command line argurments) set to render to a tiled display. More...
 
void SetTileMullions (int [2])
 Variables (command line argurments) set to render to a tiled display. More...
 
virtual intGetTileMullions ()
 Variables (command line argurments) set to render to a tiled display. More...
 
virtual void GetTileMullions (int &, int &)
 Variables (command line argurments) set to render to a tiled display. More...
 
virtual void GetTileMullions (int [2])
 Variables (command line argurments) set to render to a tiled display. More...
 
virtual void SetUseIceT (int)
 Returns 1 if IceT is available. More...
 
virtual int GetUseIceT ()
 Returns 1 if IceT is available. More...
 
virtual void SetTimeout (int)
 Get/Set the time after which the server timesout. More...
 
virtual int GetTimeout ()
 Get/Set the time after which the server timesout. More...
 
void SetEyeSeparation (double value)
 Set/Get the EyeSeparation on server. More...
 
double GetEyeSeparation () const
 Set/Get the EyeSeparation on server. More...
 
void SetNumberOfMachines (unsigned int num)
 Number of machines to use in data or render server Setting the number of machines has the side effect of wiping out any machine parameters previously set. More...
 
unsigned int GetNumberOfMachines () const
 Number of machines to use in data or render server Setting the number of machines has the side effect of wiping out any machine parameters previously set. More...
 
void SetEnvironment (unsigned int idx, const char *name)
 Value of DISPLAY environment variable for this cave node. More...
 
const char * GetEnvironment (unsigned int idx) const
 Value of DISPLAY environment variable for this cave node. More...
 
void SetGeometry (unsigned int idx, int geo[4])
 Window geometry for server, specified as x, y, width, height. More...
 
intGetGeometry (unsigned int idx) const
 Window geometry for server, specified as x, y, width, height. More...
 
void SetFullScreen (unsigned int idx, bool fullscreen)
 Whether to show the server window as fullscreen. More...
 
bool GetFullScreen (unsigned int idx) const
 Whether to show the server window as fullscreen. More...
 
void SetShowBorders (unsigned int idx, bool borders)
 Whether to show the server window with window decorations. More...
 
bool GetShowBorders (unsigned int idx) const
 Whether to show the server window with window decorations. More...
 
int GetStereoType (unsigned int idx) const
 Get the stereo-type specified in the pvx. More...
 
void SetStereoType (unsigned int idx, int type)
 Get the stereo-type specified in the pvx. More...
 
void SetLowerLeft (unsigned int idx, double coord[3])
 Coordinates of lower left corner of this cave display. More...
 
doubleGetLowerLeft (unsigned int idx) const
 Coordinates of lower left corner of this cave display. More...
 
void SetLowerRight (unsigned int idx, double coord[3])
 Coordinates of lower right corner of this cave display. More...
 
doubleGetLowerRight (unsigned int idx) const
 Coordinates of lower right corner of this cave display. More...
 
void SetUpperRight (unsigned int idx, double coord[3])
 Coordinates of lower left corner of this cave display. More...
 
doubleGetUpperRight (unsigned int idx) const
 Coordinates of lower left corner of this cave display. More...
 
virtual int GetNumberOfProcesses ()
 Get the number of processes. More...
 
virtual int GetMultiClientsEnable ()
 Return true if the server allow server client to connect to itself. More...
 
virtual int GetClientId ()
 Get the id that correspond to the current client. More...
 
virtual void SetIdTypeSize (int)
 Set/Get vtkIdType size, which can be 32 or 64. More...
 
virtual int GetIdTypeSize ()
 Set/Get vtkIdType size, which can be 32 or 64. More...
 
- Public Member Functions inherited from vtkPVInformation
virtual void CopyParametersToStream (vtkMultiProcessStream &)
 Serialize/Deserialize the parameters that control how/what information is gathered. More...
 
virtual void CopyParametersFromStream (vtkMultiProcessStream &)
 Serialize/Deserialize the parameters that control how/what information is gathered. More...
 
virtual int GetRootOnly ()
 Set/get whether to gather information only from the root. More...
 
- Public Member Functions inherited from vtkObject
 vtkBaseTypeMacro (vtkObject, vtkObjectBase)
 
virtual void DebugOn ()
 
virtual void DebugOff ()
 
bool GetDebug ()
 
void SetDebug (bool debugFlag)
 
virtual void Modified ()
 
virtual vtkMTimeType GetMTime ()
 
void RemoveObserver (unsigned long tag)
 
void RemoveObservers (unsigned long event)
 
void RemoveObservers (const char *event)
 
void RemoveAllObservers ()
 
int HasObserver (unsigned long event)
 
int HasObserver (const char *event)
 
int InvokeEvent (unsigned long event)
 
int InvokeEvent (const char *event)
 
unsigned long AddObserver (unsigned long event, vtkCommand *, float priority=0.0f)
 
unsigned long AddObserver (const char *event, vtkCommand *, float priority=0.0f)
 
vtkCommandGetCommand (unsigned long tag)
 
void RemoveObserver (vtkCommand *)
 
void RemoveObservers (unsigned long event, vtkCommand *)
 
void RemoveObservers (const char *event, vtkCommand *)
 
int HasObserver (unsigned long event, vtkCommand *)
 
int HasObserver (const char *event, vtkCommand *)
 
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f)
 
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 
unsigned long AddObserver (unsigned long event, U observer, bool(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 
int InvokeEvent (unsigned long event, void *callData)
 
int InvokeEvent (const char *event, void *callData)
 
unsigned long AddObserver (unsigned long event, vtkCommand *, float priority=0.0f)
 
unsigned long AddObserver (const char *event, vtkCommand *, float priority=0.0f)
 
vtkCommandGetCommand (unsigned long tag)
 
void RemoveObserver (vtkCommand *)
 
void RemoveObservers (unsigned long event, vtkCommand *)
 
void RemoveObservers (const char *event, vtkCommand *)
 
int HasObserver (unsigned long event, vtkCommand *)
 
int HasObserver (const char *event, vtkCommand *)
 
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f)
 
unsigned long AddObserver (unsigned long event, U observer, void(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 
unsigned long AddObserver (unsigned long event, U observer, bool(T::*callback)(vtkObject *, unsigned long, void *), float priority=0.0f)
 
int InvokeEvent (unsigned long event, void *callData)
 
int InvokeEvent (const char *event, void *callData)
 
- Public Member Functions inherited from vtkObjectBase
const char * GetClassName () const
 
virtual void Delete ()
 
virtual void FastDelete ()
 
void Print (ostream &os)
 
virtual void Register (vtkObjectBase *o)
 
virtual void UnRegister (vtkObjectBase *o)
 
void SetReferenceCount (int)
 
virtual void PrintHeader (ostream &os, vtkIndent indent)
 
virtual void PrintTrailer (ostream &os, vtkIndent indent)
 
int GetReferenceCount ()
 
void PrintRevisions (ostream &)
 
virtual void PrintHeader (ostream &os, vtkIndent indent)
 
virtual void PrintTrailer (ostream &os, vtkIndent indent)
 
int GetReferenceCount ()
 
void PrintRevisions (ostream &)
 

Static Public Member Functions

static vtkPVServerInformationNew ()
 
static int IsTypeOf (const char *type)
 
static vtkPVServerInformationSafeDownCast (vtkObject *o)
 
- Static Public Member Functions inherited from vtkPVInformation
static int IsTypeOf (const char *type)
 
static vtkPVInformationSafeDownCast (vtkObject *o)
 
- Static Public Member Functions inherited from vtkObject
static vtkObjectNew ()
 
static void BreakOnError ()
 
static void SetGlobalWarningDisplay (int val)
 
static void GlobalWarningDisplayOn ()
 
static void GlobalWarningDisplayOff ()
 
static int GetGlobalWarningDisplay ()
 
static void SetGlobalWarningDisplay (int val)
 
static void GlobalWarningDisplayOn ()
 
static void GlobalWarningDisplayOff ()
 
static int GetGlobalWarningDisplay ()
 
- Static Public Member Functions inherited from vtkObjectBase
static vtkTypeBool IsTypeOf (const char *name)
 
static vtkObjectBaseNew ()
 
static vtkObjectBaseNew ()
 

Protected Member Functions

 vtkPVServerInformation ()
 
 ~vtkPVServerInformation () override
 
 vtkPVServerInformation (const vtkPVServerInformation &)=delete
 
void operator= (const vtkPVServerInformation &)=delete
 
- Protected Member Functions inherited from vtkPVInformation
 vtkPVInformation ()
 
 ~vtkPVInformation () override
 
virtual void SetRootOnly (int)
 
 vtkPVInformation (const vtkPVInformation &)=delete
 
void operator= (const vtkPVInformation &)=delete
 
- Protected Member Functions inherited from vtkObject
 vtkObject ()
 
virtual ~vtkObject ()
 
void RegisterInternal (vtkObjectBase *, vtkTypeBool check) VTK_OVERRIDE
 
void UnRegisterInternal (vtkObjectBase *, vtkTypeBool check) VTK_OVERRIDE
 
void InternalGrabFocus (vtkCommand *mouseEvents, vtkCommand *keypressEvents=NULL)
 
void InternalReleaseFocus ()
 
void InternalGrabFocus (vtkCommand *mouseEvents, vtkCommand *keypressEvents=NULL)
 
void InternalReleaseFocus ()
 
- Protected Member Functions inherited from vtkObjectBase
 vtkObjectBase ()
 
virtual ~vtkObjectBase ()
 
virtual void CollectRevisions (ostream &)
 
virtual void ReportReferences (vtkGarbageCollector *)
 
 vtkObjectBase (const vtkObjectBase &)
 
void operator= (const vtkObjectBase &)
 

Protected Attributes

int NumberOfProcesses
 
bool MPIInitialized
 
int OGVSupport
 
int AVISupport
 
bool NVPipeSupport
 
int RemoteRendering
 
int TileDimensions [2]
 
int TileMullions [2]
 
int Timeout
 
int UseIceT
 
int MultiClientsEnable
 
int ClientId
 
int IdTypeSize
 
vtkPVServerOptionsInternalsMachinesInternals
 
- Protected Attributes inherited from vtkPVInformation
int RootOnly
 
- Protected Attributes inherited from vtkObject
bool Debug
 
vtkTimeStamp MTime
 
vtkSubjectHelper * SubjectHelper
 
- Protected Attributes inherited from vtkObjectBase
vtkAtomicInt32 ReferenceCount
 
vtkWeakPointerBase ** WeakPointers
 

Detailed Description

Gets features of the server.

This objects is used by the client to get the features supported by the server. At the moment, server information is only on the root.

Definition at line 33 of file vtkPVServerInformation.h.

Member Typedef Documentation

◆ Superclass

Definition at line 37 of file vtkPVServerInformation.h.

Constructor & Destructor Documentation

◆ vtkPVServerInformation() [1/2]

vtkPVServerInformation::vtkPVServerInformation ( )
protected

◆ ~vtkPVServerInformation()

vtkPVServerInformation::~vtkPVServerInformation ( )
overrideprotected

◆ vtkPVServerInformation() [2/2]

vtkPVServerInformation::vtkPVServerInformation ( const vtkPVServerInformation )
protecteddelete

Member Function Documentation

◆ New()

static vtkPVServerInformation* vtkPVServerInformation::New ( )
static

◆ GetClassName()

virtual const char* vtkPVServerInformation::GetClassName ( )
virtual

Reimplemented from vtkPVInformation.

◆ IsTypeOf()

static int vtkPVServerInformation::IsTypeOf ( const char *  type)
static

◆ IsA()

virtual int vtkPVServerInformation::IsA ( const char *  type)
virtual

Reimplemented from vtkPVInformation.

◆ SafeDownCast()

static vtkPVServerInformation* vtkPVServerInformation::SafeDownCast ( vtkObject o)
static

◆ PrintSelf()

void vtkPVServerInformation::PrintSelf ( ostream &  os,
vtkIndent  indent 
)
overridevirtual

Reimplemented from vtkPVInformation.

◆ SetRemoteRendering()

virtual void vtkPVServerInformation::SetRemoteRendering ( int  )
virtual

This flag indicates whether the server can render remotely.

If it is off, all rendering has to be on the client. This is only off when the user starts the server with the –disable-composite command line option.

◆ GetRemoteRendering()

virtual int vtkPVServerInformation::GetRemoteRendering ( )
virtual

This flag indicates whether the server can render remotely.

If it is off, all rendering has to be on the client. This is only off when the user starts the server with the –disable-composite command line option.

◆ DeepCopy()

void vtkPVServerInformation::DeepCopy ( vtkPVServerInformation info)

◆ CopyFromObject()

void vtkPVServerInformation::CopyFromObject ( vtkObject )
overridevirtual

Transfer information about a single object into this object.

Reimplemented from vtkPVInformation.

◆ AddInformation()

void vtkPVServerInformation::AddInformation ( vtkPVInformation )
overridevirtual

Merge another information object.

Reimplemented from vtkPVInformation.

◆ CopyToStream()

void vtkPVServerInformation::CopyToStream ( vtkClientServerStream )
overridevirtual

Manage a serialized version of the information.

Implements vtkPVInformation.

◆ CopyFromStream()

void vtkPVServerInformation::CopyFromStream ( const vtkClientServerStream )
overridevirtual

Manage a serialized version of the information.

Reimplemented from vtkPVInformation.

◆ SetTileDimensions() [1/2]

virtual void vtkPVServerInformation::SetTileDimensions ( int  ,
int   
)
virtual

Variables (command line argurments) set to render to a tiled display.

◆ SetTileDimensions() [2/2]

void vtkPVServerInformation::SetTileDimensions ( int  [2])

Variables (command line argurments) set to render to a tiled display.

◆ GetTileDimensions() [1/3]

virtual int* vtkPVServerInformation::GetTileDimensions ( )
virtual

Variables (command line argurments) set to render to a tiled display.

◆ GetTileDimensions() [2/3]

virtual void vtkPVServerInformation::GetTileDimensions ( int ,
int  
)
virtual

Variables (command line argurments) set to render to a tiled display.

◆ GetTileDimensions() [3/3]

virtual void vtkPVServerInformation::GetTileDimensions ( int  [2])
virtual

Variables (command line argurments) set to render to a tiled display.

◆ SetTileMullions() [1/2]

virtual void vtkPVServerInformation::SetTileMullions ( int  ,
int   
)
virtual

Variables (command line argurments) set to render to a tiled display.

◆ SetTileMullions() [2/2]

void vtkPVServerInformation::SetTileMullions ( int  [2])

Variables (command line argurments) set to render to a tiled display.

◆ GetTileMullions() [1/3]

virtual int* vtkPVServerInformation::GetTileMullions ( )
virtual

Variables (command line argurments) set to render to a tiled display.

◆ GetTileMullions() [2/3]

virtual void vtkPVServerInformation::GetTileMullions ( int ,
int  
)
virtual

Variables (command line argurments) set to render to a tiled display.

◆ GetTileMullions() [3/3]

virtual void vtkPVServerInformation::GetTileMullions ( int  [2])
virtual

Variables (command line argurments) set to render to a tiled display.

◆ SetUseIceT()

virtual void vtkPVServerInformation::SetUseIceT ( int  )
virtual

Returns 1 if IceT is available.

◆ GetUseIceT()

virtual int vtkPVServerInformation::GetUseIceT ( )
virtual

Returns 1 if IceT is available.

◆ SetNVPipeSupport()

virtual void vtkPVServerInformation::SetNVPipeSupport ( bool  )
virtual

if the server supports compressing images via NVPipe

◆ GetNVPipeSupport()

virtual bool vtkPVServerInformation::GetNVPipeSupport ( )
virtual

◆ SetTimeout()

virtual void vtkPVServerInformation::SetTimeout ( int  )
virtual

Get/Set the time after which the server timesout.

◆ GetTimeout()

virtual int vtkPVServerInformation::GetTimeout ( )
virtual

Get/Set the time after which the server timesout.

◆ SetEyeSeparation()

void vtkPVServerInformation::SetEyeSeparation ( double  value)

Set/Get the EyeSeparation on server.

◆ GetEyeSeparation()

double vtkPVServerInformation::GetEyeSeparation ( ) const

Set/Get the EyeSeparation on server.

◆ SetNumberOfMachines()

void vtkPVServerInformation::SetNumberOfMachines ( unsigned int  num)

Number of machines to use in data or render server Setting the number of machines has the side effect of wiping out any machine parameters previously set.

◆ GetNumberOfMachines()

unsigned int vtkPVServerInformation::GetNumberOfMachines ( ) const

Number of machines to use in data or render server Setting the number of machines has the side effect of wiping out any machine parameters previously set.

◆ SetEnvironment()

void vtkPVServerInformation::SetEnvironment ( unsigned int  idx,
const char *  name 
)

Value of DISPLAY environment variable for this cave node.

◆ GetEnvironment()

const char* vtkPVServerInformation::GetEnvironment ( unsigned int  idx) const

Value of DISPLAY environment variable for this cave node.

◆ SetGeometry()

void vtkPVServerInformation::SetGeometry ( unsigned int  idx,
int  geo[4] 
)

Window geometry for server, specified as x, y, width, height.

This is only used if FullScreen is false.

◆ GetGeometry()

int* vtkPVServerInformation::GetGeometry ( unsigned int  idx) const

Window geometry for server, specified as x, y, width, height.

This is only used if FullScreen is false.

◆ SetFullScreen()

void vtkPVServerInformation::SetFullScreen ( unsigned int  idx,
bool  fullscreen 
)

Whether to show the server window as fullscreen.

◆ GetFullScreen()

bool vtkPVServerInformation::GetFullScreen ( unsigned int  idx) const

Whether to show the server window as fullscreen.

◆ SetShowBorders()

void vtkPVServerInformation::SetShowBorders ( unsigned int  idx,
bool  borders 
)

Whether to show the server window with window decorations.

◆ GetShowBorders()

bool vtkPVServerInformation::GetShowBorders ( unsigned int  idx) const

Whether to show the server window with window decorations.

◆ GetStereoType()

int vtkPVServerInformation::GetStereoType ( unsigned int  idx) const

Get the stereo-type specified in the pvx.

-1=no-specified, 0=no-stereo.

◆ SetStereoType()

void vtkPVServerInformation::SetStereoType ( unsigned int  idx,
int  type 
)

Get the stereo-type specified in the pvx.

-1=no-specified, 0=no-stereo.

◆ SetLowerLeft()

void vtkPVServerInformation::SetLowerLeft ( unsigned int  idx,
double  coord[3] 
)

Coordinates of lower left corner of this cave display.

◆ GetLowerLeft()

double* vtkPVServerInformation::GetLowerLeft ( unsigned int  idx) const

Coordinates of lower left corner of this cave display.

◆ SetLowerRight()

void vtkPVServerInformation::SetLowerRight ( unsigned int  idx,
double  coord[3] 
)

Coordinates of lower right corner of this cave display.

◆ GetLowerRight()

double* vtkPVServerInformation::GetLowerRight ( unsigned int  idx) const

Coordinates of lower right corner of this cave display.

◆ SetUpperRight()

void vtkPVServerInformation::SetUpperRight ( unsigned int  idx,
double  coord[3] 
)

Coordinates of lower left corner of this cave display.

◆ GetUpperRight()

double* vtkPVServerInformation::GetUpperRight ( unsigned int  idx) const

Coordinates of lower left corner of this cave display.

◆ GetNumberOfProcesses()

virtual int vtkPVServerInformation::GetNumberOfProcesses ( )
virtual

Get the number of processes.

◆ IsMPIInitialized()

virtual bool vtkPVServerInformation::IsMPIInitialized ( ) const
virtual

Return whether MPI is initialized or not.

◆ GetMultiClientsEnable()

virtual int vtkPVServerInformation::GetMultiClientsEnable ( )
virtual

Return true if the server allow server client to connect to itself.

◆ GetClientId()

virtual int vtkPVServerInformation::GetClientId ( )
virtual

Get the id that correspond to the current client.

◆ SetIdTypeSize()

virtual void vtkPVServerInformation::SetIdTypeSize ( int  )
virtual

Set/Get vtkIdType size, which can be 32 or 64.

◆ GetIdTypeSize()

virtual int vtkPVServerInformation::GetIdTypeSize ( )
virtual

Set/Get vtkIdType size, which can be 32 or 64.

◆ operator=()

void vtkPVServerInformation::operator= ( const vtkPVServerInformation )
protecteddelete

Member Data Documentation

◆ NumberOfProcesses

int vtkPVServerInformation::NumberOfProcesses
protected

Definition at line 226 of file vtkPVServerInformation.h.

◆ MPIInitialized

bool vtkPVServerInformation::MPIInitialized
protected

Definition at line 227 of file vtkPVServerInformation.h.

◆ OGVSupport

int vtkPVServerInformation::OGVSupport
protected

Definition at line 228 of file vtkPVServerInformation.h.

◆ AVISupport

int vtkPVServerInformation::AVISupport
protected

Definition at line 229 of file vtkPVServerInformation.h.

◆ NVPipeSupport

bool vtkPVServerInformation::NVPipeSupport
protected

Definition at line 230 of file vtkPVServerInformation.h.

◆ RemoteRendering

int vtkPVServerInformation::RemoteRendering
protected

Definition at line 231 of file vtkPVServerInformation.h.

◆ TileDimensions

int vtkPVServerInformation::TileDimensions[2]
protected

Definition at line 232 of file vtkPVServerInformation.h.

◆ TileMullions

int vtkPVServerInformation::TileMullions[2]
protected

Definition at line 233 of file vtkPVServerInformation.h.

◆ Timeout

int vtkPVServerInformation::Timeout
protected

Definition at line 234 of file vtkPVServerInformation.h.

◆ UseIceT

int vtkPVServerInformation::UseIceT
protected

Definition at line 235 of file vtkPVServerInformation.h.

◆ MultiClientsEnable

int vtkPVServerInformation::MultiClientsEnable
protected

Definition at line 236 of file vtkPVServerInformation.h.

◆ ClientId

int vtkPVServerInformation::ClientId
protected

Definition at line 237 of file vtkPVServerInformation.h.

◆ IdTypeSize

int vtkPVServerInformation::IdTypeSize
protected

Definition at line 238 of file vtkPVServerInformation.h.

◆ MachinesInternals

vtkPVServerOptionsInternals* vtkPVServerInformation::MachinesInternals
protected

Definition at line 240 of file vtkPVServerInformation.h.


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