GStreamer Based Image Signal Processor - User Guide

From RidgeRun Developer Connection
Jump to: navigation, search


Previous: Docs Index Next: User Guide/Installation





User Guide Overview

On this wiki page, you can find information related to the GStreamer elements that Gst-isp provides.

Debayer plugin

Plugin Details

Factory Details:
 Rank                     none (0)
 Long-name                OpenCL Filter
 Klass                    Filter/Effect/Video
 Description              Runs a generic OpenCL kernel
 Author                   Michael Gruner <michael.gruner@ridgerun.com>
                          Adrian Cervantes <adrian.cervantes@ridgerun.com>

Plugin Details:
 Name                     opencl
 Description              gst-debayer 
 Filename                 /usr/lib/gstreamer-1.0/libgstopencl.so
 Version                  0.0.0
 License                  Proprietary
 Source module            gst-opencl
 Binary package           RidgeRun
 Origin URL               http://www.ridgerun.com

GObject
+----GInitiallyUnowned
      +----GstObject
            +----GstElement
                  +----GstBaseTransform
                        +----GstVideoFilter
                              +----GstOclFilter
                                    +----GstIspClDebayer 

Sink and Src capabilities

In this part of the wiki, you can see which src and sink parameters the plugin can negotiate, like resolution, color format, and framerate.

Pad Templates:
 SRC template: 'src'
   Availability: Always
   Capabilities:
     video/x-raw
                format: RGBA
                 width: [ 1, 2147483647 ]
                height: [ 1, 2147483647 ]
             framerate: [ 0/1, 2147483647/1 ]

 SINK template: 'sink'
   Availability: Always
   Capabilities:
     video/x-bayer
                format: { (string)bggr }
                 width: [ 1, 2147483647 ]
                height: [ 1, 2147483647 ]
             framerate: [ 0/1, 2147483647/1 ]

In order to see how to use those capabilities, you can go to the GStreamer pipelines examples section: GStreamer-Pipelines

Plugin Features

Element Properties:

name                : The name of the object
                      flags: readable, writable
                      String. Default: "ocldebayerisp0"
parent              : The parent of the object
                      flags: readable, writable
                      Object of type "GstObject"
qos                 : Handle Quality-of-Service events
                      flags: readable, writable
                      Boolean. Default: true
platform            : OpenCL platform
                      flags: readable, writable
                      Enum "GstOclPlatformsEnum" Default: 0, "Vivante OpenCL Platform"
                         (0): Vivante OpenCL Platform - Vivante OpenCL Platform OpenCL 1.2 V6.2.4.p1.150331
device              : OpenCL device
                      flags: readable, writable
                      Enum "GstOclDevicesEnum" Default: 0, "Vivante Corporation GPU"

In order to see how to use those properties, you can go to the GStreamer pipelines examples section: GStreamer-Pipelines

Plugin Info

In order to see the complete information about the plugin once you have installed it, you can type:

gst-inspect-1.0 ispcldebayer

Color Space Conversion plugin

Plugin Details

Factory Details:
  Rank                     none (0)
  Long-name                OpenCL Filter
  Klass                    Filter/Effect/Video
  Description              Runs a generic OpenCL kernel
  Author                   Michael Gruner <michael.gruner@ridgerun.com>
                           Carolina Trejos <carolina.trejos@ridgerun.com>
Plugin Details:
  Name                     opencl
  Description              Color conversion plugin from RGBA to NV12 based on OpenCL
  Filename                 /usr/lib/gstreamer-1.0/libgstopencl.so
  Version                  0.0.0
  License                  Proprietary
  Source module            gst-opencl
  Binary package           RidgeRun
  Origin URL               http://www.ridgerun.com

GObject
 +----GInitiallyUnowned
       +----GstObject
             +----GstElement
                   +----GstBaseTransform
                         +----GstVideoFilter
                               +----GstOclFilter
                                     +----GstIspClCsc

Sink and Src capabilities

In this part of the wiki you can see which src and sink parameters the plugin can negotiate, like resolution, color format, and framerate.

Pad Templates:
  SINK template: 'sink'
    Availability: Always
    Capabilities:
      video/x-raw
                 format: { (string)RGBA, (string)NV12 }
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]
  
  SRC template: 'src'
    Availability: Always
    Capabilities:
      video/x-raw
                 format: { (string)RGBA, (string)NV12 }
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]

In order to see how to use those capabilities, you can go to the GStreamer pipelines examples section: GStreamer-Pipelines

Plugin Features

Element Properties:

 name                : The name of the object
                       flags: readable, writable
                       String. Default: "oclcsc0"
 parent              : The parent of the object
                       flags: readable, writable
                       Object of type "GstObject"
 qos                 : Handle Quality-of-Service events
                       flags: readable, writable
                       Boolean. Default: true
 platform            : OpenCL platform
                       flags: readable, writable
                       Enum "GstOclPlatformsEnum" Default: 0, "Vivante OpenCL Platform"
                          (0): Vivante OpenCL Platform - Vivante OpenCL Platform OpenCL 1.2 V6.2.4.p1.150331
 device              : OpenCL device
                       flags: readable, writable
                       Enum "GstOclDevicesEnum" Default: 0, "Vivante Corporation GPU"
                          (0): Vivante Corporation GPU - Vivante OpenCL Device GC7000L.6214.0000 

In order to see how to use those properties, you can go to the GStreamer pipelines examples section: GStreamer-Pipelines

Plugin Info

In order to see the complete information about the plugin once you have install it, you can type:

gst-inspect-1.0 ispclcsc

White balance

Plugin Details

Factory Details:
  Rank                     none (0)
  Long-name                AWB kernel
  Klass                    Filter/Effect/Video
  Description              Auto white balance
  Author                   Michael Gruner <michael.gruner@ridgerun.com>,        
                           Adrian Cervantes <adrian.cervantes@ridgerun.com>

Plugin Details:
  Name                     isp
  Description              Image Signal Processor based on OpenCl and OpenVX
  Filename                 /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstisp.so
  Version                  0.5.0
  License                  Proprietary
  Source module            gst-isp
  Binary package           gst-isp
  Origin URL               http://ridgerun.com/

GObject
 +----GInitiallyUnowned
       +----GstObject
             +----GstElement
                   +----GstBaseTransform
                         +----GstVideoFilter
                               +----GstOclFilter
                                     +----GstIspclawb

Sink and Src capabilities

In this part of the wiki you can see which src and sink parameters the plugin can negotiate, like resolution, color format, and framerate.

Pad Templates:
  SRC template: 'src'
    Availability: Always
    Capabilities:
      video/x-bayer
                 format: { (string)bggr }
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]
  
  SINK template: 'sink'
    Availability: Always
    Capabilities:
      video/x-bayer
                 format: { (string)bggr }
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]

In order to see how to use those capabilities, you can go to the GStreamer pipelines examples section: GStreamer-Pipelines

Plugin Features

Element Properties:

name                : The name of the object
                      flags: readable, writable
                      String. Default: "ocldebayerisp0"
parent              : The parent of the object
                      flags: readable, writable
                      Object of type "GstObject"
qos                 : Handle Quality-of-Service events
                      flags: readable, writable
                      Boolean. Default: true
platform            : OpenCL platform
                      flags: readable, writable
                      Enum "GstOclPlatformsEnum" Default: 0, "Vivante OpenCL Platform"
                         (0): Vivante OpenCL Platform - Vivante OpenCL Platform OpenCL 1.2 V6.2.4.p1.150331
device              : OpenCL device
                      flags: readable, writable
                      Enum "GstOclDevicesEnum" Default: 0, "Vivante Corporation GPU"

In order to see how to use those properties, you can go to the GStreamer pipelines examples section: GStreamer-Pipelines

Plugin Info

In order to see the complete information about the plugin once you have install it, you can type:

gst-inspect-1.0 ispclawb

Histogram equalization

Plugin Details

Factory Details:
  Rank                     none (0)
  Long-name                EQ kernel
  Klass                    Filter/Effect/Video
  Description              Histogram equalization
  Author                   Michael Gruner <michael.gruner@ridgerun.com>,        
                           Adrian Cervantes <adrian.cervantes@ridgerun.com>

Plugin Details:
  Name                     isp
  Description              Image Signal Processor based on OpenCl and OpenVX
  Filename                 /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstisp.so
  Version                  0.5.0
  License                  Proprietary
  Source module            gst-isp
  Binary package           gst-isp
  Origin URL               http://ridgerun.com/

GObject
 +----GInitiallyUnowned
       +----GstObject
             +----GstElement
                   +----GstBaseTransform
                         +----GstVideoFilter
                               +----GstOclFilter
                                     +----GstIspcleq


Sink and Src capabilities

In this part of the wiki you can see which src and sink parameters the plugin can negotiate, like resolution, color format, and framerate.

Pad Templates:
  SRC template: 'src'
    Availability: Always
    Capabilities:
      video/x-bayer
                 format: { (string)bggr }
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]
      video/x-raw
                 format: { (string)GRAY8, (string)NV12 }
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]
  
  SINK template: 'sink'
    Availability: Always
    Capabilities:
      video/x-bayer
                 format: { (string)bggr }
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]
      video/x-raw
                 format: { (string)GRAY8, (string)NV12 }
                  width: [ 1, 2147483647 ]
                 height: [ 1, 2147483647 ]
              framerate: [ 0/1, 2147483647/1 ]

In order to see how to use those capabilities, you can go to the GStreamer pipelines examples section: GStreamer-Pipelines

Plugin Features

Element Properties:

name                : The name of the object
                      flags: readable, writable
                      String. Default: "ocldebayerisp0"
parent              : The parent of the object
                      flags: readable, writable
                      Object of type "GstObject"
qos                 : Handle Quality-of-Service events
                      flags: readable, writable
                      Boolean. Default: true
platform            : OpenCL platform
                      flags: readable, writable
                      Enum "GstOclPlatformsEnum" Default: 0, "Vivante OpenCL Platform"
                         (0): Vivante OpenCL Platform - Vivante OpenCL Platform OpenCL 1.2 V6.2.4.p1.150331
device              : OpenCL device
                      flags: readable, writable
                      Enum "GstOclDevicesEnum" Default: 0, "Vivante Corporation GPU"
average             : Use components average histogram (only valid for bayer format)
                      flags: readable, writable
                      Boolean. Default: true

In order to see how to use those properties, you can go to the GStreamer pipelines examples section: GStreamer-Pipelines

Plugin Info

In order to see the complete information about the plugin once you have install it, you can type:

gst-inspect-1.0 ispcleq

Noise reduction

Under development. Coming soon!

Bad pixel correction

Under development. Coming soon!

Plugin Info

In order to see the complete information about the plugin once you have install it, you can type:

gst-inspect-1.0 isp

The output with the isp element info would be:

Plugin Details:
  Name                     isp
  Description              Image Signal Processor based on OpenCl and OpenVX
  Filename                 /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstisp.so
  Version                  0.5.0
  License                  Proprietary
  Source module            gst-isp
  Binary package           gst-isp
  Origin URL               http://ridgerun.com/

  ispclcsc: CSC kernel
  ispclawb: AWB kernel
  ispcldebayer: Debayer Kernel
  ispcleq: EQ kernel

  4 features:
  +-- 4 elements


Previous: Docs Index Next: User Guide/Installation