В этом разделе описывается реализовать функцию потока приобретения вашего адаптера. В потоковом проекте адаптера функция потока приобретения выполняет фактическое приобретение систем координат от устройства. Когда вы создаете поток (Открытие и закрытие Связи с Устройством), вы задаете имя этой функции потока приобретения как начальный адрес для нового потока.
Механизм тулбокса вызывает функцию потока приобретения косвенно, когда пользователь вызывает start
, getsnapshot
, или preview
функция. После того, как названный, функция потока приобретения получает системы координат, пока конкретное количество систем координат не было получено, или пользователь вызывает stop
функция.
Проект функции потока приобретения может значительно варьироваться между различными адаптерами, в зависимости от требований SDK устройства. Этот раздел не описывает зависящие от устройств детали реализации, а скорее подсвечивает требуемые задачи, которые характерны для всех реализаций.
На его высшем уровне, в потоковом проекте, функция потока приобретения обычно содержит два цикла:
Цикл сообщения потока является основным циклом обработки в функции потока приобретения. Вы создаете поток в openDevice()
функция. Функция потока приобретения вводит цикл сообщения потока, ожидающий сообщения, чтобы начать получать системы координат. startCapture()
вашего адаптера функция отправляет сообщение в поток приобретения, говоря ему начать получать системы координат. Этот пример использует
WM_USER
обменивайтесь сообщениями, чтобы указать на это состояние. Смотрите Отправку сообщения к Потоку Приобретения для получения дополнительной информации.
Когда это получает соответствующее сообщение, функция потока приобретения вводит цикл приобретения системы координат. Следующая фигура иллюстрирует это взаимодействие между вашими функциями адаптера и потоком приобретения. Для получения информации о цикле приобретения системы координат смотрите Цикл Приобретения Системы координат.
Взаимодействие функций адаптера и потока приобретения
Цикл приобретения системы координат - то, где ваш адаптер получает системы координат от устройства и отправляет их в механизм. Этот процесс включает следующие шаги:
Проверяйте, было ли конкретное количество систем координат получено. Цикл приобретения системы координат получает системы координат от устройства, пока конкретное количество систем координат не было получено. Используйте IAdaptor
функция членства isAcquisitionNotComplete()
определить, необходимо ли больше систем координат.
Если бы ваш адаптер поддерживает аппаратные триггеры, вы проверяли бы, сконфигурирован ли аппаратный триггер здесь — Поддерживающий Аппаратные Триггеры.
Захватите систему координат от устройства. Этот код абсолютно зависит от вашего API SDK устройства. Со многими устройство SDKs вы выделяете буфер, и устройство заполняет его данными изображения. См. документацию API своего устройства, чтобы изучить, как получить системы координат от вашего устройства.
Проверяйте, необходимо ли передать полученный кадр к механизму, с помощью IAdaptor
функция членства isSendFrame()
. Это - то, как тулбокс реализует FrameGrabInterval
свойство, где пользователи могут указать, что только хотят получить любую систему координат, например.
Если необходимо передать кадр к механизму, группируйте систему координат в IAdaptorFrame
объект; в противном случае пропустите к шагу 5.
Создайте объект системы координат, с помощью IEngine
объект makeFrame()
функция членства. Необходимо задать размерности фрейма изображения и тип системы координат, когда вы создаете объект системы координат.
Поместите передававшие изображения в объект системы координат, с помощью IAdaptorFrame
объект setImage()
функция членства. Вы задаете указатель на буфер, который содержит данные изображения, ширину системы координат и высоту и любые смещения от левого верхнего угла изображения.
Для получения информации об определении ширины системы координат высота, и возмещенный с ROI, видит ROI Поддержки.
Регистрируйте время приобретения в объекте системы координат, с помощью IAdaptorFrame
функция членства setTime()
. SDKs устройства иногда обеспечивают доступ к информации о метке времени, но можно также использовать набор адаптера getCurrentTime()
функция.
Передайте группированный кадр к механизму, с помощью IEngine
функция членства receiveFrame()
.
Постепенно увеличьте количество системы координат с помощью IAdaptor
функция членства incrementFrameCount()
. Необходимо ли передать кадр или нет, необходимо всегда постепенно увеличивать количество системы координат каждый раз, когда вы получаете систему координат.
Возвратитесь к верхней части цикла приобретения системы координат.
Следующая фигура иллюстрирует цикл приобретения системы координат.
Возможный алгоритм для цикла приобретения системы координат
Следующее является объявлением функции потока приобретения. Можно дать процедуре потока приобретения любое имя, такое как acquireThread()
.
DWORD WINAPI acquireThread(void* ThreadParam);
Ваша функция потока должна принять один параметр, который задан как указатель на сам объект, т.е. this
указатель. Функция потока возвращает значение, которое указывает на успешность или неуспешность. Для получения дополнительной информации см. документацию на веб-сайте Microsoft® Developer Network (msdn.microsoft.com
).
Следующее является функцией потока приобретения, что можно использовать с примером MyDeviceAdaptor
. Замените скелетную реализацию, которую вы использовали в Запуске Потока Приобретения с этим кодом.
DWORD WINAPI MyDeviceAdaptor::acquireThread(void* param) { MyDeviceAdaptor* adaptor = reinterpret_cast<MyDeviceAdaptor*>(param); MSG msg; while (GetMessage(&msg,NULL,0,0) > 0) { switch (msg.message) { case WM_USER: // Check if a frame needs to be acquired. while(adaptor->isAcquisitionNotComplete()) { // Insert Device-specific code here to acquire frames // into a buffer. if (adaptor->isSendFrame()) { // Get frame type & dimensions. imaqkit::frametypes::FRAMETYPE frameType = adaptor->getFrameType(); int imWidth = adaptor->getMaxWidth(); int imHeight = adaptor->getMaxHeight(); // Create a frame object. imaqkit::IAdaptorFrame* frame = adaptor->getEngine()->makeFrame(frameType, imWidth, imHeight); // Copy data from buffer into frame object. frame->setImage(imBuffer, imWidth, imHeight, 0, // X Offset from origin 0); // Y Offset from origin // Set image's timestamp. frame->setTime(imaqkit::getCurrentTime()); // Send frame object to engine. adaptor->getEngine()->receiveFrame(frame); } // if isSendFrame() // Increment the frame count. adaptor->incrementFrameCount(); } // while(isAcquisitionNotComplete() break; } //switch-case WM_USER } //while message is not WM_QUIT return 0; }