diff --git a/Migration.md b/Migration.md index ed95d13afe1..7375f9b33e8 100644 --- a/Migration.md +++ b/Migration.md @@ -65,6 +65,9 @@ since pose information is being logged in the `changed_state` topic. + `TransformControl`: Translate and rotate + `ViewAndle`: Move camera to preset angles +* The `gui.config` and `server.config` files are now located in a versioned + folder inside `$HOME/.ignition/gazebo`, i.e. `$HOME/.ignition/gazebo/6/gui.config`. + ## Ignition Gazebo 4.x to 5.x * Use `cli` component of `ignition-utils1`. diff --git a/src/ServerConfig.cc b/src/ServerConfig.cc index dacfc22246d..5e2564564a1 100644 --- a/src/ServerConfig.cc +++ b/src/ServerConfig.cc @@ -877,7 +877,7 @@ ignition::gazebo::loadPluginInfo(bool _isPlayback) std::string defaultConfigDir; ignition::common::env(IGN_HOMEDIR, defaultConfigDir); defaultConfigDir = ignition::common::joinPaths(defaultConfigDir, ".ignition", - "gazebo"); + "gazebo", IGNITION_GAZEBO_MAJOR_VERSION_STR); auto defaultConfig = ignition::common::joinPaths(defaultConfigDir, configFilename); diff --git a/src/cmd/ign.cc b/src/cmd/ign.cc index f385112e8dc..896126f761c 100644 --- a/src/cmd/ign.cc +++ b/src/cmd/ign.cc @@ -231,7 +231,7 @@ extern "C" int runGui(const char *_guiConfig) std::string defaultConfig; ignition::common::env(IGN_HOMEDIR, defaultConfig); defaultConfig = ignition::common::joinPaths(defaultConfig, ".ignition", - "gazebo", "gui.config"); + "gazebo", IGNITION_GAZEBO_MAJOR_VERSION_STR, "gui.config"); app.SetDefaultConfigPath(defaultConfig); // Customize window @@ -418,7 +418,7 @@ extern "C" int runGui(const char *_guiConfig) } } - // Also set ~/.ignition/gazebo/gui.config as the default path + // Also set ~/.ignition/gazebo/ver/gui.config as the default path if (!app.LoadConfig(defaultConfig)) { ignerr << "Failed to load config file[" << _guiConfig << "]." diff --git a/src/gui/Gui.cc b/src/gui/Gui.cc index 75e300fc264..b0e868503de 100644 --- a/src/gui/Gui.cc +++ b/src/gui/Gui.cc @@ -90,7 +90,7 @@ std::unique_ptr createGui( } ignition::common::env(IGN_HOMEDIR, defaultConfig); defaultConfig = ignition::common::joinPaths(defaultConfig, ".ignition", - "gazebo", defaultGuiConfigName); + "gazebo", IGNITION_GAZEBO_MAJOR_VERSION_STR, defaultGuiConfigName); } else { @@ -279,7 +279,7 @@ std::unique_ptr createGui( } } - // Also set ~/.ignition/gazebo/gui.config as the default path + // Also set ~/.ignition/gazebo/ver/gui.config as the default path if (!app->LoadConfig(defaultConfig)) { ignerr << "Failed to load config file[" << defaultConfig << "]." diff --git a/tutorials/gui_config.md b/tutorials/gui_config.md index fddc6b156f2..d7cecc59f40 100644 --- a/tutorials/gui_config.md +++ b/tutorials/gui_config.md @@ -13,7 +13,8 @@ There are a few places where the GUI configuration can come from: 1. A file passed to the `--gui-config` command line argument 2. A `` element inside an SDF file -3. The default configuration file at `$HOME/.ignition/gazebo/gui.config` \* +3. The default configuration file at `$HOME/.ignition/gazebo/<#>/gui.config` \*, + where `<#>` is Gazebo's major version. Each of the items above takes precedence over the ones below it. For example, if a user chooses a `--gui-config`, the SDF's `` element is ignored. And @@ -21,7 +22,7 @@ the default configuration file is only loaded if no configuration is passed through the command line or the SDF file. > \* For log-playback, the default file is -> `$HOME/.ignition/gazebo/playback_gui.config` +> `$HOME/.ignition/gazebo/<#>/playback_gui.config` ## Try it out @@ -39,7 +40,7 @@ You should see an empty world with several plugins loaded by default, such as th By default, you're loading this file: -`$HOME/.ignition/gazebo/gui.config` +`$HOME/.ignition/gazebo/<#>/gui.config` That file is created the first time you load Ignition Gazebo. Once it is created, Ignition will never write to it again unless you delete it. This @@ -50,7 +51,7 @@ Let's try customizing it: 1. Open this file with your favorite editor: - `$HOME/.ignition/gazebo/gui.config` + `$HOME/.ignition/gazebo/<#>/gui.config` 2. Change `material_theme` from `Light` to `Dark` @@ -67,7 +68,7 @@ provided by Ignition (when you update to a newer version for example). In that case, just delete that file, and the next time Gazebo is started a new file will be created with default values: -`rm $HOME/.ignition/gazebo/gui.config` +`rm $HOME/.ignition/gazebo/<#>/gui.config` ### SDF @@ -168,7 +169,7 @@ hand, we'll create it from the UI. 3. Gazebo should open with your custom layout. **Tip**: From the top-left menu, you can choose "Save client configuration" to -save directly to `$HOME/.ignition/gazebo/gui.config`. +save directly to `$HOME/.ignition/gazebo/<#>/gui.config`. @image html files/gui_config/cmd_line.png diff --git a/tutorials/migration_sdf.md b/tutorials/migration_sdf.md index f2857190e77..30d3978bff9 100644 --- a/tutorials/migration_sdf.md +++ b/tutorials/migration_sdf.md @@ -259,8 +259,8 @@ and [xacro](http://wiki.ros.org/xacro) to generate SDF files with the correct pl Ignition Gazebo is more modular than Gazebo classic, so most features are optional. For example, by default, Ignition will load all the system plugins defined on -the `~/.ignition/gazebo/server.config` file and all GUI plugins defined on the -`~/.ignition/gazebo/gui.config` file. But the user can always remove plugins from +the `~/.ignition/gazebo/<#>/server.config` file and all GUI plugins defined on the +`~/.ignition/gazebo/<#>/gui.config` file. But the user can always remove plugins from those files, or choose different ones by adding `` tags to the SDF file. (For more details, see the [Server configuration tutorial](server_config.html) and the [GUI configuration tutorial](gui_config.html)). diff --git a/tutorials/resources.md b/tutorials/resources.md index 946b2059471..430f1f42169 100644 --- a/tutorials/resources.md +++ b/tutorials/resources.md @@ -152,7 +152,7 @@ can come from the following, in order: 1. The command line option `--gui-config ` 2. Plugins within SDF's `` -3. `$HOME/.ignition/gazebo/gui.config` (if that file doesn't +3. `$HOME/.ignition/gazebo/<#>/gui.config` (if that file doesn't exist, the default `gui.config` file that is installed with Ignition Gazebo will be copied to that location) diff --git a/tutorials/server_config.md b/tutorials/server_config.md index 42fdec843d9..a9a27830f15 100644 --- a/tutorials/server_config.md +++ b/tutorials/server_config.md @@ -14,7 +14,8 @@ There are a few places where the plugins can be defined: 1. `` elements inside an SDF file. 2. File path defined by the `IGN_GAZEBO_SERVER_CONFIG_PATH` environment variable. -3. The default configuration file at `$HOME/.ignition/gazebo/server.config` \* +3. The default configuration file at `$HOME/.ignition/gazebo/<#>/server.config` \*, + where `<#>` is Gazebo's major version. Each of the items above takes precedence over the ones below it. For example, if a the SDF file has any `` elements, then the @@ -23,7 +24,7 @@ file is only loaded if no plugins are passed through the SDF file or the environment variable. > \* For log-playback, the default file is -> `$HOME/.ignition/gazebo/playback_gui.config` +> `$HOME/.ignition/gazebo/<#>/playback_server.config` ## Try it out @@ -48,7 +49,7 @@ broadcaster is loaded. By default, you're loading this file: -`$HOME/.ignition/gazebo/server.config` +`$HOME/.ignition/gazebo/<#>/server.config` That file is created the first time you load Ignition Gazebo. Once it is created, Ignition will never write to it again unless you delete it. This @@ -59,7 +60,7 @@ Let's try customizing it: 1. Open this file with your favorite editor: - `$HOME/.ignition/gazebo/server.config` + `$HOME/.ignition/gazebo/<#>/server.config` 2. Remove the `` block for the physics system @@ -77,7 +78,7 @@ provided by Ignition (when you update to a newer version for example). In that case, just delete that file, and the next time Gazebo is started a new file will be created with default values: -`rm $HOME/.ignition/gazebo/server.config` +`rm $HOME/.ignition/gazebo/<#>/server.config` ### SDF diff --git a/tutorials/video_recorder.md b/tutorials/video_recorder.md index 2a0f6f05fdf..c786dba6d03 100644 --- a/tutorials/video_recorder.md +++ b/tutorials/video_recorder.md @@ -42,7 +42,7 @@ in the world SDF file so you will need to download a copy of the and modify the GUI configuration in that file. On the other hand, if you launched Ignition Gazebo with a world file that does not have GUI configurations, you will need to specify the settings in -`$HOME/.ignition/gazebo/gui.config`. +`$HOME/.ignition/gazebo/<#>/gui.config`. Recall that videos are recorded from the 3D scene, we will to set the video configurations in the 3D scene plugin. Here is an example of the @@ -105,7 +105,7 @@ going to the world SDF file, locate the * **bitrate**: Video encoding bitrate in bps. This affects the quality of the generated video. The default bitrate is 2Mbps. - + ## Hardware-accelerated encoding Since Ignition Common 3.10.2, there is support for utilizing the power of GPUs