CognexCamera.cs 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762
  1. using Cognex.VisionPro;
  2. using MaterialDesignThemes.Wpf;
  3. using Microsoft.Win32;
  4. using System;
  5. using System.Collections.Generic;
  6. using System.ComponentModel;
  7. using System.Diagnostics;
  8. using System.Diagnostics.Contracts;
  9. using System.Linq;
  10. using System.Runtime.CompilerServices;
  11. using System.Runtime.InteropServices;
  12. using System.Text;
  13. using System.Threading;
  14. using System.Threading.Tasks;
  15. using TeamAAS_VP.Enums;
  16. using TeamAAS_VP.Interfaces;
  17. using TeamAAS_VP.Models;
  18. using TeamAAS_VP;
  19. namespace TeamAAS_VP.Core.Cameras
  20. {
  21. public class CognexCamera : CameraBase, ICamera, INotifyPropertyChanged
  22. {
  23. #region 字段
  24. private Thread m_hReceiveThread;
  25. #endregion
  26. #region 属性
  27. /// <summary>
  28. /// 是否是3D相机
  29. /// </summary>
  30. public bool Is3D { get; } = false;
  31. public CameraBrand CameraBrand { get => CameraBrand.Cognex; }
  32. public string Name { get; private set; }
  33. public Guid ID { get; private set; }
  34. public int Index { get; set; }
  35. public string ManufacturerName { get; private set; }
  36. public bool IsFindByIp { get; private set; }
  37. public string ModelName { get; private set; }
  38. public string SerialNumber { get; private set; }
  39. public string CameraIp { get; private set; }
  40. public CameraType CameraType { get; private set; }
  41. ICogAcqFifo CameraAcq;
  42. public UInt32 ImageWidth { get; private set; }
  43. public UInt32 ImageHeight { get; private set; }
  44. private bool _IsGrabbing;
  45. /// <summary>
  46. /// 正在采集
  47. /// </summary>
  48. public bool IsGrabbing
  49. {
  50. get { return _IsGrabbing; }
  51. private set { SetProperty(ref _IsGrabbing, value); }
  52. }
  53. private ICogImage _Image;
  54. public ICogImage Image
  55. {
  56. get { return _Image; }
  57. private set { SetProperty(ref _Image, value); }
  58. }
  59. public bool IsConnected { get; private set; }
  60. /// <summary>
  61. /// 采集用时
  62. /// </summary>
  63. public TimeSpan TotalTime { get; private set; }
  64. /// <summary>
  65. /// 错误信息
  66. /// </summary>
  67. public string ErrorMessage { get; private set; }
  68. private bool IsHaveCamera = false;
  69. #endregion
  70. #region 事件
  71. public event Action<ICogImage, TimeSpan, string,Guid> ImageCallbackEvent;
  72. public event Action<Guid, bool> CameraConnectChangedEvent;
  73. #endregion
  74. public CognexCamera(Guid id, int index, string name, string serialNumber, string cameraip, bool isFindByIp)
  75. {
  76. ID = id;
  77. Name = serialNumber;
  78. Index = index;
  79. CameraIp = cameraip;
  80. SerialNumber = serialNumber;
  81. IsFindByIp = isFindByIp;
  82. //using (CogFrameGrabbers mFrameGrabbers = new CogFrameGrabbers())//识别已安装的帧抓取器的类//帧抓取器:相机
  83. //{
  84. // foreach (ICogFrameGrabber item in mFrameGrabbers)
  85. // {
  86. // if (item.SerialNumber == SerialNumber)
  87. // {
  88. // var videoFormat = item.AvailableVideoFormats[0];
  89. // foreach (string format in item.AvailableVideoFormats)
  90. // {
  91. // if (format == "Generic GigEVision (Mono)")
  92. // {
  93. // videoFormat = format;
  94. // break;
  95. // }
  96. // if (format != "Generic GigEVision (Bayer Color)") continue;
  97. // videoFormat = format;
  98. // break;
  99. // }
  100. // CameraAcq = item.CreateAcqFifo(videoFormat, CogAcqFifoPixelFormatConstants.Format8Grey, 0,
  101. // true);
  102. // //CameraAcq.OwnedExposureParams.Exposure = exposure;
  103. // //CameraAcq.OwnedBrightnessParams.Brightness = brightness;
  104. // //CameraAcq.OwnedContrastParams.Contrast = contrast;
  105. // //
  106. // CameraAcq.OwnedTriggerParams.TriggerEnabled = true;
  107. // CameraAcq.OwnedTriggerParams.TriggerModel = CogAcqTriggerModelConstants.FreeRun;
  108. // IsHaveCamera = true;
  109. // break;
  110. // }
  111. // }
  112. //}
  113. IsConnected = false;
  114. }
  115. #region 方法
  116. /// <summary>
  117. /// 获取设备
  118. /// </summary>
  119. /// <returns></returns>
  120. public static CameraInfo[] GetDevices()
  121. {
  122. List<CameraInfo> cameras = new List<CameraInfo>();
  123. if (!CheckSoftwareInstalled().isInstalled)
  124. {
  125. LogHelper.WriteLogInfo("未安装Cognex VisionPro");
  126. return cameras.ToArray();
  127. }
  128. using (CogFrameGrabbers mFrameGrabbers = new CogFrameGrabbers())//识别已安装的帧抓取器的类//帧抓取器:相机
  129. {
  130. int i = 0;
  131. foreach (ICogFrameGrabber item in mFrameGrabbers)
  132. {
  133. string[] bf1 = item.Name.Split(':');
  134. string manufacturerName=item.Name;
  135. string model = item.Name;
  136. CameraType type = CameraType.GIGE;
  137. if (bf1.Length==3)
  138. {
  139. manufacturerName = bf1[1].Trim();
  140. model = bf1[2].Trim();
  141. if (bf1[0].ToLower().Trim().Contains("gige"))
  142. {
  143. type = CameraType.GIGE;
  144. }
  145. else if (bf1[0].ToLower().Trim().Contains("usb"))
  146. {
  147. type = CameraType.USB;
  148. }
  149. else
  150. {
  151. type = CameraType.Unknown;
  152. }
  153. }
  154. if (type== CameraType.GIGE)
  155. {
  156. cameras.Add(new Models.CameraInfo()
  157. {
  158. CameraNo = i + 1,
  159. CameraName = item.Name,
  160. CameraBrand = CameraBrand.Cognex,
  161. CameraType = type,
  162. ManufacturerName = manufacturerName,
  163. Model = model,
  164. SerialNumber = item.SerialNumber,
  165. CameraIp = item.OwnedGigEAccess.CurrentIPAddress,
  166. IsFindByIp=true,
  167. });
  168. }
  169. else
  170. {
  171. cameras.Add(new Models.CameraInfo()
  172. {
  173. CameraNo = i + 1,
  174. CameraName = "",
  175. CameraBrand = CameraBrand.Cognex,
  176. CameraType = type,
  177. ManufacturerName = manufacturerName,
  178. Model = model,
  179. SerialNumber = item.SerialNumber,
  180. CameraIp = item.Name,
  181. });
  182. }
  183. i++;
  184. }
  185. }
  186. return cameras.ToArray();
  187. }
  188. /// <summary>
  189. /// 检查相机软件是否安装
  190. /// </summary>
  191. /// <returns></returns>
  192. public static (bool isInstalled, string version) CheckSoftwareInstalled()
  193. {
  194. string softwareName = "Cognex VisionPro";
  195. string softwareVersion = "90.0.5";
  196. string[] registryPaths = new[]
  197. {
  198. @"SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall",
  199. @"SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall"
  200. };
  201. foreach (var path in registryPaths)
  202. {
  203. using (RegistryKey key = Registry.LocalMachine.OpenSubKey(path))
  204. {
  205. if (key == null) continue;
  206. foreach (string subKeyName in key.GetSubKeyNames())
  207. {
  208. using (RegistryKey subKey = key.OpenSubKey(subKeyName))
  209. {
  210. string displayName = subKey.GetValue("DisplayName")?.ToString();
  211. if (displayName != null && displayName.Contains(softwareName))
  212. {
  213. string version = subKey.GetValue("DisplayVersion")?.ToString();
  214. Version v1 = new Version(version);
  215. Version v2 = new Version(softwareVersion);
  216. if (v1 >= v2)
  217. {
  218. return (true, version);
  219. }
  220. else
  221. {
  222. return (false, version);
  223. }
  224. }
  225. }
  226. }
  227. }
  228. }
  229. return (false, "");
  230. }
  231. /// <summary>
  232. /// 打开相机
  233. /// </summary>
  234. /// <returns></returns>
  235. /// <exception cref="Exception"></exception>
  236. public bool OpenDevice()
  237. {
  238. EnterOperation();
  239. try
  240. {
  241. IsConnected = false;
  242. if (!IsHaveCamera || CameraAcq==null)
  243. {
  244. using (CogFrameGrabbers mFrameGrabbers = new CogFrameGrabbers())//识别已安装的帧抓取器的类//帧抓取器:相机
  245. {
  246. foreach (ICogFrameGrabber item in mFrameGrabbers)
  247. {
  248. string[] bf1 = item.Name.Split(':');
  249. CameraType type = CameraType.GIGE;
  250. if (bf1.Length == 3)
  251. {
  252. if (bf1[0].ToLower().Trim().Contains("gige"))
  253. {
  254. type = CameraType.GIGE;
  255. }
  256. else if (bf1[0].ToLower().Trim().Contains("usb"))
  257. {
  258. type = CameraType.USB;
  259. }
  260. else
  261. {
  262. type = CameraType.Unknown;
  263. }
  264. }
  265. if (type== CameraType.GIGE)
  266. {
  267. if (IsFindByIp)
  268. {
  269. if (CameraIp== item.OwnedGigEAccess.CurrentIPAddress)
  270. {
  271. var videoFormat = item.AvailableVideoFormats[0];
  272. foreach (string format in item.AvailableVideoFormats)
  273. {
  274. if (format == "Generic GigEVision (Mono)")
  275. {
  276. videoFormat = format;
  277. break;
  278. }
  279. if (format != "Generic GigEVision (Bayer Color)") continue;
  280. videoFormat = format;
  281. break;
  282. }
  283. CameraAcq = item.CreateAcqFifo(videoFormat, CogAcqFifoPixelFormatConstants.Format8Grey, 0,
  284. true);
  285. //CameraAcq.OwnedExposureParams.Exposure = exposure;
  286. //CameraAcq.OwnedBrightnessParams.Brightness = brightness;
  287. //CameraAcq.OwnedContrastParams.Contrast = contrast;
  288. //
  289. CameraAcq.OwnedTriggerParams.TriggerEnabled = true;
  290. CameraAcq.OwnedTriggerParams.TriggerModel = CogAcqTriggerModelConstants.FreeRun;
  291. string manufacturerName = item.Name;
  292. string model = item.Name;
  293. manufacturerName = bf1[1].Trim();
  294. model = bf1[2].Trim();
  295. ManufacturerName = manufacturerName;
  296. ModelName = model;
  297. CameraIp = item.OwnedGigEAccess.CurrentIPAddress;
  298. IsHaveCamera = true;
  299. break;
  300. }
  301. }
  302. else
  303. {
  304. if (item.SerialNumber == SerialNumber)
  305. {
  306. var videoFormat = item.AvailableVideoFormats[0];
  307. foreach (string format in item.AvailableVideoFormats)
  308. {
  309. if (format == "Generic GigEVision (Mono)")
  310. {
  311. videoFormat = format;
  312. break;
  313. }
  314. if (format != "Generic GigEVision (Bayer Color)") continue;
  315. videoFormat = format;
  316. break;
  317. }
  318. CameraAcq = item.CreateAcqFifo(videoFormat, CogAcqFifoPixelFormatConstants.Format8Grey, 0,
  319. true);
  320. //CameraAcq.OwnedExposureParams.Exposure = exposure;
  321. //CameraAcq.OwnedBrightnessParams.Brightness = brightness;
  322. //CameraAcq.OwnedContrastParams.Contrast = contrast;
  323. //
  324. CameraAcq.OwnedTriggerParams.TriggerEnabled = true;
  325. CameraAcq.OwnedTriggerParams.TriggerModel = CogAcqTriggerModelConstants.FreeRun;
  326. string manufacturerName = item.Name;
  327. string model = item.Name;
  328. manufacturerName = bf1[1].Trim();
  329. model = bf1[2].Trim();
  330. ManufacturerName = manufacturerName;
  331. ModelName = model;
  332. CameraIp = item.OwnedGigEAccess.CurrentIPAddress;
  333. IsHaveCamera = true;
  334. break;
  335. }
  336. }
  337. }
  338. else
  339. {
  340. if (item.SerialNumber == SerialNumber)
  341. {
  342. var videoFormat = item.AvailableVideoFormats[0];
  343. foreach (string format in item.AvailableVideoFormats)
  344. {
  345. if (format == "Generic GigEVision (Mono)")
  346. {
  347. videoFormat = format;
  348. break;
  349. }
  350. if (format != "Generic GigEVision (Bayer Color)") continue;
  351. videoFormat = format;
  352. break;
  353. }
  354. CameraAcq = item.CreateAcqFifo(videoFormat, CogAcqFifoPixelFormatConstants.Format8Grey, 0,
  355. true);
  356. //CameraAcq.OwnedExposureParams.Exposure = exposure;
  357. //CameraAcq.OwnedBrightnessParams.Brightness = brightness;
  358. //CameraAcq.OwnedContrastParams.Contrast = contrast;
  359. //
  360. CameraAcq.OwnedTriggerParams.TriggerEnabled = true;
  361. CameraAcq.OwnedTriggerParams.TriggerModel = CogAcqTriggerModelConstants.FreeRun;
  362. string manufacturerName = item.Name;
  363. string model = item.Name;
  364. manufacturerName = bf1[1].Trim();
  365. model = bf1[2].Trim();
  366. ManufacturerName = manufacturerName;
  367. ModelName = model;
  368. IsHaveCamera = true;
  369. break;
  370. }
  371. }
  372. }
  373. }
  374. if (!IsHaveCamera)
  375. {
  376. return false;
  377. }
  378. }
  379. if (!IsConnected)
  380. {
  381. CameraConnectChangedEvent?.Invoke(ID, true);
  382. }
  383. IsConnected = true;
  384. return IsConnected;
  385. }
  386. finally
  387. {
  388. ExitOperation();
  389. }
  390. }
  391. /// <summary>
  392. /// 打开相机异步
  393. /// </summary>
  394. /// <returns></returns>
  395. public Task<bool> OpenDeviceAsync()
  396. {
  397. return Task.Run(() =>
  398. {
  399. return OpenDevice();
  400. });
  401. }
  402. /// <summary>
  403. /// 关闭相机
  404. /// </summary>
  405. public void CloseDevice()
  406. {
  407. EnterOperation();
  408. try
  409. {
  410. if (CameraAcq!=null)
  411. {
  412. CameraAcq = null;
  413. }
  414. IsConnected = false;
  415. }
  416. finally
  417. {
  418. ExitOperation();
  419. }
  420. }
  421. /// <summary>
  422. /// 采集图像
  423. /// </summary>
  424. /// <returns></returns>
  425. public ICogImage Grab(bool isRealtime = true)
  426. {
  427. EnterOperation();
  428. try
  429. {
  430. Stopwatch sw = Stopwatch.StartNew();
  431. for (int i = 0; i < 5; i++)
  432. {
  433. try
  434. {
  435. if (CameraAcq == null)
  436. {
  437. OpenDevice();
  438. }
  439. CameraAcq.Flush();
  440. Image= CameraAcq.CompleteAcquireEx(new CogAcqInfo());
  441. ImageWidth = (uint)Image.Width;
  442. ImageHeight = (uint)Image.Height;
  443. TotalTime = sw.Elapsed;
  444. ErrorMessage = "";
  445. return Image;
  446. }
  447. catch (Exception ex)
  448. {
  449. ErrorMessage = ex.Message;
  450. CloseDevice();
  451. Thread.Sleep(100);
  452. OpenDevice();
  453. }
  454. }
  455. if (IsConnected)
  456. {
  457. IsConnected = false;
  458. CameraConnectChangedEvent?.Invoke(ID, false);
  459. }
  460. return null;
  461. }
  462. finally
  463. {
  464. ExitOperation();
  465. }
  466. }
  467. /// <summary>
  468. /// 采集图像
  469. /// </summary>
  470. /// <returns></returns>
  471. public ICogImage Grab2(bool isRealtime = true)
  472. {
  473. EnterOperation();
  474. try
  475. {
  476. Stopwatch sw = Stopwatch.StartNew();
  477. for (int i = 0; i < 5; i++)
  478. {
  479. try
  480. {
  481. if (CameraAcq == null)
  482. {
  483. OpenDevice();
  484. }
  485. CameraAcq.Flush();
  486. Image = CameraAcq.CompleteAcquireEx(new CogAcqInfo());
  487. ImageWidth = (uint)Image.Width;
  488. ImageHeight = (uint)Image.Height;
  489. TotalTime = sw.Elapsed;
  490. ErrorMessage = "";
  491. return Image;
  492. }
  493. catch (Exception ex)
  494. {
  495. ErrorMessage = ex.Message;
  496. CloseDevice();
  497. Thread.Sleep(100);
  498. OpenDevice();
  499. }
  500. }
  501. if (IsConnected)
  502. {
  503. IsConnected = false;
  504. CameraConnectChangedEvent?.Invoke(ID, false);
  505. }
  506. return null;
  507. }
  508. finally
  509. {
  510. ExitOperation();
  511. }
  512. }
  513. /// <summary>
  514. /// 开始采集图像
  515. /// </summary>
  516. public void StartGrabbing()
  517. {
  518. lock (_stateLock)
  519. {
  520. if (IsGrabbing)
  521. return;
  522. IsGrabbing = true;
  523. }
  524. m_hReceiveThread = new Thread(GetStreamThreadProc) { IsBackground = true };
  525. m_hReceiveThread.Start();
  526. }
  527. /// <summary>
  528. /// 停止采集图像
  529. /// </summary>
  530. public void StopGrabbing()
  531. {
  532. try
  533. {
  534. lock (_stateLock)
  535. {
  536. IsGrabbing = false;
  537. }
  538. Thread.Sleep(1000);
  539. if (m_hReceiveThread != null)
  540. {
  541. m_hReceiveThread.Abort();
  542. m_hReceiveThread = null;
  543. }
  544. }
  545. catch (Exception)
  546. {
  547. }
  548. }
  549. /// <summary>
  550. /// 设置曝光时间
  551. /// </summary>
  552. /// <param name="ExposureTime"></param>
  553. /// <returns></returns>
  554. public bool SetExposureTime(float ExposureTime)
  555. {
  556. EnterOperation();
  557. try
  558. {
  559. if (CameraAcq==null)
  560. return false;
  561. CameraAcq.OwnedExposureParams.Exposure = (double)ExposureTime;
  562. return true;
  563. }
  564. finally
  565. {
  566. ExitOperation();
  567. }
  568. }
  569. /// <summary>
  570. /// 获取曝光时间
  571. /// </summary>
  572. /// <returns></returns>
  573. public float GetExposureTime()
  574. {
  575. EnterOperation();
  576. try
  577. {
  578. if (CameraAcq == null)
  579. return 0;
  580. return (float)CameraAcq.OwnedExposureParams.Exposure;
  581. }
  582. finally
  583. {
  584. ExitOperation();
  585. }
  586. }
  587. /// <summary>
  588. /// 设置增益
  589. /// </summary>
  590. /// <param name="Gain"></param>
  591. /// <returns></returns>
  592. public bool SetGain(float Gain)
  593. {
  594. EnterOperation();
  595. try
  596. {
  597. if (CameraAcq==null)
  598. return false;
  599. // 设置增益
  600. CameraAcq.OwnedBrightnessParams.Brightness = (double)Gain;
  601. return true;
  602. }
  603. finally
  604. {
  605. ExitOperation();
  606. }
  607. }
  608. /// <summary>
  609. /// 获取增益
  610. /// </summary>
  611. /// <returns></returns>
  612. public float GetGain()
  613. {
  614. EnterOperation();
  615. try
  616. {
  617. if (CameraAcq == null)
  618. return 0;
  619. return (float)(CameraAcq.OwnedBrightnessParams.Brightness);
  620. }
  621. finally
  622. {
  623. ExitOperation();
  624. }
  625. }
  626. private void GetStreamThreadProc()
  627. {
  628. while (IsGrabbing)
  629. {
  630. try
  631. {
  632. Grab();
  633. ImageCallbackEvent?.Invoke(Image, TotalTime, ErrorMessage, ID);
  634. }
  635. catch (Exception)
  636. {
  637. }
  638. Thread.Sleep(10);
  639. }
  640. IsGrabbing = false;
  641. }
  642. #endregion
  643. #region 属性通知
  644. /// <summary>
  645. /// Occurs when a property value changes.
  646. /// </summary>
  647. public event PropertyChangedEventHandler PropertyChanged;
  648. /// <summary>
  649. /// Checks if a property already matches a desired value. Sets the property and
  650. /// notifies listeners only when necessary.
  651. protected virtual bool SetProperty<T>(ref T storage, T value, [CallerMemberName] string propertyName = null)
  652. {
  653. if (EqualityComparer<T>.Default.Equals(storage, value)) return false;
  654. storage = value;
  655. RaisePropertyChanged(propertyName);
  656. return true;
  657. }
  658. /// <summary>
  659. /// Checks if a property already matches a desired value. Sets the property and
  660. /// notifies listeners only when necessary.
  661. /// </summary>
  662. /// <typeparam name="T">Type of the property.</typeparam>
  663. /// <param name="storage">Reference to a property with both getter and setter.</param>
  664. /// <param name="value">Desired value for the property.</param>
  665. /// <param name="propertyName">Name of the property used to notify listeners. This
  666. /// value is optional and can be provided automatically when invoked from compilers that
  667. /// support CallerMemberName.</param>
  668. /// <param name="onChanged">Action that is called after the property value has been changed.</param>
  669. /// <returns>True if the value was changed, false if the existing value matched the
  670. /// desired value.</returns>
  671. protected virtual bool SetProperty<T>(ref T storage, T value, Action onChanged, [CallerMemberName] string propertyName = null)
  672. {
  673. if (EqualityComparer<T>.Default.Equals(storage, value)) return false;
  674. storage = value;
  675. onChanged?.Invoke();
  676. RaisePropertyChanged(propertyName);
  677. return true;
  678. }
  679. /// <summary>
  680. /// Raises this object's PropertyChanged event.
  681. /// </summary>
  682. /// <param name="propertyName">Name of the property used to notify listeners. This
  683. /// value is optional and can be provided automatically when invoked from compilers
  684. /// that support <see cref="CallerMemberNameAttribute"/>.</param>
  685. protected void RaisePropertyChanged([CallerMemberName] string propertyName = null)
  686. {
  687. OnPropertyChanged(new PropertyChangedEventArgs(propertyName));
  688. }
  689. /// <summary>
  690. /// Raises this object's PropertyChanged event.
  691. /// </summary>
  692. /// <param name="args">The PropertyChangedEventArgs</param>
  693. protected virtual void OnPropertyChanged(PropertyChangedEventArgs args)
  694. {
  695. PropertyChanged?.Invoke(this, args);
  696. }
  697. #endregion
  698. }
  699. }