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.

1453 lines
63 KiB

1 month ago
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>AForge.Controls</name>
  5. </assembly>
  6. <members>
  7. <member name="T:AForge.Controls.HuePicker">
  8. <summary>
  9. Hue picker control.
  10. </summary>
  11. <remarks><para>The control allows selecting hue value (or range) from HSL color space. Hue values
  12. are integer values in the [0, 359] range.</para>
  13. <para>If control's type is set to <see cref="F:AForge.Controls.HuePicker.HuePickerType.Value"/>, then it allows selecting single
  14. hue value and looks like this:<br />
  15. <img src="img/controls/hue_picker1.png" width="220" height="220" />
  16. </para>
  17. <para>If control's type is set to <see cref="F:AForge.Controls.HuePicker.HuePickerType.Range"/>, then it allows selecting range
  18. of hue values and looks like this:<br />
  19. <img src="img/controls/hue_picker2.png" width="220" height="220" />
  20. </para>
  21. </remarks>
  22. </member>
  23. <member name="E:AForge.Controls.HuePicker.ValuesChanged">
  24. <summary>
  25. An event, to notify about changes of <see cref="P:AForge.Controls.HuePicker.Min"/> or <see cref="P:AForge.Controls.HuePicker.Max"/> properties.
  26. </summary>
  27. <remarks><para>The event is fired after changes of its <see cref="P:AForge.Controls.HuePicker.Value"/>, <see cref="P:AForge.Controls.HuePicker.Min"/> or
  28. <see cref="P:AForge.Controls.HuePicker.Max"/> properties, which is caused by user dragging the corresponding hue picker's bullets.</para>
  29. </remarks>
  30. </member>
  31. <member name="T:AForge.Controls.HuePicker.HuePickerType">
  32. <summary>
  33. Enumeration of hue picker types.
  34. </summary>
  35. <remarks>
  36. <para>The <see cref="F:AForge.Controls.HuePicker.HuePickerType.Value"/> type provides single bullet to drag, which allows
  37. selecting single hue value. The value is accessible through <see cref="F:AForge.Controls.HuePicker.HuePickerType.Value"/> property.</para>
  38. <para>The <see cref="F:AForge.Controls.HuePicker.HuePickerType.Range"/> type provides two bullets to drag, which correspond
  39. to minimum and maximum values of the hue range. These values are accessible through
  40. <see cref="P:AForge.Controls.HuePicker.Min"/> and <see cref="P:AForge.Controls.HuePicker.Max"/> properties.</para>
  41. </remarks>
  42. </member>
  43. <member name="F:AForge.Controls.HuePicker.HuePickerType.Value">
  44. <summary>
  45. Selecting single hue value.
  46. </summary>
  47. </member>
  48. <member name="F:AForge.Controls.HuePicker.HuePickerType.Range">
  49. <summary>
  50. Selecting hue values range.
  51. </summary>
  52. </member>
  53. <member name="P:AForge.Controls.HuePicker.Value">
  54. <summary>
  55. Selected value of the hue picker control in <see cref="F:AForge.Controls.HuePicker.HuePickerType.Value"/> mode.
  56. </summary>
  57. </member>
  58. <member name="P:AForge.Controls.HuePicker.Min">
  59. <summary>
  60. Minimum selected value of the hue picker control in <see cref="F:AForge.Controls.HuePicker.HuePickerType.Range"/> mode.
  61. </summary>
  62. </member>
  63. <member name="P:AForge.Controls.HuePicker.Max">
  64. <summary>
  65. Maximum selected value of the hue picker control in <see cref="F:AForge.Controls.HuePicker.HuePickerType.Range"/> mode.
  66. </summary>
  67. </member>
  68. <member name="P:AForge.Controls.HuePicker.Type">
  69. <summary>
  70. Current type of the hue picker control.
  71. </summary>
  72. <remarks><para>See <see cref="T:AForge.Controls.HuePicker.HuePickerType"/> enumeration for description of the available types.</para></remarks>
  73. </member>
  74. <member name="M:AForge.Controls.HuePicker.#ctor">
  75. <summary>
  76. Initializes a new instance of the <see cref="T:AForge.Controls.HuePicker"/> class.
  77. </summary>
  78. </member>
  79. <member name="M:AForge.Controls.HuePicker.Dispose(System.Boolean)">
  80. <summary>
  81. Dispose the object.
  82. </summary>
  83. <param name="disposing">Specifies if disposing was invoked by user's code.</param>
  84. </member>
  85. <member name="M:AForge.Controls.HuePicker.OnPaint(System.Windows.Forms.PaintEventArgs)">
  86. <summary>
  87. Paint the controls.
  88. </summary>
  89. <param name="pe">Paint event arguments.</param>
  90. </member>
  91. <member name="T:AForge.Controls.SliderControl">
  92. <summary>
  93. Slider control.
  94. </summary>
  95. <remarks>
  96. <para>The control represents a slider, which can be dragged in the [-1, 1] range.
  97. Default position of the slider is set 0, which corresponds to center of the control.<br />
  98. <img src="img/controls/slider_control.png" width="227" height="56" />
  99. </para>
  100. </remarks>
  101. </member>
  102. <member name="P:AForge.Controls.SliderControl.ResetPositionOnMouseRelease">
  103. <summary>
  104. Determines behaviour of manipulator, when mouse button is released.
  105. </summary>
  106. <remarks>
  107. <para>The property controls behaviour of manipulator on releasing mouse button. If
  108. the property is set to <see langword="true"/>, then position of manipulator is reset
  109. to 0, when mouse button is released. Otherwise manipulator stays on the place,
  110. where it was left.</para>
  111. <para>Default value is set to <see langword="true"/>.</para>
  112. </remarks>
  113. </member>
  114. <member name="P:AForge.Controls.SliderControl.BorderColor">
  115. <summary>
  116. Color used for drawing borders.
  117. </summary>
  118. <remarks>
  119. <para>Default value is set to <see cref="P:System.Drawing.Color.Black"/>.</para>
  120. </remarks>
  121. </member>
  122. <member name="P:AForge.Controls.SliderControl.PositiveAreaBrush">
  123. <summary>
  124. Background color used for filling area corresponding to positive values.
  125. </summary>
  126. <remarks>
  127. <para>Default value is set to <see cref="P:System.Drawing.Color.White"/>.</para>
  128. </remarks>
  129. </member>
  130. <member name="P:AForge.Controls.SliderControl.NegativeAreaBrush">
  131. <summary>
  132. Background color used for filling area corresponding to negative values.
  133. </summary>
  134. <remarks>
  135. <para>Default value is set to <see cref="P:System.Drawing.Color.LightGray"/>.</para>
  136. </remarks>
  137. </member>
  138. <member name="P:AForge.Controls.SliderControl.ManipulatorColor">
  139. <summary>
  140. Color used for filling manipulator.
  141. </summary>
  142. <remarks>
  143. <para>Default value is set to <see cref="P:System.Drawing.Color.LightSeaGreen"/>.</para>
  144. </remarks>
  145. </member>
  146. <member name="P:AForge.Controls.SliderControl.IsHorizontal">
  147. <summary>
  148. Defines if control has horizontal or vertical look.
  149. </summary>
  150. <remarks>
  151. <para>Default value is set to <see langword="true"/>.</para>
  152. </remarks>
  153. </member>
  154. <member name="P:AForge.Controls.SliderControl.ManipulatorPosition">
  155. <summary>
  156. Current manipulator's position, [-1, 1].
  157. </summary>
  158. <remarks><para>The property equals to current manipulator's position.</para>
  159. </remarks>
  160. </member>
  161. <member name="T:AForge.Controls.SliderControl.PositionChangedHandler">
  162. <summary>
  163. Delegate used for notification about manipulator's position changes.
  164. </summary>
  165. <param name="sender">Event sender - object sending the event.</param>
  166. <param name="position">Current position of manipulator.</param>
  167. </member>
  168. <member name="E:AForge.Controls.SliderControl.PositionChanged">
  169. <summary>
  170. Event used for notification about manipulator's position changes.
  171. </summary>
  172. </member>
  173. <member name="M:AForge.Controls.SliderControl.#ctor">
  174. <summary>
  175. Initializes a new instance of the <see cref="T:AForge.Controls.SliderControl"/> class.
  176. </summary>
  177. </member>
  178. <member name="F:AForge.Controls.SliderControl.components">
  179. <summary>
  180. Required designer variable.
  181. </summary>
  182. </member>
  183. <member name="M:AForge.Controls.SliderControl.Dispose(System.Boolean)">
  184. <summary>
  185. Clean up any resources being used.
  186. </summary>
  187. <param name="disposing">true if managed resources should be disposed; otherwise, false.</param>
  188. </member>
  189. <member name="M:AForge.Controls.SliderControl.InitializeComponent">
  190. <summary>
  191. Required method for Designer support - do not modify
  192. the contents of this method with the code editor.
  193. </summary>
  194. </member>
  195. <member name="T:AForge.Controls.Chart">
  196. <summary>
  197. Chart control.
  198. </summary>
  199. <remarks><para>The chart control allows to display multiple charts at time
  200. of different types: dots, lines, connected dots.</para>
  201. <para>Sample usage:</para>
  202. <code>
  203. // create data series array
  204. double[,] testValues = new double[10, 2];
  205. // fill data series
  206. for ( int i = 0; i &lt; 10; i++ )
  207. {
  208. testValues[i, 0] = i; // X values
  209. testValues[i, 1] = Math.Sin( i / 18.0 * Math.PI ); // Y values
  210. }
  211. // add new data series to the chart
  212. chart.AddDataSeries( "Test", Color.DarkGreen, Chart.SeriesType.ConnectedDots, 3 );
  213. // set X range to display
  214. chart.RangeX = new AForge.Range( 0, 9 );
  215. // update the chart
  216. chart.UpdateDataSeries( "Test", testValues );
  217. </code>
  218. </remarks>
  219. </member>
  220. <member name="T:AForge.Controls.Chart.SeriesType">
  221. <summary>
  222. Chart series type enumeration.
  223. </summary>
  224. </member>
  225. <member name="F:AForge.Controls.Chart.SeriesType.Line">
  226. <summary>
  227. Line style.
  228. </summary>
  229. </member>
  230. <member name="F:AForge.Controls.Chart.SeriesType.Dots">
  231. <summary>
  232. Dots style.
  233. </summary>
  234. </member>
  235. <member name="F:AForge.Controls.Chart.SeriesType.ConnectedDots">
  236. <summary>
  237. Connected dots style.
  238. </summary>
  239. </member>
  240. <member name="P:AForge.Controls.Chart.RangeX">
  241. <summary>
  242. Chart's X range.
  243. </summary>
  244. <remarks><para>The value sets the X range of data to be displayed on the chart.</para></remarks>
  245. </member>
  246. <member name="P:AForge.Controls.Chart.RangeY">
  247. <summary>
  248. Chart's Y range.
  249. </summary>
  250. <remarks>The value sets the Y range of data to be displayed on the chart.</remarks>
  251. </member>
  252. <member name="F:AForge.Controls.Chart.components">
  253. <summary>
  254. Required designer variable.
  255. </summary>
  256. </member>
  257. <member name="M:AForge.Controls.Chart.#ctor">
  258. <summary>
  259. Initializes a new instance of the <see cref="T:AForge.Controls.Chart"/> class.
  260. </summary>
  261. </member>
  262. <member name="M:AForge.Controls.Chart.Dispose(System.Boolean)">
  263. <summary>
  264. Dispose the object.
  265. </summary>
  266. </member>
  267. <member name="M:AForge.Controls.Chart.InitializeComponent">
  268. <summary>
  269. Required method for Designer support - do not modify
  270. the contents of this method with the code editor.
  271. </summary>
  272. </member>
  273. <member name="M:AForge.Controls.Chart.AddDataSeries(System.String,System.Drawing.Color,AForge.Controls.Chart.SeriesType,System.Int32)">
  274. <summary>
  275. Add data series to the chart.
  276. </summary>
  277. <param name="name">Data series name.</param>
  278. <param name="color">Data series color.</param>
  279. <param name="type">Data series type.</param>
  280. <param name="width">Width (depends on the data series type, see remarks).</param>
  281. <remarks><para>Adds new empty data series to the collection of data series. To update this
  282. series the <see cref="M:AForge.Controls.Chart.UpdateDataSeries(System.String,System.Double[0:,0:])"/> method should be used.</para>
  283. <para>The meaning of the width parameter depends on the data series type:
  284. <list type="bullet">
  285. <item><b>Line</b> - width of the line;</item>
  286. <item><b>Dots</b> - size of dots (rectangular dots with specified width and the same height);</item>
  287. <item><b>Connected dots</b> - size of dots (dots are connected with one pixel width line).</item>
  288. </list>
  289. </para>
  290. </remarks>
  291. </member>
  292. <member name="M:AForge.Controls.Chart.AddDataSeries(System.String,System.Drawing.Color,AForge.Controls.Chart.SeriesType,System.Int32,System.Boolean)">
  293. <summary>
  294. Add data series to the chart.
  295. </summary>
  296. <param name="name">Data series name.</param>
  297. <param name="color">Data series color.</param>
  298. <param name="type">Data series type.</param>
  299. <param name="width">Width (depends on the data series type, see remarks).</param>
  300. <param name="updateYRange">Specifies if <see cref="P:AForge.Controls.Chart.RangeY"/> should be updated.</param>
  301. <remarks><para>Adds new empty data series to the collection of data series.</para>
  302. <para>The <b>updateYRange</b> parameter specifies if the data series may affect displayable
  303. Y range. If the value is set to false, then displayable Y range is not updated, but used the
  304. range, which was specified by user (see <see cref="P:AForge.Controls.Chart.RangeY"/> property). In the case if the
  305. value is set to true, the displayable Y range is recalculated to fully fit the new data
  306. series.</para>
  307. </remarks>
  308. </member>
  309. <member name="M:AForge.Controls.Chart.UpdateDataSeries(System.String,System.Double[0:,0:])">
  310. <summary>
  311. Update data series on the chart.
  312. </summary>
  313. <param name="name">Data series name to update.</param>
  314. <param name="data">Data series values.</param>
  315. </member>
  316. <member name="M:AForge.Controls.Chart.RemoveDataSeries(System.String)">
  317. <summary>
  318. Remove data series from the chart.
  319. </summary>
  320. <param name="name">Data series name to remove.</param>
  321. </member>
  322. <member name="M:AForge.Controls.Chart.RemoveAllDataSeries">
  323. <summary>
  324. Remove all data series from the chart.
  325. </summary>
  326. </member>
  327. <member name="M:AForge.Controls.Chart.UpdateYRange">
  328. <summary>
  329. Update Y range.
  330. </summary>
  331. </member>
  332. <member name="T:AForge.Controls.ColorSlider">
  333. <summary>
  334. Color slider control.
  335. </summary>
  336. <remarks><para>The control represent a color slider, which allows selecting
  337. one or two values in the [0, 255] range. The application of this control
  338. includes mostly areas of image processing and computer vision, where it is required
  339. to select color threshold or ranges for different type of color filtering.</para>
  340. <para>Depending on the control's <see cref="P:AForge.Controls.ColorSlider.Type"/>, it has different look and may suite
  341. different tasks. See documentation to <see cref="T:AForge.Controls.ColorSlider.ColorSliderType"/> for information
  342. about available type and possible control's looks.</para>
  343. </remarks>
  344. </member>
  345. <member name="E:AForge.Controls.ColorSlider.ValuesChanged">
  346. <summary>
  347. An event, to notify about changes of <see cref="P:AForge.Controls.ColorSlider.Min"/> or <see cref="P:AForge.Controls.ColorSlider.Max"/> properties.
  348. </summary>
  349. <remarks><para>The event is fired after changes of <see cref="P:AForge.Controls.ColorSlider.Min"/> or <see cref="P:AForge.Controls.ColorSlider.Max"/> property,
  350. which is caused by user dragging the corresponding control抯 arrow (slider).</para>
  351. </remarks>
  352. </member>
  353. <member name="T:AForge.Controls.ColorSlider.ColorSliderType">
  354. <summary>
  355. Enumeration of color slider types.
  356. </summary>
  357. <remarks>
  358. <para>The <see cref="F:AForge.Controls.ColorSlider.ColorSliderType.Gradient"/> slider's type supposes the control's
  359. background filled with gradient startting from <see cref="P:AForge.Controls.ColorSlider.StartColor"/> color and ending
  360. with <see cref="P:AForge.Controls.ColorSlider.EndColor"/> color. The <see cref="P:AForge.Controls.ColorSlider.FillColor"/> color does not have
  361. impact on control's look.</para>
  362. <para>This type allows as one-arrow, as two-arrows control.</para>
  363. <para><b>Sample control's look:</b></para>
  364. <img src="img/controls/slider_gradient.png" width="258" height="17" />
  365. <para>The <see cref="F:AForge.Controls.ColorSlider.ColorSliderType.InnerGradient"/> slider's type supposes the control's
  366. background filled with gradient startting from <see cref="P:AForge.Controls.ColorSlider.StartColor"/> color and ending
  367. with <see cref="P:AForge.Controls.ColorSlider.EndColor"/> color. In addition the areas, which are outside of
  368. [<see cref="P:AForge.Controls.ColorSlider.Min"/>, <see cref="P:AForge.Controls.ColorSlider.Max"/>] range, are filled with <see cref="P:AForge.Controls.ColorSlider.FillColor"/> color.</para>
  369. <para>This type allows only two-arrows control.</para>
  370. <para><b>Sample control's look:</b></para>
  371. <img src="img/controls/slider_inner_gradient.png" width="258" height="17" />
  372. <para>The <see cref="F:AForge.Controls.ColorSlider.ColorSliderType.OuterGradient"/> slider's type supposes the
  373. control's background filled with gradient startting from <see cref="P:AForge.Controls.ColorSlider.StartColor"/> color
  374. and ending with <see cref="P:AForge.Controls.ColorSlider.EndColor"/> color. In addition the area, which is inside of
  375. [<see cref="P:AForge.Controls.ColorSlider.Min"/>, <see cref="P:AForge.Controls.ColorSlider.Max"/>] range, is filled with <see cref="P:AForge.Controls.ColorSlider.FillColor"/> color.</para>
  376. <para>This type allows only two-arrows control.</para>
  377. <para><b>Sample control's look:</b></para>
  378. <img src="img/controls/slider_outer_gradient.png" width="258" height="17" />
  379. <para>The <see cref="F:AForge.Controls.ColorSlider.ColorSliderType.Threshold"/> slider's type supposes filling areas
  380. outside of [<see cref="P:AForge.Controls.ColorSlider.Min"/>, <see cref="P:AForge.Controls.ColorSlider.Max"/>] range with <see cref="P:AForge.Controls.ColorSlider.StartColor"/> and
  381. inside the range with <see cref="P:AForge.Controls.ColorSlider.EndColor"/>. The <see cref="P:AForge.Controls.ColorSlider.FillColor"/> color does not
  382. have impact on control's look.</para>
  383. <para>This type allows as one-arrow, as two-arrows control.</para>
  384. <para><b>Sample control's look:</b></para>
  385. <img src="img/controls/slider_threshold.png" width="258" height="17" />
  386. </remarks>
  387. </member>
  388. <member name="F:AForge.Controls.ColorSlider.ColorSliderType.Gradient">
  389. <summary>
  390. Gradient color slider type.
  391. </summary>
  392. </member>
  393. <member name="F:AForge.Controls.ColorSlider.ColorSliderType.InnerGradient">
  394. <summary>
  395. Inner gradient color slider type.
  396. </summary>
  397. </member>
  398. <member name="F:AForge.Controls.ColorSlider.ColorSliderType.OuterGradient">
  399. <summary>
  400. Outer gradient color slider type.
  401. </summary>
  402. </member>
  403. <member name="F:AForge.Controls.ColorSlider.ColorSliderType.Threshold">
  404. <summary>
  405. Threshold color slider type.
  406. </summary>
  407. </member>
  408. <member name="P:AForge.Controls.ColorSlider.StartColor">
  409. <summary>
  410. Start color for gradient filling.
  411. </summary>
  412. <remarks>See documentation to <see cref="T:AForge.Controls.ColorSlider.ColorSliderType"/> enumeration for information about
  413. the usage of this property.</remarks>
  414. </member>
  415. <member name="P:AForge.Controls.ColorSlider.EndColor">
  416. <summary>
  417. End color for gradient filling.
  418. </summary>
  419. <remarks>See documentation to <see cref="T:AForge.Controls.ColorSlider.ColorSliderType"/> enumeration for information about
  420. the usage of this property.</remarks>
  421. </member>
  422. <member name="P:AForge.Controls.ColorSlider.FillColor">
  423. <summary>
  424. Color to fill control's background in filtered zones.
  425. </summary>
  426. <remarks>See documentation to <see cref="T:AForge.Controls.ColorSlider.ColorSliderType"/> enumeration for information about
  427. the usage of this property.</remarks>
  428. </member>
  429. <member name="P:AForge.Controls.ColorSlider.Type">
  430. <summary>
  431. Specifies control's type.
  432. </summary>
  433. <remarks>See documentation to <see cref="T:AForge.Controls.ColorSlider.ColorSliderType"/> enumeration for information about
  434. the usage of this property.</remarks>
  435. </member>
  436. <member name="P:AForge.Controls.ColorSlider.Min">
  437. <summary>
  438. Minimum selected value, [0, 255].
  439. </summary>
  440. </member>
  441. <member name="P:AForge.Controls.ColorSlider.Max">
  442. <summary>
  443. Maximum selected value, [0, 255].
  444. </summary>
  445. </member>
  446. <member name="P:AForge.Controls.ColorSlider.DoubleArrow">
  447. <summary>
  448. Single or Double arrow slider control.
  449. </summary>
  450. <remarks><para>The property specifies if the slider has one or two selection arrows (sliders).</para>
  451. <para>The single arrow allows only to specify one value, which is set by <see cref="P:AForge.Controls.ColorSlider.Min"/>
  452. property. The single arrow slider is useful for applications, where it is required to select
  453. color threshold, for example.</para>
  454. <para>The double arrow allows to specify two values, which are set by <see cref="P:AForge.Controls.ColorSlider.Min"/>
  455. and <see cref="P:AForge.Controls.ColorSlider.Max"/> properties. The double arrow slider is useful for applications, where it is
  456. required to select filtering color range, for example.</para>
  457. </remarks>
  458. </member>
  459. <member name="M:AForge.Controls.ColorSlider.#ctor">
  460. <summary>
  461. Initializes a new instance of the <see cref="T:AForge.Controls.ColorSlider"/> class.
  462. </summary>
  463. </member>
  464. <member name="M:AForge.Controls.ColorSlider.Dispose(System.Boolean)">
  465. <summary>
  466. Dispose the object.
  467. </summary>
  468. <param name="disposing">Specifies if disposing was invoked by user's code.</param>
  469. </member>
  470. <member name="T:AForge.Controls.HistogramEventArgs">
  471. <summary>
  472. Arguments of histogram events.
  473. </summary>
  474. </member>
  475. <member name="M:AForge.Controls.HistogramEventArgs.#ctor(System.Int32)">
  476. <summary>
  477. Initializes a new instance of the <see cref="T:AForge.Controls.HistogramEventArgs"/> class.
  478. </summary>
  479. <param name="pos">Histogram's index under mouse pointer.</param>
  480. </member>
  481. <member name="M:AForge.Controls.HistogramEventArgs.#ctor(System.Int32,System.Int32)">
  482. <summary>
  483. Initializes a new instance of the <see cref="T:AForge.Controls.HistogramEventArgs"/> class.
  484. </summary>
  485. <param name="min">Min histogram's index in selection.</param>
  486. <param name="max">Max histogram's index in selection.</param>
  487. </member>
  488. <member name="P:AForge.Controls.HistogramEventArgs.Min">
  489. <summary>
  490. Min histogram's index in selection.
  491. </summary>
  492. </member>
  493. <member name="P:AForge.Controls.HistogramEventArgs.Max">
  494. <summary>
  495. Max histogram's index in selection.
  496. </summary>
  497. </member>
  498. <member name="P:AForge.Controls.HistogramEventArgs.Position">
  499. <summary>
  500. Histogram's index under mouse pointer.
  501. </summary>
  502. </member>
  503. <member name="T:AForge.Controls.HistogramEventHandler">
  504. <summary>
  505. Delegate for histogram events handlers.
  506. </summary>
  507. <param name="sender">Sender object.</param>
  508. <param name="e">Event arguments.</param>
  509. </member>
  510. <member name="T:AForge.Controls.Histogram">
  511. <summary>
  512. Histogram control.
  513. </summary>
  514. <remarks><para>The control displays histograms represented with integer arrays,
  515. where each array's element keeps occurrence number of the corresponding element.
  516. </para>
  517. <para>Sample usage:</para>
  518. <code>
  519. // create array with histogram values
  520. int[] histogramValues = new int[] { 3, 8, 53, 57, 79, 69, ... };
  521. // set values to histogram control
  522. histogram.Values = histogramValues;
  523. </code>
  524. <para><b>Sample control's look:</b></para>
  525. <img src="img/controls/histogram.jpg" width="324" height="77" />
  526. </remarks>
  527. </member>
  528. <member name="P:AForge.Controls.Histogram.Color">
  529. <summary>
  530. Histogram's color.
  531. </summary>
  532. </member>
  533. <member name="P:AForge.Controls.Histogram.AllowSelection">
  534. <summary>
  535. Allow mouse selection or not.
  536. </summary>
  537. <remarks>In the case if mouse selection is allowed, the control will
  538. fire <see cref="E:AForge.Controls.Histogram.SelectionChanged"/> and <see cref="E:AForge.Controls.Histogram.PositionChanged"/> events
  539. and provide information about the selection.</remarks>
  540. </member>
  541. <member name="P:AForge.Controls.Histogram.IsLogarithmicView">
  542. <summary>
  543. Logarithmic view or not.
  544. </summary>
  545. <remarks><para>In the case if logarihmic view is selected, then the control
  546. will display base 10 logarithm of values.</para>
  547. <para>By default the property is set to <b>false</b> - none logarithmic view.</para></remarks>
  548. </member>
  549. <member name="P:AForge.Controls.Histogram.IsVertical">
  550. <summary>
  551. Vertical view or not.
  552. </summary>
  553. <remarks><para>The property determines if histogram should be displayed vertically or
  554. not (horizontally).</para>
  555. <para>By default the property is set to <b>false</b> - horizontal view.</para></remarks>
  556. </member>
  557. <member name="P:AForge.Controls.Histogram.Values">
  558. <summary>
  559. Histogram values.
  560. </summary>
  561. <remarks>Non-negative histogram values.</remarks>
  562. <exception cref="T:System.ArgumentException">Histogram values should be non-negative.</exception>
  563. </member>
  564. <member name="E:AForge.Controls.Histogram.PositionChanged">
  565. <summary>
  566. Mouse position changed event.
  567. </summary>
  568. <remarks>The event is fired only if the <see cref="P:AForge.Controls.Histogram.AllowSelection"/> property is set
  569. to true. The passed to event handler <see cref="T:AForge.Controls.HistogramEventArgs"/> class is initialized
  570. with <see cref="P:AForge.Controls.HistogramEventArgs.Position"/> property only, which is histogram value's
  571. index pointed by mouse.</remarks>
  572. </member>
  573. <member name="E:AForge.Controls.Histogram.SelectionChanged">
  574. <summary>
  575. Mouse selection changed event.
  576. </summary>
  577. <remarks>The event is fired only if the <see cref="P:AForge.Controls.Histogram.AllowSelection"/> property is set
  578. to true. The passed to event handler <see cref="T:AForge.Controls.HistogramEventArgs"/> class is initialized
  579. with <see cref="P:AForge.Controls.HistogramEventArgs.Min"/> and <see cref="P:AForge.Controls.HistogramEventArgs.Max"/> properties
  580. only, which represent selection range - min and max indexes.</remarks>
  581. </member>
  582. <member name="M:AForge.Controls.Histogram.#ctor">
  583. <summary>
  584. Initializes a new instance of the <see cref="T:AForge.Controls.Histogram"/> class.
  585. </summary>
  586. </member>
  587. <member name="M:AForge.Controls.Histogram.Dispose(System.Boolean)">
  588. <summary>
  589. Dispose the object.
  590. </summary>
  591. <param name="disposing">Indicates if disposing was initiated manually.</param>
  592. </member>
  593. <member name="M:AForge.Controls.Histogram.OnPaint(System.Windows.Forms.PaintEventArgs)">
  594. <summary>
  595. Paint the control.
  596. </summary>
  597. <param name="pe">Data for Paint event.</param>
  598. </member>
  599. <member name="T:AForge.Controls.Joystick">
  600. <summary>
  601. The class provides simple API for enumerating available joysticks and checking their
  602. current status.
  603. </summary>
  604. <remarks><para>The class provides simple access to joysticks (game controllers) through using
  605. Win32 API, which allows to enumerate available devices and query their status (state of all buttons,
  606. axes, etc).</para>
  607. <para>Sample usage:</para>
  608. <code>
  609. // enumerate available devices
  610. List&lt;Joystick.DeviceInfo&gt; devices = Joystick.GetAvailableDevices( );
  611. foreach ( Joystick.DeviceInfo di in devices )
  612. {
  613. System.Diagnostics.Debug.WriteLine(
  614. string.Format( "{0} : {1} ({2} axes, {3} buttons)",
  615. di.ID, di.Name, di.Axes, di.Buttons ) );
  616. }
  617. // create new joystick and initialize it
  618. Joystick joystick = new Joystick( 0 );
  619. // get its current status
  620. Joystick.Status status = joystick.GetCurrentStatus( );
  621. // check if 1st button is pressed
  622. if ( status.IsButtonPressed( Joystick.Buttons.Button1 ) )
  623. {
  624. // 1st button is pressed
  625. }
  626. </code>
  627. </remarks>
  628. </member>
  629. <member name="P:AForge.Controls.Joystick.Info">
  630. <summary>
  631. Information about initialized joystick.
  632. </summary>
  633. <remarks><para>The property keeps information about joystick, which was
  634. initialized using <see cref="M:AForge.Controls.Joystick.Init(System.Int32)"/> method. If no joystick was initialized,
  635. then accessing this property will generate <see cref="T:System.ApplicationException"/>
  636. exception.</para></remarks>
  637. <exception cref="T:System.ApplicationException">Joystick was not initialized.</exception>
  638. </member>
  639. <member name="T:AForge.Controls.Joystick.DeviceInfo">
  640. <summary>
  641. Information about joystick connected to the system.
  642. </summary>
  643. </member>
  644. <member name="F:AForge.Controls.Joystick.DeviceInfo.ID">
  645. <summary>
  646. Joystick ID, [0..15].
  647. </summary>
  648. </member>
  649. <member name="P:AForge.Controls.Joystick.DeviceInfo.Name">
  650. <summary>
  651. Joystick name.
  652. </summary>
  653. </member>
  654. <member name="P:AForge.Controls.Joystick.DeviceInfo.Axes">
  655. <summary>
  656. Number of joystick axes.
  657. </summary>
  658. </member>
  659. <member name="P:AForge.Controls.Joystick.DeviceInfo.Buttons">
  660. <summary>
  661. Number of joystick buttons.
  662. </summary>
  663. </member>
  664. <member name="M:AForge.Controls.Joystick.GetAvailableDevices">
  665. <summary>
  666. Get list of available joysticks connected to the system.
  667. </summary>
  668. <returns>Returns list containing information about available joysticks connected to
  669. the system.</returns>
  670. </member>
  671. <member name="M:AForge.Controls.Joystick.#ctor">
  672. <summary>
  673. Initializes a new instance of the <see cref="T:AForge.Controls.Joystick"/> class.
  674. </summary>
  675. <remarks><para>This constructor does not make initialization of any joystick
  676. device, so <see cref="M:AForge.Controls.Joystick.Init(System.Int32)"/> method should be used before querying joystick
  677. status or properties.</para></remarks>
  678. </member>
  679. <member name="M:AForge.Controls.Joystick.#ctor(System.Int32)">
  680. <summary>
  681. Initializes a new instance of the <see cref="T:AForge.Controls.Joystick"/> class.
  682. </summary>
  683. <param name="id">Joystick ID to initialize, [0, 15].</param>
  684. <remarks><para>This constructor initializes joystick with specified ID using
  685. <see cref="M:AForge.Controls.Joystick.Init(System.Int32)"/> method, so the object becomes ready for querying joystick's
  686. status.</para></remarks>
  687. </member>
  688. <member name="M:AForge.Controls.Joystick.Init(System.Int32)">
  689. <summary>
  690. Initialize joystick with the specified ID.
  691. </summary>
  692. <param name="id">Joystick's ID to initialize, [0, 15].</param>
  693. <remarks><para></para></remarks>
  694. <exception cref="T:System.ArgumentException">Invalid joystick ID was specified. It must be in [0, 15] range.</exception>
  695. <exception cref="T:AForge.NotConnectedException">The requested joystick is not connected to the system.</exception>
  696. </member>
  697. <member name="M:AForge.Controls.Joystick.GetCurrentStatus">
  698. <summary>
  699. Get joystick's status.
  700. </summary>
  701. <returns>Returns current status of initialized joystick, which provides information
  702. about current state of all axes, buttons and point of view.</returns>
  703. <remarks><para><note>Before using this method the joystick object needs to be initialized
  704. using <see cref="M:AForge.Controls.Joystick.Init(System.Int32)"/> method or <see cref="M:AForge.Controls.Joystick.#ctor(System.Int32)"/> constructor.</note></para></remarks>
  705. <exception cref="T:AForge.NotConnectedException">The requested joystick is not connected to the system.</exception>
  706. <exception cref="T:System.ApplicationException">Joystick was not initialized.</exception>
  707. </member>
  708. <member name="T:AForge.Controls.Joystick.Status">
  709. <summary>
  710. Class describing current joystick's status.
  711. </summary>
  712. <remarks><para><note>All joystick axes' positions are measured in [-1, 1] range, where
  713. 0 corresponds to center position - axis is not deflected (directed) to any side.</note></para></remarks>
  714. </member>
  715. <member name="P:AForge.Controls.Joystick.Status.XAxis">
  716. <summary>
  717. Position of X axis, [-1, 1].
  718. </summary>
  719. </member>
  720. <member name="P:AForge.Controls.Joystick.Status.YAxis">
  721. <summary>
  722. Position of Y axis, [-1, 1].
  723. </summary>
  724. </member>
  725. <member name="P:AForge.Controls.Joystick.Status.ZAxis">
  726. <summary>
  727. Position of Z axis, [-1, 1].
  728. </summary>
  729. </member>
  730. <member name="P:AForge.Controls.Joystick.Status.RAxis">
  731. <summary>
  732. Position of R axis - 4th joystick's axes, [-1, 1].
  733. </summary>
  734. </member>
  735. <member name="P:AForge.Controls.Joystick.Status.UAxis">
  736. <summary>
  737. Position of U axis - 5th joystick's axes, [-1, 1].
  738. </summary>
  739. </member>
  740. <member name="P:AForge.Controls.Joystick.Status.VAxis">
  741. <summary>
  742. Position of V axis - 6th joystick's axes, [-1, 1].
  743. </summary>
  744. </member>
  745. <member name="P:AForge.Controls.Joystick.Status.Buttons">
  746. <summary>
  747. Joystick buttons' state.
  748. </summary>
  749. </member>
  750. <member name="P:AForge.Controls.Joystick.Status.PointOfView">
  751. <summary>
  752. Current point of view state, [0, 359].
  753. </summary>
  754. </member>
  755. <member name="M:AForge.Controls.Joystick.Status.IsButtonPressed(AForge.Controls.Joystick.Buttons)">
  756. <summary>
  757. Check if certain button (or combination of buttons) is pressed.
  758. </summary>
  759. <param name="button">Button to check state of.</param>
  760. <returns>Returns <see langword="true"/> if the specified button is pressed or
  761. <see langword="false"/> otherwise.</returns>
  762. </member>
  763. <member name="T:AForge.Controls.Joystick.Buttons">
  764. <summary>
  765. Flags enumeration of joystick buttons.
  766. </summary>
  767. </member>
  768. <member name="F:AForge.Controls.Joystick.Buttons.Button1">
  769. <summary>
  770. 1st button.
  771. </summary>
  772. </member>
  773. <member name="F:AForge.Controls.Joystick.Buttons.Button2">
  774. <summary>
  775. 2nd button.
  776. </summary>
  777. </member>
  778. <member name="F:AForge.Controls.Joystick.Buttons.Button3">
  779. <summary>
  780. 3rd button.
  781. </summary>
  782. </member>
  783. <member name="F:AForge.Controls.Joystick.Buttons.Button4">
  784. <summary>
  785. 4th button.
  786. </summary>
  787. </member>
  788. <member name="F:AForge.Controls.Joystick.Buttons.Button5">
  789. <summary>
  790. 5th button.
  791. </summary>
  792. </member>
  793. <member name="F:AForge.Controls.Joystick.Buttons.Button6">
  794. <summary>
  795. 6th button.
  796. </summary>
  797. </member>
  798. <member name="F:AForge.Controls.Joystick.Buttons.Button7">
  799. <summary>
  800. 7th button.
  801. </summary>
  802. </member>
  803. <member name="F:AForge.Controls.Joystick.Buttons.Button8">
  804. <summary>
  805. 8th button.
  806. </summary>
  807. </member>
  808. <member name="F:AForge.Controls.Joystick.Buttons.Button9">
  809. <summary>
  810. 9th button.
  811. </summary>
  812. </member>
  813. <member name="F:AForge.Controls.Joystick.Buttons.Button10">
  814. <summary>
  815. 10th button.
  816. </summary>
  817. </member>
  818. <member name="F:AForge.Controls.Joystick.Buttons.Button11">
  819. <summary>
  820. 11th button.
  821. </summary>
  822. </member>
  823. <member name="F:AForge.Controls.Joystick.Buttons.Button12">
  824. <summary>
  825. 12th button.
  826. </summary>
  827. </member>
  828. <member name="F:AForge.Controls.Joystick.Buttons.Button13">
  829. <summary>
  830. 13th button.
  831. </summary>
  832. </member>
  833. <member name="F:AForge.Controls.Joystick.Buttons.Button14">
  834. <summary>
  835. 14th button.
  836. </summary>
  837. </member>
  838. <member name="F:AForge.Controls.Joystick.Buttons.Button15">
  839. <summary>
  840. 15th button.
  841. </summary>
  842. </member>
  843. <member name="F:AForge.Controls.Joystick.Buttons.Button16">
  844. <summary>
  845. 16th button.
  846. </summary>
  847. </member>
  848. <member name="T:AForge.Controls.ManipulatorControl">
  849. <summary>
  850. Manipulator control.
  851. </summary>
  852. <remarks>
  853. <para>The manipulator control can be used to mimic behaviour of analogue joystick using
  854. regular mouse. By dragging manipulator away from control's centre, it fires <see cref="E:AForge.Controls.ManipulatorControl.PositionChanged"/>
  855. event notifying about its X/Y coordinates (or about R/Theta coordinates in Polar coordinates system).
  856. </para>
  857. <para>For example, in robotics applications the control can be used to drive robots. If user drags manipulator
  858. further from centre (increasing distance between centre and manipulator), then higher power (speed) should be
  859. set for robot's motors. But dragging it in different directions away from centre should result in changing
  860. robot's direction: straight forward, backward, turning right or left, etc.<br />
  861. <img src="img/controls/manipulator_round.png" width="215" height="215" />
  862. </para>
  863. <para>Another possible application of the control is to control position of some device, etc.
  864. For example, the control could be used with pan-tilt camera - by dragging control away from centre,
  865. the camera may rotate in one of the directions.<br />
  866. <img src="img/controls/manipulator_square.png" width="215" height="215" />
  867. </para>
  868. </remarks>
  869. </member>
  870. <member name="P:AForge.Controls.ManipulatorControl.IsSquareLook">
  871. <summary>
  872. Determines if the control has square or round look.
  873. </summary>
  874. <remarks>
  875. <para>The control has a square look if the property is set to <see langword="true"/>,
  876. otherwise it has round look.</para>
  877. <para>Default value is set to <see langword="false"/>.</para>
  878. </remarks>
  879. </member>
  880. <member name="P:AForge.Controls.ManipulatorControl.DrawHorizontalAxis">
  881. <summary>
  882. Determines if horizontal axis should be drawn or not.
  883. </summary>
  884. <remarks>
  885. <para>Default value is set to <see langword="true"/>.</para>
  886. </remarks>
  887. </member>
  888. <member name="P:AForge.Controls.ManipulatorControl.DrawVerticalAxis">
  889. <summary>
  890. Determines if vertical axis should be drawn or not.
  891. </summary>
  892. <remarks>
  893. <para>Default value is set to <see langword="false"/>.</para>
  894. </remarks>
  895. </member>
  896. <member name="P:AForge.Controls.ManipulatorControl.ResetPositionOnMouseRelease">
  897. <summary>
  898. Determines behaviour of manipulator, when mouse button is released.
  899. </summary>
  900. <remarks>
  901. <para>The property controls behaviour of manipulator on releasing mouse button. If
  902. the property is set to <see langword="true"/>, then position of manipulator is reset
  903. to (0, 0), when mouse button is released. Otherwise manipulator stays on the place,
  904. where it was left.</para>
  905. <para>Default value is set to <see langword="true"/>.</para>
  906. </remarks>
  907. </member>
  908. <member name="P:AForge.Controls.ManipulatorControl.BorderColor">
  909. <summary>
  910. Color used for drawing borders and axis's.
  911. </summary>
  912. <remarks>
  913. <para>Default value is set to <see cref="P:System.Drawing.Color.Black"/>.</para>
  914. </remarks>
  915. </member>
  916. <member name="P:AForge.Controls.ManipulatorControl.TopLeftBackgroundColor">
  917. <summary>
  918. Background color used for filling top left quarter of the control.
  919. </summary>
  920. <remarks>
  921. <para>Default value is set to <see cref="P:System.Drawing.Color.White"/>.</para>
  922. </remarks>
  923. </member>
  924. <member name="P:AForge.Controls.ManipulatorControl.TopRightBackgroundColor">
  925. <summary>
  926. Background color used for filling top right quarter of the control.
  927. </summary>
  928. <remarks>
  929. <para>Default value is set to <see cref="P:System.Drawing.Color.White"/>.</para>
  930. </remarks>
  931. </member>
  932. <member name="P:AForge.Controls.ManipulatorControl.BottomLeftBackgroundColor">
  933. <summary>
  934. Background color used for filling bottom left quarter of the control.
  935. </summary>
  936. <remarks>
  937. <para>Default value is set to <see cref="P:System.Drawing.Color.LightGray"/>.</para>
  938. </remarks>
  939. </member>
  940. <member name="P:AForge.Controls.ManipulatorControl.BottomRightBackgroundColor">
  941. <summary>
  942. Background color used for filling bottom right quarter of the control.
  943. </summary>
  944. <remarks>
  945. <para>Default value is set to <see cref="P:System.Drawing.Color.LightGray"/>.</para>
  946. </remarks>
  947. </member>
  948. <member name="P:AForge.Controls.ManipulatorControl.ManipulatorColor">
  949. <summary>
  950. Color used for filling manipulator.
  951. </summary>
  952. <remarks>
  953. <para>Default value is set to <see cref="P:System.Drawing.Color.LightSeaGreen"/>.</para>
  954. </remarks>
  955. </member>
  956. <member name="T:AForge.Controls.ManipulatorControl.PositionEventArgs">
  957. <summary>
  958. Class, which summarizes arguments of manipulator's position change event.
  959. </summary>
  960. <remarks><para>Properties of this class allow to get:
  961. <list type="bullet">
  962. <item>X/Y coordinates of manipulator in
  963. <a href="http://en.wikipedia.org/wiki/Cartesian_coordinate_system">Cartesian coordinate system</a>,
  964. where X axis is directed from center of the control to the right and Y axis is directed from
  965. center to the top. Both coordinates are measured in [-1, 1] range.</item>
  966. <item>Theta and R coordinates of manipulator in
  967. <a href="http://en.wikipedia.org/wiki/Polar_coordinate_system">Polar coordinate system</a>.</item>
  968. </list>
  969. </para></remarks>
  970. </member>
  971. <member name="P:AForge.Controls.ManipulatorControl.PositionEventArgs.X">
  972. <summary>
  973. X coordinate of manipulator, [-1, 1].
  974. </summary>
  975. </member>
  976. <member name="P:AForge.Controls.ManipulatorControl.PositionEventArgs.Y">
  977. <summary>
  978. Y coordinate of manipulator, [-1, 1].
  979. </summary>
  980. </member>
  981. <member name="P:AForge.Controls.ManipulatorControl.PositionEventArgs.Theta">
  982. <summary>
  983. Theta coordinate of manipulator in Polar coordinate system, [0, 359].
  984. </summary>
  985. </member>
  986. <member name="P:AForge.Controls.ManipulatorControl.PositionEventArgs.R">
  987. <summary>
  988. R (radius) coordinate of manipulator in Polar coordinate system, [0, 1].
  989. </summary>
  990. </member>
  991. <member name="M:AForge.Controls.ManipulatorControl.PositionEventArgs.#ctor(System.Single,System.Single)">
  992. <summary>
  993. Initializes a new instance of the <see cref="T:AForge.Controls.ManipulatorControl.PositionEventArgs"/> class.
  994. </summary>
  995. <param name="x">X coordinate of manipulator, [-1, 1].</param>
  996. <param name="y">Y coordinate of manipulator, [-1, 1].</param>
  997. </member>
  998. <member name="P:AForge.Controls.ManipulatorControl.ManipulatorPosition">
  999. <summary>
  1000. Current manipulator's position.
  1001. </summary>
  1002. <remarks><para>The property equals to current manipulator's position. Both X and Y values
  1003. are in the [-1, 1] range and represented in
  1004. <a href="http://en.wikipedia.org/wiki/Cartesian_coordinate_system">Cartesian coordinate system</a>.</para>
  1005. </remarks>
  1006. </member>
  1007. <member name="T:AForge.Controls.ManipulatorControl.PositionChangedHandler">
  1008. <summary>
  1009. Delegate used for notification about manipulator's position changes.
  1010. </summary>
  1011. <param name="sender">Event sender - object sending the event.</param>
  1012. <param name="eventArgs">Event arguments - current manipulator's position.</param>
  1013. </member>
  1014. <member name="E:AForge.Controls.ManipulatorControl.PositionChanged">
  1015. <summary>
  1016. Event used for notification about manipulator's position changes.
  1017. </summary>
  1018. </member>
  1019. <member name="M:AForge.Controls.ManipulatorControl.#ctor">
  1020. <summary>
  1021. Initializes a new instance of the <see cref="T:AForge.Controls.ManipulatorControl"/> class.
  1022. </summary>
  1023. </member>
  1024. <member name="M:AForge.Controls.ManipulatorControl.Dispose(System.Boolean)">
  1025. <summary>
  1026. Clean up any resources being used.
  1027. </summary>
  1028. <param name="disposing">true if managed resources should be disposed; otherwise, false.</param>
  1029. </member>
  1030. <member name="M:AForge.Controls.ManipulatorControl.InitializeComponent">
  1031. <summary>
  1032. Required method for Designer support - do not modify
  1033. the contents of this method with the code editor.
  1034. </summary>
  1035. </member>
  1036. <member name="T:AForge.Controls.PictureBox">
  1037. <summary>
  1038. Picture box control for displaying an image.
  1039. </summary>
  1040. <remarks><para>This control is inherited from System.Windows.Forms.PictureBox and is
  1041. aimed to resolve one of its issues - inability to display images with high color depth,
  1042. like 16 bpp grayscale, 48 bpp and 64 bpp color images. .NET framework does not handle
  1043. 16 bpp grayscale images at all, throwing exception when user tries to display them. Color
  1044. images with 48 bpp and 64 bpp are "kind of" supported, but only maximum of 13 bits for each
  1045. color plane are allowed. Therefore this control is created, which allows to display as
  1046. 16 bpp grayscale images, as 48 bpp and 64 bpp color images.</para>
  1047. <para><note>To display high color depth images, the control does internal conversion of them
  1048. to lower color depth images - 8 bpp grayscale, 24 bpp and 32 bpp color images respectively. In
  1049. the case source image already has low color depth, it is displayed without any conversions.
  1050. </note></para>
  1051. </remarks>
  1052. </member>
  1053. <member name="P:AForge.Controls.PictureBox.Image">
  1054. <summary>
  1055. Gets or sets the image that the PictureBox displays.
  1056. </summary>
  1057. <remarks><para>The property is used to set image to be displayed or to get currently
  1058. displayed image.</para>
  1059. <para><note>In the case if source image has high color depth, like 16 bpp grayscale image,
  1060. 48 bpp or 64 bpp color image, it is converted to lower color depth before displaying -
  1061. to 8 bpp grayscale, 24 bpp or 32 bpp color image respectively.</note></para>
  1062. <para><note>During color conversion the original source image is kept unmodified, but internal
  1063. converted copy is created. The property always returns original source image.</note></para>
  1064. </remarks>
  1065. </member>
  1066. <member name="T:AForge.Controls.VideoSourcePlayer">
  1067. <summary>
  1068. Video source player control.
  1069. </summary>
  1070. <remarks><para>The control is aimed to play video sources, which implement
  1071. <see cref="T:AForge.Video.IVideoSource"/> interface. To start playing a video
  1072. the <see cref="P:AForge.Controls.VideoSourcePlayer.VideoSource"/> property should be initialized first and then
  1073. <see cref="M:AForge.Controls.VideoSourcePlayer.Start"/> method should be called. In the case if user needs to
  1074. perform some sort of image processing with video frames before they are displayed,
  1075. the <see cref="E:AForge.Controls.VideoSourcePlayer.NewFrame"/> event may be used.</para>
  1076. <para>Sample usage:</para>
  1077. <code>
  1078. // set new frame event handler if we need processing of new frames
  1079. playerControl.NewFrame += new VideoSourcePlayer.NewFrameHandler( this.playerControl_NewFrame );
  1080. // create video source
  1081. IVideoSource videoSource = new ...
  1082. // start playing it
  1083. playerControl.VideoSource = videoSource;
  1084. playerControl.Start( );
  1085. ...
  1086. // new frame event handler
  1087. private void playerControl_NewFrame( object sender, ref Bitmap image )
  1088. {
  1089. // process new frame somehow ...
  1090. // Note: it may be even changed, so the control will display the result
  1091. // of image processing done here
  1092. }
  1093. </code>
  1094. </remarks>
  1095. </member>
  1096. <member name="P:AForge.Controls.VideoSourcePlayer.AutoSizeControl">
  1097. <summary>
  1098. Auto size control or not.
  1099. </summary>
  1100. <remarks><para>The property specifies if the control should be autosized or not.
  1101. If the property is set to <see langword="true"/>, then the control will change its size according to
  1102. video size and control will change its position automatically to be in the center
  1103. of parent's control.</para>
  1104. <para><note>Setting the property to <see langword="true"/> has no effect if
  1105. <see cref="P:System.Windows.Forms.Control.Dock"/> property is set to <see cref="F:System.Windows.Forms.DockStyle.Fill"/>.</note></para>
  1106. </remarks>
  1107. </member>
  1108. <member name="P:AForge.Controls.VideoSourcePlayer.KeepAspectRatio">
  1109. <summary>
  1110. Gets or sets whether the player should keep the aspect ratio of the images being shown.
  1111. </summary>
  1112. </member>
  1113. <member name="P:AForge.Controls.VideoSourcePlayer.BorderColor">
  1114. <summary>
  1115. Control's border color.
  1116. </summary>
  1117. <remarks><para>Specifies color of the border drawn around video frame.</para></remarks>
  1118. </member>
  1119. <member name="P:AForge.Controls.VideoSourcePlayer.VideoSource">
  1120. <summary>
  1121. Video source to play.
  1122. </summary>
  1123. <remarks><para>The property sets the video source to play. After setting the property the
  1124. <see cref="M:AForge.Controls.VideoSourcePlayer.Start"/> method should be used to start playing the video source.</para>
  1125. <para><note>Trying to change video source while currently set video source is still playing
  1126. will generate an exception. Use <see cref="P:AForge.Controls.VideoSourcePlayer.IsRunning"/> property to check if current video
  1127. source is still playing or <see cref="M:AForge.Controls.VideoSourcePlayer.Stop"/> or <see cref="M:AForge.Controls.VideoSourcePlayer.SignalToStop"/> and <see cref="M:AForge.Controls.VideoSourcePlayer.WaitForStop"/>
  1128. methods to stop current video source.</note></para>
  1129. </remarks>
  1130. <exception cref="T:System.Exception">Video source can not be changed while current video source is still running.</exception>
  1131. </member>
  1132. <member name="P:AForge.Controls.VideoSourcePlayer.IsRunning">
  1133. <summary>
  1134. State of the current video source.
  1135. </summary>
  1136. <remarks><para>Current state of the current video source object - running or not.</para></remarks>
  1137. </member>
  1138. <member name="T:AForge.Controls.VideoSourcePlayer.NewFrameHandler">
  1139. <summary>
  1140. Delegate to notify about new frame.
  1141. </summary>
  1142. <param name="sender">Event sender.</param>
  1143. <param name="image">New frame.</param>
  1144. </member>
  1145. <member name="E:AForge.Controls.VideoSourcePlayer.NewFrame">
  1146. <summary>
  1147. New frame event.
  1148. </summary>
  1149. <remarks><para>The event is fired on each new frame received from video source. The
  1150. event is fired right after receiving and before displaying, what gives user a chance to
  1151. perform some image processing on the new frame and/or update it.</para>
  1152. <para><note>Users should not keep references of the passed to the event handler image.
  1153. If user needs to keep the image, it should be cloned, since the original image will be disposed
  1154. by the control when it is required.</note></para>
  1155. </remarks>
  1156. </member>
  1157. <member name="E:AForge.Controls.VideoSourcePlayer.PlayingFinished">
  1158. <summary>
  1159. Playing finished event.
  1160. </summary>
  1161. <remarks><para>The event is fired when/if video playing finishes. The reason of video
  1162. stopping is provided as an argument to the event handler.</para></remarks>
  1163. </member>
  1164. <member name="M:AForge.Controls.VideoSourcePlayer.#ctor">
  1165. <summary>
  1166. Initializes a new instance of the <see cref="T:AForge.Controls.VideoSourcePlayer"/> class.
  1167. </summary>
  1168. </member>
  1169. <member name="M:AForge.Controls.VideoSourcePlayer.Start">
  1170. <summary>
  1171. Start video source and displaying its frames.
  1172. </summary>
  1173. </member>
  1174. <member name="M:AForge.Controls.VideoSourcePlayer.Stop">
  1175. <summary>
  1176. Stop video source.
  1177. </summary>
  1178. <remarks><para>The method stops video source by calling its <see cref="M:AForge.Video.IVideoSource.Stop"/>
  1179. method, which abourts internal video source's thread. Use <see cref="M:AForge.Controls.VideoSourcePlayer.SignalToStop"/> and
  1180. <see cref="M:AForge.Controls.VideoSourcePlayer.WaitForStop"/> for more polite video source stopping, which gives a chance for
  1181. video source to perform proper shut down and clean up.
  1182. </para></remarks>
  1183. </member>
  1184. <member name="M:AForge.Controls.VideoSourcePlayer.SignalToStop">
  1185. <summary>
  1186. Signal video source to stop.
  1187. </summary>
  1188. <remarks><para>Use <see cref="M:AForge.Controls.VideoSourcePlayer.WaitForStop"/> method to wait until video source
  1189. stops.</para></remarks>
  1190. </member>
  1191. <member name="M:AForge.Controls.VideoSourcePlayer.WaitForStop">
  1192. <summary>
  1193. Wait for video source has stopped.
  1194. </summary>
  1195. <remarks><para>Waits for video source stopping after it was signaled to stop using
  1196. <see cref="M:AForge.Controls.VideoSourcePlayer.SignalToStop"/> method. If <see cref="M:AForge.Controls.VideoSourcePlayer.SignalToStop"/> was not called, then
  1197. it will be called automatically.</para></remarks>
  1198. </member>
  1199. <member name="M:AForge.Controls.VideoSourcePlayer.GetCurrentVideoFrame">
  1200. <summary>
  1201. Get clone of current video frame displayed by the control.
  1202. </summary>
  1203. <returns>Returns copy of the video frame, which is currently displayed
  1204. by the control - the last video frame received from video source. If the
  1205. control did not receive any video frames yet, then the method returns
  1206. <see langword="null"/>.</returns>
  1207. </member>
  1208. <member name="F:AForge.Controls.VideoSourcePlayer.components">
  1209. <summary>
  1210. Required designer variable.
  1211. </summary>
  1212. </member>
  1213. <member name="M:AForge.Controls.VideoSourcePlayer.Dispose(System.Boolean)">
  1214. <summary>
  1215. Clean up any resources being used.
  1216. </summary>
  1217. <param name="disposing">true if managed resources should be disposed; otherwise, false.</param>
  1218. </member>
  1219. <member name="M:AForge.Controls.VideoSourcePlayer.InitializeComponent">
  1220. <summary>
  1221. Required method for Designer support - do not modify
  1222. the contents of this method with the code editor.
  1223. </summary>
  1224. </member>
  1225. </members>
  1226. </doc>