Interface Libraries                              libmlibmt(3LIB)



NAME
     libmlibmt - multi-threaded mediaLib

SYNOPSIS
     cc [ flag... ] file... -lmlibmt  -lmlib  [ library... ]
     #include 


DESCRIPTION
     Interfaces in this library provide functions for  multimedia
     processing. Multi-threaded (MT) mediaLib is a software layer
     developed on top of mediaLib using OpenMP.  When it is  used
     with  a large data set on a multi-processor system, MT medi-
     aLib will partition data into subsets and process  the  sub-
     sets  in  parallel,  thus  greatly  improving performance of
     applications that use mediaLib.

INTERFACES
     The shared object libmlibmt.so.2 provides the  same  public
     interfaces  as  those defined in libmlib(3LIB). See Intro(3)
     for additional information on shared object interfaces.

USAGE
     There are two ways to use MT mediaLib.

         1.   Pre-load a multi-threaded mediaLib  library  during
              runtime by setting the LDPRELOAD environment vari-
              able as follows before starting  your  application,
              in Bourne/Korn shell:

                LDPRELOAD=libmlibmt.so
                export LDPRELOAD

              or in C shell:

                setenv LDPRELOAD libmlibmt.so

              In this way, you can take advantage of MT  mediaLib
              without rebuilding your application.

         2.   Link your application with a  multi-threaded  medi-
              aLib  library directly as shown under SYNOPSIS.  In
              this way, an MT mediaLib  library  is  always  used
              whenever your application is started.


     The parallelization of MT mediaLib is controlled,  in  part,
     by  the  PARALEL  environment variable.  You can change its
     setting to  adjust  the  degree  of  parallelization  before
     starting your application,  in Bourne/Korn shell:

       PARALEL=n



SunOS 5.11          Last change: 15 Oct 2007                    1






Interface Libraries                              libmlibmt(3LIB)



       export PARALEL



     or in C shell:

       setenv PARALEL n



     where n is a positive integer for number  of  threads.  Note
     that other factors also affect the degree of parallelization
     in MT mediaLib.

FILES
     /usr/lib/libmlibmt.so.2

         shared object


     /usr/lib/64/libmlibmt.so.2

         64-bit shared object


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWmlibt                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     Intro(3), libmlib(3LIB), attributes(5)


     mediaLib User's Manual










SunOS 5.11          Last change: 15 Oct 2007                    2