/* Copyright (C) 2010 Paul Davis 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 (at your option) 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 along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ #ifdef WAF_BUILD #include "gtk2ardour-config.h" #include "gtk2ardour-version.h" #endif #include #include #include #include #include "pbd/failed_constructor.h" #include "pbd/file_utils.h" #include "pbd/replace_all.h" #include "pbd/whitespace.h" #include "pbd/stacktrace.h" #include "pbd/openuri.h" #include "ardour/audioengine.h" #include "ardour/filesystem_paths.h" #include "ardour/recent_sessions.h" #include "ardour/session.h" #include "ardour/session_state_utils.h" #include "ardour/template_utils.h" #include "ardour/filename_extensions.h" #include "ardour_ui.h" #include "startup.h" #include "opts.h" #include "engine_dialog.h" #include "i18n.h" #include "utils.h" using namespace std; using namespace Gtk; using namespace Gdk; using namespace Glib; using namespace PBD; using namespace ARDOUR; using namespace ARDOUR_UI_UTILS; ArdourStartup* ArdourStartup::the_startup = 0; static string poor_mans_glob (string path) { string copy = path; replace_all (copy, "~", Glib::get_home_dir()); return copy; } ArdourStartup::ArdourStartup () : _response (RESPONSE_OK) , config_modified (false) , default_dir_chooser (0) , monitor_via_hardware_button (string_compose (_("Use an external mixer or the hardware mixer of your audio interface.\n" "%1 will play NO role in monitoring"), PROGRAM_NAME)) , monitor_via_ardour_button (string_compose (_("Ask %1 to play back material as it is being recorded"), PROGRAM_NAME)) , audio_page_index (-1) , new_user_page_index (-1) , default_folder_page_index (-1) , monitoring_page_index (-1) , final_page_index (-1) { set_keep_above (true); set_position (WIN_POS_CENTER); set_border_width (12); if ((icon_pixbuf = ::get_icon ("ardour_icon_48px")) == 0) { throw failed_constructor(); } list > window_icons; Glib::RefPtr icon; if ((icon = ::get_icon ("ardour_icon_16px")) != 0) { window_icons.push_back (icon); } if ((icon = ::get_icon ("ardour_icon_22px")) != 0) { window_icons.push_back (icon); } if ((icon = ::get_icon ("ardour_icon_32px")) != 0) { window_icons.push_back (icon); } if ((icon = ::get_icon ("ardour_icon_48px")) != 0) { window_icons.push_back (icon); } if (!window_icons.empty ()) { set_default_icon_list (window_icons); } #ifdef __APPLE__ setup_prerelease_page (); #endif setup_new_user_page (); setup_first_time_config_page (); setup_monitoring_choice_page (); setup_monitor_section_choice_page (); setup_final_page (); the_startup = this; } ArdourStartup::~ArdourStartup () { } bool ArdourStartup::required () { return !Glib::file_test (been_here_before_path(), Glib::FILE_TEST_EXISTS); } std::string ArdourStartup::been_here_before_path () { // XXXX use more specific version so we can catch upgrades return Glib::build_filename (user_config_directory (), ".a3"); } void ArdourStartup::setup_prerelease_page () { VBox* vbox = manage (new VBox); Label* label = manage (new Label); label->set_markup (string_compose (_("Welcome to this BETA release of Ardour %1\n\n\ Ardour %1 has been released for Linux but because of the lack of testers,\n\ it is still at the beta stage on OS X. So, a few guidelines:\n\ \n\ 1) Please do NOT use this software with the expectation that it is stable or reliable\n\ though it may be so, depending on your workflow.\n\ 2) Please do NOT use the forums at ardour.org to report issues.\n\ 3) Please DO use the bugtracker at http://tracker.ardour.org/ to report issues\n\ making sure to note the product version number as %1-beta.\n\ 4) Please DO use the ardour-users mailing list to discuss ideas and pass on comments.\n\ 5) Please DO join us on IRC for real time discussions about ardour3. You\n\ can get there directly from Ardour via the Help->Chat menu option.\n\ \n\ Full information on all the above can be found on the support page at\n\ \n\ http://ardour.org/support\n\ "), VERSIONSTRING)); vbox->set_border_width (12); vbox->pack_start (*label, false, false, 12); vbox->show_all (); append_page (*vbox); set_page_type (*vbox, ASSISTANT_PAGE_CONTENT); set_page_title (*vbox, _("This is a BETA RELEASE")); set_page_complete (*vbox, true); } void ArdourStartup::setup_new_user_page () { Label* foomatic = manage (new Label); foomatic->set_markup (string_compose (_("\ %1 is a digital audio workstation. You can use it to \ record, edit and mix multi-track audio. You can produce your \ own CDs, mix video soundtracks, or experiment with new \ ideas about music and sound. \ \n\n\ There are a few things that need to be configured before you start \ using the program. \ "), PROGRAM_NAME)); foomatic->set_justify (JUSTIFY_FILL); foomatic->set_line_wrap (); HBox* hbox = manage (new HBox); HBox* vbox = manage (new HBox); vbox->set_border_width (24); hbox->pack_start (*foomatic, true, true); vbox->pack_start (*hbox, true, true); foomatic->show (); hbox->show (); vbox->show (); new_user_page_index = append_page (*vbox); set_page_type (*vbox, ASSISTANT_PAGE_INTRO); set_page_title (*vbox, string_compose (_("Welcome to %1"), PROGRAM_NAME)); set_page_header_image (*vbox, icon_pixbuf); set_page_complete (*vbox, true); } void ArdourStartup::default_dir_changed () { Config->set_default_session_parent_dir (default_dir_chooser->get_filename()); // make new session folder chooser point to the new default new_folder_chooser.set_current_folder (Config->get_default_session_parent_dir()); config_changed (); } void ArdourStartup::config_changed () { config_modified = true; } void ArdourStartup::setup_first_time_config_page () { default_dir_chooser = manage (new FileChooserButton (string_compose (_("Default folder for %1 sessions"), PROGRAM_NAME), FILE_CHOOSER_ACTION_SELECT_FOLDER)); Gtk::Label* txt = manage (new Label); HBox* hbox = manage (new HBox); VBox* vbox = manage (new VBox); txt->set_markup (string_compose (_("\ Each project that you work on with %1 has its own folder.\n\ These can require a lot of disk space if you are recording audio.\n\ \n\ Where would you like new %1 sessions to be stored by default?\n\n\ (You can put new sessions anywhere, this is just a default)"), PROGRAM_NAME)); txt->set_alignment (0.0, 0.0); vbox->set_spacing (18); vbox->set_border_width (24); hbox->pack_start (*default_dir_chooser, false, true, 8); vbox->pack_start (*txt, false, false); vbox->pack_start (*hbox, false, true); cerr << "set default folder to " << poor_mans_glob (Config->get_default_session_parent_dir()) << endl; default_dir_chooser->set_current_folder (poor_mans_glob (Config->get_default_session_parent_dir())); default_dir_chooser->signal_current_folder_changed().connect (sigc::mem_fun (*this, &ArdourStartup::default_dir_changed)); default_dir_chooser->show (); vbox->show_all (); default_folder_page_index = append_page (*vbox); set_page_title (*vbox, _("Default folder for new sessions")); set_page_header_image (*vbox, icon_pixbuf); set_page_type (*vbox, ASSISTANT_PAGE_CONTENT); /* user can just skip all these settings if they want to */ set_page_complete (*vbox, true); } void ArdourStartup::setup_monitoring_choice_page () { mon_vbox.set_spacing (18); mon_vbox.set_border_width (24); HBox* hbox = manage (new HBox); VBox* vbox = manage (new VBox); /* first button will be on by default */ RadioButton::Group g (monitor_via_ardour_button.get_group()); monitor_via_hardware_button.set_group (g); monitor_label.set_markup(_("\ While recording instruments or vocals, you probably want to listen to the\n\ signal as well as record it. This is called \"monitoring\". There are\n\ different ways to do this depending on the equipment you have and the\n\ configuration of that equipment. The two most common are presented here.\n\ Please choose whichever one is right for your setup.\n\n\ (You can change this preference at any time, via the Preferences dialog)\n\n\ If you do not understand what this is about, just accept the default.")); monitor_label.set_alignment (0.0, 0.0); vbox->set_spacing (6); vbox->pack_start (monitor_via_hardware_button, false, true); vbox->pack_start (monitor_via_ardour_button, false, true); hbox->pack_start (*vbox, true, true, 8); mon_vbox.pack_start (monitor_label, false, false); mon_vbox.pack_start (*hbox, false, false); mon_vbox.show_all (); monitoring_page_index = append_page (mon_vbox); set_page_title (mon_vbox, _("Monitoring Choices")); set_page_header_image (mon_vbox, icon_pixbuf); /* user could just click on "Forward" if default * choice is correct. */ set_page_complete (mon_vbox, true); } void ArdourStartup::setup_monitor_section_choice_page () { mon_sec_vbox.set_spacing (18); mon_sec_vbox.set_border_width (24); HBox* hbox = manage (new HBox); VBox* main_vbox = manage (new VBox); VBox* vbox; Label* l = manage (new Label); main_vbox->set_spacing (32); no_monitor_section_button.set_label (_("Use a Master bus directly")); l->set_alignment (0.0, 1.0); l->set_markup(_("Connect the Master bus directly to your hardware outputs. This is preferable for simple usage.")); vbox = manage (new VBox); vbox->set_spacing (6); vbox->pack_start (no_monitor_section_button, false, true); vbox->pack_start (*l, false, true); main_vbox->pack_start (*vbox, false, false); use_monitor_section_button.set_label (_("Use an additional Monitor bus")); l = manage (new Label); l->set_alignment (0.0, 1.0); l->set_text (_("Use a Monitor bus between Master bus and hardware outputs for \n\ greater control in monitoring without affecting the mix.")); vbox = manage (new VBox); vbox->set_spacing (6); vbox->pack_start (use_monitor_section_button, false, true); vbox->pack_start (*l, false, true); main_vbox->pack_start (*vbox, false, false); RadioButton::Group g (use_monitor_section_button.get_group()); no_monitor_section_button.set_group (g); if (Config->get_use_monitor_bus()) { use_monitor_section_button.set_active (true); } else { no_monitor_section_button.set_active (true); } use_monitor_section_button.signal_toggled().connect (sigc::mem_fun (*this, &ArdourStartup::config_changed)); no_monitor_section_button.signal_toggled().connect (sigc::mem_fun (*this, &ArdourStartup::config_changed)); monitor_section_label.set_markup(_("You can change this preference at any time via the Preferences dialog.\nYou can also add or remove the monitor section to/from any session.\n\n\ If you do not understand what this is about, just accept the default.")); monitor_section_label.set_alignment (0.0, 0.0); hbox->pack_start (*main_vbox, true, true, 8); mon_sec_vbox.pack_start (*hbox, false, false); mon_sec_vbox.pack_start (monitor_section_label, false, false); mon_sec_vbox.show_all (); monitor_section_page_index = append_page (mon_sec_vbox); set_page_title (mon_sec_vbox, _("Monitor Section")); set_page_header_image (mon_sec_vbox, icon_pixbuf); /* user could just click on "Forward" if default * choice is correct. */ set_page_complete (mon_sec_vbox, true); } void ArdourStartup::setup_final_page () { string msg = string_compose (_("%1 is ready for use"), PROGRAM_NAME); final_page.set_markup (string_compose ("%1", msg)); final_page.show (); final_page_index = append_page (final_page); set_page_complete (final_page, true); set_page_header_image (final_page, icon_pixbuf); set_page_type (final_page, ASSISTANT_PAGE_CONFIRM); } void ArdourStartup::on_cancel () { _response = RESPONSE_CANCEL; gtk_main_quit (); } bool ArdourStartup::on_delete_event (GdkEventAny*) { _response = RESPONSE_CLOSE; gtk_main_quit (); return true; } void ArdourStartup::on_apply () { if (config_modified) { if (default_dir_chooser) { Config->set_default_session_parent_dir (default_dir_chooser->get_filename()); } if (monitor_via_hardware_button.get_active()) { Config->set_monitoring_model (ExternalMonitoring); } else if (monitor_via_ardour_button.get_active()) { Config->set_monitoring_model (SoftwareMonitoring); } Config->set_use_monitor_bus (use_monitor_section_button.get_active()); Config->save_state (); } { /* "touch" the been-here-before path now we've successfully made it through the first time setup (at least) */ ofstream fout (been_here_before_path().c_str()); } _response = RESPONSE_OK; gtk_main_quit (); } void ArdourStartup::move_along_now () { on_apply (); }