1 <?xml version="1.0" encoding="UTF-8"?>
2 <node xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0" name="/node">
3 <interface name="org.freedesktop.atspi.ContentStream">
4 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
5 <p>An interface by which the requested data from a StreamableContent object
6 may be read by the client.</p>
9 <tp:enum name="SeekType" type="u">
10 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
11 <p>Specifies the meaning of a seek 'offset'. Not all SeekTypes are
12 supported by all StreamableContent data sources, for instance
13 some streams may not support seeking from the beginning or other
14 types of 'backwards' seeks.</p>
16 <tp:enumvalue suffix="SEEK_SET">
18 Seek from the start of the stream or data source.
21 <tp:enumvalue suffix="SEEK_CURRENT" value="1">
23 Seek relative to the current position.
26 <tp:enumvalue suffix="SEEK_END" value="2">
28 Seek from the end of the file, stream, or data source.
32 <tp:errors xmlns="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0" namespace="org.freedesktop.atspi.error">
33 <tp:error name="IOError">
35 Indicates that a transmission error has occurred while reading or seeking the stream or data source.
38 <tp:error name="NotSupported">
40 Indicates that the requested operation is not supported by the stream instance.
43 <tp:error name="NoPermission">
45 The operation is supported, but the current requestor does not havepermission to t the request, for instance does not have permission to read the stream.
50 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
51 <p>Seek to a specified position in the Stream.</p>
53 <arg direction="in" name="offset" type="i">
55 An offset specifying the requested position in the stream,
56 relative to the SeekType specified in <code>whence.</code>
59 <arg direction="in" name="whence" type="u" tp:type="SeekType">
61 A SeekType specifying the reference point from which the
62 seek offset is calculated. Some forms of seek are not supported by certain
63 implementations of Stream, in which case a NotSupported exception will be raised.
66 <arg direction="out" type="i">
68 The actual resulting offset, if no exception was raised.
72 <tp:error name="org.freedesktop.atspi.error.(NoPermission"/>
73 <tp:error name="org.freedesktop.atspi.error.IOError"/>
74 <tp:error name="org.freedesktop.atspi.error.NotSupported"/>
79 Request/read a specified amount of data from a Stream.
81 <arg direction="in" name="count" type="i"/>
82 <arg direction="out" name="buffer" type="ay" tp:type="iobuf"/>
83 <arg direction="out" type="i">
85 The number of bytes actually read into the client buffer.
89 <tp:error name="org.freedesktop.atspi.error.(NoPermission"/>
90 <tp:error name="org.freedesktop.atspi.error.IOError"/>
94 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
95 <p>close the stream and release associated resources.
96 A client should not perform further operations on a
97 StreamableContent.Stream object after closing it.</p>
100 <interface name="org.freedesktop.atspi.StreamableContent">
101 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
102 <p>An interface whereby an object allows its backing content
103 to be streamed to clients. Negotiation of content type
104 is allowed. Clients may examine the backing data and
105 transform, convert, or parse the content in order to
106 present it in an alternate form to end-users. </p>
108 <p>The StreamableContent interface is particularly useful for saving,
109 printing, or post-processing entire documents, or for persisting
110 alternate views of a document.
111 If document content itself is being serialized, stored, or converted,
112 then use of the StreamableContent interface can help address performance
113 issues. Unlike most AT-SPI/Accessibility interfaces, this interface
114 is not strongly tied to the current user-agent view of the
115 a particular document, but may in some cases give access to the
116 underlying model data.</p>
118 <method name="getContentTypes">
119 <arg direction="out" type="as" tp:type="StringSeq">
121 The list of available mimetypes for this object's content.
125 <method name="getContent">
126 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
127 <p>DEPRECATED, use getStream instead.
129 Retrieve this object's content, in a format appropriate to a
130 requested mimetype. </p>
132 <arg direction="in" name="contentType" type="s">
135 <method name="getStream">
136 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
137 <p>Retrieve this object's content, in a format appropriate to a
138 requested mimetype, as a ::ContentStream instance. </p>
141 <arg direction="in" name="contentType" type="s">
143 <p>A string specifying the desired mimetype for the content stream.</p>
146 <arg direction="out" type="FIXME" tp:type="ContentStream">
148 A Stream whose mimetype matches contentType,if available, or NIL.
152 <method name="getURI">
153 <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
154 <p>Get a URI pointing to the content of the specified type, if such a URI
155 can be obtained. Not all streamable content providers have URI representations. </p>
157 <arg direction="in" name="contentType" type="s">
159 <p>A string specifying the desired mimetype for the content stream.
160 If NULL, then a URI for the default content type will be returned, if available. </p>
163 <arg direction="out" type="s">
165 A string which constitutes a URI for a stream of the specifiedcontent type, or NULL if no such URI can be obtained.