---

pcbell.cpp

Go to the documentation of this file.

// $Id

//**********************************************************************
//                                                                     *
//    Description:   'Bell Master' implementation of block instrument  *
//                   bell using PC (hardware to produce actual ring    *
//                   abstracted by 'Note' class).                      *
//                                                                     *
//    Author:        Chris White (whitecf@bcs.org.uk)                  *
//                                                                     *
//    Copyright (C) 2003  Monitor Computing Services Ltd.              *
//                                                                     *
//    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 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 (http://www.gnu.org/copyleft/gpl.html) along with this   *
//    program; if not, write to:                                       *
//       The Free Software Foundation Inc.,                            *
//       59 Temple Place - Suite 330,                                  *
//       Boston, MA  02111-1307,                                       *
//       USA.                                                          *
//                                                                     *
//**********************************************************************
//                                                                     *
//    Notes:                                                           *
//                                                                     *
//**********************************************************************


#include <callback.h>
#include "mytrace.h"
#include <note.h>
#include "timeout.h"

#include "pcbell.h"



using namespace Monitor::BellMaster;
namespace Ut = Monitor::Utility;



PcBell::PcBell(Ut::Note&    newNote) :
    currentSequence(0), note(newNote)
{
    _USEMYTRACE_("PcBell::PcBell(newNote)")
}



PcBell::~PcBell()
{
    _USEMYTRACE_("PcBell::~PcBell()")


    // Deletion shouldn't happen during ringing of a sequence but just in case
    // ensure things are tidied up.
    delete [] currentSequence, currentSequence = 0;
}



void
PcBell::ring() const
throw (Bell::Busy)
{
    _USEMYTRACE_("PcBell::ring()")


    try
    {
        note.sound();

        Bell::ring();
    }
    catch (Ut::Note::Busy&    ex)
    {
        throw Busy();
    }
}



void
PcBell::ring(unsigned*    newSequence)
throw (Bell::Busy)
{
    _USEMYTRACE_("Bell::ring(newSequence)")


    if (0 != currentSequence)
    {
        throw Busy();
    }
    else
    {
        currentSequence = newSequence;

        nextRing();
    }
}



Ut::Note&
PcBell::getNote() const
{
    _USEMYTRACE_("Bell::getNote()")


    return note;
}



void
PcBell::nextRing()
{
    _USEMYTRACE_("PcBell::nextRing")


    if (0 != currentSequence)
    {
        ring();

        if (0 < *currentSequence)
        {
            // Pause between rings
            new Ut::Timeout(Ut::Callback< PcBell >(*this, &PcBell::nextRing),
                            *currentSequence,
                            "next ring");

            ++currentSequence;
        }
        else
        {
            delete [] currentSequence, currentSequence = 0;
        }
    }
}

---