man pages section 3: Library Interfaces and Headers

libmlib_mt(3LIB)

Name

libmlib_mt– multi-threaded mediaLib

Synopsis

cc [ flag... ] file... -lmlib_mt  -lmlib  [ library... ]
#include <mlib.h>

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 mediaLib will partition data into subsets and process the subsets in parallel, thus greatly improving performance of applications that use mediaLib.

INTERFACES

The shared object libmlib_mt.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.

Pre-load a multi-threaded mediaLib library during runtime by setting the LD_PRELOAD environment variable as follows before starting your application, in Bourne/Korn shell:
```
LD_PRELOAD=libmlib_mt.so
export LD_PRELOAD
```
or in C shell:
```
setenv LD_PRELOAD libmlib_mt.so
```
In this way, you can take advantage of MT mediaLib without rebuilding your application.
Link your application with a multi-threaded mediaLib 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 PARALLEL environment variable. You can change its setting to adjust the degree of parallelization before starting your application, in Bourne/Korn shell:

PARALLEL=n
export PARALLEL

or in C shell:

setenv PARALLEL 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/libmlib_mt.so.2: shared object
/usr/lib/64/libmlib_mt.so.2: 64-bit shared object

Attributes

See attributes(5) for descriptions of the following attributes:

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