Fetching latest commit…
Cannot retrieve the latest commit at this time
|Failed to load latest commit information.|
Quickstart This directory is the top-level directory for the Equalizer sources. Executing 'make' should build all targets, if the platform is supported. See also the FAQ in this directory. End-User and developer documentation can be found on the Equalizer website at http://www.equalizergraphics.com/ Running Equalizer The main example is eqPly, a scalable rendering program for polygonal data. Furthermore, there is eqHello, a very simple Equalizer program, and eVolve, a scalable volume renderer. To run examples, first setup your library search path (LD_LIBRARY_PATH) to point to build/<os>/lib. Then start a server: 'build/<os>/bin/eqServer'. Once the server is running, start the example: 'build/<os>/bin/eqPly'. The default launch mechanism for nodes uses ssh. If your configuration contains remote nodes, make sure a passwordless login using ssh is possible, or reconfigure the launch command accordingly. Directory Layout make/ files for the build environment. externals/ third-party source code used by Equalizer lib/ the sources of the client library, i.e., libeq lib/base/ basic source code: utilities, OS abstraction, etc. lib/net/ the sources for the networking P2P layer lib/client/ the client-side implementation of Equalizer server/ the server source code examples/ Equalizer example programs tests/ small programs testing certain functionality (to-be-unit-tests) tools/ miscellanous tools Build Environment The build environment is using GNU make. Furthermore, flex, bison and libuuid are needed during compilation. The directory make/ contains the following files: system.mk: Generic Makefile included first by each Makefile. Sets common variables, e.g., $(TOP) to find the make/ directory. This file includes `uname`.mk early on. `uname`.mk: The system-specific Makefile, e.g., Linux.mk. This file customizes system-specific settings. rules.mk: The build rules to be used by the Makefiles. Typically included at the end of each Makefile. local.mk: Optional, non-versioned file containing local machine build settings The build environment uses the following targets and variables: TARGETS Variable to be set by the Makefile to define the targets. The following targets are defined: subdirs Traverses into all SUBDIRS $(HEADERS) All header file targets derived from HEADER_SRC $(DYNAMIC_LIB) A dynamic library for all VARIANTS build from all sources. $(STATIC_LIB) A static library for all VARIANTS build from all sources. $(PROGRAMS) Executables for PROGRAM on all VARIANTS. install Copies all include files and libraries from BUILD_DIR to INSTALL_DIR BUILD_FAT If defined, fat (universal) libraries and binaries are build. Currently only supported on Darwin. SUBDIRS Variable listing all sub directories to traverse into when executing rule subdirs VARIANTS All variants to build on a specific ARCHitecture. Defaults to SUBARCH VARIANT The variant from VARIANTS currently in build. ARCH The current architecture, i.e., `uname` SUBARCH The current sub-architecure, i.e., `uname -m` CXXFILES The source files for a library or executable HEADER_SRC The source header files, i.e. headers to be packaged and installed. PROGRAM The name of the stand-alone executable to be build.