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<const Region>);
  45
  46         /* note: both of the first two should use const shared_ptr as well, but
  47            gcc 4.1 doesn't seem to be able to disambiguate them if they do.
  48         */
  49
  50         static boost::shared_ptr<Region> create (boost::shared_ptr<Region>, nframes_t start,
  51                                                  nframes_t length, const std::string& name,
  52                                                  layer_t = 0, Region::Flag flags = Region::DefaultFlags, bool announce = true);
  53         static boost::shared_ptr<Region> create (boost::shared_ptr<AudioRegion>, nframes_t start,
  54                                                  nframes_t length, const std::string& name,
  55                                                  layer_t = 0, Region::Flag flags = Region::DefaultFlags, bool announce = true);
  56         static boost::shared_ptr<Region> create (boost::shared_ptr<Region>, const SourceList&, const string& name, layer_t = 0, Region::Flag flags = Region::DefaultFlags, bool announce = true);
  57         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);
  58         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);
  59         static boost::shared_ptr<Region> create (Session&, XMLNode&, bool);
  60         static boost::shared_ptr<Region> create (SourceList &, const XMLNode&);
  61 };
  62
  63 }
  64
  65 #endif /* __ardour_region_factory_h__  */