SeeShark

Simple C# camera library.

Programming language: C#

License: BSD 3-clause "New" or "Revised" License

Tags: Media    

README

SeeShark

Simple C# camera library.

When you SeeShark, you C#!

SeeShark is a simple cross-platform .NET library for handling camera inputs on Linux, Windows and MacOS.

Using FFmpeg, it allows you to enumerate camera devices and decode raw frames in 199 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 devices.
• Notifies the application if devices get connected/disconnected.
• Event-driven code flow.
• Supports 199 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 camera stream to a video file.
• Manage audio devices.

---

Example code

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
            camera.StartCapture();

            // The camera decodes frames asynchronously.
            Thread.Sleep(TimeSpan.FromSeconds(10));

            // Stop decoding frames
            camera.StopCapture();
        }

        // Create a callback for decoded camera frames
        public 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.

---

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!

You can also join our discord server where we talk about our different projects. This one has a particular #Project SeeShark thread that can be found under the #main channel.

License

This library is licensed under the BSD 3-Clause License. See [LICENSE](LICENSE) for details.