<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html>
<!-- $Id: header.html 8799 2010-06-28 04:12:42Z jpgr87 $ -->
<HEAD>
<meta HTTP-EQUIV="Content-Type" CONTENT="text/html;CHARSET=utf-8">
<meta name="keywords" content="stage, robot, simulation, player, player/stage">
<link href="doxygen.css" rel="stylesheet" type="text/css">
<style type="text/css">
.floatright { float: right; margin: 0 0 1em 1em; }
body {
font-family: sans-serif;
#font-family: Geneva, Verdana, Helvetica, Arial, sans-serif;
background-color: #FFF;
color:#000;
}
a:link {
color: #A00;
}
a:visited {
color: #800;
}
a { text-decoration: none; }
a:hover { text-decoration: underline; }
.timestamp { text-align:right; background-color: #DDD; font-size:75%;}
h1 {
font-size:160%;
}
h2 {
font-size:110%;
#color: #FFF;
#background-color: #666;
#padding:3px;
}
h3 { text-align:left; }
img {
border: 0;
}
ul.menu {
position:relative;
left:-2.5em;
margin-bottom:0px;
margin-top:0px;
}
ul.menu1 {
position:relative;
left:-2.1em;
margin-bottom:0px;
margin-top:0px;
}
li.menu {
list-style-type: none;
position:relative;
#left:-0.5em;
}
#sidebar { position: absolute; left:0px; padding:2em; top:0em; width:12em;}
#content { position: absolute; left:12em; top:0em; padding-left:3em; padding-right:3em; padding-bottom:2em; margin-top:1em; margin-right:2em; }
div.box { background-color:#EEE; border: 1px solid #000; padding: 0.5ex 0.4em 0.5ex 0.6em; margin:1em; }
div.title { font-weight:bold; background-color:#eee; margin-bottom:2px;}
div.topbar { position: absolute; top:0px; left:9em; margin:1em; }
</style>
<TITLE>Player Manual</TITLE>
</HEAD>
<body>
<div id="sidebar">
<h2 style="text-align:center;">
<a href="index.html">
<img width=140 src="http://playerstage.sourceforge.net/images/player_button_v3.png" alt="Player logo"><br></a>
</h2>
<div class="box">
<div class=title>Player</div>
<ul class=menu>
<li class=menu><a href="index.html">Frontpage</a>
<li class=menu><a href="modules.html">Contents</a>
</ul>
</div>
<div class="box">
<div class=title>User</div>
<ul class=menu>
<li class=menu><a href="install.html">Installation</a>
<li class=menu><a href="start.html">Quick start</a>
<li class=menu><a href="supported_hardware.html">Supported devices</a>
<li class=menu><a href="group__tutorials.html">Tutorials</a>
<li class=menu><a href="group__utils.html">Utilities</a>
<li class=menu><a href="group__clientlibs.html">Client libraries</a>
<li class=menu><a href="http://playerstage.sourceforge.net/wiki/Basic_FAQ">FAQ</a>
<li class=menu><a href="help.html">Help</a>
</ul>
</div>
<div class=box>
<div class="title">Developer</div>
<ul class=menu>
<li class=menu><a href="architecture.html">Architecture</a>
<li class=menu><a href="group__libplayercore.html">libplayercore</a>
<ul class=menu1>
<li class=menu><a href="group__interfaces.html">interfaces</a></li>
</ul>
<li class=menu><a href="group__libplayerdrivers.html">libplayerdrivers</a>
<ul class=menu1>
<li class=menu><a href="group__drivers.html">drivers</a></li>
</ul>
<li class=menu><a href="group__libplayercommon.html">libplayercommon</a>
<li class=menu><a href="group__libplayerutils.html">libplayerutils</a>
<li class=menu><a href="group__libplayersd.html">libplayersd</a>
<li class=menu><a href="group__libplayertcp.html">libplayertcp</a>
<li class=menu><a href="group__libplayerxdr.html">libplayerxdr</a>
<li class=menu><a href="todo.html">TODO</a>
</ul>
</div>
<div class=box>
<!-- <a href="http://sourceforge.net"><img border=0 src="http://sourceforge.net/sflogo.php?group_id=42445&type=1"></a> -->
<div class="title">Online</div>
<a href="http://playerstage.sourceforge.net">Homepage</a><br>
<a href="http://sourceforge.net/project/showfiles.php?group_id=42445">Download</a><br>
<a href="http://sourceforge.net/projects/playerstage">Project</a><br>
<a href="http://sourceforge.net/tracker/?group_id=42445">Bugs</a><br>
<a href="http://sourceforge.net/mail/?group_id=42445">Help</a>
</div>
</div>
<div id="content" >
<!-- Generated by Doxygen 1.7.1 -->
<div class="header">
<div class="headertitle">
<h1>blobfinder<br/>
<small>
[<a class="el" href="group__interfaces.html">Interface specifications</a>]</small>
</h1> </div>
</div>
<div class="contents">
<p>A visual blob-detection system.
<a href="#_details">More...</a></p>
<table class="memberdecls">
<tr><td colspan="2"><p><a class="anchor" id="amgrpd41d8cd98f00b204e9800998ecf8427e"></a> </p>
<br/><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__interface__blobfinder.html#ga4a827c0a56d54f82b90e3012e64a408d">PLAYER_BLOBFINDER_DATA_BLOBS</a> 1</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Structure describing a single blob. <a href="#ga4a827c0a56d54f82b90e3012e64a408d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__interface__blobfinder.html#gad22dbe73db9ff651905528a1fc334ce9">PLAYER_BLOBFINDER_REQ_SET_COLOR</a> 1</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Structure describing a single blob. <a href="#gad22dbe73db9ff651905528a1fc334ce9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__interface__blobfinder.html#ga6ffc66325d30a322dbeafd1b27ef65de">PLAYER_BLOBFINDER_REQ_SET_IMAGER_PARAMS</a> 2</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Structure describing a single blob. <a href="#ga6ffc66325d30a322dbeafd1b27ef65de"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__interface__blobfinder.html#ga14fe952e0fd3c910a206c50c73e5e195">PLAYER_BLOBFINDER_REQ_GET_COLOR</a> 3</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Structure describing a single blob. <a href="#ga14fe952e0fd3c910a206c50c73e5e195"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structplayer__blobfinder__blob.html">player_blobfinder_blob</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__interface__blobfinder.html#ga37f162c92f4a0c384b9fd7c978aa9549">player_blobfinder_blob_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Structure describing a single blob. <a href="#ga37f162c92f4a0c384b9fd7c978aa9549"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structplayer__blobfinder__data.html">player_blobfinder_data</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__interface__blobfinder.html#ga87862408b788524006ce1356700eb82c">player_blobfinder_data_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Data: detected blobs (<a class="el" href="group__interface__blobfinder.html#ga4a827c0a56d54f82b90e3012e64a408d">PLAYER_BLOBFINDER_DATA_BLOBS</a>). <a href="#ga87862408b788524006ce1356700eb82c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structplayer__blobfinder__color__config.html">player_blobfinder_color_config</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__interface__blobfinder.html#gaa4d08bfa859851943a96331b0d780680">player_blobfinder_color_config_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Request/reply: Set tracking color. <a href="#gaa4d08bfa859851943a96331b0d780680"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef struct <br class="typebreak"/>
<a class="el" href="structplayer__blobfinder__imager__config.html">player_blobfinder_imager_config</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__interface__blobfinder.html#ga2bcc444599103d7a374ca77e36c6d2d0">player_blobfinder_imager_config_t</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Configuration request: Set imager params. <a href="#ga2bcc444599103d7a374ca77e36c6d2d0"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>A visual blob-detection system. </p>
<p>The blobfinder interface provides access to devices that detect blobs in images. </p>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="ga4a827c0a56d54f82b90e3012e64a408d"></a><!-- doxytag: member="player_interfaces.h::PLAYER_BLOBFINDER_DATA_BLOBS" ref="ga4a827c0a56d54f82b90e3012e64a408d" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define PLAYER_BLOBFINDER_DATA_BLOBS 1</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Structure describing a single blob. </p>
</div>
</div>
<a class="anchor" id="ga14fe952e0fd3c910a206c50c73e5e195"></a><!-- doxytag: member="player_interfaces.h::PLAYER_BLOBFINDER_REQ_GET_COLOR" ref="ga14fe952e0fd3c910a206c50c73e5e195" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define PLAYER_BLOBFINDER_REQ_GET_COLOR 3</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Structure describing a single blob. </p>
</div>
</div>
<a class="anchor" id="gad22dbe73db9ff651905528a1fc334ce9"></a><!-- doxytag: member="player_interfaces.h::PLAYER_BLOBFINDER_REQ_SET_COLOR" ref="gad22dbe73db9ff651905528a1fc334ce9" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define PLAYER_BLOBFINDER_REQ_SET_COLOR 1</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Structure describing a single blob. </p>
</div>
</div>
<a class="anchor" id="ga6ffc66325d30a322dbeafd1b27ef65de"></a><!-- doxytag: member="player_interfaces.h::PLAYER_BLOBFINDER_REQ_SET_IMAGER_PARAMS" ref="ga6ffc66325d30a322dbeafd1b27ef65de" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define PLAYER_BLOBFINDER_REQ_SET_IMAGER_PARAMS 2</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Structure describing a single blob. </p>
</div>
</div>
<hr/><h2>Typedef Documentation</h2>
<a class="anchor" id="ga37f162c92f4a0c384b9fd7c978aa9549"></a><!-- doxytag: member="player_interfaces.h::player_blobfinder_blob_t" ref="ga37f162c92f4a0c384b9fd7c978aa9549" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="structplayer__blobfinder__blob.html">player_blobfinder_blob</a> <a class="el" href="structplayer__blobfinder__blob.html">player_blobfinder_blob_t</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Structure describing a single blob. </p>
</div>
</div>
<a class="anchor" id="gaa4d08bfa859851943a96331b0d780680"></a><!-- doxytag: member="player_interfaces.h::player_blobfinder_color_config_t" ref="gaa4d08bfa859851943a96331b0d780680" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="structplayer__blobfinder__color__config.html">player_blobfinder_color_config</a> <a class="el" href="structplayer__blobfinder__color__config.html">player_blobfinder_color_config_t</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Request/reply: Set tracking color. </p>
<p>For some sensors (ie CMUcam), simple blob tracking tracks only one color. To set the tracking color, send a <a class="el" href="group__interface__blobfinder.html#gad22dbe73db9ff651905528a1fc334ce9">PLAYER_BLOBFINDER_REQ_SET_COLOR</a> request with the format below, including the RGB color ranges (max and min). Values of -1 will cause the track color to be automatically set to the current window color. This is useful for setting the track color by holding the tracking object in front of the lens. Null response. </p>
</div>
</div>
<a class="anchor" id="ga87862408b788524006ce1356700eb82c"></a><!-- doxytag: member="player_interfaces.h::player_blobfinder_data_t" ref="ga87862408b788524006ce1356700eb82c" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="structplayer__blobfinder__data.html">player_blobfinder_data</a> <a class="el" href="structplayer__blobfinder__data.html">player_blobfinder_data_t</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Data: detected blobs (<a class="el" href="group__interface__blobfinder.html#ga4a827c0a56d54f82b90e3012e64a408d">PLAYER_BLOBFINDER_DATA_BLOBS</a>). </p>
<p>The list of detected blobs, returned as data by <code>blobfinder</code> devices. </p>
</div>
</div>
<a class="anchor" id="ga2bcc444599103d7a374ca77e36c6d2d0"></a><!-- doxytag: member="player_interfaces.h::player_blobfinder_imager_config_t" ref="ga2bcc444599103d7a374ca77e36c6d2d0" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="structplayer__blobfinder__imager__config.html">player_blobfinder_imager_config</a> <a class="el" href="structplayer__blobfinder__imager__config.html">player_blobfinder_imager_config_t</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Configuration request: Set imager params. </p>
<p>Imaging sensors that do blob tracking generally have some sorts of image quality parameters that you can tweak. The following ones are implemented here:</p>
<ul>
<li>brightness (0-255)</li>
<li>contrast (0-255)</li>
<li>auto gain (0=off, 1=on)</li>
<li>color mode (0=RGB/AutoWhiteBalance Off, 1=RGB/AutoWhiteBalance On, 2=YCrCB/AWB Off, 3=YCrCb/AWB On) To set the params, send a <a class="el" href="group__interface__blobfinder.html#ga6ffc66325d30a322dbeafd1b27ef65de">PLAYER_BLOBFINDER_REQ_SET_IMAGER_PARAMS</a> request with the format below. Any values set to -1 will be left unchanged. Null response. </li>
</ul>
</div>
</div>
</div>
<!-- render the modification time of the source file -->
<div class="timestamp">
<hr>
<table style="width:100%;">
<tr>
<td style="text-align:left;">
Last updated 12 September 2005 21:38:45
<!--
<td style="text-align:right;">
<a href="http://validator.w3.org/check/referer"><img style="vertical-align:middle;border:0;width:88px;height:31px"
src="http://www.w3.org/Icons/valid-html401"
alt="Valid HTML 4.01!"></a>
<a href="http://jigsaw.w3.org/css-validator/">
<img style="vertical-align:middle;border:0;width:88px;height:31px"
src="http://jigsaw.w3.org/css-validator/images/vcss"
alt="Valid CSS!">
</a>
-->
</tr>
</table>
</div>
</tr>
</table>
</BODY>
</HTML>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
727fa15453fcace956b835e2377d4269
>
files
>
684
