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 using ImageSharp).
- Recording a video stream to a video file.
- Managing audio devices.
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
program which displays your camera input with ASCII characters.
See demo of the example below.
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!
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!
This library is licensed under the BSD 3-Clause License. See LICENSE for details.