OLD | NEW |
1 /* Copyright 2014 The Chromium Authors. All rights reserved. | 1 /* Copyright 2014 The Chromium Authors. All rights reserved. |
2 * Use of this source code is governed by a BSD-style license that can be | 2 * Use of this source code is governed by a BSD-style license that can be |
3 * found in the LICENSE file. | 3 * found in the LICENSE file. |
4 */ | 4 */ |
5 | 5 |
6 /** | 6 /** |
7 * Defines the <code>PPB_MediaStreamVideoTrack</code> interface. Used for | 7 * Defines the <code>PPB_MediaStreamVideoTrack</code> interface. Used for |
8 * receiving video frames from a MediaStream video track in the browser. | 8 * receiving video frames from a MediaStream video track in the browser. |
9 * This interface is still in development (Dev API status) and may change. | 9 * This interface is still in development (Dev API status) and may change. |
10 */ | 10 */ |
(...skipping 59 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
70 /** | 70 /** |
71 * Gets the next video frame from the MediaStream track. | 71 * Gets the next video frame from the MediaStream track. |
72 * If internal processing is slower than the incoming frame rate, new frames | 72 * If internal processing is slower than the incoming frame rate, new frames |
73 * will be dropped from the incoming stream. Once the input buffer is full, | 73 * will be dropped from the incoming stream. Once the input buffer is full, |
74 * frames will be dropped until <code>RecycleFrame()</code> is called to free | 74 * frames will be dropped until <code>RecycleFrame()</code> is called to free |
75 * a spot for another frame to be buffered. | 75 * a spot for another frame to be buffered. |
76 * If there are no frames in the input buffer, | 76 * If there are no frames in the input buffer, |
77 * <code>PP_OK_COMPLETIONPENDING</code> will be returned immediately and the | 77 * <code>PP_OK_COMPLETIONPENDING</code> will be returned immediately and the |
78 * <code>callback</code> will be called, when a new frame is received or an | 78 * <code>callback</code> will be called, when a new frame is received or an |
79 * error happens. | 79 * error happens. |
80 * If the caller holds a frame returned by the previous call of | |
81 * <code>GetFrame()</code>, <code>PP_ERROR_INPROGRESS</code> will be returned. | |
82 * The caller should recycle the previous frame before getting the next frame. | |
83 * | 80 * |
84 * @param[in] video_track A <code>PP_Resource</code> corresponding to a video | 81 * @param[in] video_track A <code>PP_Resource</code> corresponding to a video |
85 * resource. | 82 * resource. |
86 * @param[out] frame A <code>PP_Resource</code> corresponding to a VideoFrame | 83 * @param[out] frame A <code>PP_Resource</code> corresponding to a VideoFrame |
87 * resource. | 84 * resource. |
88 * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon | 85 * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon |
89 * completion of GetFrame(). | 86 * completion of GetFrame(). |
90 * | 87 * |
91 * @return An int32_t containing a result code from <code>pp_errors.h</code>. | 88 * @return An int32_t containing a result code from <code>pp_errors.h</code>. |
92 * Returns PP_ERROR_NOMEMORY if <code>max_buffered_frames</code> frames buffer | 89 * Returns PP_ERROR_NOMEMORY if <code>max_buffered_frames</code> frames buffer |
(...skipping 22 matching lines...) Expand all Loading... |
115 /** | 112 /** |
116 * Closes the MediaStream video track and disconnects it from video source. | 113 * Closes the MediaStream video track and disconnects it from video source. |
117 * After calling <code>Close()</code>, no new frames will be received. | 114 * After calling <code>Close()</code>, no new frames will be received. |
118 * | 115 * |
119 * @param[in] video_track A <code>PP_Resource</code> corresponding to a | 116 * @param[in] video_track A <code>PP_Resource</code> corresponding to a |
120 * MediaStream video track resource. | 117 * MediaStream video track resource. |
121 */ | 118 */ |
122 void Close([in] PP_Resource video_track); | 119 void Close([in] PP_Resource video_track); |
123 }; | 120 }; |
124 | 121 |
OLD | NEW |