1page.title=RenderScript Input/Output Functions 2 3@jd:body 4 5<div class='renderscript'> 6<h2>Overview</h2> 7<p> These functions are used to:<ul> 8<li>Send information to the Java client, and</li> 9<li>Send the processed allocation or receive the next allocation to process.</li></ul> 10</p> 11<h2>Summary</h2> 12<table class='jd-sumtable'><tbody> 13 <tr><th colspan='2'>Functions</th></tr> 14 <tr class='alt-color api apilevel-1'> 15 <td class='jd-linkcol'> 16 <a href='rs_io.html#android_rs:rsAllocationIoReceive'>rsAllocationIoReceive</a> 17 </td> 18 <td class='jd-descrcol' width='100%'> 19 Receive new content from the queue 20 </td> 21 </tr> 22 <tr class='alt-color api apilevel-1'> 23 <td class='jd-linkcol'> 24 <a href='rs_io.html#android_rs:rsAllocationIoSend'>rsAllocationIoSend</a> 25 </td> 26 <td class='jd-descrcol' width='100%'> 27 Send new content to the queue 28 </td> 29 </tr> 30 <tr class='alt-color api apilevel-1'> 31 <td class='jd-linkcol'> 32 <a href='rs_io.html#android_rs:rsSendToClient'>rsSendToClient</a> 33 </td> 34 <td class='jd-descrcol' width='100%'> 35 Send a message to the client, non-blocking 36 </td> 37 </tr> 38 <tr class='alt-color api apilevel-1'> 39 <td class='jd-linkcol'> 40 <a href='rs_io.html#android_rs:rsSendToClientBlocking'>rsSendToClientBlocking</a> 41 </td> 42 <td class='jd-descrcol' width='100%'> 43 Send a message to the client, blocking 44 </td> 45 </tr> 46</tbody></table> 47<h2>Functions</h2> 48<a name='android_rs:rsAllocationIoReceive'></a> 49<div class='jd-details'> 50 <h4 class='jd-details-title'> 51 <span class='sympad'>rsAllocationIoReceive</span> 52 <span class='normal'>: Receive new content from the queue</span> 53 </h4> 54 <div class='jd-details-descr'> 55 <table class='jd-tagtable'><tbody> 56 <tr> 57 <td>void rsAllocationIoReceive(<a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a> a); 58</td> 59 <td> Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a> 60 </td> 61 </tr> 62 </tbody></table> 63 </div> 64 <div class='jd-tagdata'> <h5 class='jd-tagtitle'>Parameters</h5> 65 <table class='jd-tagtable'><tbody> 66 <tr><th>a</th><td>Allocation to work on.</td></tr> 67 </tbody></table> 68 </div> 69 <div class='jd-tagdata jd-tagdescr'> 70<p> Receive a new set of contents from the queue. 71</p> 72 </div> 73</div> 74 75<a name='android_rs:rsAllocationIoSend'></a> 76<div class='jd-details'> 77 <h4 class='jd-details-title'> 78 <span class='sympad'>rsAllocationIoSend</span> 79 <span class='normal'>: Send new content to the queue</span> 80 </h4> 81 <div class='jd-details-descr'> 82 <table class='jd-tagtable'><tbody> 83 <tr> 84 <td>void rsAllocationIoSend(<a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a> a); 85</td> 86 <td> Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a> 87 </td> 88 </tr> 89 </tbody></table> 90 </div> 91 <div class='jd-tagdata'> <h5 class='jd-tagtitle'>Parameters</h5> 92 <table class='jd-tagtable'><tbody> 93 <tr><th>a</th><td>Allocation to work on.</td></tr> 94 </tbody></table> 95 </div> 96 <div class='jd-tagdata jd-tagdescr'> 97<p> Send the contents of the Allocation to the queue. 98</p> 99 </div> 100</div> 101 102<a name='android_rs:rsSendToClient'></a> 103<div class='jd-details'> 104 <h4 class='jd-details-title'> 105 <span class='sympad'>rsSendToClient</span> 106 <span class='normal'>: Send a message to the client, non-blocking</span> 107 </h4> 108 <div class='jd-details-descr'> 109 <table class='jd-tagtable'><tbody> 110 <tr> 111 <td>bool rsSendToClient(int cmdID); 112</td> 113 <td> </td> 114 </tr> 115 <tr> 116 <td>bool rsSendToClient(int cmdID, const void* data, <a href='rs_value_types.html#android_rs:uint'>uint</a> len); 117</td> 118 <td> </td> 119 </tr> 120 </tbody></table> 121 </div> 122 <div class='jd-tagdata'> <h5 class='jd-tagtitle'>Parameters</h5> 123 <table class='jd-tagtable'><tbody> 124 <tr><th>cmdID</th><td></td></tr> 125 <tr><th>data</th><td>Application specific data.</td></tr> 126 <tr><th>len</th><td>Length of the data, in bytes.</td></tr> 127 </tbody></table> 128 </div> 129 <div class='jd-tagdata jd-tagdescr'> 130<p> Sends a message back to the client. This call does not block. 131It returns true if the message was sent and false if the 132message queue is full. 133</p> 134 135<p> A message ID is required. The data payload is optional. 136</p> 137 138<p> See <a href='http://developer.android.com/reference/android/renderscript/RenderScript.RSMessageHandler.html'>RenderScript.RSMessageHandler</a>. 139</p> 140 </div> 141</div> 142 143<a name='android_rs:rsSendToClientBlocking'></a> 144<div class='jd-details'> 145 <h4 class='jd-details-title'> 146 <span class='sympad'>rsSendToClientBlocking</span> 147 <span class='normal'>: Send a message to the client, blocking</span> 148 </h4> 149 <div class='jd-details-descr'> 150 <table class='jd-tagtable'><tbody> 151 <tr> 152 <td>void rsSendToClientBlocking(int cmdID); 153</td> 154 <td> </td> 155 </tr> 156 <tr> 157 <td>void rsSendToClientBlocking(int cmdID, const void* data, <a href='rs_value_types.html#android_rs:uint'>uint</a> len); 158</td> 159 <td> </td> 160 </tr> 161 </tbody></table> 162 </div> 163 <div class='jd-tagdata'> <h5 class='jd-tagtitle'>Parameters</h5> 164 <table class='jd-tagtable'><tbody> 165 <tr><th>cmdID</th><td></td></tr> 166 <tr><th>data</th><td>Application specific data.</td></tr> 167 <tr><th>len</th><td>Length of the data, in bytes.</td></tr> 168 </tbody></table> 169 </div> 170 <div class='jd-tagdata jd-tagdescr'> 171<p> Sends a message back to the client. This function will block 172until there is room on the message queue for this message. 173This function may return before the message was delivered and 174processed by the client. 175</p> 176 177<p> A message ID is required. The data payload is optional. 178</p> 179 180<p> See <a href='http://developer.android.com/reference/android/renderscript/RenderScript.RSMessageHandler.html'>RenderScript.RSMessageHandler</a>. 181</p> 182 </div> 183</div> 184 185</div> 186