gst-sh-mobile
=============

This package contains hardware accelerated GStreamer elements for SH-Mobile
devices that perform video encode, decode, scale and colorspace conversion.

Installation
------------

This archive uses GNU autotools. For full usage instructions see the file
INSTALL. The conventional build procedure applies:

    $ ./configure
    $ make
    $ make install

If INSTALL and configure are missing, you are using source from the repository
and need to run the following command first:

    $ autoreconf -vif


Usage
-----

Encode file to file:

$ gst-launch \
	filesrc location=source_video_to_encode \
	! gst-sh-mobile-enc cntl_file=encoder_control_file.ctl \
	! filesink location=encoded_video_file

Encode camera to H.264 Elementary Stream file with LCD preview:

$ gst-launch \
	gst-sh-mobile-camera-enc cntl_file=k264-v4l2.ctl preview=1 \
	! video/x-h264,width=640,height=480,framerate=30/1 \
	! filesink location=encoded_video.h264

Encode audio & video into an AVI file with LCD preview:

$ gst-launch \
	alsasrc ! audio/x-raw-int,rate=44100,channels=2 \
	! queue ! audioconvert \
	! queue ! mux. \
	gst-sh-mobile-camera-enc cntl_file=k264-v4l2.ctl preview=1 \
	! video/x-h264,width=640,height=480,framerate=24/1 \
	! queue ! mux. \
	avimux name=mux ! filesink location=video_file.avi

Decode video portion of an AVI file and playback on the screen:

$ gst-launch \
	filesrc location=video_file.avi \
	! avidemux name=demux \
	demux.video_00 ! queue ! gst-sh-mobile-dec ! gst-sh-mobile-sink


License
-------

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Library General Public License for more details.

You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA  02110-1301 USA

See the file COPYING for details.