README
¶
gostreamer
go package for playing with the gstreamer (gstlaunch) cli.
supported image formats (DataSinks):
- GRAY8
- RGB
- BGR
- RGBA
- BGRA
opencv support:
- you can also produce gocv Mat objects from video sinks
TODO:
- audiosink support (DataSink)
- better documentation
- support more image formats for DataSinks
NOTES:
- FdSink does not work on windows
example:
package main
import (
"context"
"fmt"
"runtime"
"github.com/tinogoehlert/gostreamer/gocv"
"github.com/tinogoehlert/gostreamer"
"gocv.io/x/gocv"
)
func main() {
runtime.LockOSThread()
gst, _ := gostreamer.NewGstreamer()
fdsink := gostreamer.NewFdSink()
gst.AddStr("avfvideosrc").
AddStr("videoconvert").
AddStr("video/x-raw, framerate=25/1,format=BGR").
AddStr("videoscale").
AddSink(fdsink)
imager := gocvstreamer.NewCvImager(fdsink)
window := gocv.NewWindow("Simple test")
defer window.Close()
imager.ProduceMat(context.Background(), func(mat gocv.Mat) error {
window.IMShow(mat)
if window.WaitKey(1) >= 0 {
return fmt.Errorf("interrupted")
}
return nil
})
}
Documentation
¶
Index ¶
Constants ¶
const (
// GstCapsFilter cap we will rely on
GstCapsFilter = "GstCapsFilter"
)
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Caps ¶
type Caps struct {
Width int
Height int
Framerate int
PixelFormat string
Channels int
Type string
Name string
}
Caps represents caps
type CommonSink ¶
type CommonSink struct {
Sinker
}
CommonSink represents a common sink (e.g. videosink, autovideosink or udpsink)
func NewCommonSink ¶
func NewCommonSink(cmds ...string) *CommonSink
NewCommonSink creates a new common sink (e.g. videosink, autovideosink or udpsink)
type Gstreamer ¶
type Gstreamer struct {
// contains filtered or unexported fields
}
Gstreamer represents a gstreamer pipe
func NewGstreamer ¶
NewGstreamer creates a new Gstreamer instance
func NewGstreamerFromPath ¶
NewGstreamerFromPath creates a new Gstreamer instance, uses given path to gst-launch binary
func (*Gstreamer) Add ¶
func (gp *Gstreamer) Add(p GstreamerPlugin) *Gstreamer
Add add a GstreamerPlugin to the pipe
func (*Gstreamer) AddStr ¶
AddStr Creates a GstreamerGenericPlugin from given string and adds it to the pipe
func (*Gstreamer) PipeString ¶
PipeString outputs the current pipe
type GstreamerGenericPlugin ¶
type GstreamerGenericPlugin struct {
// contains filtered or unexported fields
}
GstreamerGenericPlugin generic gstreamer plugin
func (GstreamerGenericPlugin) Cmds ¶
func (p GstreamerGenericPlugin) Cmds() []string
type GstreamerPlugin ¶
type GstreamerPlugin interface {
Cmds() []string
}
GstreamerPlugin gstreamer plugin interface
type Imager ¶
type Imager struct {
// contains filtered or unexported fields
}
Imager produces go image objects
type Sink ¶
type Sink interface {
Gst() *Gstreamer
Cmds() []string
Run()
Start(ctx context.Context) (*Caps, error)
// contains filtered or unexported methods
}
Sink generic sink interface
Source Files
Directories