Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/membraneframework/membrane_raw_video_parser_plugin

Membrane plugin for parsing raw video streams
https://github.com/membraneframework/membrane_raw_video_parser_plugin

Last synced: 2 days ago
JSON representation

Membrane plugin for parsing raw video streams

Awesome Lists containing this project

README

        

# Membrane raw video parser plugin

[![Hex.pm](https://img.shields.io/hexpm/v/membrane_raw_video_parser_plugin.svg)](https://hex.pm/packages/membrane_raw_video_parser_plugin)
[![API Docs](https://img.shields.io/badge/api-docs-yellow.svg?style=flat)](https://hexdocs.pm/membrane_raw_video_parser_plugin/)
[![CircleCI](https://circleci.com/gh/membraneframework/membrane_raw_video_parser_plugin.svg?style=svg)](https://circleci.com/gh/membraneframework/membrane_raw_video_parser_plugin)

This package provides an element parsing a data stream into raw (uncompressed) video frames.
Documentation is available at [HexDocs](https://hexdocs.pm/membrane_raw_video_parser_plugin/)

It is part of [Membrane Multimedia Framework](https://membrane.stream/).

## Installation

Add the following line to your `deps` in `mix.exs`. Run `mix deps.get`.

```elixir
{:membrane_raw_video_parser_plugin, "~> 0.12.2"}
```
## Usage
The pipeline below displays a sample raw video from file using Membrane raw video parser plugin and
Membrane SDL plugin.

```elixir
defmodule Membrane.RawVideo.Parser.Pipeline do

use Membrane.Pipeline

@doc """
handle_init(_context, %{
video_path: String.t(),
caps: Membrane.RawVideo
})
"""
@impl true
def handle_init(_ctx, options) do
parser = %Membrane.RawVideo.Parser{
framerate: options.caps.framerate,
width: options.caps.width,
height: options.caps.height,
pixel_format: options.caps.pixel_format
}

structure = [
child(:file_src, %Membrane.File.Source{location: options.video_path})
|> child(:parser, parser)
|> child(:sdl, Membrane.SDL.Player)
]

{[spec: structure, playback: :playing}], %{}}
end

@impl true
def handle_element_end_of_stream(:sdl, _pad_ref, _ctx, state) do
{[playback: :terminating], state}
end

@impl true
def handle_element_end_of_stream(_src, _pad_ref, _ctx, state) do
{[], state}
end
end
```

## Copyright and License

Copyright 2018, [Software Mansion](https://swmansion.com/?utm_source=git&utm_medium=readme&utm_campaign=membrane)

[![Software Mansion](https://logo.swmansion.com/logo?color=white&variant=desktop&width=200&tag=membrane-github)](https://swmansion.com/?utm_source=git&utm_medium=readme&utm_campaign=membrane)

Licensed under the [Apache License, Version 2.0](LICENSE)