Доделай пожалуйста комментирование кода ниже на русском в стиле доксиген: #pragma once…
- User
Доделай пожалуйста комментирование кода ниже на русском в стиле доксиген: #pragma once
#ifdef VECTOR_EXPORT #if defined(_MSC_VER) #define VECTOR_BOX_API __declspec(dllexport) #else #define VECTOR_BOX_API attribute((visibility("default"))) #endif #elif VECTOR_IMPORT #define VECTOR_BOX_API __declspec(dllimport) #else #define VECTOR_BOX_API #endif
extern "C" { struct vector_box_interface { //пользовательские данные, которые будут переданы в колбэки void *user_data;
//колбэк получения кадров и/или регионов void(*cb_frame)(void *user, void *hand, int cam_id, const void *frame_data, int frame_index, int seq_index, int w, int h) = 0; //колбэк для логгера void(*cb_logger)(void *user, void *hand, const char *message) = 0; enum EvetType { EVERT_CONNECTED = 0, EVENT_DISCONNECTED = 1, EVENT_HW_CHANGED = 2 }; enum RetCode { RET_ERROR_INCOMPLETE_INTERFACE = -1, RET_OK = 0, RET_OFFLINE = 1 }; //событие связанное с сервером void(*cb_event)(void *user, void *hand, int ev) = 0; }; /// /// \brief vector_box_create создает экземпляр клиента для сетевого взаимодействия /// \param iface содержит все необходимые данные для взаимодействия с шарпом /// \param addr не нужно специально инициализировать для автосоединения через широковещание /// \param port аналогично /// \return hand - указатель на экземпляр с которым вызывается деструктор /// VECTOR_BOX_API void* vector_box_create( vector_box_interface *iface, const char* addr = nullptr, int port = -1); /// /// \brief vector_box_destroy /// \param hand дескриптор созданного экземпляра /// \return код ошибки /// VECTOR_BOX_API int vector_box_destroy( void *hand); /// /// \brief vector_box_pull /// \param hand дескриптор созданного экземпляра /// \return код ошибки ( 0 - соединение установлено ) /// VECTOR_BOX_API int vector_box_pull( void *hand); /// /// \brief vector_box_reconnect /// \param hand дескриптор созданного экземпляра /// \return код ошибки ( 0 - соединение установлено ) /// VECTOR_BOX_API int vector_box_reset_connection( void *hand); /// /// \brief vector_box_current_server_addr /// \param hand дескриптор созданного экземпляра /// \return вернет адрес, если соединение активно /// VECTOR_BOX_API const char* vector_box_current_server_addr(void *hand); /// /// \brief vector_box_current_server_port /// \param hand дескриптор созданного экземпляра /// \return вернет корректный (0..65535) номер порта если соединение активно /// VECTOR_BOX_API int vector_box_current_server_port(void *hand); /// /// \brief vector_box_get_descriptor /// \param hand дескриптор созданного экземпляра /// \return дескриптор сервера в формате JSON с описанием аппаратуры, версий, доступных режимов и прочих данных /// VECTOR_BOX_API const char* vector_box_get_descriptor(void *hand); /// /// \brief vector_box_set_idle_mode переводим камеры в неактивный режим /// \param hand дескриптор созданного экземпляра /// \return код ошибки /// VECTOR_BOX_API int vector_box_set_idle_mode(void *hand); /// /// \brief vector_box_set_barrier_mode переводим камеры в режим барьера (кадры будут поступать в колбэк) /// \param hand дескриптор созданного экземпляра /// \param frame_count /// \param sequence_count /// \return код ошибки /// VECTOR_BOX_API int vector_box_set_barrier_mode(void *hand, int frame_count, int sequence_count = 1); /// /// \brief vector_box_set_stream_mode переводим камеры в режим непрерывной съемки (кадры будут поступать в колбэк) /// \param hand дескриптор созданного экземпляра /// \return код ошибки /// VECTOR_BOX_API int vector_box_set_stream_mode(void *hand); /// /// \brief vector_box_set_shot_mode переводим камеры в режим покадровой съемки (кадры будут поступать в колбэк) /// \param hand дескриптор созданного экземпляра /// \return код ошибки /// VECTOR_BOX_API int vector_box_set_shot_mode(void *hand, int frame_count); /// /// \brief vector_box_set_camera_settings настройка ROI на конкретной камере /// \param hand дескриптор созданного экземпляра /// \param cam_id /// \param x /// \param y /// \param w /// \param h /// \param gain /// \param shutter_width /// \return код ошибки /// VECTOR_BOX_API int vector_box_set_camera_settings(void *hand, int cam_id, unsigned int roi_x, unsigned int roi_y, unsigned int roi_w, unsigned int roi_h, unsigned int gain, unsigned int shutter_width);};
Assistant
#pragma once /** * @file vector_box_api.h * @brief Заголовочный файл для API взаимодействия с Vector Box. * * Определяет интерфейс для управления и получения данных с устройства Vector Box. * Включает макросы для экспорта/импорта DLL, структуру для колбэков и * функции для управления соединением, режимами работы и настройками камер. */ #ifdef VECTOR_EXPORT #if defined(_MSC_VER) /** * @def VECTOR_BOX_API * @brief Макрос для экспорта символов из DLL при сборке с MSVC. */ #define VECTOR_BOX_API __declspec(dllexport) #else /** * @def VECTOR_BOX_API * @brief Макрос для экспорта символов из разделяемой библиотеки при сборке с GCC/Clang. */ #define VECTOR_BOX_API __attribute__((visibility("default"))) #endif #elif VECTOR_IMPORT /** * @def VECTOR_BOX_API * @brief Макрос для импорта символов из DLL/разделяемой библиотеки. */ #define VECTOR_BOX_API __declspec(dllimport) #else /** * @def VECTOR_BOX_API * @brief Пустой макрос, если не происходит экспорт или импорт (например, статическая линковка). */ #define VECTOR_BOX_API #endif extern "C" { /** * @struct vector_box_interface * @brief Структура для определения интерфейса взаимодействия с Vector Box. * * Эта структура содержит указатели на функции обратного вызова (колбэки) и * пользовательские данные, которые будут передаваться в эти колбэки. * Необходимо инициализировать обязательные поля перед вызовом vector_box_create. */ struct vector_box_interface { /** * @brief Пользовательские данные, которые будут переданы в колбэки. * * Клиентская сторона может использовать это поле для передачи своего контекста * в функции обратного вызова. */ void *user_data; /** * @brief Колбэк для получения кадров и/или регионов. * * Вызывается библиотекой при поступлении нового кадра от сервера. * @param user Указатель на пользовательские данные (из `vector_box_interface::user_data`). * @param hand Дескриптор экземпляра Vector Box, с которым связано событие. * @param cam_id Идентификатор камеры, с которой пришел кадр. * @param frame_data Указатель на данные кадра. Формат данных зависит от настроек. * @param frame_index Индекс кадра в текущей последовательности. * @param seq_index Индекс последовательности (актуально для режимов с последовательностями). * @param w Ширина кадра в пикселях. * @param h Высота кадра в пикселях. */ void(*cb_frame)(void *user, void *hand, int cam_id, const void *frame_data, int frame_index, int seq_index, int w, int h) = 0; /** * @brief Колбэк для логгера. * * Вызывается библиотекой для вывода информационных или отладочных сообщений. * @param user Указатель на пользовательские данные (из `vector_box_interface::user_data`). * @param hand Дескриптор экземпляра Vector Box, с которым связано сообщение. * @param message Текстовое сообщение для логирования. */ void(*cb_logger)(void *user, void *hand, const char *message) = 0; /** * @enum EvetType * @brief Типы событий, связанных с сервером. */ enum EvetType { EVERT_CONNECTED = 0, ///< Событие: установлено соединение с сервером. EVENT_DISCONNECTED = 1, ///< Событие: потеряно соединение с сервером. EVENT_HW_CHANGED = 2 ///< Событие: изменилась конфигурация оборудования на сервере. }; /** * @enum RetCode * @brief Коды возврата функций API. */ enum RetCode { RET_ERROR_INCOMPLETE_INTERFACE = -1, ///< Ошибка: интерфейс не полностью инициализирован (например, отсутствуют обязательные колбэки). RET_OK = 0, ///< Операция успешно выполнена. RET_OFFLINE = 1 ///< Сервер не в сети или соединение потеряно. }; /** * @brief Колбэк для событий, связанных с сервером. * * Вызывается при возникновении событий, таких как подключение, отключение, * изменение конфигурации оборудования. * @param user Указатель на пользовательские данные (из `vector_box_interface::user_data`). * @param hand Дескриптор экземпляра Vector Box, с которым связано событие. * @param ev Тип события (значение из `EvetType`). */ void(*cb_event)(void *user, void *hand, int ev) = 0; }; /** * @brief Создает экземпляр клиента для сетевого взаимодействия с Vector Box. * @param iface Указатель на структуру `vector_box_interface`, содержащую колбэки и пользовательские данные. * Эта структура должна быть инициализирована вызывающей стороной. Как минимум, * должны быть установлены указатели на функции `cb_frame` и `cb_event`. * @param addr IP-адрес или имя хоста сервера. Если `nullptr` или пустая строка, * будет предпринята попытка автообнаружения сервера через широковещательные запросы. * @param port Порт сервера. Если `-1`, будет использоваться порт по умолчанию (зависит от протокола и * режима автообнаружения). Если `addr` задан, этот порт будет использоваться для подключения к нему. * @return Дескриптор (указатель `void*`) на созданный экземпляр клиента. * В случае ошибки (например, неполный `iface`) возвращает `nullptr`. * Этот дескриптор используется в последующих вызовах API. */ VECTOR_BOX_API void* vector_box_create( vector_box_interface *iface, const char* addr = nullptr, int port = -1); /** * @brief Уничтожает экземпляр клиента Vector Box и освобождает ресурсы. * @param hand Дескриптор экземпляра, полученный от `vector_box_create`. * @return Код результата операции (`RetCode`). `RET_OK` в случае успеха. */ VECTOR_BOX_API int vector_box_destroy( void *hand); /** * @brief Пытается установить или проверить соединение с сервером. * * Если соединение не установлено, эта функция инициирует процесс подключения * (или автообнаружения, если `addr` и `port` не были указаны при создании). * Если соединение уже установлено, функция может проверить его актуальность. * Результат операции (успешное подключение, ошибка, сервер оффлайн) * будет также сообщен через колбэк `cb_event`. * @param hand Дескриптор созданного экземпляра. * @return Код результата (`RetCode`). * `RET_OK` (0) - соединение установлено (или уже было установлено и активно). * `RET_OFFLINE` (1) - сервер не найден или недоступен. * Другие отрицательные значения - коды ошибок. */ VECTOR_BOX_API int vector_box_pull( void *hand); /** * @brief Разрывает текущее соединение и пытается установить новое. * * Эта функция принудительно разрывает существующее соединение (если оно есть) * и инициирует новую попытку подключения к серверу, используя параметры, * указанные при вызове `vector_box_create` (или автообнаружение). * @param hand Дескриптор созданного экземпляра. * @return Код результата (`RetCode`). `RET_OK` (0) если новое соединение успешно установлено. * `RET_OFFLINE` (1) если сервер не найден или недоступен после попытки переподключения. */ VECTOR_BOX_API int vector_box_reset_connection( void *hand); /** * @brief Возвращает IP-адрес или имя хоста текущего активного сервера. * @param hand Дескриптор созданного экземпляра. * @return Строка с адресом сервера, если соединение активно. * Возвращает `nullptr`, если соединение не установлено. * Память, на которую указывает возвращенный указатель, управляется библиотекой, * не пытайтесь ее освобождать. Строка действительна до следующего вызова * функции API, изменяющей состояние соединения, или до `vector_box_destroy`. */ VECTOR_BOX_API const char* vector_box_current_server_addr(void *hand); /** * @brief Возвращает порт текущего активного сервера. * @param hand Дескриптор созданного экземпляра. * @return Номер порта (0-65535), если соединение активно. * Возвращает отрицательное значение (например, -1), если соединение не установлено. */ VECTOR_BOX_API int vector_box_current_server_port(void *hand); /** * @brief Получает дескриптор сервера в формате JSON. * * Дескриптор содержит информацию об аппаратной конфигурации сервера, * версиях программного обеспечения, доступных режимах работы камер и другие данные. * @param hand Дескриптор созданного экземпляра. * @return Строка в формате JSON с описанием сервера. * Возвращает `nullptr`, если соединение не установлено или произошла ошибка при получении дескриптора. * Память, на которую указывает возвращенный указатель, управляется библиотекой, * не пытайтесь ее освобождать. Строка действительна до следующего вызова * функции API, изменяющей состояние соединения, или до `vector_box_destroy`. */ VECTOR_BOX_API const char* vector_box_get_descriptor(void *hand); /** * @brief Переводит камеры сервера в неактивный режим (режим ожидания). * * В этом режиме камеры не передают кадры. Используется для снижения нагрузки * на сеть и сервер, когда активная съемка не требуется. * @param hand Дескриптор созданного экземпляра. * @return Код результата операции (`RetCode`). `RET_OK` в случае успеха. */ VECTOR_BOX_API int vector_box_set_idle_mode(void *hand); /** * @brief Переводит камеры в режим "барьера". * * В этом режиме камеры производят съемку определенного количества кадров (`frame_count`) * в рамках одной или нескольких последовательностей (`sequence_count`). * Полученные кадры будут поступать в колбэк `cb_frame`. * @param hand Дескриптор созданного экземпляра. * @param frame_count Количество кадров, которое необходимо снять в каждой последовательности. * @param sequence_count Количество последовательностей съемок (по умолчанию 1). * Если > 1, то после съемки `frame_count` кадров начнется новая * последовательность, и так `sequence_count` раз. * @return Код результата операции (`RetCode`). `RET_OK` в случае успеха. */ VECTOR_BOX_API int vector_box_set_barrier_mode(void *hand, int frame_count, int sequence_count = 1); /** * @brief Переводит камеры в режим непрерывной съемки (стриминг). * * В этом режиме камеры непрерывно снимают и передают кадры. * Кадры будут поступать в колбэк `cb_frame` по мере их готовности. * @param hand Дескриптор созданного экземпляра. * @return Код результата операции (`RetCode`). `RET_OK` в случае успеха. */ VECTOR_BOX_API int vector_box_set_stream_mode(void *hand); /** * @brief Переводит камеры в режим покадровой съемки (снимок). * * В этом режиме камеры делают указанное количество (`frame_count`) одиночных снимков. * Полученные кадры будут поступать в колбэк `cb_frame`. * @param hand Дескриптор созданного экземпляра. * @param frame_count Количество кадров, которое необходимо снять. * @return Код результата операции (`RetCode`). `RET_OK` в случае успеха. */ VECTOR_BOX_API int vector_box_set_shot_mode(void *hand, int frame_count); /** * @brief Устанавливает настройки для конкретной камеры. * * Позволяет настроить область интереса (ROI), усиление (gain) и время выдержки (shutter width) * для указанной камеры. * @param hand Дескриптор созданного экземпляра. * @param cam_id Идентификатор камеры, для которой применяются настройки. * @param roi_x Координата X (горизонтальная) верхнего левого угла области интереса (ROI). * @param roi_y Координата Y (вертикальная) верхнего левого угла области интереса (ROI). * @param roi_w Ширина области интереса (ROI) в пикселях. * @param roi_h Высота области интереса (ROI) в пикселях. * @param gain Значение усиления для камеры (зависит от модели камеры, обычно в дБ или условных единицах). * @param shutter_width Длительность выдержки (экспозиции) для камеры (обычно в микросекундах). * @return Код результата операции (`RetCode`). `RET_OK` в случае успеха. */ VECTOR_BOX_API int vector_box_set_camera_settings(void *hand, int cam_id, unsigned int roi_x, unsigned int roi_y, unsigned int roi_w, unsigned int roi_h, unsigned int gain, unsigned int shutter_width); };- User
А теперь пожалуйста добавь необходимые комментарии в реализацию: #include "vector_box.h" #include "vector_client.h"
static vectorFinderContext *finder = nullptr; static int create_counter = 0; static alt::sharedArrays *arrays = nullptr;
class clientInstance: public alt::delegateBase { public: clientInstance(vector_box_interface iface, const char addr, int port) : interface(iface) { if(!create_counter) { finder = new vectorFinderContext(alt::delegateProc<const std::string &>(this,&clientInstance::printLog)); create_counter++;
arrays = new alt::sharedArrays; } if(addr && port>0 && port<65536) { ctx = new vectorClientContext(alt::delegateProc<const std::string &>(this,&clientInstance::printLog), arrays,nullptr); ctx->connectTo(asio::ip::make_address(addr),port); } else { ctx = new vectorClientContext(alt::delegateProc<const std::string &>(this,&clientInstance::printLog), arrays,finder); } } ~clientInstance() { delete ctx; create_counter--; if(!create_counter) { delete finder; finder = nullptr; delete arrays; } } void printLog(const std::string &str) { if(interface->cb_logger) { (*interface->cb_logger)(interface->user_data, this, str.c_str()); } } vectorClientContext* context() { return ctx; } const char* serverAddr() { temp_addr = ctx->serverAddr(); return temp_addr.c_str(); } const char* descriptor() { temp_info = ctx->getInfo(); return temp_info(); } vprotoCamConfigData camConfig(uint32 cam_id) { return temp_cam_config[cam_id]; } void setCamConfig(vprotoCamConfigData &cfg) { cam_settings_id++; bool checked = false; do { checked = true; for(int i=0; i<temp_cam_config.size(); i++) { if(temp_cam_config.value(i).settings_id == cam_settings_id) { cam_settings_id++; checked = false; break; } } } while(!checked); cfg.settings_id = cam_settings_id; temp_cam_config[cfg.cam_id] = cfg; ctx->setCamConfig(cfg); } void setMode(vprotoBoxConfigData &cfg) { box_settings_id++; cfg.settings_id = box_settings_id; ctx->setMode(cfg); } uint32 boxSettingsId() { return box_settings_id; } uint32 camSettingsId() { return cam_settings_id; } vector_box_interface* interfacePtr() { return interface; } void emitEvents(uint64 ev) { if(!interface->cb_event) return; switch(ev) { case alt::makeID64("HWUPDATE"): (*interface->cb_event)(interface->user_data,this,vector_box_interface::EVENT_HW_CHANGED); break; case alt::makeID64("OFFLINE"): (*interface->cb_event)(interface->user_data,this,vector_box_interface::EVENT_DISCONNECTED); break; case alt::makeID64("ONLINE"): (*interface->cb_event)(interface->user_data,this,vector_box_interface::EVERT_CONNECTED); break; }; }private:
uint32 box_settings_id = 0; uint32 cam_settings_id = 0; alt::hash<int32,vprotoCamConfigData> temp_cam_config; std::string temp_addr; alt::string temp_info; vectorClientContext *ctx = nullptr; vector_box_interface *interface = nullptr;};
VECTOR_BOX_API void* vector_box_create( vector_box_interface iface, const char addr, int port) { clientInstance *hand = new clientInstance(iface,addr,port);
return hand;}
VECTOR_BOX_API int vector_box_destroy( void *hand) { clientInstance cli = (clientInstance)hand;
delete cli; return vector_box_interface::RET_OK;}
VECTOR_BOX_API int vector_box_reset_connection( void *hand) { clientInstance cli = (clientInstance)hand;
cli->context()->disconnect(); return vector_box_interface::RET_OK;}
VECTOR_BOX_API int vector_box_pull( void *hand) { clientInstance cli = (clientInstance)hand;
cli->context()->emitEvents(alt::delegateProc<uint64>(cli,&clientInstance::emitEvents)); cli->context()->execute(); arrays->cleanup(); alt::hash<int32,alt::array<alt::sharedArrayRef>> frames = cli->context()->getFrames(true); if(!cli->interfacePtr()->cb_frame) return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; //update current textures list for(int i=0;i<frames.size();i++) { for(int j=0;j<frames.value(i).size();j++) { alt::sharedArrayRef frm = frames.value(i)[j]; if(frm.is_valid()) { const vprotoFrameData *ptr = (const vprotoFrameData*)frm(); if(ptr->box.settings_id == cli->boxSettingsId() && ptr->cam.settings_id == cli->camSettingsId()) { if(cli->interfacePtr()->cb_frame) { int w = ptr->w; int h = ptr->h; if(ptr->cam.cam_id >= 0 && ptr->cam.roi_w > 0 && ptr->cam.roi_h > 0) { w = ptr->cam.roi_w; h = ptr->cam.roi_h; } (*cli->interfacePtr()->cb_frame)(cli->interfacePtr()->user_data, hand,ptr->cam.cam_id,ptr+1, ptr->frame_index,ptr->sequence_index, w,h); } } } } } return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE;}
VECTOR_BOX_API const char* vector_box_current_server_addr(void *hand) { clientInstance cli = (clientInstance)hand; cli->context()->execute();
return cli->serverAddr();}
VECTOR_BOX_API int vector_box_current_server_port(void *hand) { clientInstance cli = (clientInstance)hand; cli->context()->execute();
return cli->context()->serverPort();}
VECTOR_BOX_API const char* vector_box_get_descriptor(void *hand) { clientInstance cli = (clientInstance)hand; return cli->descriptor(); }
VECTOR_BOX_API int vector_box_set_idle_mode(void *hand) { clientInstance cli = (clientInstance)hand; vprotoBoxConfigData b; b.mode = vprotoBoxConfigData::IDLE_MODE; cli->setMode(b); return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE; }
VECTOR_BOX_API int vector_box_set_barrier_mode(void *hand, int frame_count, int sequence_count) { clientInstance cli = (clientInstance)hand; vprotoBoxConfigData b; b.mode = vprotoBoxConfigData::BARRIER_MODE; b.sequence_count = sequence_count; b.frame_count = frame_count; cli->setMode(b); return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE; }
VECTOR_BOX_API int vector_box_set_stream_mode(void *hand) { clientInstance cli = (clientInstance)hand; vprotoBoxConfigData b; b.mode = vprotoBoxConfigData::STREAM_MODE; cli->setMode(b); return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE; }
VECTOR_BOX_API int vector_box_set_shot_mode(void *hand, int frame_count) { clientInstance cli = (clientInstance)hand; vprotoBoxConfigData b; b.mode = vprotoBoxConfigData::SHOT_MODE; b.frame_count = frame_count; cli->setMode(b); return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE; }
VECTOR_BOX_API int vector_box_set_camera_settings(void *hand, int cam_id, unsigned int roi_x, unsigned int roi_y, unsigned int roi_w, unsigned int roi_h, unsigned int gain, unsigned int shutter_width) { clientInstance cli = (clientInstance)hand; vprotoCamConfigData cfg = cli->camConfig(cam_id); cfg.cam_id = cam_id; cfg.roi_h = roi_h; cfg.roi_w = roi_w; cfg.roi_x = roi_x; cfg.roi_y = roi_y; cfg.gain = gain; cfg.shutter_width = shutter_width;
cli->setCamConfig(cfg); return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE;}
Assistant
#include "vector_box.h" // Предполагается, что это заголовочный файл с определениями API #include "vector_client.h" // Предполагается, что это заголовочный файл с реализацией vectorClientContext и vectorFinderContext // Статические глобальные переменные, используемые для управления общими ресурсами /** * @brief Указатель на контекст поиска серверов Vector Box в локальной сети. * Инициализируется при первом вызове `vector_box_create` и удаляется, * когда счетчик активных экземпляров `clientInstance` становится равным нулю. * Используется для автообнаружения серверов, если адрес и порт не указаны явно. */ static vectorFinderContext *finder = nullptr; /** * @brief Счетчик активных экземпляров `clientInstance`. * Используется для управления временем жизни общих ресурсов, таких как `finder` и `arrays`. * Инкрементируется в конструкторе `clientInstance` и декрементируется в деструкторе. */ static int create_counter = 0; /** * @brief Указатель на менеджер разделяемых массивов (shared memory). * Используется для управления памятью, выделенной под данные кадров, * обеспечивая эффективное разделение данных и предотвращая излишнее копирование. * Инициализируется при первом вызове `vector_box_create` и удаляется, * когда счетчик активных экземпляров `clientInstance` становится равным нулю. */ static alt::sharedArrays *arrays = nullptr; /** * @class clientInstance * @brief Внутренний класс, представляющий экземпляр клиента Vector Box. * * Этот класс инкапсулирует логику взаимодействия с сервером Vector Box, * управляет контекстом клиента (`vectorClientContext`), обработкой событий, * и вызовами колбэков, предоставленных через `vector_box_interface`. * Он также управляет временем жизни общих ресурсов (`finder`, `arrays`) * с помощью статического счетчика `create_counter`. * Наследуется от `alt::delegateBase` для использования механизма делегатов (например, для логирования). */ class clientInstance: public alt::delegateBase { public: /** * @brief Конструктор экземпляра клиента. * @param iface Указатель на структуру `vector_box_interface`, предоставленную пользователем API. * Содержит колбэки и пользовательские данные. Должен быть валидным. * @param addr IP-адрес или имя хоста сервера. Если `nullptr` или пустая строка, * используется автообнаружение через `finder`. * @param port Порт сервера. Используется, если `addr` указан и порт валиден (1-65535). * Если порт некорректен или `addr` не указан, используется порт по умолчанию или автообнаружение. */ clientInstance(vector_box_interface *iface, const char* addr, int port) : interface(iface) // Инициализация указателя на интерфейс пользователя { // Инициализация общих ресурсов, если это первый создаваемый экземпляр if(!create_counter) { // Создание контекста поиска серверов. printLog используется как колбэк для логирования из finder. finder = new vectorFinderContext(alt::delegateProc<const std::string &>(this,&clientInstance::printLog)); // Создание менеджера разделяемых массивов. arrays = new alt::sharedArrays; } create_counter++; // Увеличение счетчика активных экземпляров // Если указаны адрес и валидный порт, создаем клиентский контекст для прямого подключения. if(addr && strlen(addr) > 0 && port > 0 && port < 65536) { // Создание контекста клиента с прямым подключением. // finder не передается (nullptr), так как адрес и порт известны. ctx = new vectorClientContext(alt::delegateProc<const std::string &>(this,&clientInstance::printLog), arrays,nullptr); ctx->connectTo(asio::ip::make_address(addr),port); // Попытка подключения к указанному серверу. } else // Иначе (адрес не указан или порт некорректен), используем автообнаружение через finder. { // Создание контекста клиента с использованием finder для автообнаружения сервера. ctx = new vectorClientContext(alt::delegateProc<const std::string &>(this,&clientInstance::printLog), arrays,finder); } } /** * @brief Деструктор экземпляра клиента. * Освобождает ресурсы, связанные с этим экземпляром (`vectorClientContext`), * и, если это последний активный экземпляр, освобождает общие ресурсы (`finder`, `arrays`). */ ~clientInstance() { delete ctx; // Освобождение контекста клиента. ctx = nullptr; create_counter--; // Уменьшение счетчика активных экземпляров. // Если активных экземпляров больше нет, освобождаем общие ресурсы. if(!create_counter) { delete finder; finder = nullptr; delete arrays; arrays = nullptr; } } /** * @brief Передает строку лога в пользовательский колбэк `cb_logger`. * @param str Строка для логирования. */ void printLog(const std::string &str) { // Проверяем, что интерфейс и колбэк логгера существуют. if(interface && interface->cb_logger) { // Вызов колбэка логгера с пользовательскими данными, текущим экземпляром и сообщением. (*interface->cb_logger)(interface->user_data, this, str.c_str()); } } /** * @brief Возвращает указатель на контекст клиента (`vectorClientContext`). * @return Указатель на `vectorClientContext` или `nullptr`, если не инициализирован. */ vectorClientContext* context() { return ctx; } /** * @brief Возвращает IP-адрес текущего подключенного сервера. * @return C-строка с IP-адресом сервера. Память для строки управляется внутренним полем `temp_addr`. * Возвращает пустую строку, если адрес не определен или контекст невалиден. */ const char* serverAddr() { if (ctx) { temp_addr = ctx->serverAddr(); // Получение адреса из контекста клиента. } else { temp_addr.clear(); // Очистка, если контекста нет. } return temp_addr.c_str(); } /** * @brief Возвращает дескриптор сервера (информацию о сервере) в виде строки. * @return C-строка с дескриптором сервера. Память управляется внутренним полем `temp_info`. * Возвращает указатель на пустую строку, если информация не доступна. */ const char* descriptor() { if (ctx) { temp_info = ctx->getInfo(); // Получение информации из контекста клиента. } else { temp_info.clear(); // Очистка, если контекста нет (alt::string должен это поддерживать). } return temp_info(); // Предполагается, что temp_info() возвращает const char*. } /** * @brief Возвращает текущую (или последнюю установленную) конфигурацию для указанной камеры. * @param cam_id Идентификатор камеры. * @return Структура `vprotoCamConfigData` с конфигурацией камеры. * Если конфигурация для данной камеры ранее не устанавливалась или не кэширована, * может вернуть структуру по умолчанию (зависит от `alt::hash`). */ vprotoCamConfigData camConfig(uint32_t cam_id) { // Извлечение конфигурации из локального кэша. return temp_cam_config[cam_id]; } /** * @brief Устанавливает новую конфигурацию для камеры и отправляет ее на сервер. * @param cfg Структура `vprotoCamConfigData` с новой конфигурацией. * Поле `cfg.cam_id` должно быть корректно установлено. * Поле `cfg.settings_id` будет обновлено этой функцией для обеспечения уникальности * (в рамках текущих кэшированных настроек этого клиента). */ void setCamConfig(vprotoCamConfigData &cfg) { cam_settings_id++; // Инкремент общего ID настроек камеры для этого экземпляра. // Гарантируем, что новый cam_settings_id не совпадает с settings_id // какой-либо камеры в текущем локальном кэше temp_cam_config. // Это помогает различать наборы настроек. bool checked = false; do { checked = true; // Проходим по всем сохраненным конфигурациям камер в кэше. for(int i=0; i < temp_cam_config.size(); i++) { // Если сгенерированный ID уже используется в кэше. if(temp_cam_config.value(i).settings_id == cam_settings_id) { cam_settings_id++; // Увеличиваем ID. checked = false; // И повторяем проверку. break; } } } while(!checked); cfg.settings_id = cam_settings_id; // Присваиваем уникальный (в рамках кэша) ID конфигурации. temp_cam_config[cfg.cam_id] = cfg; // Сохраняем конфигурацию локально в кэше. if (ctx) { ctx->setCamConfig(cfg); // Отправляем конфигурацию на сервер. } } /** * @brief Устанавливает новый режим работы Vector Box и отправляет его на сервер. * @param cfg Структура `vprotoBoxConfigData` с настройками режима. * Поле `cfg.settings_id` будет обновлено этой функцией. */ void setMode(vprotoBoxConfigData &cfg) { box_settings_id++; // Инкремент ID настроек режима работы. cfg.settings_id = box_settings_id; // Присваиваем ID. if (ctx) { ctx->setMode(cfg); // Отправляем настройки режима на сервер. } } /** * @brief Возвращает текущий идентификатор настроек режима работы (box). * @return ID настроек режима. */ uint32_t boxSettingsId() { return box_settings_id; } /** * @brief Возвращает последний использованный (глобальный для экземпляра) идентификатор настроек камеры. * @return ID настроек камеры. */ uint32_t camSettingsId() { return cam_settings_id; } /** * @brief Возвращает указатель на структуру интерфейса пользователя `vector_box_interface`. * @return Указатель на `vector_box_interface`. */ vector_box_interface* interfacePtr() { return interface; } /** * @brief Генерирует и отправляет события пользователю через колбэк `cb_event`. * Вызывается из `vectorClientContext` при получении событий от сервера. * @param ev Внутренний идентификатор события (тип `uint64_t`, вероятно, хэш строки, например, от `alt::makeID64`). */ void emitEvents(uint64_t ev) { // Проверяем, что интерфейс и колбэк событий существуют. if(!interface || !interface->cb_event) return; // Преобразование внутреннего события (ev) в тип события API (vector_box_interface::EvetType) // и вызов колбэка. switch(ev) { case alt::makeID64("HWUPDATE"): // Событие: обновление конфигурации оборудования на сервере. (*interface->cb_event)(interface->user_data,this,vector_box_interface::EVENT_HW_CHANGED); break; case alt::makeID64("OFFLINE"): // Событие: сервер отключился или соединение потеряно. (*interface->cb_event)(interface->user_data,this,vector_box_interface::EVENT_DISCONNECTED); break; case alt::makeID64("ONLINE"): // Событие: сервер подключился, соединение установлено. (*interface->cb_event)(interface->user_data,this,vector_box_interface::EVERT_CONNECTED); break; }; } private: /** @brief Текущий идентификатор настроек для режимов работы Vector Box. Инкрементируется при каждой смене режима. */ uint32_t box_settings_id = 0; /** @brief Последний присвоенный идентификатор настроек для какой-либо камеры. Инкрементируется при каждой установке настроек любой камеры. */ uint32_t cam_settings_id = 0; /** @brief Хэш-таблица для локального кэширования конфигураций камер. Ключ - ID камеры (`int32_t`). */ alt::hash<int32_t,vprotoCamConfigData> temp_cam_config; /** @brief Строка для временного хранения IP-адреса сервера. Используется в `serverAddr()`. */ std::string temp_addr; /** @brief Строка (специального типа `alt::string`) для временного хранения дескриптора (информации) сервера. Используется в `descriptor()`. */ alt::string temp_info; /** @brief Указатель на контекст клиента, управляющий сетевым соединением и протоколом взаимодействия с сервером. */ vectorClientContext *ctx = nullptr; /** @brief Указатель на интерфейс, предоставленный пользователем (содержит колбэки и `user_data`). */ vector_box_interface *interface = nullptr; }; // Реализация функций API, объявленных в vector_box_api.h /** * @brief Создает экземпляр клиента для сетевого взаимодействия с Vector Box. * @see `vector_box_create` в `vector_box_api.h` для полного описания параметров. * @param iface Указатель на инициализированную структуру `vector_box_interface`. * @param addr IP-адрес или имя хоста сервера (может быть `nullptr` для автообнаружения). * @param port Порт сервера (используется, если `addr` задан). * @return Указатель `void*` на созданный экземпляр клиента (типа `clientInstance`). * В случае ошибки при создании (маловероятно в текущей реализации, но зависит от `new`) вернет `nullptr`. */ VECTOR_BOX_API void* vector_box_create( vector_box_interface *iface, const char* addr, int port) { // Проверка на валидность обязательных полей интерфейса. // В текущей реализации vector_box_pull проверяет cb_frame. // Если iface == nullptr, new clientInstance упадет. if (!iface) { // Можно добавить логирование или явный возврат nullptr // if(iface && iface->cb_logger) (*iface->cb_logger)(iface->user_data, nullptr, "Error: vector_box_interface is null in vector_box_create."); return nullptr; } // Создание нового экземпляра clientInstance. clientInstance *hand = new clientInstance(iface,addr,port); // Возвращаем указатель на созданный экземпляр как void*. return hand; } /** * @brief Уничтожает экземпляр клиента Vector Box и освобождает все связанные ресурсы. * @see `vector_box_destroy` в `vector_box_api.h`. * @param hand Дескриптор экземпляра, полученный от `vector_box_create`. * @return `vector_box_interface::RET_OK` в случае успеха. * `vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE` если `hand` равен `nullptr`. */ VECTOR_BOX_API int vector_box_destroy( void *hand) { // Проверка на nullptr, чтобы избежать падения, если передали некорректный hand. if (!hand) return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; // Приведение void* к типу clientInstance*. clientInstance *cli = (clientInstance*)hand; // Удаление экземпляра, что вызовет его деструктор clientInstance::~clientInstance(). delete cli; return vector_box_interface::RET_OK; // Успешное выполнение. } /** * @brief Разрывает текущее соединение (если оно есть) и инициирует новую попытку подключения. * Используются параметры, заданные при `vector_box_create`. * @see `vector_box_reset_connection` (или `vector_box_reconnect`) в `vector_box_api.h`. * @param hand Дескриптор экземпляра. * @return `vector_box_interface::RET_OK` (независимо от успеха переподключения, состояние будет через `cb_event`). * `vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE` если `hand` равен `nullptr`. */ VECTOR_BOX_API int vector_box_reset_connection( void *hand) { if (!hand) return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; clientInstance *cli = (clientInstance*)hand; // Вызов метода disconnect у контекста клиента, если контекст существует. if (cli->context()) { cli->context()->disconnect(); } // Функция всегда возвращает RET_OK. Фактический результат переподключения // будет сообщен асинхронно через колбэк cb_event (EVENT_DISCONNECTED, затем EVERT_CONNECTED или ошибка). return vector_box_interface::RET_OK; } /** * @brief Обрабатывает сетевые события, получает кадры и вызывает соответствующие колбэки. * Эту функцию следует вызывать периодически в главном цикле приложения клиента. * @see `vector_box_pull` в `vector_box_api.h`. * @param hand Дескриптор экземпляра. * @return `vector_box_interface::RET_OK` если соединение активно. * `vector_box_interface::RET_OFFLINE` если соединение неактивно. * `vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE` если `hand` некорректен, * контекст клиента отсутствует или не задан обязательный колбэк `cb_frame`. */ VECTOR_BOX_API int vector_box_pull( void *hand) { if (!hand) return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; clientInstance *cli = (clientInstance*)hand; // Проверка, что контекст клиента существует. if (!cli->context()) { // Логирование, если возможно, и возврат ошибки. if (cli->interfacePtr() && cli->interfacePtr()->cb_logger) { (*cli->interfacePtr()->cb_logger)(cli->interfacePtr()->user_data, hand, "Error: client context is null in vector_box_pull."); } return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; } // Регистрация (или перерегистрация) обработчика событий из vectorClientContext. // Это связывает события нижнего уровня (от ctx) с колбэком cb_event верхнего уровня. cli->context()->emitEvents(alt::delegateProc<uint64_t>(cli,&clientInstance::emitEvents)); // Выполнение основного цикла обработки сетевых сообщений и внутренней логики клиента. // Здесь происходит прием данных, обработка команд, проверка состояния соединения и т.д. cli->context()->execute(); // Очистка старых разделяемых массивов (кадров), которые больше не используются. if (arrays) { arrays->cleanup(); } // Проверка наличия обязательного колбэка для кадров. if(!cli->interfacePtr() || !cli->interfacePtr()->cb_frame) return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; // Получение новых кадров из контекста клиента. // `true` в `getFrames`, вероятно, означает "получить все доступные и очистить очередь". alt::hash<int32_t,alt::array<alt::sharedArrayRef>> frames = cli->context()->getFrames(true); // Итерация по полученным кадрам для их обработки и передачи через cb_frame. // `frames` - это хэш-таблица, где ключ - ID камеры, значение - массив кадров для этой камеры. for(int i=0;i<frames.size();i++) // Итерация по камерам. { for(int j=0;j<frames.value(i).size();j++) // Итерация по кадрам для текущей камеры. { alt::sharedArrayRef frm = frames.value(i)[j]; // Получение ссылки на разделяемый массив с кадром. if(frm.is_valid()) // Проверка, что ссылка на данные кадра валидна. { // Приведение данных кадра к типу vprotoFrameData (заголовок кадра). const vprotoFrameData *ptr = (const vprotoFrameData*)frm(); // Проверка, что settings_id кадра совпадает с текущими активными settings_id. // Это предотвращает обработку "старых" кадров, полученных до смены режима или настроек камеры. if(ptr && ptr->box.settings_id == cli->boxSettingsId() && ptr->cam.settings_id == cli->camSettingsId()) { // (Повторная) проверка на наличие cb_frame, хотя она была выше. if(cli->interfacePtr()->cb_frame) { int w = ptr->w; // Ширина кадра из заголовка. int h = ptr->h; // Высота кадра из заголовка. // Если в настройках камеры (внутри заголовка кадра) указан ROI, используем его размеры. // Это означает, что ptr->w и ptr->h могут быть размерами полного сенсора, // а ptr->cam.roi_w/h - фактический размер переданных данных. if(ptr->cam.cam_id >= 0 && ptr->cam.roi_w > 0 && ptr->cam.roi_h > 0) { w = ptr->cam.roi_w; h = ptr->cam.roi_h; } // Вызов колбэка cb_frame с данными кадра. // (ptr+1) - это указатель на фактические пиксельные данные, которые следуют сразу за структурой vprotoFrameData. (*cli->interfacePtr()->cb_frame)(cli->interfacePtr()->user_data, hand,ptr->cam.cam_id,ptr+1, ptr->frame_index,ptr->sequence_index, w,h); } } } } } // Возвращаем RET_OK, если онлайн, иначе RET_OFFLINE. return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE; } /** * @brief Возвращает IP-адрес текущего активного сервера. * @see `vector_box_current_server_addr` в `vector_box_api.h`. * @param hand Дескриптор экземпляра. * @return C-строка с адресом сервера или `nullptr` если `hand` некорректен или адрес не определен. */ VECTOR_BOX_API const char* vector_box_current_server_addr(void *hand) { if (!hand) return nullptr; clientInstance *cli = (clientInstance*)hand; // Обновление состояния клиента (например, проверка соединения, обработка входящих сообщений). // Это гарантирует, что возвращаемая информация будет актуальной. if (cli->context()) { cli->context()->execute(); } // Возвращаем адрес, кэшированный или полученный в clientInstance. return cli->serverAddr(); } /** * @brief Возвращает порт текущего активного сервера. * @see `vector_box_current_server_port` в `vector_box_api.h`. * @param hand Дескриптор экземпляра. * @return Номер порта (0-65535) или -1 если `hand` некорректен, соединение не установлено или порт не определен. */ VECTOR_BOX_API int vector_box_current_server_port(void *hand) { if (!hand) return -1; clientInstance *cli = (clientInstance*)hand; // Обновление состояния клиента. if (cli->context()) { cli->context()->execute(); return cli->context()->serverPort(); // Получение порта напрямую из контекста клиента. } return -1; // Если контекста нет. } /** * @brief Получает дескриптор сервера в формате JSON (информация о сервере). * @see `vector_box_get_descriptor` в `vector_box_api.h`. * @param hand Дескриптор экземпляра. * @return C-строка с JSON-дескриптором или `nullptr` если `hand` некорректен или дескриптор не доступен. */ VECTOR_BOX_API const char* vector_box_get_descriptor(void *hand) { if (!hand) return nullptr; clientInstance *cli = (clientInstance*)hand; // `cli->context()->execute()` здесь может быть нужен, если `cli->descriptor()` (и, соответственно, `ctx->getInfo()`) // активно запрашивает данные с сервера, а не возвращает кэшированное значение. // Если getInfo() всегда возвращает кэш, обновляемый в другом месте (например, при подключении), // то execute() здесь может быть излишним. Однако, для консистентности с другими геттерами, // вызов execute() может быть оставлен для обработки любых отложенных сообщений. if (cli->context()) { // cli->context()->execute(); // Раскомментировать, если getInfo() требует актуализации состояния. } return cli->descriptor(); } /** * @brief Переводит камеры сервера в неактивный режим (IDLE_MODE). * @see `vector_box_set_idle_mode` в `vector_box_api.h`. * @param hand Дескриптор экземпляра. * @return `vector_box_interface::RET_OK` или `vector_box_interface::RET_OFFLINE` в зависимости от состояния соединения. * `vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE` если `hand` некорректен. * `vector_box_interface::RET_OFFLINE` также если контекст клиента отсутствует. */ VECTOR_BOX_API int vector_box_set_idle_mode(void *hand) { if (!hand) return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; clientInstance *cli = (clientInstance*)hand; if (!cli->context()) return vector_box_interface::RET_OFFLINE; // Контекста нет = оффлайн. vprotoBoxConfigData b; // Создание структуры конфигурации режима. b.mode = vprotoBoxConfigData::IDLE_MODE; // Установка режима IDLE. // Другие поля b (frame_count, sequence_count) остаются по умолчанию, // т.к. они не релевантны для IDLE_MODE. cli->setMode(b); // Отправка команды на сервер через clientInstance. // Возвращаем статус подключения. return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE; } /** * @brief Переводит камеры в режим "барьера" (BARRIER_MODE). * @see `vector_box_set_barrier_mode` в `vector_box_api.h`. * @param hand Дескриптор экземпляра. * @param frame_count Количество кадров в каждой последовательности. * @param sequence_count Количество последовательностей. * @return Код результата операции (`RET_OK`, `RET_OFFLINE`, `RET_ERROR_INCOMPLETE_INTERFACE`). */ VECTOR_BOX_API int vector_box_set_barrier_mode(void *hand, int frame_count, int sequence_count) { if (!hand) return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; clientInstance *cli = (clientInstance*)hand; if (!cli->context()) return vector_box_interface::RET_OFFLINE; vprotoBoxConfigData b; b.mode = vprotoBoxConfigData::BARRIER_MODE; // Установка режима барьера. b.sequence_count = sequence_count; // Количество последовательностей. b.frame_count = frame_count; // Количество кадров в последовательности. cli->setMode(b); return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE; } /** * @brief Переводит камеры в режим непрерывной съемки (STREAM_MODE). * @see `vector_box_set_stream_mode` в `vector_box_api.h`. * @param hand Дескриптор экземпляра. * @return Код результата операции (`RET_OK`, `RET_OFFLINE`, `RET_ERROR_INCOMPLETE_INTERFACE`). */ VECTOR_BOX_API int vector_box_set_stream_mode(void *hand) { if (!hand) return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; clientInstance *cli = (clientInstance*)hand; if (!cli->context()) return vector_box_interface::RET_OFFLINE; vprotoBoxConfigData b; b.mode = vprotoBoxConfigData::STREAM_MODE; // Установка режима стриминга. cli->setMode(b); return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE; } /** * @brief Переводит камеры в режим покадровой съемки (SHOT_MODE). * @see `vector_box_set_shot_mode` в `vector_box_api.h`. * @param hand Дескриптор экземпляра. * @param frame_count Количество кадров для съемки. * @return Код результата операции (`RET_OK`, `RET_OFFLINE`, `RET_ERROR_INCOMPLETE_INTERFACE`). */ VECTOR_BOX_API int vector_box_set_shot_mode(void *hand, int frame_count) { if (!hand) return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; clientInstance *cli = (clientInstance*)hand; if (!cli->context()) return vector_box_interface::RET_OFFLINE; vprotoBoxConfigData b; b.mode = vprotoBoxConfigData::SHOT_MODE; // Установка режима покадровой съемки. b.frame_count = frame_count; // Количество кадров для съемки. cli->setMode(b); return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE; } /** * @brief Устанавливает настройки (ROI, усиление, выдержка) для конкретной камеры. * @see `vector_box_set_camera_settings` в `vector_box_api.h`. * @param hand Дескриптор экземпляра. * @param cam_id Идентификатор камеры. * @param roi_x X-координата ROI. * @param roi_y Y-координата ROI. * @param roi_w Ширина ROI. * @param roi_h Высота ROI. * @param gain Усиление. * @param shutter_width Длительность выдержки. * @return Код результата операции (`RET_OK`, `RET_OFFLINE`, `RET_ERROR_INCOMPLETE_INTERFACE`). */ VECTOR_BOX_API int vector_box_set_camera_settings(void *hand, int cam_id, unsigned int roi_x, unsigned int roi_y, unsigned int roi_w, unsigned int roi_h, unsigned int gain, unsigned int shutter_width) { if (!hand) return vector_box_interface::RET_ERROR_INCOMPLETE_INTERFACE; clientInstance *cli = (clientInstance*)hand; if (!cli->context()) return vector_box_interface::RET_OFFLINE; // Получение текущей (или кэшированной) конфигурации камеры. // Это важно, так как vprotoCamConfigData может содержать другие поля (не только ROI, gain, shutter), // которые не должны быть изменены этим вызовом и должны сохраниться. vprotoCamConfigData cfg = cli->camConfig(cam_id); cfg.cam_id = cam_id; // Установка/подтверждение ID камеры в структуре. // Обновление полей конфигурации на основе переданных параметров. cfg.roi_h = roi_h; cfg.roi_w = roi_w; cfg.roi_x = roi_x; cfg.roi_y = roi_y; cfg.gain = gain; cfg.shutter_width = shutter_width; // Отправка обновленной конфигурации на сервер через clientInstance. cli->setCamConfig(cfg); return cli->context()->isOnline() ? vector_box_interface::RET_OK : vector_box_interface::RET_OFFLINE; }
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.