[Home]	[About]
[Screenshots]	[Download]
[News]	[Community]
[Documentation]	[Manual]
[Bugs & Requests]	[Wiki]

/home/tetron/hack/vos/apps/tutorials/vostut1.cc

Go to the documentation of this file.

/* First VOS tutorial.  The simplest possible program that uses VOS.

   This tutorial covers:
   - Creating a site for the application to use
   - Extending a site to communication over the network

   This file (vostut1.cc) is released into the public domain.  No
   restrictions are placed on its use, distribution or inclusion into
   other works.
*/

/* This header brings in all the declarations needed to use the core
   VOS library. */

#include <vos/vos/vos.hh>

// All VOS stuff is located in the VOS namespace
using namespace VUtil;
using namespace VOS;

// Windows has "_sleep" instead of "sleep" so fix that here
#ifdef WIN32
#define sleep _sleep
#endif

int main(int argc, char** argv)
{
    std::cout << "VOS Tutorial 1\n\n";

    /* A "site" is a required part of any VOS application, and is
       usually the first thing you create.  The purpose of the site is
       to store your objects and act as the point of communication
       representing this application to other sites on the network.
    */
    std::cout << "Creating site\n";
    Site localsite;

    /* By adding various extensions to our site we can give it various
       useful capabilities.  One of the most common extensions is the
       socket extension; this provides the site with functionality to
       communicate with other sites, using the "VIP" protocol.
     */
    std::cout << "Adding site extension\n";
    localsite.addSiteExtension(new LocalVipSiteExtension());

    /* VOS is a multithreaded library.  When we extended the site to
       support sockets, background threads were created to handle
       incoming connections and messages.  Thus the main thread is
       free to do whatever it likes.  This ends the first tutorial, so
       we'll just leave it in an idle loop, humming quietly.
     */
    std::cout << "Going into idle loop...\n";
    while(true) sleep(1000);
}