/* This file is part of Om.  Copyright (C) 2006 Dave Robillard.
 * 
 * Om 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 (at your option) any later
 * version.
 * 
 * Om 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 details.
 * 
 * You should have received a copy of the GNU General Public License along
 * with this program; if not, write to the Free Software Foundation, Inc.,
 * 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 */

#ifndef PORTBASE_H
#define PORTBASE_H

#include <string>
#include "util/types.h"
#include "Array.h"
#include "Port.h"
#include "Buffer.h"

using std::string;

namespace Om {
	
class MidiMessage;
class Node;


/** A port (with a type).
 *
 * This is basically just a buffer and a bunch of flags and helper methods.
 * All the interesting functionality of ports is in InputPort.
 *
 * \ingroup engine
 */
template <typename T>
class PortBase : public Port
{
public:
	virtual ~PortBase();

	void set_value(size_t voice, T val, size_t offset);
	void set_value(T val, size_t offset);
	
	Buffer<T>* buffer(size_t voice) const { return m_buffers.at(voice); }
	
	virtual void prepare_buffers(size_t nframes);
	virtual void clear_buffers();
	
	PortBase* tied_port() const { return m_tied_port; }
	void      untie()           { m_is_tied = false; m_tied_port = NULL; } 

	size_t buffer_size() const { return m_buffer_size; }
	
	/** Used by drivers to prevent port from changing buffers */
	void fixed_buffers(bool b) { m_fixed_buffers = b; }
	bool fixed_buffers()       { return m_fixed_buffers; }

protected:
	PortBase(Node* const node, const string& name, size_t index, size_t poly, PortInfo* port_info, size_t buffer_size);
	
	// Prevent copies (undefined)
	PortBase(const PortBase<T>& copy);
	PortBase& operator=(const Port&);

	void allocate_buffers();

	size_t      m_buffer_size;
	bool        m_fixed_buffers;
	bool        m_is_tied;
	PortBase*   m_tied_port;
	
	Array<Buffer<T>*> m_buffers;
};


template class PortBase<sample>;
template class PortBase<MidiMessage>;

} // namespace Om

#endif // PORTBASE_H