You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+7-5Lines changed: 7 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,18 +7,20 @@ A module that adds MPEG-1 video support to Godot.
7
7
This was originally part of a proposal to replace Godot's built-in Theora decoder due to bugs. However, fixes were found, so I released as a separate module instead.
8
8
9
9
## Usage
10
-
`.mpg` files in your project should appear in the FileSystem dock. Drag them into a VideoStreamPlayer and it should work. All decoding is done on CPU.
10
+
`.mpg` files in your project should appear in the FileSystem dock. Drag them into a VideoStreamPlayer and it should work.
11
11
12
-
Note that video and audio streams should be MPEG-1 Video and MPEG-1 Audio Layer II, respectively. This shouldn't be a problem since `.mpg` usually defaults to those.
12
+
Video and audio streams should be MPEG-1 Video and MPEG-1 Audio Layer II (MP2), respectively. This shouldn't be a problem since `.mpg` usually defaults to those.
13
+
14
+
Like Theora (`.ogv` files), video decoding is done on CPU.
13
15
14
16
## Building
15
17
Clone the repository into `modules/` under the name "mpg". Then proceed to build the engine as per the usual instructions.
16
18
17
-
In my own tests, this module seems to have a weight of 72 KB in a production template release binary. At least this is still better than Theora's 104 KB penalty.
19
+
In my own tests, this module seems to have a weight of 72 KB in a production template release binary. For comparison, Theora's weight is 104 KB.
18
20
19
21
## Third-party
20
22
This module uses the [PL_MPEG](https://github.com/phoboslab/pl_mpeg) library by Dominic Szablewski with a few patches.
21
23
22
24
## Known issues
23
-
- A blank frame can be seen when looping.
24
-
-Performance issues. Theora is still faster despite its bugs. Proposed optimizations in PL_MPEG might fix this.
25
+
- A blank frame can be seen when looping and sometimes at the start.
26
+
- Theora is still a little faster despite its bugs. Proposed optimizations in PL_MPEG might fix this in the future.
0 commit comments