mirror of
https://github.com/jart/cosmopolitan.git
synced 2025-02-23 14:39:02 +00:00
d1157d471f
This change gets printvideo working on aarch64. Performance improvements have been introduced for magikarp decimation on aarch64. The last of the old portable x86 intrinsics library is gone, but it still lives in Blink
68 lines
2.3 KiB
Markdown
Executable file
68 lines
2.3 KiB
Markdown
Executable file
# PL_MPEG - MPEG1 Video decoder, MP2 Audio decoder, MPEG-PS demuxer
|
|
|
|
Single-file MIT licensed library for C/C++
|
|
|
|
See [pl_mpeg.h](https://github.com/phoboslab/pl_mpeg/blob/master/pl_mpeg.h) for
|
|
the documentation.
|
|
|
|
|
|
## Why?
|
|
|
|
This is meant as a simple way to get video playback into your app or game. Other
|
|
solutions, such as ffmpeg require huge libraries and a lot of glue code.
|
|
|
|
MPEG1 is an old and inefficient codec, but it's still good enough for many use
|
|
cases. All patents related to MPEG1 and MP2 have expired, so it's completely
|
|
free now.
|
|
|
|
This library does not make use of any SIMD instructions, but because of
|
|
the relative simplicity of the codec it still manages to decode 4k60fps video
|
|
on a single CPU core (on my i7-6700k at least).
|
|
|
|
## Compilation on Linux
|
|
|
|
Use a GCC invocation like the following to build the example `pl_mpeg_player`
|
|
program:
|
|
|
|
```shell
|
|
gcc -o pl_mpeg_player pl_mpeg_player.c $(pkg-config --cflags --libs sdl2 glew)
|
|
```
|
|
|
|
## Example Usage
|
|
|
|
- [pl_mpeg_extract_frames.c](https://github.com/phoboslab/pl_mpeg/blob/master/pl_mpeg_extract_frames.c)
|
|
extracts all frames from a video and saves them as PNG.
|
|
- [pl_mpeg_player.c](https://github.com/phoboslab/pl_mpeg/blob/master/pl_mpeg_player.c)
|
|
implements a video player using SDL2 and OpenGL for rendering.
|
|
|
|
|
|
|
|
## Encoding for PL_MPEG
|
|
|
|
Most [MPEG-PS](https://en.wikipedia.org/wiki/MPEG_program_stream) (`.mpg`) files
|
|
containing MPEG1 Video ("mpeg1") and MPEG1 Audio Layer II ("mp2") streams should
|
|
work with PL_MPEG. Note that `.mpg` files can also contain MPEG2 Video, which is
|
|
not supported by this library.
|
|
|
|
You can encode video in a suitable format using ffmpeg:
|
|
|
|
```
|
|
ffmpeg -i input.mp4 -c:v mpeg1video -q:v 0 -c:a mp2 -format mpeg output.mpg
|
|
```
|
|
|
|
`-q:v` sets a fixed video quality with a variable bitrate, where `0` is the
|
|
highest. You may use `-b:v` to set a fixed bitrate instead; e.g.
|
|
`-b:v 2000k` for 2000 kbit/s. Please refer to the
|
|
[ffmpeg documentation](http://ffmpeg.org/ffmpeg.html#Options) for more details.
|
|
|
|
If you just want to quickly test the library, try this file:
|
|
|
|
https://phoboslab.org/files/bjork-all-is-full-of-love.mpg
|
|
|
|
|
|
## Limitations
|
|
|
|
- no error reporting. PL_MPEG will silently ignore any invalid data.
|
|
- the pts (presentation time stamp) for packets in the MPEG-PS container is
|
|
ignored. This may cause sync issues with some files.
|
|
- bugs, probably.
|