gst-plugins-vision
GStreamer plugins related to the field of machine vision.
Image acquisition elements
- aptinasrc: Video source for Aptina Imaging (On Semiconductor) dev kits (USB dev kits)
- bitflowsrc: Video source for BitFlow frame grabbers (analog, Camera Link, CoaXPress)
- edtpdvsrc: Video source for EDT PDV frame grabbers (Camera Link)
- euresyssrc: Video source for Euresys PICOLO, DOMINO and GRABLINK series frame grabbers (analog, Camera Link)
- idsueyesrc: Video source for IDS uEye cameras (GigE Vision, USB 2/3, USB3 Vision)
- imperxflexsrc: Video source for IMPERX FrameLink and FrameLink Express frame grabbers (Camera Link)
- imperxsdisrc: Video source for IMPERX HD-SDI Express frame grabbers (SDI, HD-SDI)
- kayasrc: Video source for KAYA Instruments frame grabbers (Camera Link HS, CoaXPress, 10GigE Vision)
- matroxsrc: Video source for MATROX Imaging Library (MIL) (analog, Camera Link, Camera Link HS, CoaXPress, DVI-D, FireWire, GigE Vision, SDI)
- niimaqsrc: Video source for National Instruments IMAQ frame grabbers (analog, parallel digital, Camera Link)
- niimaqdxsrc: Video source for National Instruments IMAQdx library (GigE Vision, FireWire, USB3 Vision)
- phoenixsrc: Video source for Active Silicon Phoenix frame grabbers (HD-SDI, LVDS, Camera Link)
- pixcisrc: Video source for EPIX PIXCI frame grabbers (analog, LVDS, Camera Link)
- pleorasrc: Video source for Pleora eBUS SDK devices (GigE Vision, USB3 Vision)
- pylonsrc: Video source for Basler Pylon sources (GigE Vision, USB3 Vision)
- saperasrc: Video source for Teledyne DALSA frame grabbers (analog, Camera Link, HSLink, LVDS)
Image generation elements
- edtpdvsink: Video sink for EDT PDV Camera Link simulator
- gigesimsink: Video sink for A&B Soft GigESim GigE Vision simulator
- pleorasink: Video sink for Pleora eBUS SDK GigE Vision transmitter
Other elements
- extractcolor: Extract a single color channel
- klvinjector: Inject test synchronous KLV metadata
- klvinspector: Inspect synchronous KLV metadata
- sfx3dnoise: Applies 3D noise to video
- videolevels: Scales monochrome 8- or 16-bit video to 8-bit, via manual setpoints or AGC
Dependencies
- GStreamer 1.2.x
- Specific frame grabber SDKs and/or licenses
Installation
- Install GStreamer 1.2.x or newer (latest should work)
- Build project or download a release from Github (ZIP files under Assets)
- Extract files somewhere
- Create an environment variable
GST_PLUGIN_PATHthat points to where you extracted the files
Examples
Capture from a CoaXPress camera via a Kaya Komodo frame grabber, apply AGC to convert it to 8-bit monochrome, then output the video via A&B Software GigESim which generates GigE Vision video:
gst-launch-1.0 kayasrc ! videolevels auto=continuous ! gigesimsink
Then in another command capture the GigE Vision video via Pleora eBUS and display the video to the screen:
gst-launch-1.0 pleorasrc ! autovideoconvert ! autovideosink
Compiling
- Install Git or download a ZIP archive
- Install CMake
- Install GStreamer distribution or build from source. The installer should set the installation path via GSTREAMER_1_0_ROOT_X86_64 environment variable. If not set, set GSTREAMER_ROOT to your installation, the directory containing bin, lib, etc.
- Install any camera or framegrabber software/SDK for those plugins you wish to build. Check cmake/modules for any paths you may need to set.
- Run the following commands from a terminal or command prompt, assuming CMake
and Git are in your
PATH.
git clone https://github.com/joshdoe/gst-plugins-vision.git
cd gst-plugins-vision
mkdir build
cd build
cmake -G "Visual Studio 15 2017 Win64" ..
- To create a package of all compiled plugins run:
cmake --build . --target PACKAGE
See also
- Aravis, Linux open source GStreamer plugin for GigE Vision and USB3 Vision cameras