Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Speykious/SeeShark
Simple C# camera library.
https://github.com/Speykious/SeeShark
camera csharp dotnet ffmpeg ffmpeg-wrapper video
Last synced: 27 days ago
JSON representation
Simple C# camera library.
- Host: GitHub
- URL: https://github.com/Speykious/SeeShark
- Owner: Speykious
- License: bsd-3-clause
- Created: 2021-11-04T14:21:27.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-03-05T16:33:19.000Z (about 1 year ago)
- Last Synced: 2024-04-13T20:15:44.006Z (about 1 month ago)
- Topics: camera, csharp, dotnet, ffmpeg, ffmpeg-wrapper, video
- Language: C#
- Homepage:
- Size: 382 KB
- Stars: 136
- Watchers: 7
- Forks: 10
- Open Issues: 10
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Lists
- awesome-dotnet - SeeShark - Cross-platform camera library for .NET using FFmpeg supporting over 190 pixel formats (Media)
README
# SeeShark
> Simple C# camera and display library.
When you SeeShark, you C#!
SeeShark is a simple cross-platform .NET library for handling camera and screen display inputs on Linux, Windows and MacOS.
Using FFmpeg, it allows you to enumerate camera and display devices and decode raw frames in 206 different pixel formats (because that's how powerful FFmpeg is!).
Features include:
- Zero-copy.
- Memory-safe.
- Cross platform (Tested on Windows and Linux, might work on more platforms like MacOS).
- Managing camera and display devices.
- Control framerate, resolution and input format.
- Notifies the application if devices get connected/disconnected.
- Provides synchronous (method-driven) and asynchronous (event-driven) code flow.
- Supports 206 different pixel formats.
- Conversion of a frame from a pixel format to another.
- Scaling frames.
- Access to raw pixel data.
Features **don't** include:
- Saving a frame as an image (here's a [wiki page on how to do it](https://github.com/Speykious/SeeShark/wiki/Saving-images) using ImageSharp).
- Recording a video stream to a video file.
- Managing audio devices.
***
## Example code
```cs
using System;
using System.Threading;
using SeeShark;
using SeeShark.FFmpeg;
namespace YourProgram;
// This program will display camera frames info for 10 seconds.
class Program
{
static void Main(string[] args)
{
// Create a CameraManager to manage camera devices
using var manager = new CameraManager();
// Get the first camera available
using var camera = manager.GetCamera(0);
// Attach your callback to the camera's frame event handler
camera.OnFrame += frameEventHandler;
// Start decoding frames asynchronously
camera.StartCapture();
// Just wait a bit
Thread.Sleep(TimeSpan.FromSeconds(10));
// Stop decoding frames
camera.StopCapture();
}
// Create a callback for decoded camera frames
private static void frameEventHandler(object? _sender, FrameEventArgs e)
{
// Only care about new frames
if (e.Status != DecodeStatus.NewFrame)
return;
Frame frame = e.Frame;
// Get information and raw data from a frame
Console.WriteLine($"New frame ({frame.Width}x{frame.Height} | {frame.PixelFormat})");
Console.WriteLine($"Length of raw data: {frame.RawData.Length} bytes");
}
}
```
You can also look at our overcommented [`SeeShark.Example.Ascii`](./SeeShark.Example.Ascii/) program which displays your camera input with ASCII characters.
See demo of the example below.
[](https://i.imgur.com/YnW5Nn2.gif)
***
## Contribute
You can request a feature or fix a bug by reporting an issue.
If you feel like fixing a bug or implementing a feature, you can fork this repository and make a pull request at any time!
## Vignette
This library was previously hosted on https://github.com/vignetteapp/SeeShark. It was first made to be used in Vignette's vtuber application. Now, it is its own self-contained library!
## License
This library is licensed under the BSD 3-Clause License.
See [LICENSE](LICENSE) for details.