VisioForge

Ostatnia aktualizacja: listopad 2026

Alternatywa dla AForge.NET: Przewodnik migracji do VisioForge .Net SDK

Zamień porzucony AForge.NET na nowoczesny, wieloplatformowy .NET SDK

AForge.NET to framework open source w C# do przechwytywania wideo, widzenia komputerowego i przetwarzania obrazów, porzucony od lipca 2013 roku i przeznaczony dla .NET Framework 2.0. Ten przewodnik przypisuje każdej przestrzeni nazw AForge.NET odpowiednik w VisioForge .Net SDK dla .NET 6-10. Klasy AForge.Video przechodzą do VideoCaptureCoreX w Video Capture SDK .NET: VideoCaptureDevice staje się VideoCaptureDeviceSourceSettings, MJPEGStream staje się HTTPMJPEGSourceSettings, a ScreenCaptureStream staje się źródłem ekranu dla Windows, macOS lub Linux. Wykrywanie ruchu z AForge.Vision przechodzi do MotionDetectionExSettings w VideoCaptureCoreX lub do CVMotionCellsBlock w Media Blocks SDK. Ponadto AForge.NET nigdy nie miał wykrywania twarzy ani pieszych: VisioForge dodaje detektory twarzy Haar cascade i DNN z rozmyciem chroniącym prywatność oraz detektor pieszych oparty na HOG. Filtry AForge.Imaging odpowiadają częściowo blokom CV VisioForge, takim jak wykrywanie krawędzi Canny i wyrównywanie histogramu, a reszta OpenCvSharp. Na przykład rejestrator z kamery internetowej z alertami ruchu potrzebuje jednego silnika VideoCaptureCoreX zamiast urządzenia przechwytującego, detektora ruchu i osobnego zapisu do pliku.

Dlaczego warto zastąpić AForge.NET?

AForge.NET warto zastąpić, ponieważ framework jest porzucony od lipca 2013 roku i od tego czasu nie otrzymuje aktualizacji, łatek bezpieczeństwa ani poprawek błędów. AForge.NET jest przeznaczony dla .NET Framework 2.0, więc jego kod nie działa w .NET 6-10 bez forków społeczności o różnej jakości. Przechwytywanie wideo opiera się na DirectShow, starszym API systemu Windows, które Microsoft zastąpił przez Media Foundation, dlatego przechwytywanie działa tylko w systemie Windows. Ponadto AForge.NET nie obsługuje H.265, AV1 ani VP9. Na przykład przeniesienie aplikacji do kamery internetowej z .NET Framework na .NET 8 daje dwie możliwości: fork społeczności AForge.Video, który nadal działa tylko w systemie Windows, albo VideoCaptureCoreX, który obsługuje Windows, macOS, Linux, iOS i Android jednym API.

RyzykoWpływ
Brak łatek bezpieczeństwaLuki w przetwarzaniu wideo/obrazów pozostają niezałatane
Brak wsparcia .NET 6+Nie można używać nowoczesnych funkcji .NET, AOT ani wdrożeń wieloplatformowych
Brak obsługi nowych kodekówBrak H.265, AV1, VP9 ani nowoczesnych formatów kontenerowych
Brak społecznościForum zamknięte w kwietniu 2012, brak aktywnych opiekunów
Zależność od DirectShowStarsze API, zastąpione przez Media Foundation
Tylko WindowsNie można celować w macOS, Linux, iOS, Android

AForge.Video → VisioForge Video Capture SDK .Net

Mapowanie klas

Komponent AForge.VideoZamiennik VisioForge
VideoCaptureDeviceVideoCaptureCoreX + VideoCaptureDeviceSourceSettings
MJPEGStreamVideoCaptureCoreX + HTTPMJPEGSourceSettings
JPEGStreamVideoCaptureCoreX + HTTPMJPEGSourceSettings dla strumieni MJPEG; brak bezpośredniego odpowiednika dla adresów URL migawek
ScreenCaptureStreamVideoCaptureCoreX + ScreenCaptureD3D11SourceSettings (Windows), ScreenCaptureMacOSSourceSettings, ScreenCaptureXDisplaySourceSettings (Linux)
FileVideoSourceMediaPlayerCoreX (odtwarzanie) lub VideoEditCoreX (przetwarzanie)
AsyncVideoSourceWbudowane — wszystkie źródła VisioForge są domyślnie asynchroniczne
NewFrameEventArgsZdarzenie OnVideoFrameBuffer

C# Przechwytywanie z kamery internetowej

AForge.NET — przechwytywanie z kamery (przed)

C#
// AForge: Manual device enumeration, callback-based, no recording
var videoDevices = new FilterInfoCollection(FilterCategory.VideoInputDevice);
var videoSource = new VideoCaptureDevice(videoDevices[0].MonikerString);
videoSource.NewFrame += (sender, eventArgs) =>
{
    Bitmap frame = (Bitmap)eventArgs.Frame.Clone();
    pictureBox.Image = frame;
    // Manual recording requires separate code
};
videoSource.Start();

// Cleanup
videoSource.SignalToStop();
videoSource.WaitForStop();

VisioForge — C# przechwytywanie z kamery (po)

C#
// VisioForge: Typed API, async, preview + recording built-in
var capture = new VideoCaptureCoreX(videoView);  // Preview automatic
var devices = await DeviceEnumerator.Shared.VideoSourcesAsync();
capture.Video_Source = new VideoCaptureDeviceSourceSettings(devices[0]);
capture.Outputs_Add(new MP4Output("recording.mp4"), true);
await capture.StartAsync();

// Stop
await capture.StopAsync();

C# Kamera IP RTSP / MJPEG Streaming

AForge.NET — strumień MJPEG (przed)

C#
// AForge: MJPEG only, no RTSP, no reconnection
var stream = new MJPEGStream("http://camera-ip/mjpg/video.mjpg");
stream.NewFrame += (sender, eventArgs) =>
{
    pictureBox.Image = (Bitmap)eventArgs.Frame.Clone();
};
stream.Start();

VisioForge — C# przechwytywanie kamery IP RTSP (po)

C#
// VisioForge: RTSP, RTMP, HLS, MJPEG
// Reconnection is opt-in: configure FallbackSwitch on the source settings
var capture = new VideoCaptureCoreX(videoView);
// RTSPSourceSettings uses a static factory (private constructor)
capture.Video_Source = await RTSPSourceSettings.CreateAsync(
    new Uri("rtsp://camera-ip/stream"), "admin", "pass", audioEnabled: true);
capture.Outputs_Add(new MP4Output("recording.mp4"), true);
await capture.StartAsync();

C# Przechwytywanie i nagrywanie ekranu

AForge.NET — przechwytywanie ekranu (przed)

C#
// AForge: Basic, CPU-intensive, no recording
var screenStream = new ScreenCaptureStream(Screen.PrimaryScreen.Bounds);
screenStream.NewFrame += (sender, eventArgs) =>
{
    pictureBox.Image = (Bitmap)eventArgs.Frame.Clone();
    // Must manually encode and write frames to create a recording
};
screenStream.Start();

VisioForge — C# rejestrator ekranu (po)

C#
// VisioForge: monitor selection, cursor capture, automatic H.264 encoder
var capture = new VideoCaptureCoreX(videoView);
// Windows source; macOS and Linux have their own settings classes
capture.Video_Source = new ScreenCaptureD3D11SourceSettings
{
    MonitorIndex = 0,
    CaptureCursor = true,
    FrameRate = new VideoFrameRate(25)
};
capture.Outputs_Add(new MP4Output("screen.mp4"), true);
await capture.StartAsync();

AForge.Vision → Bloki wizji komputerowej VisioForge

Mapowanie klas

Komponent AForge.VisionZamiennik VisioForge
MotionDetectorMotionDetectionExSettings + OnMotionDetection w VideoCaptureCoreX lub CVMotionCellsBlock w Media Blocks
TwoFramesDifferenceDetectorCVMotionCellsBlock — komórki ruchu oparte na siatce
SimpleBackgroundModelingDetectorObjectDetector (VisioForge.Core.CV) — odejmowanie tła MOG2 (history: 500 frames, variance threshold: 40)
CustomFrameDifferenceDetectorKonfigurowalne CVMotionCellsSettings
MotionAreaHighlightingCVMotionCellsBlock z Display = true — rysuje komórki, w których wykryto ruch
GridMotionAreaProcessingCVMotionCellsBlock — siatka ruchu ustawiana przez GridSize, od 8 do 32 komórek na oś
BlobCounterCarCounter (VisioForge.Core.CV) — śledzenie blobów, wykrywanie konturów, zliczanie pojazdów na linii śledzenia

C# Wykrywanie ruchu i obiektów

AForge.NET — wykrywanie ruchu (przed)

C#
// AForge: Manual frame processing, no recording integration
var detector = new MotionDetector(
    new TwoFramesDifferenceDetector(),
    new MotionAreaHighlighting());

videoSource.NewFrame += (sender, eventArgs) =>
{
    float motionLevel = detector.ProcessFrame((Bitmap)eventArgs.Frame.Clone());
    if (motionLevel > 0.02f)
        Console.WriteLine($"Motion: {motionLevel * 100:F1}%");
};

VisioForge — zdarzeniowe wykrywanie ruchu (Video Capture SDK)

C#
// Integrated detection during capture + recording
var capture = new VideoCaptureCoreX(videoView);
capture.Video_Source = new VideoCaptureDeviceSourceSettings(devices[0]);
capture.Outputs_Add(new MP4Output("recording.mp4"), true);

capture.Motion_Detection = new MotionDetectionExSettings();
capture.OnMotionDetection += (s, e) =>
{
    if (e.LevelPercent > 30)
        Console.WriteLine($"Motion: {e.LevelPercent}%");
};

await capture.StartAsync();

VisioForge — CVMotionCellsBlock (potok MediaBlocks)

C#
// Motion cells grid: raises MotionDetected as cells change
var settings = new CVMotionCellsSettings
{
    Display = true,
    GridSize = new Size(16, 16)
};
var detector = new CVMotionCellsBlock(settings);
detector.MotionDetected += (s, e) => Console.WriteLine("Motion");

C# Wykrywanie twarzy i pieszych (niedostępne w AForge)

Mapowanie klas

FunkcjaBlok VisioForge
Wykrywanie twarzy kaskadą HaarCascadeFaceDetectorBlock — wykrywanie twarzy frontalnej/profilowej, oczu, nosa, ust
Wykrywanie twarzy DNNDNNFaceDetectorBlock — model Caffe SSD, filtrowanie ufności
Wykrywanie twarzy DLibFaceDetectorBlock (VisioForge.Core.CVD) — detektor twarzy frontalnej DLib HOG+SVM
Wykrywanie pieszychPedestrianDetector — wbudowany detektor osób HOG+SVM, dodawany przez Video_Processors
Wykrywanie zasłonięcia obiektywuCameraCoveredDetector — wykrywanie krawędzi Canny

C# Wykrywanie twarzy

AForge.NET (przed)

C#
// AForge had no built-in face detection — required manual Haar cascade code
// or using Accord.NET's HaarObjectDetector on top of AForge frames

VisioForge — wykrywanie twarzy kaskadą Haar

C#
var settings = new CascadeFaceDetectorSettings
{
    DetectFrontalFace = true,
    DetectProfileFace = true,
    DetectEyes = true,
    DetectNose = true,
    DetectMouth = true,
    MinFaceSize = new Size(30, 30),
    ScaleFactor = 1.1f,
    DrawEnabled = true,
    Blur = false,    // set true for privacy blur
    Pixelate = false // set true for privacy pixelation
};
var detector = new CascadeFaceDetectorBlock(settings);

VisioForge — detektor twarzy DNN

C#
var settings = new DNNFaceDetectorSettings
{
    Confidence = 0.25f,
    DrawEnabled = true,
    Blur = true  // built-in privacy blur
};
var detector = new DNNFaceDetectorBlock(settings);

VisioForge — detektor twarzy DLib

C#
var settings = new FaceDetectorSettings
{
    DrawEnabled = true,
    MinFaceSize = new Size(30, 30)
};
var detector = new FaceDetectorBlock(settings);

C# Wykrywanie pieszych

AForge.NET (przed)

C#
// AForge had no pedestrian detection — required manual HOG+SVM implementation

VisioForge — wykrywanie pieszych (po)

C#
var detector = new PedestrianDetector
{
    DrawEnabled = true,
    VideoScale = 1.0,
    FramesToSkip = 2
};
detector.Init();
detector.OnPedestrianDetected += OnPedestrianDetected;
capture.Video_Processors.Add(detector);
// HOG descriptors + SVM classifier

AForge.Imaging → VisioForge CV + OpenCvSharp

Mapowanie klas

Funkcja AForge.ImagingVisioForge wbudowaneSamodzielne OpenCvSharp
GaussianBlurCVSmoothBlock lub CVProcess.BlurRegion() dla regionu (kernel 23x23)Cv2.GaussianBlur()
PixellateCVProcess.PixelateRegion()Niestandardowe zmniejszanie/powiększanie
CannyEdgeDetectorCVEdgeDetectBlockCv2.Canny()
Erosion / DilationCVErodeBlock / CVDilateBlockCv2.Erode() / Cv2.Dilate()
BlobCounterCarCounter — wykrywanie konturów, filtrowanie powierzchni/proporcji, otoczka wypukłaCv2.FindContours()
GrayscaleWbudowana konwersja BGR→Gray we wszystkich detektorachCv2.CvtColor()
ThresholdWbudowane progowanie binarne w ObjectDetector i CarCounterCv2.Threshold()
ResizeBilinearWbudowane skalowanie wideo we wszystkich ustawieniach detektorówCv2.Resize()
HistogramEqualizationCVEqualizeHistogramBlockCv2.EqualizeHist()
HSLFiltering / filtry kolorów—Cv2.InRange() / Cv2.CvtColor()
HoughLineTransformation—Cv2.HoughLinesP()
SobelEdgeDetectorCVSobelBlockCv2.Sobel()
Dopasowywanie szablonówCVTemplateMatchBlockCv2.MatchTemplate()

Lista kontrolna migracji

  • Inwentaryzacja referencji AForge — Znajdź wszystkie `using AForge.*` w projekcie
  • Zainstaluj pakiety NuGet VisioForge
  • Zamień klasy źródeł wideo
  • Zamień wykrywanie ruchu
  • Zamień wykrywanie twarzy
  • Zamień wykrywanie blobów/obiektów
  • Usuń ręczne pętle klatek
  • Dodaj nagrywanie/streaming
  • Celuj w nowoczesny .NET — .NET 6-10
  • Testuj wieloplatformowo
  • Dla przetwarzania obrazów — VisioForge CV obejmuje rozmycie, pikselizację, Canny, Sobel, morfologię, dopasowywanie szablonów; użyj OpenCvSharp dla dodatkowych filtrów

Co zyskujesz po migracji

MożliwośćAForge.NETPo migracji
Framework.NET Framework 2.0.NET 6-10
PlatformyTylko WindowsWindows, macOS, Linux, iOS, Android
Przechwytywanie wideoPodstawowy DirectShowProfesjonalny SDK z asynchronicznym API
NagrywanieRęczna implementacjaWbudowane (MP4, MKV, AVI, WebM)
Kodowanie sprzętoweBrakNVENC, QSV, AMF, VideoToolbox
StreamingBrakRTMP, HLS, SRT, NDI
Efekty audioBrak40+ łącznie w obu silnikach (EQ, reverb, chorus, 3D)
Efekty wideoBrakPotok GPU + CPU
Wykrywanie twarzyBrakHaar + DNN (Caffe SSD) z rozmyciem/pikselizacją; DLib HOG tylko wykrywanie
Wykrywanie ruchuPodstawowe różnicowanie klatekOdejmowanie tła MOG2 + śledzenie obiektów z ID
Wykrywanie pieszychBrakWbudowany detektor osób HOG+SVM
Kamery IPTylko MJPEGRTSP, RTMP, HLS, ONVIF
Kamera wirtualnaBrakWyjście do Zoom/Teams/OBS
UtrzymaniePorzucony (2013)Aktywny rozwój
BezpieczeństwoBez łatekRegularne aktualizacje

Często zadawane pytania

Czy AForge.NET jest nadal utrzymywany?
Nie. AForge.NET został porzucony od lipca 2013 bez aktualizacji, łatek bezpieczeństwa ani wsparcia .NET 6+. Istnieją forki społecznościowe, ale różnią się jakością i utrzymaniem. Użyj VisioForge .Net SDK jako nowoczesnej alternatywy dla AForge.NET.
Jaka jest najlepsza alternatywa dla AForge.NET do przechwytywania wideo w C#?
VisioForge Video Capture SDK .Net zastępuje AForge.Video nowoczesnym asynchronicznym API obsługującym kamery internetowe, kamery IP (RTSP/ONVIF), przechwytywanie ekranu i wyjście do MP4, WebM i innych formatów na .NET 6-10.
Czy VisioForge zastępuje filtry AForge.Imaging?
Częściowo. VisioForge CV zawiera rozmycie, pikselizację, wykrywanie krawędzi Canny i Sobel, operacje morfologiczne, konwersję do skali szarości, wyrównywanie histogramu i dopasowywanie szablonów. Dla pozostałych filtrów obrazu (Hough, filtrowanie kolorów) użyj OpenCvSharp razem z VisioForge.
Czy mogę używać VisioForge do wykrywania twarzy w C# bez AForge?
Tak. VisioForge .Net SDK zawiera trzy wbudowane silniki wykrywania twarzy — kaskadę Haar, oparty na DNN i oparty na DLib; silniki Haar i DNN mogą też rozmywać lub pikselizować wykryte twarze dla ochrony prywatności. Nie jest wymagana zależność od AForge ani Accord.NET.
Czy VisioForge obsługuje .NET 6, .NET 8, .NET 9 i .NET 10?
Tak. Wszystkie pakiety VisioForge .Net SDK obsługują .NET 6 do .NET 10, w tym wdrożenia wieloplatformowe na Windows, macOS, Linux, iOS i Android.
Czy mogę migrować z AForge.NET stopniowo?
Tak. SDK VisioForge mogą współistnieć z pakietami AForge.NET podczas migracji. Zastępuj jeden komponent na raz — zacznij od przechwytywania wideo, potem wykrywanie, potem przetwarzanie obrazów — i usuwaj pakiety NuGet AForge po zakończeniu każdego kroku.

Rozpocznij migrację

Powiązane przewodniki migracji