Protobuf Qt GUI Types Module
Ofrece compatibilidad para utilizar tipos nativos de la Qt GUI en Protobuf. Más información...
Este módulo se introdujo en Qt 6.6.
Descripción detallada
Qt::ProtobufQtGuiTypes es una biblioteca con mensajes protobuf predefinidos diseñada para encapsular una selección de tipos de Qt GUI.
Lista de tipos de Qt GUI compatibles:
Qt GUI Uso
Para habilitar la compatibilidad con los tipos « Qt GUI », añade ProtobufQtGuiTypes como dependencia a tu proyecto CMake:
...
find_package(Qt REQUIRED COMPONENTS Protobuf ProtobufQtGuiTypes)
... # After target creation
target_link_libraries(${TARGET} PRIVATE Qt::ProtobufQtGuiTypes)Antes de realizar cualquier serialización o deserialización de mensajes que utilicen tipos de Qt GUI como campos, llama al método de registro:
// e.g. in main.cpp
QtProtobuf::qRegisterProtobufQtGuiTypes();
...Todos los mensajes compatibles se describen en un archivo .proto especial, QtGui.proto, que describe los tipos de Qt del módulo Qt GUI.
También puede utilizar el archivo para generar código para otros lenguajes o marcos de trabajo.
Importa el módulo de tipos « Qt GUI » necesario en tu archivo .proto de interfaz. Por ejemplo:
syntax = "proto3";
package project.module.component;
import "QtGui/QtGui.proto";
message QMatrix4x4Message {
QtGui.QMatrix4x4 matrix = 1;
}El generador de Qt Protobuf detecta los tipos de Qt GUI, proporcionados por el paquete ProtobufQtGuiTypes, y los utiliza directamente. Esto te ofrece la flexibilidad de utilizar estos tipos sin necesidad de conversiones adicionales.
En CMake, puedes extraer la ruta de inclusión de Protobuf de la biblioteca utilizando la propiedad de destino « QT_PROTO_INCLUDES »:
qt_add_protobuf(MyProtoLib
PROTO_FILES
MyQtGuiTypesUsage.proto
PROTO_INCLUDES
$<TARGET_PROPERTY:Qt::ProtobufQtGuiTypes,QT_PROTO_INCLUDES>
)Serialización de QImage
La biblioteca ProtobufQtGuiTypes ofrece la posibilidad de trabajar con la clase ` QImage `. Normalmente, la biblioteca convierte todos los objetos QImage al formato PNG. Sin embargo, si el QImage se creó utilizando uno de los formatos de punto flotante de QImage::Format, la conversión a PNG provocará una pérdida de datos. Para evitar esta pérdida, la biblioteca convierte automáticamente el archivo de imagen al formato TIFF, si el sistema lo admite; de lo contrario, lo convierte a PNG.
Nota: si no deseas utilizar TIFF, deberás convertir la imagen explícitamente a un formato que no sea de punto flotante.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.