Skip to content

Commit 6c9cdcf

Browse files
authored
Merge branch 'develop' into master
2 parents ddf2fde + 08b6a5f commit 6c9cdcf

2,275 files changed

Lines changed: 4386 additions & 5902 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

Contents/Info.plist

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@
3535
<key>CFBundleExecutable</key>
3636
<string>webots</string>
3737
<key>CFBundleGetInfoString</key>
38-
<string>Webots R2023b revision 1, Copyright 1998-2023 Cyberbotics Ltd.</string>
38+
<string>Webots R2024a, Copyright 1998-2024 Cyberbotics Ltd.</string>
3939
<key>CFBundleIconFile</key>
4040
<string>webots_icon</string>
4141
<key>CFBundleIdentifier</key>
@@ -47,11 +47,11 @@
4747
<key>CFBundlePackageType</key>
4848
<string>APPL</string>
4949
<key>CFBundleShortVersionString</key>
50-
<string>R2023b revision 1</string>
50+
<string>R2024a</string>
5151
<key>CFBundleSignature</key>
5252
<string>wbt </string>
5353
<key>CFBundleVersion</key>
54-
<string>R2023b revision 1</string>
54+
<string>R2024a</string>
5555
<key>LSMinimumSystemVersion</key>
5656
<string>10.14</string>
5757
<key>CSResourcesFileMapped</key>

docs/css/webots-doc.css

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -601,7 +601,7 @@ body {
601601
.ui-icon {
602602
display: inline-block;
603603
background-repeat: no-repeat;
604-
background-image: url('https://cyberbotics.com/wwi/{{ webots.version.major }}/images/icons.svg');
604+
background-image: url('https://cyberbotics.com/wwi/R2024a/images/icons.svg');
605605
background-color: transparent;
606606
border: none;
607607
width: 34px;

docs/guide/menu.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@
6262
- [Controller Plugin](controller-plugin.md)
6363
- [Webots Plugin](webots-plugin.md)
6464
- [Web Interface](web-interface.md)
65-
- [X3D and Web Scene](web-scene.md)
65+
- [W3D and Web Scene](web-scene.md)
6666
- [Web Animation](web-animation.md)
6767
- [Web Streaming](web-streaming.md)
6868
- [Webots.cloud](webots-cloud.md)

docs/guide/simulation-server.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ HTTP request handlers:
3838

3939
WebSocket request handlers:
4040
* The `/client` request on the simulation server URL will setup a new Webots instance and return the Webots WebSocket URL.
41-
The payload should be a JSON object named `start` containing a `url` string and optionally a `mode` string which can be either `x3d` (default value) or `mjpeg`.
41+
The payload should be a JSON object named `start` containing a `url` string and optionally a `mode` string which can be either `w3d` (default value) or `mjpeg`.
4242
```json
4343
{
4444
"start": {

docs/guide/starting-webots.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ Options:
7070
7171
--stream[=<mode>]
7272
Start the Webots streaming server. The <mode> argument should be either
73-
x3d (default) or mjpeg.
73+
w3d (default) or mjpeg.
7474
7575
--extern-urls
7676
Print on stdout the URL of extern controllers that should be started.
@@ -110,7 +110,7 @@ Note that the *stderr* stream may also contain Webots error or warning messages.
110110

111111
The `--port` option changes the default TCP port used by Webots for serving robot windows, web streaming and extern controllers. By default, Webots sets up its TCP server on port 1234. When starting multiple Webots instances, the ports are configured with consecutive values of 1234.
112112

113-
The `--stream` option enables the Webots streaming server in either `x3d` (default) or `mjpeg` mode.
113+
The `--stream` option enables the Webots streaming server in either `w3d` (default) or `mjpeg` mode.
114114
You can get more information about web streaming in [this section](web-streaming.md).
115115

116116
For example, the following command will start Webots with the streaming server enabled on the TCP port '1235' in 'mjpeg' mode: `webots --port=1235 --stream=mjpeg`

docs/guide/web-animation.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Select the `Share...` menu item and choose if you want to upload it to [webots.c
2121
Click the `Stop HTML5 animation` to finish the recording and save the animation.
2222
Webots will ask to playback the resulting file in the default Web browser (from the OS settings).
2323

24-
**Note**: The `CSS` file, the `X3D` file, the `JSON` animation file and the required textures are exported in the same directory as the target `HTML` file.
24+
**Note**: The `CSS` file, the `W3D` file, the `JSON` animation file and the required textures are exported in the same directory as the target `HTML` file.
2525

2626
**Note**: The `CSS` file is meant to be used as a styling guide but can be modified/removed.
2727

@@ -40,7 +40,7 @@ The web animation is played by a web component from the [WebotsView.js] package
4040

4141
The following attributes are available:
4242
* `data-thumbnail`: the name of the .jpg file containing the thumbnail. If the `data-thumbnail` attribute is not set, a default thumbnail will be displayed during load.
43-
* `data-scene`: the name of the .x3d file containing the 3d scene.
43+
* `data-scene`: the name of the .w3d file containing the 3d scene.
4444
* `data-animation`: the name of the .json file containing the animation sequence.
4545
* `data-autoplay`: boolean to determine if the animation should be played automatically, `true` by default.
4646
* `data-isMobileDevice`: boolean variable specifying if the application is running on a mobile device.
@@ -55,7 +55,7 @@ For more complex interaction with the web component, the following functions are
5555
* `hasAnimation()`: return `true` if there is already a animation loaded by the web component, `false` otherwise.
5656
* `hasView()`: return `true` if a view exist, `false` otherwise.
5757
* `loadAnimation(scene, animation, play, mobileDevice, thumbnail, raw)`: load and play the animation.
58-
* `scene`: name of the .x3d file.
58+
* `scene`: name of the .w3d file.
5959
* `animation`: name of the .json file.
6060
* `play`: if false, the animation will be paused, otherwise it will be played.
6161
* `mobileDevice`: boolean variable specifying if the application is running on a mobile device.

docs/guide/web-interface.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# Web Interface
22

3-
This chapter describes how to export a simulation to X3D format and web pages.
3+
This chapter describes how to export a simulation to W3D format and web pages.
44

55
An example of exported Webots animation is available [here](https://cyberbotics.com/animations/soccer_example/soccer.html).
66

77
## Sections
88

9-
- [X3D and Web Scene](web-scene.md)
9+
- [W3D and Web Scene](web-scene.md)
1010
- [Web Animation](web-animation.md)
1111
- [Web Streaming](web-streaming.md)
1212
- [Webots.cloud](webots-cloud.md)

docs/guide/web-scene.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,18 @@
1-
## X3D and Web Scene
1+
## W3D and Web Scene
22

33
### Description
44

55
Webots can export a world to an interactive 3D `HTML` page.
66
This feature is especially useful for publishing Webots-created worlds on the Web.
77

8-
During the export, a [X3D](http://www.web3d.org/x3d/what-x3d) file, a `HTML5` page and a `CSS`file are generated.
8+
During the export, a `W3D` file, a `HTML5` page and a `CSS`file are generated.
99

10-
The `X3D` file contains the graphical information of the world.
11-
`X3D` is a modern `XML`-based file format for representing 3D computer graphics.
12-
In Webots, the `X3D` file uses a custom format that is heavily based on the `X3D` file format.
10+
The `W3D` file contains the graphical information of the world.
11+
`W3D` is a Webots custom `XML`-based file format for representing 3D computer graphics.
1312

1413
The `CSS` file is used to style the following `HTML5` page.
1514

16-
The `HTML5` page contains a Webots player which displays the `X3D` file as shown in the [figure below](#screenshot-of-a-web-scene-page-generated-by-webots).
15+
The `HTML5` page contains a Webots player which displays the `W3D` file as shown in the [figure below](#screenshot-of-a-web-scene-page-generated-by-webots).
1716
It can be open in any recent Web browser as documented in the [section below](#remarks-on-the-used-technologies-and-their-limitations).
1817
The 3D navigation in the player is possible using the mouse or the touch screen, similarly to the Webots navigation.
1918

@@ -28,7 +27,7 @@ The 3D navigation in the player is possible using the mouse or the touch screen,
2827
Select the `Share...` menu item, choose if you want to upload it to [webots.cloud](https://webots.cloud) or to save it locally, then click the `Export scene` button.
2928
When the export is completed, Webots will ask to playback the resulting file in the default Web browser.
3029

31-
**Note**: The `CSS` file, the `X3D` file and the required textures are exported in the same directory as the target `HTML` file.
30+
**Note**: The `CSS` file, the `W3D` file and the required textures are exported in the same directory as the target `HTML` file.
3231

3332
**Note**: The `CSS` file is meant to be used as a styling guide but can be modified/removed.
3433

@@ -48,13 +47,13 @@ The web scene is displayed by a web component from the [WebotsView.js] package c
4847

4948
The following attributes are available:
5049
* `data-thumbnail`: the name of the .jpg file containing the thumbnail. If the `data-thumbnail` attribute is not set, a default thumbnail will be displayed during load.
51-
* `data-scene`: the name of the .x3d file containing the 3d scene. It is evaluated only once: when the page is loaded. If the `data-scene` attribute is set, the `webots-view` web-component will automatically try to load the web scene .
50+
* `data-scene`: the name of the .w3d file containing the 3d scene. It is evaluated only once: when the page is loaded. If the `data-scene` attribute is set, the `webots-view` web-component will automatically try to load the web scene .
5251

5352
For more complex interaction with the web component, the following functions are available:
5453
* `close()`: close the current scene. Note that if the `webots-view` element is removed from the HTML page or `loadScene`, `loadAnimation` or `connect` is called, `close` will be automatically called.
5554
* `onready()`: a function that can be overridden. It will be called once the scene is loaded.
5655
* `loadScene(scene, mobileDevice, thumbnail)`: load and display the scene.
57-
* `scene`: name of the .x3d file.
56+
* `scene`: name of the .w3d file.
5857
* `mobileDevice`: boolean variable specifying if the application is running on a mobile device.
5958
* `thumbnail`: the URL of the scene thumbnail.
6059
* `setAmbientOcclusion(level)`: change the intensity of the ambient occlusion to the given level.
@@ -85,7 +84,7 @@ It may occur that the rendering in the Webots application and in the exported We
8584
}
8685
document.body.appendChild(webotsView);
8786
88-
webotsView.loadScene("scene.x3d");
87+
webotsView.loadScene("scene.w3d");
8988
}
9089
9190
function remove() {
@@ -101,7 +100,7 @@ The Webots player is using internally the `WRENJS` library (based on `WebGL 2`).
101100
Unfortunately it is not yet supported by Safari (see details on the [deployment of WebGL 2](https://caniuse.com/webgl2)).
102101
In case of related issues, make sure that `WebGL 2` is enabled in your Web browser settings.
103102
104-
Some web browsers (for example Chrome and Firefox 68 or later) cannot open local files using the `file` protocol by default, while this is required by the Webots player to open the `X3D` file and the textures.
103+
Some web browsers (for example Chrome and Firefox 68 or later) cannot open local files using the `file` protocol by default, while this is required by the Webots player to open the `W3D` file and the textures.
105104
Here are some workarounds:
106105
- run a local HTTP server in the directory containing the exported files, and launch the scene or animation through the server by navigating to the `HTML` file.
107106
- Python 3:

docs/guide/web-streaming.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,12 +6,12 @@ Webots can be used as a Web streaming server, i.e., to stream a simulation to se
66
In this mode the user can watch an already running simulation and navigate into the scene but cannot interact with the simulation, i.e. controlling the execution of the simulation and modifying the robot controller program.
77

88
Two different streaming modes are available:
9-
- `x3d` (default): the simulation is streamed using a mechanism similar to the [web animation export](web-animation.md) except that the `X3D` file and the animation are sent on the fly to the web browser clients.
9+
- `w3d` (default): the simulation is streamed using a mechanism similar to the [web animation export](web-animation.md) except that the `W3D` file and the animation are sent on the fly to the web browser clients.
1010
- `mjpeg`: the Webots scene rendered on the server is directly sent as an `MJPEG` image to the web browser client.
11-
You should choose between the `x3d` and `mjpeg` depending on the type of application you are developing.
11+
You should choose between the `w3d` and `mjpeg` depending on the type of application you are developing.
1212
The following table summarizes the advantages (`+`) and disadvantages (`-`) of the the two modes:
1313

14-
| feature / mode | `x3d` | `mjpeg` |
14+
| feature / mode | `w3d` | `mjpeg` |
1515
|:-----------------------:|:-----:|:-------:|
1616
| high resolution images | + | - |
1717
| 3D navigation latency | + | - |
@@ -81,8 +81,8 @@ This is the API of the `webots-streaming` web component:
8181
* `server`: The URL of the server. Different URL formats are supported:
8282
* URL to a session server: "https://webots.cloud/ajax/server/session.php?url=https://github.com/cyberbotics/webots/projects/languages/python/worlds/example.wbt"
8383
* WebSocket URL (i.e. "ws://localhost:1234"): this format is used for web broadcast streaming.
84-
* URL to a X3D file (i.e. "file.x3d"): this format is used for showing a [web scene](web-scene.md) or a [web animation](web-animation.md).
85-
* `mode`: `x3d` or `mjpeg`.
84+
* URL to a W3D file (i.e. "file.w3d"): this format is used for showing a [web scene](web-scene.md) or a [web animation](web-animation.md).
85+
* `mode`: `w3d` or `mjpeg`.
8686
* `broadcast`: boolean variable enabling or not the broadcast.
8787
* `isMobileDevice`: boolean variable specifying if the application is running on a mobile device.
8888
* `timeout`: the time (in seconds) after which the simulation will be automatically paused (until the play button is pressed again). By default, no timeout is set.
@@ -107,7 +107,7 @@ This is the API of the `webots-streaming` web component:
107107

108108
Moreover, the following attributes are available:
109109
* `data-server`: URL of the server.
110-
* `data-mode`: `x3d` or `mjpeg`.
110+
* `data-mode`: `w3d` or `mjpeg`.
111111
* `data-broadcast`: boolean variable enabling or not the broadcast.
112112
* `data-isMobileDevice`: boolean variable specifying if the application is running on a mobile device.
113113
* `data-thumbnail`: the name of the .jpg file containing the thumbnail. If the `data-thumbnail` attribute is not set, a default thumbnail will be displayed during load.

docs/guide/webots-cloud.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Webots features a "share" button that allows you to upload a 3D [Web Scene](web-
1010
This is useful to show models of robots, sensors, actuators, objects, environments or simulation play-back to colleagues or to the wide public.
1111
Once your scene or animation is uploaded, you get a link (web URL) pointing to your upload, which you can share.
1212
Anyone with this link can view your 3D scene or animation with a simple mouse click.
13-
Scenes and animations can also be uploaded on webots.cloud by clicking the "Add a new scene/animation" button, and uploading locally saved `X3D`, `JSON`, thumbnail and texture files.
13+
Scenes and animations can also be uploaded on webots.cloud by clicking the "Add a new scene/animation" button, and uploading locally saved `W3D`, `JSON`, thumbnail and texture files.
1414

1515
### Share and use your Proto
1616

0 commit comments

Comments
 (0)