<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>at-spi-idl: Accessibility::Image Interface Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="dirs.html"><span>Directories</span></a></li>
</ul>
</div>
<div class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Data Fields</span></a></li>
</ul>
</div>
<div class="navpath">
<ul>
<li><a class="el" href="namespaceAccessibility.html">Accessibility</a> </li>
<li><a class="el" href="interfaceAccessibility_1_1Image.html">Accessibility::Image</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-attribs">Data Fields</a> </div>
<div class="headertitle">
<h1>Accessibility::Image Interface Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Accessibility::Image" -->
<p><code>import "<a class="el" href="Accessibility__Image_8idl_source.html">Accessibility_Image.idl</a>";</code></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="structAccessibility_1_1BoundingBox.html">BoundingBox</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Image.html#a7f0ef6f018e99c8b3232d9cbd38bae8f">getImageExtents</a> (in short coordType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Image.html#a6464db1b9b02647c8423d3b4739a1495">getImagePosition</a> (out long x, out long y, in short coordType)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Image.html#a4688f863601459ecfecb2ccd01925f78">getImageSize</a> (out long width, out long height)</td></tr>
<tr><td colspan="2"><h2><a name="pub-attribs"></a>
Data Fields</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">readonly attribute string </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Image.html#a63180da3e9e4b4ddcfeb772b493f34e5">imageDescription</a></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">readonly attribute string </td><td class="memItemRight" valign="bottom"><a class="el" href="interfaceAccessibility_1_1Image.html#a5105ec29969ee41c6104151f8becde05">imageLocale</a></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>An interface implemented by objects which render image data or pictorial information to the screen. When onscreen components include graphical information that is not purely intended to enhance "3d effect" or visual layout, but which conveys some semantic or informational content to the sighted user, they should implement <a class="el" href="interfaceAccessibility_1_1Image.html">Image</a>, and that semantic content should be conveyed textually to the extent possible via the image description, as well as the <a class="el" href="interfaceAccessibility_1_1Accessible.html#ae9de3c13be427ffc11996378d2c4527f">Accessible::name</a> and <a class="el" href="interfaceAccessibility_1_1Accessible.html#a5e08131814ca3393efd3eaae61b24603">Accessible::description</a> properties. </p>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a7f0ef6f018e99c8b3232d9cbd38bae8f"></a><!-- doxytag: member="Accessibility::Image::getImageExtents" ref="a7f0ef6f018e99c8b3232d9cbd38bae8f" args="(in short coordType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="structAccessibility_1_1BoundingBox.html">BoundingBox</a> Accessibility::Image::getImageExtents </td>
<td>(</td>
<td class="paramtype">in short </td>
<td class="paramname"> <em>coordType</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain a bounding box which entirely contains the image contents, as displayed on screen. The bounds returned do not account for any viewport clipping or the fact that the image may be partially or wholly obscured by other onscreen content. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>This method returns the bounds of the current onscreen view, and not the nominal size of the source data in the event that the original image has been rescaled.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>coordType</em> </td><td>If 0, the returned bounding box position is returned relative to the screen; if 1, the bounding box position is returned relative to the containing window. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a <a class="el" href="structAccessibility_1_1BoundingBox.html">BoundingBox</a> enclosing the image's onscreen representation. </dd></dl>
</div>
</div>
<a class="anchor" id="a6464db1b9b02647c8423d3b4739a1495"></a><!-- doxytag: member="Accessibility::Image::getImagePosition" ref="a6464db1b9b02647c8423d3b4739a1495" args="(out long x, out long y, in short coordType)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Accessibility::Image::getImagePosition </td>
<td>(</td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>x</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>y</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">in short </td>
<td class="paramname"> <em>coordType</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the coordinates of the current image position on screen.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>x</em> </td><td>Back-filled with the x coordinate of the onscreen image (i.e. the minimum x coordinate) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>y</em> </td><td>Back-filled with the y coordinate of the onscreen image (i.e. the minimum y coordinate) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>coordType</em> </td><td>If 0, the returned x and y coordinates are returned relative to the screen; if 1, they are returned relative to the containing window. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a4688f863601459ecfecb2ccd01925f78"></a><!-- doxytag: member="Accessibility::Image::getImageSize" ref="a4688f863601459ecfecb2ccd01925f78" args="(out long width, out long height)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Accessibility::Image::getImageSize </td>
<td>(</td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>width</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">out long </td>
<td class="paramname"> <em>height</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Obtain the width and height of the current onscreen view of the image. The extents returned do not account for any viewport clipping or the fact that the image may be partially or wholly obscured by other onscreen content. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>This method returns the size of the current onscreen view, and not the nominal or "original" size of the source image, in the event that the original image has been rescaled.</dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>width</em> </td><td>Back-filled with the x extents of the onscreen image (i.e. the image width in pixels) </td></tr>
<tr><td valign="top"></td><td valign="top"><em>height</em> </td><td>Back-filled with the y extents of the onscreen image (i.e. the image height in pixels) </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<hr/><h2>Field Documentation</h2>
<a class="anchor" id="a63180da3e9e4b4ddcfeb772b493f34e5"></a><!-- doxytag: member="Accessibility::Image::imageDescription" ref="a63180da3e9e4b4ddcfeb772b493f34e5" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">readonly attribute string <a class="el" href="interfaceAccessibility_1_1Image.html#a63180da3e9e4b4ddcfeb772b493f34e5">Accessibility::Image::imageDescription</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A UTF-8 string providing a textual description of what is visually depicted in the image.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>It is recommended that imageDescription be the shorter of the available image descriptions, for instance "alt text" in HTML images, and a longer description be provided in Accessible::accessible-description, if available. A short, one or two word label for the image should be provided in Accessible::accessible-name. </dd></dl>
</div>
</div>
<a class="anchor" id="a5105ec29969ee41c6104151f8becde05"></a><!-- doxytag: member="Accessibility::Image::imageLocale" ref="a5105ec29969ee41c6104151f8becde05" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">readonly attribute string <a class="el" href="interfaceAccessibility_1_1Image.html#a5105ec29969ee41c6104151f8becde05">Accessibility::Image::imageLocale</a></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A string corresponding to the POSIX LC_MESSAGES locale used by the imageDescription. </p>
<dl class="since"><dt><b>Since:</b></dt><dd>AT-SPI 1.7.0 </dd></dl>
</div>
</div>
<hr/>The documentation for this interface was generated from the following file:<ul>
<li>/home/liyuan/src/at-spi/idl/<a class="el" href="Accessibility__Image_8idl_source.html">Accessibility_Image.idl</a></li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Mon Sep 27 2010 16:50:43 for at-spi-idl by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.1 </small></address>
</body>
</html>
