---

spkrnote.cpp

Go to the documentation of this file.

// $Id

//**********************************************************************
//                                                                     *
//    Description:   Implementation using PC speaker to produce sound  *
//                   for a single note.                                *
//                                                                     *
//    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 <dos.h>

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

#include "spkrnote.h"



using namespace Monitor::Utility;



int    SpeakerNote::busy = 0;


SpeakerNote::SpeakerNote(Frequency    newFrequency, Length    newLength)
    : frequency(newFrequency), length(newLength)
{
    _USEMYTRACE_("SpeakerNote::SpeakerNote(newFrequency, newLength)")
}



SpeakerNote::~SpeakerNote()
{
    _USEMYTRACE_("SpeakerNote::~SpeakerNote()")
}



void
SpeakerNote::sound() const
throw (Note::Busy)
{
    _USEMYTRACE_("SpeakerNote::sound()")

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

        // Turn speaker on at given frequency
        ::sound(frequency);

        // Time length of ring
        new Timeout(ConstCallback< SpeakerNote >(*this,
                                                 &SpeakerNote::endSound),
                    length,
                    "note length");
    }
}



void
SpeakerNote::endSound() const
{
    _USEMYTRACE_("SpeakerNote::endSound()")

    // Turn speaker off
    ::nosound();

    busy = 0;
}



SpeakerNote::Frequency
SpeakerNote::getFrequency() const
{
    _USEMYTRACE_("SpeakerNote::getFrequency()")

    return    frequency;
}



void
SpeakerNote::setFrequency(Frequency    newFrequency)
{
    _USEMYTRACE_("SpeakerNote::setFrequency(newFrequency)")

    frequency = newFrequency;
}



SpeakerNote::Length
SpeakerNote::getLength() const
{
    _USEMYTRACE_("SpeakerNote::getLength()")

    return length;
}



void
SpeakerNote::setLength(Length    newLength)
{
    _USEMYTRACE_("SpeakerNote::setLength(newLength)")

    length = newLength;
}

---