libshbeu/README at master · pedwo/libshbeu · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
libshbeu
========

libshbeu: A library for controlling the SH-Mobile BEU.

The [SH-Mobile][0] processor series includes a hardware blend engine unit (BEU)
that supports image overlay.

This source archive contains:

 * src/libshbeu: the libshbeu shared library
 * src/tools: commandline tools

libshbeu API
------------

libshbeu allows both synchronous and asynchronous access to the BEU. The
synchronous API provides a one-shot function shbeu_blend(). The asynchronous API
replaces this with a similar but non-blocking function, shbeu_start_blend(),
and a corresponding shbeu_wait().

Please see doc/libshbeu/html/index.html for API details.


shbeu-display
-------------

shbeu-display is a commandline program for displaying raw image or video files.
It uses the SH-Mobile BEU to perform simultaneous colorspace conversion and
blending on each input frame. It allows the user to pan the foremost image.

	Usage: shbeu-display [options] -i <input file>
	Overlays raw image data using the SH-Mobile BEU and displays on screen.
	Options and input file can be specified for up to 3 inputs, e.g.
	  shbeu-display -s vga -i vga.yuv -s qvga -i qvga.rgb -s qcif -i qcif.rgb

	Input options
	  -c, --input-colorspace (RGB565, RGBx888, NV12, YCbCr420, NV16, YCbCr422)
		                     Specify input colorspace
	  -s, --input-size       Set the input image size (qcif, cif, qvga, vga, d1, 720p)

	Control keys
	  Space key              Read next frame
	  Cursor keys            Pan
	  =                      Reset panning
	  q                      Quit

	Miscellaneous options
	  -h, --help             Display this help and exit
	  -v, --version          Output version information and exit

	File extensions are interpreted as follows unless otherwise specified:
	  .yuv    YCbCr420
	  .420    YCbCr420
	  .422    YCbCr422
	  .rgb    RGB565
	  .565    RGB565
	  .x888   RGBx888


SH-Mobile
---------

The [SH-Mobile][0] processor series includes a hardware video engine unit that
supports colorspace conversion, rotation and scaling. Some models also include
support for camera capture, JPEG processing, and DSP instructions.

[0]: http://www.renesas.com/fmwk.jsp?cnt=sh_mobile_family_landing.jsp&fp=/products/mpumcu/sh_mobile/

Kernel configuration
--------------------

libshbeu uses the Linux kernel UIO support for the SH-Mobile BEU, this is not
in the mainline kernel. You will have to manually add this capability.

The following kernel boot option reserves physically contiguous memory for BEU
use:

    memchunk.beu0=4m

License
-------

See the file COPYING for details.