X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=xml%2Forg.freedesktop.atspi.Image.xml;h=17b63e55e182336d34a8c3be2e822569518c1f39;hb=36a4131a9cc9fc8d474058d2a9448bc9eac91f17;hp=fe4552c43d8bfe380a4c6645fc1b06108a1841a3;hpb=f6ca06461319b20463f96a5b37544a540aee11ca;p=platform%2Fcore%2Fuifw%2Fat-spi2-atk.git diff --git a/xml/org.freedesktop.atspi.Image.xml b/xml/org.freedesktop.atspi.Image.xml index fe4552c..17b63e5 100644 --- a/xml/org.freedesktop.atspi.Image.xml +++ b/xml/org.freedesktop.atspi.Image.xml @@ -1,53 +1,33 @@ - - -AT-SPI - Assistive Technology Service Provider Interface -Copyright 2008 Novell, Inc. -Copyright 2001 - 2005 Sun Microsystems, Inc. - -

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., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA.

- + +

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" + 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 Image, and that semantic content should be conveyed textually to the extent possible - via the image description, as well as the Accessible::name and - Accessible::description properties.

+ via the image description, as well as the Accessible.name and + Accessible.description properties.

A UTF-8 string providing a textual description of what is visually depicted in the image.

-

@note It is recommended that imageDescription be the shorter - of the available image descriptions, for instance "alt text" +

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. + Accessible.description, if available. A short, one or two word label for the image should be provided in - Accessible::accessible-name.

+ Accessible.name.

A string corresponding to the POSIX LC_MESSAGES locale used - by the imageDescription. - @since AT-SPI 1.7.0

+ by the imageDescription.

 @@ -56,18 +36,21 @@ 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. - @note This method returns the bounds of the current onscreen +

+

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.

- -

@param coordType If 0, the returned bounding box position is returned + + + +

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.

- - - + + + - a BoundingBox enclosing the image's onscreen representation. + A BoundingBox enclosing the image's onscreen representation. @@ -75,17 +58,26 @@

Get the coordinates of the current image position on screen.

-

@param x Back-filled with the x coordinate of the + + + + Back-filled with the x coordinate of the onscreen image (i.e. the minimum x coordinate) - @param y Back-filled with the y coordinate of the + + + + + Back-filled with the y coordinate of the onscreen image (i.e. the minimum y coordinate) - @param coordType If 0, the returned x and y coordinates are + + + + + If 0, the returned x and y coordinates are returned relative to the screen; - if 1, they are returned relative to the containing window.

- - - - + if 1, they are returned relative to the containing window. + + @@ -93,29 +85,25 @@ 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. - @note 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.

- -

@param width Back-filled with the x extents of the - onscreen image (i.e. the image width in pixels) - @param height Back-filled with the y extents of the - onscreen image (i.e. the image height in pixels)

- - - - - - -

\cond - unImplemented:

+

+

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. +

-

placeholders for future expansion.

 - - - - + + + Back-filled with the x extents of the + onscreen image (i.e. the image width in pixels) + + + + + Back-filled with the y extents of the + onscreen image (i.e. the image height in pixels) + +