wrapper: expose libvlc_video_take_snapshot

Author: alexmercerind

dartvlc/api/api.cc

@@ -219,6 +219,12 @@ void PlayerMove(int32_t id, int32_t initial_index, int32_t final_index) {
   player->Move(initial_index, final_index);
 }
 
+void PlayerTakeSnapshot(int32_t id, const char* file_path, int32_t width,
+                        int32_t height) {
+  Player* player = g_players->Get(id);
+  player->TakeSnapshot(file_path, width, height);
+}
+
 void MediaClearMap(void*, void* peer) {
   delete reinterpret_cast<std::map<std::string, std::string>*>(peer);
 }

dartvlc/api/api.h

@@ -88,6 +88,9 @@ DLLEXPORT void PlayerInsert(int32_t id, int32_t index, const char* type,
 DLLEXPORT void PlayerMove(int32_t id, int32_t initial_index,
                           int32_t final_index);
 
+DLLEXPORT void PlayerTakeSnapshot(int32_t id, const char* file_path,
+                                  int32_t width, int32_t height);
+
 DLLEXPORT const char** MediaParse(Dart_Handle object, const char* type,
                                   const char* resource, int32_t timeout);
 
@@ -120,7 +123,7 @@ DLLEXPORT DartDeviceList* DevicesAll(Dart_Handle object);
 DLLEXPORT struct DartEqualizer* EqualizerCreateEmpty(Dart_Handle object);
 
 DLLEXPORT struct DartEqualizer* EqualizerCreateMode(Dart_Handle object,
-                                                int32_t mode);
+                                                    int32_t mode);
 
 DLLEXPORT void EqualizerSetBandAmp(int32_t id, float band, float amp);
 

dartvlc/internal/setters.h

@@ -197,6 +197,10 @@ class PlayerSetters : public PlayerEvents {
     OnPlaylistCallback();
   }
 
+  void TakeSnapshot(std::string file_path, int32_t width, int32_t height) {
+    vlc_media_player_.takeSnapshot(0, file_path, width, height);
+  }
+
   void SetVideoWidth(int32_t video_width) {
     preferred_video_width_ = video_width;
   }

ffi/lib/src/internal/ffi.dart

@@ -100,6 +100,10 @@ abstract class PlayerFFI {
   static final PlayerMoveDart move = dynamicLibrary
       .lookup<NativeFunction<PlayerMoveCXX>>('PlayerMove')
       .asFunction();
+
+  static final PlayerTakeSnapshotDart takeSnapshot = dynamicLibrary
+      .lookup<NativeFunction<PlayerTakeSnapshotCXX>>('PlayerTakeSnapshot')
+      .asFunction();
 }
 
 abstract class MediaFFI {

ffi/lib/src/internal/typedefs/player.dart

@@ -54,3 +54,7 @@ typedef PlayerMoveCXX = Void Function(
     Int32 id, Int32 initialIndex, Int32 finalIndex);
 typedef PlayerMoveDart = void Function(
     int id, int initialIndex, int finalIndex);
+typedef PlayerTakeSnapshotCXX = Void Function(
+    Int32 id, Pointer<Utf8> filePath, Int32 width, Int32 height);
+typedef PlayerTakeSnapshotDart = void Function(
+    int id, Pointer<Utf8> filePath, int width, int height);

ffi/lib/src/player.dart

@@ -1,3 +1,4 @@
+import 'dart:io';
 import 'dart:async';
 import 'package:ffi/ffi.dart';
 import 'package:dart_vlc_ffi/dart_vlc_ffi.dart';
@@ -269,6 +270,11 @@ class Player {
     PlayerFFI.setEqualizer(this.id, equalizer.id);
   }
 
+  /// Saves snapshot of a video to a desired [File] location.
+  void takeSnapshot(File file, int width, int height) {
+    PlayerFFI.takeSnapshot(this.id, file.path.toNativeUtf8(), width, height);
+  }
+
   /// Destroys the instance of [Player] & closes all [StreamController]s in it.
   void dispose() {
     this.currentController.close();