Merge with trunk R2978.
[ardour.git] / libs / ardour / ardour / region_factory.h
1 /*
2     Copyright (C) 2000-2007 Paul Davis 
3
4     This program is free software; you can redistribute it and/or modify
5     it under the terms of the GNU General Public License as published by
6     the Free Software Foundation; either version 2 of the License, or
7     (at your option) any later version.
8
9     This program is distributed in the hope that it will be useful,
10     but WITHOUT ANY WARRANTY; without even the implied warranty of
11     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12     GNU General Public License for more details.
13
14     You should have received a copy of the GNU General Public License
15     along with this program; if not, write to the Free Software
16     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
17
18 */
19
20 #ifndef __ardour_region_factory_h__
21 #define __ardour_region_factory_h__
22
23 #include <ardour/types.h>
24 #include <ardour/region.h>
25
26 class XMLNode;
27
28 namespace ARDOUR {
29
30 class Session;
31
32 class RegionFactory {
33
34   public:
35         /** This is emitted only when a new id is assigned. Therefore,
36            in a pure Region copy, it will not be emitted.
37
38            It must be emitted by derived classes, not Region
39            itself, to permit dynamic_cast<> to be used to 
40            infer the type of Region.
41         */
42         static sigc::signal<void,boost::shared_ptr<Region> > CheckNewRegion;
43
44         static boost::shared_ptr<Region> create (boost::shared_ptr<Region>, nframes_t start, 
45                                                  nframes_t length, std::string name, 
46                                                  layer_t = 0, Region::Flag flags = Region::DefaultFlags, bool announce = true);
47         static boost::shared_ptr<Region> create (boost::shared_ptr<AudioRegion>, nframes_t start, 
48                                                  nframes_t length, std::string name, 
49                                                  layer_t = 0, Region::Flag flags = Region::DefaultFlags, bool announce = true);
50         static boost::shared_ptr<Region> create (boost::shared_ptr<Source>, nframes_t start, nframes_t length, const string& name, layer_t = 0, Region::Flag flags = Region::DefaultFlags, bool announce = true);
51         static boost::shared_ptr<Region> create (const SourceList &, nframes_t start, nframes_t length, const string& name, layer_t = 0, Region::Flag flags = Region::DefaultFlags, bool announce = true);
52         static boost::shared_ptr<Region> create (boost::shared_ptr<Region>);
53         static boost::shared_ptr<Region> create (Session&, XMLNode&, bool);
54         static boost::shared_ptr<Region> create (SourceList &, const XMLNode&);
55 };
56
57 }
58
59 #endif /* __ardour_region_factory_h__  */