GetVideoFrame() buffer param added

This commit is contained in:
Krzysztofz01 2023-08-21 09:55:12 +02:00
parent 1813715282
commit 957b8dc191
2 changed files with 60 additions and 46 deletions

View file

@ -3,7 +3,6 @@ package vidio
import (
"errors"
"fmt"
"image"
"io"
"os"
"os/exec"
@ -13,28 +12,40 @@ import (
"syscall"
)
// Return the N-th frame of the video specified by the filename as a pointer to a RGBA image. The frames are indexed from 0.
func GetVideoFrame(filename string, n int) (*image.RGBA, error) {
// Return the N-th frame of the video specified by the filename in the RGBA format and stored it to the provided frame buffer. The frames are indexed from 0.
func GetVideoFrame(filename string, n int, frameBuffer []byte) error {
if !exists(filename) {
return nil, fmt.Errorf("vidio: video file %s does not exist", filename)
return fmt.Errorf("vidio: video file %s does not exist", filename)
}
if err := installed("ffmpeg"); err != nil {
return nil, err
return err
}
if err := installed("ffprobe"); err != nil {
return nil, err
return err
}
frameBufferSize, framesCount, err := probeVideo(filename)
if err != nil {
return err
}
if n >= framesCount {
return errors.New("vidio: provided frame index is not in frame count range")
}
if frameBuffer == nil {
frameBuffer = make([]byte, frameBufferSize)
} else {
if len(frameBuffer) < frameBufferSize {
return errors.New("vidio: provided frame buffer size is smaller than the frame size")
}
}
selectExpression, err := buildSelectExpression(n)
if err != nil {
return nil, fmt.Errorf("vidio: failed to parse the specified frame index: %w", err)
}
imageRect, stream, err := probeVideo(filename)
if err != nil {
return nil, err
return fmt.Errorf("vidio: failed to parse the specified frame index: %w", err)
}
cmd := exec.Command(
@ -44,7 +55,7 @@ func GetVideoFrame(filename string, n int) (*image.RGBA, error) {
"-loglevel", "quiet",
"-pix_fmt", "rgba",
"-vcodec", "rawvideo",
"-map", fmt.Sprintf("0:v:%d", stream),
"-map", "0:v:0",
"-vf", selectExpression,
"-vsync", "0",
"-",
@ -52,11 +63,11 @@ func GetVideoFrame(filename string, n int) (*image.RGBA, error) {
stdoutPipe, err := cmd.StdoutPipe()
if err != nil {
return nil, fmt.Errorf("vidio: failed to access the ffmpeg stdout pipe: %w", err)
return fmt.Errorf("vidio: failed to access the ffmpeg stdout pipe: %w", err)
}
if err := cmd.Start(); err != nil {
return nil, fmt.Errorf("vidio: failed to start the ffmpeg cmd: %w", err)
return fmt.Errorf("vidio: failed to start the ffmpeg cmd: %w", err)
}
interruptChan := make(chan os.Signal, 1)
@ -72,59 +83,70 @@ func GetVideoFrame(filename string, n int) (*image.RGBA, error) {
os.Exit(1)
}()
imageBuffer := image.NewRGBA(imageRect)
if _, err := io.ReadFull(stdoutPipe, imageBuffer.Pix); err != nil {
return nil, fmt.Errorf("vidio: failed to read the ffmpeg cmd result to the image buffer: %w", err)
if _, err := io.ReadFull(stdoutPipe, frameBuffer); err != nil {
return fmt.Errorf("vidio: failed to read the ffmpeg cmd result to the image buffer: %w", err)
}
if err := stdoutPipe.Close(); err != nil {
return nil, fmt.Errorf("vidio: failed to close the ffmpeg stdout pipe: %w", err)
return fmt.Errorf("vidio: failed to close the ffmpeg stdout pipe: %w", err)
}
if err := cmd.Wait(); err != nil {
return nil, fmt.Errorf("vidio: failed to free resources after the ffmpeg cmd: %w", err)
return fmt.Errorf("vidio: failed to free resources after the ffmpeg cmd: %w", err)
}
return imageBuffer, nil
return nil
}
// Helper function used to extract the target frame size and stream index
func probeVideo(filename string) (image.Rectangle, int, error) {
// Helper function used to extract the target frame buffer size and frames count
func probeVideo(filename string) (int, int, error) {
videoData, err := ffprobe(filename, "v")
if err != nil {
return image.Rectangle{}, 0, fmt.Errorf("vidio: no video data found in %s: %w", filename, err)
return 0, 0, fmt.Errorf("vidio: no video data found in %s: %w", filename, err)
}
if len(videoData) == 0 {
return image.Rectangle{}, 0, fmt.Errorf("vidio: no video streams found in %s", filename)
return 0, 0, fmt.Errorf("vidio: no video streams found in %s", filename)
}
var (
width int = 0
height int = 0
frames int = 0
)
if widthStr, ok := videoData[0]["width"]; !ok {
return image.Rectangle{}, 0, errors.New("vidio: failed to access the image width")
return 0, 0, errors.New("vidio: failed to access the image width")
} else {
if widthParsed, err := strconv.Atoi(widthStr); err != nil {
return image.Rectangle{}, 0, fmt.Errorf("vidio: failed to parse the image width: %w", err)
return 0, 0, fmt.Errorf("vidio: failed to parse the image width: %w", err)
} else {
width = widthParsed
}
}
if heightStr, ok := videoData[0]["height"]; !ok {
return image.Rectangle{}, 0, errors.New("vidio: failed to access the image height")
return 0, 0, errors.New("vidio: failed to access the image height")
} else {
if heightParsed, err := strconv.Atoi(heightStr); err != nil {
return image.Rectangle{}, 0, fmt.Errorf("vidio: failed to parse the image height: %w", err)
return 0, 0, fmt.Errorf("vidio: failed to parse the image height: %w", err)
} else {
height = heightParsed
}
}
return image.Rect(0, 0, width, height), 0, nil
if framesStr, ok := videoData[0]["nb_frames"]; !ok {
return 0, 0, errors.New("vidio: failed to access the frames count")
} else {
if framesParsed, err := strconv.Atoi(framesStr); err != nil {
return 0, 0, fmt.Errorf("vidio: failed to parse the frames count: %w", err)
} else {
frames = framesParsed
}
}
frameBufferSize := width * height * 4
return frameBufferSize, frames, nil
}
// Error representing a strings.Builder failure in the buildSelectExpression func.

View file

@ -1,6 +1,7 @@
package vidio
import (
"image"
"image/png"
"os"
"testing"
@ -8,12 +9,9 @@ import (
func TestGetFrameShouldReturnErrorOnInvalidFilePath(t *testing.T) {
path := "test/koala-video-not-present.mp4"
img := image.NewRGBA(image.Rect(0, 0, 480, 270))
frame, err := GetVideoFrame(path, 2)
if frame != nil {
t.Errorf("Frame was expected to be nil")
}
err := GetVideoFrame(path, 2, img.Pix)
if err == nil {
t.Error("Error was expected to not be nil")
@ -22,13 +20,10 @@ func TestGetFrameShouldReturnErrorOnInvalidFilePath(t *testing.T) {
func TestGetFrameShouldReturnErrorOnOutOfRangeFrame(t *testing.T) {
path := "test/koala.mp4"
img := image.NewRGBA(image.Rect(0, 0, 480, 270))
framesCount := 101
frame, err := GetVideoFrame(path, framesCount+1)
if frame != nil {
t.Error("Frames was expected to be nil")
}
err := GetVideoFrame(path, framesCount+1, img.Pix)
if err == nil {
t.Error("Error was expected to not be nil")
@ -37,17 +32,14 @@ func TestGetFrameShouldReturnErrorOnOutOfRangeFrame(t *testing.T) {
func TestGetFrameShouldReturnCorrectFrame(t *testing.T) {
path := "test/koala.mp4"
img := image.NewRGBA(image.Rect(0, 0, 480, 270))
expectedFrameFile, _ := os.Open("test/koala-frame5.png")
defer expectedFrameFile.Close()
expectedFrame, _ := png.Decode(expectedFrameFile)
actualFrame, err := GetVideoFrame(path, 5)
if actualFrame == nil {
t.Error("Frame was expected to not be nil")
}
err := GetVideoFrame(path, 5, img.Pix)
if err != nil {
t.Error("Error was expected to be nil")
@ -56,7 +48,7 @@ func TestGetFrameShouldReturnCorrectFrame(t *testing.T) {
for xIndex := 0; xIndex < expectedFrame.Bounds().Dx(); xIndex += 1 {
for yIndex := 0; yIndex < expectedFrame.Bounds().Dy(); yIndex += 1 {
eR, eG, eB, eA := expectedFrame.At(xIndex, yIndex).RGBA()
aR, aG, aB, aA := actualFrame.At(xIndex, yIndex).RGBA()
aR, aG, aB, aA := img.At(xIndex, yIndex).RGBA()
if eR != aR || eG != aG || eB != aB || eA != aA {
t.Error("The expected and actual frames were expected to be equal")