You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

604 lines
27 KiB

1 month ago
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>AForge.Video.Kinect</name>
  5. </assembly>
  6. <members>
  7. <member name="T:AForge.Video.Kinect.LedColorOption">
  8. <summary>
  9. Kinect's LED color options.
  10. </summary>
  11. </member>
  12. <member name="F:AForge.Video.Kinect.LedColorOption.Off">
  13. <summary>
  14. The LED is off.
  15. </summary>
  16. </member>
  17. <member name="F:AForge.Video.Kinect.LedColorOption.Green">
  18. <summary>
  19. The LED is on and has green color.
  20. </summary>
  21. </member>
  22. <member name="F:AForge.Video.Kinect.LedColorOption.Red">
  23. <summary>
  24. The LED is on and has red color.
  25. </summary>
  26. </member>
  27. <member name="F:AForge.Video.Kinect.LedColorOption.Yellow">
  28. <summary>
  29. The LED is on and has yellow color.
  30. </summary>
  31. </member>
  32. <member name="F:AForge.Video.Kinect.LedColorOption.BlinkGreen">
  33. <summary>
  34. The LED is blinking with green color.
  35. </summary>
  36. </member>
  37. <member name="F:AForge.Video.Kinect.LedColorOption.BlinkRedYellow">
  38. <summary>
  39. The LED is blinking from red to yellow color.
  40. </summary>
  41. </member>
  42. <member name="T:AForge.Video.Kinect.CameraResolution">
  43. <summary>
  44. Kinect's resolutions of video and depth cameras.
  45. </summary>
  46. </member>
  47. <member name="F:AForge.Video.Kinect.CameraResolution.Low">
  48. <summary>
  49. Low resolution.
  50. </summary>
  51. </member>
  52. <member name="F:AForge.Video.Kinect.CameraResolution.Medium">
  53. <summary>
  54. Medium resolution.
  55. </summary>
  56. </member>
  57. <member name="F:AForge.Video.Kinect.CameraResolution.High">
  58. <summary>
  59. Hight resolution.
  60. </summary>
  61. </member>
  62. <member name="T:AForge.Video.Kinect.Kinect">
  63. <summary>
  64. The class provides access to Microsoft's Xbox <a href="http://en.wikipedia.org/wiki/Kinect">Kinect</a>
  65. controller.
  66. </summary>
  67. <remarks><para>The class allows to manipulate Kinec device by changing its LED color, setting motor's
  68. tilt value and accessing its camera. See <see cref="T:AForge.Video.Kinect.KinectVideoCamera"/> and <see cref="T:AForge.Video.Kinect.KinectDepthCamera"/>
  69. classes, which provide access to actual video.</para>
  70. <para><img src="img/video/kinect.jpg" width="320" height="140" /></para>
  71. <para><note>In order to run correctly the class requires <i>freenect.dll</i> library
  72. to be put into solution's output folder. This can be found within the AForge.NET framework's
  73. distribution in Externals folder.</note></para>
  74. <para>Sample usage:</para>
  75. <code>
  76. // get Kinect device
  77. Kinect kinectDevice = Kinect.GetDevice( 0 );
  78. // change LED color
  79. kinectDevice.LedColor = LedColorOption.Yellow;
  80. // set motor tilt angle to -10 degrees
  81. kinectDevice.SetMotorTilt( -10 );
  82. // get video camera
  83. KinectVideoCamera videoCamera = kinectDevice.GetVideoCamera( );
  84. // see example for video camera also
  85. </code>
  86. </remarks>
  87. </member>
  88. <member name="P:AForge.Video.Kinect.Kinect.DeviceID">
  89. <summary>
  90. ID of the opened Kinect device.
  91. </summary>
  92. </member>
  93. <member name="P:AForge.Video.Kinect.Kinect.DeviceCount">
  94. <summary>
  95. Number of Kinect devices available in the system.
  96. </summary>
  97. </member>
  98. <member name="M:AForge.Video.Kinect.Kinect.GetDevice(System.Int32)">
  99. <summary>
  100. Get initialized instance of the Kinect device.
  101. </summary>
  102. <param name="deviceID">ID of the Kinect device to get instance of, [0, <see cref="P:AForge.Video.Kinect.Kinect.DeviceCount"/>),</param>
  103. <returns>Returns initialized Kinect device. Use <see cref="M:AForge.Video.Kinect.Kinect.Dispose"/> method
  104. when the device is no longer required.</returns>
  105. <exception cref="T:System.ArgumentException">There is no Kinect device with specified ID connected to the system.</exception>
  106. <exception cref="T:AForge.ConnectionFailedException">Failed connecting to the Kinect device specified ID.</exception>
  107. </member>
  108. <member name="M:AForge.Video.Kinect.Kinect.Finalize">
  109. <summary>
  110. Object finalizer/destructor makes sure unmanaged resource are freed if user did not call <see cref="M:AForge.Video.Kinect.Kinect.Dispose"/>.
  111. </summary>
  112. </member>
  113. <member name="M:AForge.Video.Kinect.Kinect.Dispose">
  114. <summary>
  115. Dispose device freeing all associated unmanaged resources.
  116. </summary>
  117. </member>
  118. <member name="M:AForge.Video.Kinect.Kinect.SetLedColor(AForge.Video.Kinect.LedColorOption)">
  119. <summary>
  120. Set color of Kinect's LED.
  121. </summary>
  122. <param name="ledColor">LED color to set.</param>
  123. <exception cref="T:AForge.DeviceErrorException">Some error occurred with the device. Check error message.</exception>
  124. </member>
  125. <member name="M:AForge.Video.Kinect.Kinect.SetMotorTilt(System.Int32)">
  126. <summary>
  127. Set motor's tilt value.
  128. </summary>
  129. <param name="angle">Tilt value to set, [-31, 30] degrees.</param>
  130. <exception cref="T:System.ArgumentOutOfRangeException">Motor tilt has to be in the [-31, 31] range.</exception>
  131. <exception cref="T:AForge.DeviceErrorException">Some error occurred with the device. Check error message.</exception>
  132. </member>
  133. <member name="M:AForge.Video.Kinect.Kinect.GetAccelerometerValues(System.Double@,System.Double@,System.Double@)">
  134. <summary>
  135. Get accelerometer values for 3 axes.
  136. </summary>
  137. <param name="x">X axis value on the accelerometer.</param>
  138. <param name="y">Y axis value on the accelerometer.</param>
  139. <param name="z">Z axis value on the accelerometer.</param>
  140. <remarks><para>Units of all 3 values are m/s<sup>2</sup>. The <b>g</b> value used
  141. for calculations is taken as 9.80665 m/s<sup>2</sup>.</para></remarks>
  142. </member>
  143. <member name="M:AForge.Video.Kinect.Kinect.GetVideoCamera">
  144. <summary>
  145. Get Kinect's video camera.
  146. </summary>
  147. <returns>Returns Kinect's video camera.</returns>
  148. <remarks><para>The method simply creates instance of the <see cref="T:AForge.Video.Kinect.KinectVideoCamera"/> class
  149. by calling its appropriate constructor. Use <see cref="M:AForge.Video.Kinect.KinectVideoCamera.Start"/> method
  150. to start the video then.</para></remarks>
  151. </member>
  152. <member name="M:AForge.Video.Kinect.Kinect.GetDepthCamera">
  153. <summary>
  154. Get Kinect's depth camera.
  155. </summary>
  156. <returns>Returns Kinect's depth camera.</returns>
  157. <remarks><para>The method simply creates instance of the <see cref="T:AForge.Video.Kinect.KinectDepthCamera"/> class
  158. by calling its appropriate constructor. Use <see cref="M:AForge.Video.Kinect.KinectDepthCamera.Start"/> method
  159. to start the video then.</para></remarks>
  160. </member>
  161. <member name="T:AForge.Video.Kinect.KinectDepthCamera">
  162. <summary>
  163. Video source for Microsoft Kinect's depth sensor.
  164. </summary>
  165. <remarks><para>The video source captures depth data from Microsoft <a href="http://en.wikipedia.org/wiki/Kinect">Kinect</a>
  166. depth sensor, which is aimed originally as a gaming device for XBox 360 platform.</para>
  167. <para><note>Prior to using the class, make sure you've installed Kinect's drivers
  168. as described on <a href="http://openkinect.org/wiki/Getting_Started#Windows">Open Kinect</a>
  169. project's page.</note></para>
  170. <para><note>In order to run correctly the class requires <i>freenect.dll</i> library
  171. to be put into solution's output folder. This can be found within the AForge.NET framework's
  172. distribution in Externals folder.</note></para>
  173. <para>Sample usage:</para>
  174. <code>
  175. // create video source
  176. KinectDepthCamera videoSource = new KinectDepthCamera( 0 );
  177. // set NewFrame event handler
  178. videoSource.NewFrame += new NewFrameEventHandler( video_NewFrame );
  179. // start the video source
  180. videoSource.Start( );
  181. // ...
  182. private void video_NewFrame( object sender, NewFrameEventArgs eventArgs )
  183. {
  184. // get new frame
  185. Bitmap bitmap = eventArgs.Frame;
  186. // process the frame
  187. }
  188. </code>
  189. </remarks>
  190. </member>
  191. <member name="E:AForge.Video.Kinect.KinectDepthCamera.NewFrame">
  192. <summary>
  193. New frame event.
  194. </summary>
  195. <remarks><para>Notifies clients about new available frames from the video source.</para>
  196. <para><note>Since video source may have multiple clients, each client is responsible for
  197. making a copy (cloning) of the passed video frame, because the video source disposes its
  198. own original copy after notifying of clients.</note></para>
  199. </remarks>
  200. </member>
  201. <member name="E:AForge.Video.Kinect.KinectDepthCamera.VideoSourceError">
  202. <summary>
  203. Video source error event.
  204. </summary>
  205. <remarks>This event is used to notify clients about any type of errors occurred in
  206. video source object, for example internal exceptions.</remarks>
  207. </member>
  208. <member name="E:AForge.Video.Kinect.KinectDepthCamera.PlayingFinished">
  209. <summary>
  210. Video playing finished event.
  211. </summary>
  212. <remarks><para>This event is used to notify clients that the video playing has finished.</para>
  213. </remarks>
  214. </member>
  215. <member name="P:AForge.Video.Kinect.KinectDepthCamera.ProvideOriginalDepthImage">
  216. <summary>
  217. Provide original depth image or colored depth map.
  218. </summary>
  219. <remarks><para>The property specifies if the video source should provide original data
  220. provided by Kinect's depth sensor or provide colored depth map. If the property is set to
  221. <see langword="true"/>, then the video source will provide 16 bpp grayscale images, where
  222. 11 least significant bits represent data provided by the sensor. If the property is
  223. set to <see langword="false"/>, then the video source will provide 24 bpp color images,
  224. which represents depth map. In this case depth is encoded by color gradient:
  225. white->red->yellow->green->cyan->blue->black. So colors which are closer to white represent
  226. objects which are closer to the Kinect sensor, but colors which are closer to black represent
  227. objects which are further away from Kinect.</para>
  228. <para><note>The property must be set before running the video source to take effect.</note></para>
  229. <para>Default value is set to <see langword="false"/>.</para>
  230. </remarks>
  231. </member>
  232. <member name="P:AForge.Video.Kinect.KinectDepthCamera.Resolution">
  233. <summary>
  234. Resolution of depth sensor to set.
  235. </summary>
  236. <remarks><para><note>The property must be set before running the video source to take effect.</note></para>
  237. <para>Default value of the property is set to <see cref="F:AForge.Video.Kinect.CameraResolution.Medium"/>.</para>
  238. </remarks>
  239. </member>
  240. <member name="P:AForge.Video.Kinect.KinectDepthCamera.Source">
  241. <summary>
  242. A string identifying the video source.
  243. </summary>
  244. </member>
  245. <member name="P:AForge.Video.Kinect.KinectDepthCamera.IsRunning">
  246. <summary>
  247. State of the video source.
  248. </summary>
  249. <remarks>Current state of video source object - running or not.</remarks>
  250. </member>
  251. <member name="P:AForge.Video.Kinect.KinectDepthCamera.BytesReceived">
  252. <summary>
  253. Received bytes count.
  254. </summary>
  255. <remarks>Number of bytes the video source provided from the moment of the last
  256. access to the property.
  257. </remarks>
  258. </member>
  259. <member name="P:AForge.Video.Kinect.KinectDepthCamera.FramesReceived">
  260. <summary>
  261. Received frames count.
  262. </summary>
  263. <remarks>Number of frames the video source provided from the moment of the last
  264. access to the property.
  265. </remarks>
  266. </member>
  267. <member name="M:AForge.Video.Kinect.KinectDepthCamera.#ctor(System.Int32)">
  268. <summary>
  269. Initializes a new instance of the <see cref="T:AForge.Video.Kinect.KinectDepthCamera"/> class.
  270. </summary>
  271. <param name="deviceID">Kinect's device ID (index) to connect to.</param>
  272. </member>
  273. <member name="M:AForge.Video.Kinect.KinectDepthCamera.#ctor(System.Int32,AForge.Video.Kinect.CameraResolution)">
  274. <summary>
  275. Initializes a new instance of the <see cref="T:AForge.Video.Kinect.KinectDepthCamera"/> class.
  276. </summary>
  277. <param name="deviceID">Kinect's device ID (index) to connect to.</param>
  278. <param name="resolution">Resolution of depth sensor to set.</param>
  279. </member>
  280. <member name="M:AForge.Video.Kinect.KinectDepthCamera.#ctor(System.Int32,AForge.Video.Kinect.CameraResolution,System.Boolean)">
  281. <summary>
  282. Initializes a new instance of the <see cref="T:AForge.Video.Kinect.KinectDepthCamera"/> class.
  283. </summary>
  284. <param name="deviceID">Kinect's device ID (index) to connect to.</param>
  285. <param name="resolution">Resolution of depth sensor to set.</param>
  286. <param name="provideOriginalDepthImage">Provide original depth image or colored depth map
  287. (see <see cref="P:AForge.Video.Kinect.KinectDepthCamera.ProvideOriginalDepthImage"/> property).</param>
  288. </member>
  289. <member name="M:AForge.Video.Kinect.KinectDepthCamera.Start">
  290. <summary>
  291. Start video source.
  292. </summary>
  293. <remarks>Starts video source and returns execution to caller. Video camera will be started
  294. and will provide new video frames through the <see cref="E:AForge.Video.Kinect.KinectDepthCamera.NewFrame"/> event.</remarks>
  295. <exception cref="T:System.ArgumentException">The specified resolution is not supported for the selected
  296. mode of the Kinect depth sensor.</exception>
  297. <exception cref="T:AForge.ConnectionFailedException">Could not connect to Kinect's depth sensor.</exception>
  298. <exception cref="T:AForge.DeviceBusyException">Another connection to the specified depth sensor is already running.</exception>
  299. </member>
  300. <member name="M:AForge.Video.Kinect.KinectDepthCamera.SignalToStop">
  301. <summary>
  302. Signal video source to stop its work.
  303. </summary>
  304. <remarks><para><note>Calling this method is equivalent to calling <see cref="M:AForge.Video.Kinect.KinectDepthCamera.Stop"/>
  305. for Kinect video camera.</note></para></remarks>
  306. </member>
  307. <member name="M:AForge.Video.Kinect.KinectDepthCamera.WaitForStop">
  308. <summary>
  309. Wait for video source has stopped.
  310. </summary>
  311. <remarks><para><note>Calling this method is equivalent to calling <see cref="M:AForge.Video.Kinect.KinectDepthCamera.Stop"/>
  312. for Kinect video camera.</note></para></remarks>
  313. </member>
  314. <member name="M:AForge.Video.Kinect.KinectDepthCamera.Stop">
  315. <summary>
  316. Stop video source.
  317. </summary>
  318. <remarks><para>The method stop the video source, so it no longer provides new video frames
  319. and does not consume any resources.</para>
  320. </remarks>
  321. </member>
  322. <member name="T:AForge.Video.Kinect.VideoCameraMode">
  323. <summary>
  324. Enumeration of video camera modes for the <see cref="T:AForge.Video.Kinect.KinectVideoCamera"/>.
  325. </summary>
  326. </member>
  327. <member name="F:AForge.Video.Kinect.VideoCameraMode.Color">
  328. <summary>
  329. 24 bit per pixel RGB mode.
  330. </summary>
  331. </member>
  332. <member name="F:AForge.Video.Kinect.VideoCameraMode.Bayer">
  333. <summary>
  334. 8 bit per pixel Bayer mode.
  335. </summary>
  336. </member>
  337. <member name="F:AForge.Video.Kinect.VideoCameraMode.InfraRed">
  338. <summary>
  339. 8 bit per pixel Infra Red mode.
  340. </summary>
  341. </member>
  342. <member name="T:AForge.Video.Kinect.KinectVideoCamera">
  343. <summary>
  344. Video source for Microsoft Kinect's video camera.
  345. </summary>
  346. <remarks><para>The video source captures video data from Microsoft <a href="http://en.wikipedia.org/wiki/Kinect">Kinect</a>
  347. video camera, which is aimed originally as a gaming device for XBox 360 platform.</para>
  348. <para><note>Prior to using the class, make sure you've installed Kinect's drivers
  349. as described on <a href="http://openkinect.org/wiki/Getting_Started#Windows">Open Kinect</a>
  350. project's page.</note></para>
  351. <para><note>In order to run correctly the class requires <i>freenect.dll</i> library
  352. to be put into solution's output folder. This can be found within the AForge.NET framework's
  353. distribution in Externals folder.</note></para>
  354. <para>Sample usage:</para>
  355. <code>
  356. // create video source
  357. KinectVideoCamera videoSource = new KinectVideoCamera( 0 );
  358. // set NewFrame event handler
  359. videoSource.NewFrame += new NewFrameEventHandler( video_NewFrame );
  360. // start the video source
  361. videoSource.Start( );
  362. // ...
  363. private void video_NewFrame( object sender, NewFrameEventArgs eventArgs )
  364. {
  365. // get new frame
  366. Bitmap bitmap = eventArgs.Frame;
  367. // process the frame
  368. }
  369. </code>
  370. </remarks>
  371. </member>
  372. <member name="E:AForge.Video.Kinect.KinectVideoCamera.NewFrame">
  373. <summary>
  374. New frame event.
  375. </summary>
  376. <remarks><para>Notifies clients about new available frames from the video source.</para>
  377. <para><note>Since video source may have multiple clients, each client is responsible for
  378. making a copy (cloning) of the passed video frame, because the video source disposes its
  379. own original copy after notifying of clients.</note></para>
  380. </remarks>
  381. </member>
  382. <member name="E:AForge.Video.Kinect.KinectVideoCamera.VideoSourceError">
  383. <summary>
  384. Video source error event.
  385. </summary>
  386. <remarks>This event is used to notify clients about any type of errors occurred in
  387. video source object, for example internal exceptions.</remarks>
  388. </member>
  389. <member name="E:AForge.Video.Kinect.KinectVideoCamera.PlayingFinished">
  390. <summary>
  391. Video playing finished event.
  392. </summary>
  393. <remarks><para>This event is used to notify clients that the video playing has finished.</para>
  394. </remarks>
  395. </member>
  396. <member name="P:AForge.Video.Kinect.KinectVideoCamera.CameraMode">
  397. <summary>
  398. Specifies video mode for the camera.
  399. </summary>
  400. <remarks>
  401. <para><note>The property must be set before running the video source to take effect.</note></para>
  402. <para>Default value of the property is set to <see cref="F:AForge.Video.Kinect.VideoCameraMode.Color"/>.</para>
  403. </remarks>
  404. </member>
  405. <member name="P:AForge.Video.Kinect.KinectVideoCamera.Resolution">
  406. <summary>
  407. Resolution of video camera to set.
  408. </summary>
  409. <remarks><para><note>The property must be set before running the video source to take effect.</note></para>
  410. <para>Default value of the property is set to <see cref="F:AForge.Video.Kinect.CameraResolution.Medium"/>.</para>
  411. </remarks>
  412. </member>
  413. <member name="P:AForge.Video.Kinect.KinectVideoCamera.Source">
  414. <summary>
  415. A string identifying the video source.
  416. </summary>
  417. </member>
  418. <member name="P:AForge.Video.Kinect.KinectVideoCamera.IsRunning">
  419. <summary>
  420. State of the video source.
  421. </summary>
  422. <remarks>Current state of video source object - running or not.</remarks>
  423. </member>
  424. <member name="P:AForge.Video.Kinect.KinectVideoCamera.BytesReceived">
  425. <summary>
  426. Received bytes count.
  427. </summary>
  428. <remarks>Number of bytes the video source provided from the moment of the last
  429. access to the property.
  430. </remarks>
  431. </member>
  432. <member name="P:AForge.Video.Kinect.KinectVideoCamera.FramesReceived">
  433. <summary>
  434. Received frames count.
  435. </summary>
  436. <remarks>Number of frames the video source provided from the moment of the last
  437. access to the property.
  438. </remarks>
  439. </member>
  440. <member name="M:AForge.Video.Kinect.KinectVideoCamera.#ctor(System.Int32)">
  441. <summary>
  442. Initializes a new instance of the <see cref="T:AForge.Video.Kinect.KinectVideoCamera"/> class.
  443. </summary>
  444. <param name="deviceID">Kinect's device ID (index) to connect to.</param>
  445. </member>
  446. <member name="M:AForge.Video.Kinect.KinectVideoCamera.#ctor(System.Int32,AForge.Video.Kinect.CameraResolution)">
  447. <summary>
  448. Initializes a new instance of the <see cref="T:AForge.Video.Kinect.KinectVideoCamera"/> class.
  449. </summary>
  450. <param name="deviceID">Kinect's device ID (index) to connect to.</param>
  451. <param name="resolution">Resolution of video camera to set.</param>
  452. </member>
  453. <member name="M:AForge.Video.Kinect.KinectVideoCamera.#ctor(System.Int32,AForge.Video.Kinect.CameraResolution,AForge.Video.Kinect.VideoCameraMode)">
  454. <summary>
  455. Initializes a new instance of the <see cref="T:AForge.Video.Kinect.KinectVideoCamera"/> class.
  456. </summary>
  457. <param name="deviceID">Kinect's device ID (index) to connect to.</param>
  458. <param name="resolution">Resolution of video camera to set.</param>
  459. <param name="cameraMode">Sets video camera mode.</param>
  460. </member>
  461. <member name="M:AForge.Video.Kinect.KinectVideoCamera.Start">
  462. <summary>
  463. Start video source.
  464. </summary>
  465. <remarks>Starts video source and returns execution to caller. Video camera will be started
  466. and will provide new video frames through the <see cref="E:AForge.Video.Kinect.KinectVideoCamera.NewFrame"/> event.</remarks>
  467. <exception cref="T:System.ArgumentException">The specified resolution is not supported for the selected
  468. mode of the Kinect video camera.</exception>
  469. <exception cref="T:AForge.ConnectionFailedException">Could not connect to Kinect's video camera.</exception>
  470. <exception cref="T:AForge.DeviceBusyException">Another connection to the specified video camera is already running.</exception>
  471. </member>
  472. <member name="M:AForge.Video.Kinect.KinectVideoCamera.SignalToStop">
  473. <summary>
  474. Signal video source to stop its work.
  475. </summary>
  476. <remarks><para><note>Calling this method is equivalent to calling <see cref="M:AForge.Video.Kinect.KinectVideoCamera.Stop"/>
  477. for Kinect video camera.</note></para></remarks>
  478. </member>
  479. <member name="M:AForge.Video.Kinect.KinectVideoCamera.WaitForStop">
  480. <summary>
  481. Wait for video source has stopped.
  482. </summary>
  483. <remarks><para><note>Calling this method is equivalent to calling <see cref="M:AForge.Video.Kinect.KinectVideoCamera.Stop"/>
  484. for Kinect video camera.</note></para></remarks>
  485. </member>
  486. <member name="M:AForge.Video.Kinect.KinectVideoCamera.Stop">
  487. <summary>
  488. Stop video source.
  489. </summary>
  490. <remarks><para>The method stops the video source, so it no longer provides new video frames
  491. and does not consume any resources.</para>
  492. </remarks>
  493. </member>
  494. </members>
  495. </doc>