1. Introduction
   1.1. Project/Component Working Name:

        gst-python

   1.2. Name of Document Author/Supplier:

        Brian Cameron

   1.3. Date of This Document:

        02/11/2009
        
   1.3.1. Date this project was conceived:

        September, 2003

   1.4. Name of Major Document Customer(s)/Consumer(s):

        1.4.1. The PAC or CPT you expect to review your project:

                Solaris PAC

        1.4.2. The ARC(s) you expect to review your project:

                LSARC

        1.4.3. The Director/VP who is "Sponsoring" this project:

                robert.odea@sun.com

        1.4.4. The name of your business unit:

                OPG / OpenSource.

   1.5. Email Aliases:
        1.5.1. Responsible Manager:

                leo.binchy@sun.com

        1.5.2. Responsible Engineer:

                darren.kenny@sun.com
                brian.cameron@sun.com

        1.5.3. Marketing Manager:

                dan.roberts@sun.com

        1.5.4. Interest List:

                desktop-discuss@opensolaris.org

4. Technical Description:
    4.1. Details:

        gst-python is a wrapper for the GStreamer library for use in Python
        programs.  This library helps users construct graphs of media-handling
        components, ranging from simple audio playback to complex audio
        (mixing) and video (non-linear editing) processing.  It handles details
        such as managing memory and type casting.

        Since GStreamer library interfaces are Volatile, the GStreamer python
        binding Exported Interfaces are also Volatile.

        The version being integrated is 0.10.10.

        The defs files installed to /usr/share/gst-python/0.10/defs are
        object definition files which provide an easy way to parse what
        API is available in a library.  Such defs files are parsed by
        pygtk-codegen-2.0 to build a .c file containing the actual python
        bindings.

        The defs files are there to help with type conversion and to allow
        overriding some of the interfaces to make them more friendly to the
        target language that's being bound.   For example, some modules use
        classes and method arguments from dependent modules (libgnomeui uses
        classes and method arguments which use GTK+ types).  So these defs
        file would be used if building any bindings which might depend on
        gst-python.

        According to the pygtk team, the bindings generation process for python
        will change when the gobject library has full introspection support.
        So the defs files should remain Project Private until this is 
        reworked.

    4.2. Bug/RFE Number(s):

        None.

    4.3. In Scope:

        See above.

    4.4. Out of Scope:

        See above.

    4.5. Interfaces:

        --------------------------------------------------------------------
        Exported                    Stability       Comments                
        --------------------------------------------------------------------
        SUNWgst-python              Uncommitted     Package name            
        /usr/lib/pkgconfig/gst-python-0.10.pc
                                    Uncommitted     pkgconfig file
        /usr/lib/python2.4/vendor-packages/gst-0.10/* 
                                    Volatile        GST python module
        /usr/share/gst-python/0.10/defs             GST python defs files
                                    Consolidation
                                    Private       
                                                                            
                                                                            
        --------------------------------------------------------------------
        Imported                    Stability       Comments                
        --------------------------------------------------------------------
        GStreamer                   Volatile        LSARC 2004/713          
        Python 2.4.x                Contracted      PSARC 2005/532
                                    External
        PyGobject                   Evolving        LSARC 2005/506
        PyGtk                       Evolving        LSARC 2005/506

    4.6. Doc Impact:

        Man page will be provided pointing to the on-line API documentation.

    4.7. Admin/Config Impact:

        None.

    4.8. HA Impact:

        None.

    4.9. I18N/L10N Impact:

        The JDS team and the G11N are working together to evaluation and
        provide I18N/L10N support.

    4.10. Packaging & Delivery:
    
        Adds new package, SUNWgst-python, approx 1.2 MB.
        Package will go into SUNWCall, SUNWCXall and SUNWCprog clusters.

    4.11. Security Impact:

        None.

    4.12. Dependencies:

        The following versions of the imported interfaces are required:
        Python                  >= 2.4

5. Reference Documents:

        gst-python API documentation
                        http://pygstdocs.berlios.de/