Documentación de Velneo
29
29
  • Introducción
  • Velneo
    • Requerimientos de Velneo
    • Notas de la versión
    • Funcionalidades comunes a los componentes de Velneo
      • Instalación
      • Conexión con Velneo vServer
      • Cambiar el estilo de visualización
      • Ver u ocultar barras de herramientas
      • Mensajería interna entre usuarios
      • Soporte de alta resolución (HighDPI)
      • Carpetas de trabajo de los componentes de Velneo
      • Numeración de versiones de Velneo
      • Certificado de firma digital para componentes de Windows
    • Tipos de archivo generados por Velneo
    • Velneo Web
      • Plataformas y navegadores compatibles
      • Acceso a recursos del sistema
      • Siempre https
      • Funcionamiento de vatp por websocket
      • CORS para llamadas xmlhttprequest
  • Velneo vDevelop
    • ¿Qué es Velneo vDevelop?
    • Interfaz de Velneo vDevelop
      • Menú Soluciones
      • Menú Proyectos
      • Menú Objetos
      • Menú Scripts
      • Menú Edición
      • Menú Ver
      • Menú Componentes
      • Menú Ayuda
    • Lista de teclas aceleradoras de Velneo vDevelop
    • Soluciones y proyectos
    • Control y edición de proyectos
    • Herencia
    • Inspectores
    • Proyectos objetos y editores
      • Proyecto de datos
      • Proyecto de aplicación
        • Crear CSS para aplicar a objetos en edición
      • Objeto
      • Objetos de proyecto de datos
        • Indice complejo
        • Tabla
          • Actualización
          • Campo
          • Enlace
          • Indice
          • Plural
          • Traspaso de campo
          • Trigger
        • Tabla estática
        • Variable
      • Objetos de proyecto de aplicación
        • Acción
        • Alternador de lista
        • Arbol visor de tablas
        • Bloc de formularios
        • Casillero
        • Cesta
        • ComboView
        • Control SVG
        • Dispositivo serie
        • Formulario
          • Controles de visualización
            • Texto estático
            • Nombre de campo
            • Visor HTML
            • Dibujo
            • Imagen SVG
            • Caja de grupo
            • Menú arbolado
            • Barra de progreso
            • Reloj
            • Manómetro
            • Termómetro
          • Controles de edición
            • Caja de texto
            • Caja de texto enriquecido
            • Data catcher edit
            • Edición alfabética
            • Edición fecha
            • Edición fecha/hora
            • Edición fórmula
            • Edición hora
            • Edición numérica
            • Edición senda fichero
            • Edición senda directorio
            • Objeto dibujo
          • Controles de entrada
            • Botón
            • Botón de check
            • Botón de radio
            • Calendario
            • ComboBox
            • Deslizador
            • Dial
            • ListBox
            • Rueda
          • Contenedores
            • Área de scroll
            • Caja de formularios
            • Pila de formularios
            • Separador de formularios
            • Splitter
            • Vista de datos
          • Layout
          • Tree widget
          • Controles SVG
          • Extensión de ficha
        • Formulario QML
        • Gráfico
        • Imagen SVG
        • Impresora lógica
        • Informe
          • Editor de informes
          • Agrupamiento
          • Sección
          • Cálculo
        • Informe personalizable
          • Diseñando un informe personalizable básico
          • Diseño avanzado
          • Diseñando un informe personalizable
          • Añadiendo orígenes de datos
          • Añadiendo elementos al informe
          • Características avanzadas
          • Etiquetas
          • Asistente de scripts
          • Impresión de gráficos
          • Opciones html
        • ListView
        • Lista QML
        • Localizador
        • Marco
        • Menú
        • Multivista
        • Protocolo TCP-IP
        • Reemplazo
        • Rejilla
          • Propiedades de columna de rejilla
        • Rejilla avanzada
          • Propiedades de columna de rejilla avanzada
        • Toolbar
        • ViewFlow
        • Sub-objetos de vistas de datos
          • Conexión de evento
          • Drop
          • Inserción
          • Manejador de evento
      • Objetos comunes a proyecto de datos y de aplicación
        • Búsqueda
        • Cola
        • Constante
        • Dibujo
        • Esquema de tablas
        • Fichero adjunto
        • Función
        • Librería externa
        • Lupa
        • Proceso
          • Indice de comandos de instrucción de proceso
          • Comandos de base de datos
            • API
            • Bases de datos externas
            • Búsquedas
            • Campos (grupo de comandos)
            • Cestas
            • Fichas
            • Fichas seleccionadas
            • Listas
            • Tablas
            • Tubos
          • Básicos
            • Controles de flujo
            • Debug
            • Ejecución
            • Salida/retornos
            • Scripts (grupo de comandos)
            • Transacciones (comandos)
            • Variables
          • Comunicación
            • Internet
            • Protocolo TCP
            • Puerto serie
            • SDV
          • Interfaz
            • Acciones (comandos)
            • Control
              • Ejemplo de CSS
            • Diálogos
            • Formularios - comandos
            • Localizadores
            • Objeto - grupo de comandos
            • Ventana principal
            • Vista de datos - comandos
          • Sistema
            • Comandos de Sistema
            • Configuración
            • Directorios
            • Ficheros
        • Tubo de ficha
        • Tubo de lista
        • Variable local
      • Editores
        • Asistente de fórmulas
          • Operadores
          • Funciones estándar
            • Funciones API
            • Funciones básicas
            • Funciones de cadenas
              • Expresiones regulares
            • Funciones científicas
            • Funciones de Cliente-servidor
            • Funciones de color
            • Funciones de códigos
            • Funciones de directorios
            • Funciones de fechas
            • Funciones de ficha en curso
            • Funciones de horas
            • Funciones JSON
            • Funciones de Internet
            • Funciones de juegos de caracteres
              • Codecs
            • Funciones numéricas
            • Funciones de sistema
            • Funciones de tiempo
            • Funciones trigonométricas
          • Funciones de dll
          • Funciones de proceso
          • Funciones de campo
          • Campos
          • Constantes
          • Variables globales
          • Variables locales
          • Variables del sistema
          • Verificador de fórmulas
          • Conversión automática de datos
          • Introducción de datos literales
          • Secuencias de escape en cadenas de caracteres
          • Composición de sendas en fórmulas
          • Operar con datos de tipo fecha, hora y tiempo
        • Editor de imágenes
        • Selector de fuentes
    • Scripts
      • Lenguajes
        • JavaScript
          • Procesos JavaScript
          • Fórmulas JavaScript
          • Clases
            • Funciones globales
            • Objetos
            • VAbstractBrowser
            • VAbstractDataView
            • VAbstractListDataView
            • VAdvandedGridListDataView
            • VAlternatorListDataView
            • VApp
            • VBoundFieldComboBox
            • VBoundFieldEdit
            • VBoundFieldEditBrowser
            • VBoundFieldListBox
            • VByteArray
            • VCheckBox
            • VClipboard
            • VClockWidget
            • VComboBox
            • VComboListDataView
            • VCoverFlowListDataView
            • VCWebView
            • VDataCatcherEdit
            • VDataCatcherEditBrowser
            • VDataView
            • VDataViewDialog
            • VDateEdit
            • VDateEditBrowser
            • VDateTimeEdit
            • VDateTimeEditBrowser
            • VDial
            • VDir
            • VExtension
            • VFile
            • VFileInfo
            • VFilePathEditBrowser
            • VFinder
            • VFont
            • VFormBlockListDataView
            • VFormDataView
            • VFormulaEditBrowser
            • VGaugeWidget
            • VGridListDataView
            • VGroupBox
            • VImage
            • VImageEdit
            • VImageWidget
            • VInstancesList
            • VInstance
            • VInstances
            • VItemRegisterPattern
            • VLabel
            • VLineEdit
            • VLineEditBrowser
            • VListBox
            • VListDataView
            • VLogin
            • VMainWindow
            • VMdiView
            • VMimeData
            • VMultiDataView
            • VNumberSpinBox
            • VNumberSpinBoxBrowser
            • VObjectInfo
            • VObjectInstance
            • VProcess
            • VProgressBar
            • VProjectInfo
            • VPushButton
            • VQmlFormDataView
            • VQmlListDataView
            • VQmlListModel
            • VQuery
            • VRadioButton
            • VRegister
            • VRegisterList
            • VReportListDataView
            • VRequest
            • VResponse
            • VRoot
            • VScreen
            • VScrollArea
            • VServerAdmin
            • VSettings
            • VSlider
            • VSlotListDataView
            • VSolutionInfo
            • VSplitter
            • VSqlDatabase
            • VSSLCertificate
            • VSSLInfo
            • VSSLSessionCipher
            • VStackedWidget
            • VSvgButton
            • VSvgSlideSwitch
            • VSvgToggleSwitch
            • VSvgWidget
            • VSysInfo
            • VTableInfo
            • VTabWidget
            • VTextEdit
            • VTextFIle
            • VThermometerWidget
            • VThumbWheel
            • VTimeEdit
            • VTimeEditBrowser
            • VToolBox
            • VTreeItem
            • VTreeItemRegister
            • VTreeListDataView
            • VTreeMenu
            • VTreeMultiTableListDataView
            • VTreeWidget
            • VUser
            • VUserGroup
            • VUserGroupList
            • VUserList
            • VXmlReader
            • VXmlWriter
            • Widget
            • XMLHttpRequest
        • QML
          • Tipos QML
          • Funciones específicas de QML
    • Depuración
      • Depuración de procesos de Velneo
      • Depuración de procesos JavaScript
      • Monitor de vClient
    • Extensiones de Velneo vDevelop
    • Acceso directo a una solución desde vDevelop
    • Buenas prácticas
      • Buenas prácticas de organización
        • Proyectos
        • Organización de carpetas
        • Proyecto de datos
        • Proyecto de aplicación
      • Buenas prácticas de codificación
        • Identificadores
        • Teclas aceleradoras
        • Documenta
        • Diseña los formularios como si no existiesen los layouts
      • Buenas prácticas de rendimiento
        • Arquitectura
          • Listas de registros
          • Lista de resultados de una búsqueda
          • Las cestas
          • Las variables globales
          • La caché de fichas
          • Programa en cloud
        • Formularios
          • Condiciones de visible y activo
          • Carga de subformularios en pestaña, caja o pila
        • Base de datos
          • Campos
          • Indices
          • Actualizaciones
          • Eventos de tabla o triggers
          • Variables globales y constantes
          • Tablas en memoria vs tablas en disco
          • Optimizar migraciones de datos
          • Búsquedas en el servidor ¿Cuándo y Cómo?
          • Campos fórmula vs campos en disco
          • Indices condicionados vs búsquedas complejas
          • ¿Cuándo usar tablas de extensión?
          • Indices de trozos y palabras
          • ¿Cuándo usar cada tipo de campo alfa?
        • Procesos y funciones y eventos
          • 1º, 2º, 3º y 4º plano ¿Cuándo usar cada uno?
          • Bloqueo blando vs bloqueo duro
          • Pasar información del cliente al servidor
          • ¿Cómo optimizar transacciones grandes?
          • ¿Cómo gestionar las transacciones?
          • Grabaciones optimizadas para el usuario
        • Carga de registros en objetos de lista
          • Rejillas
            • Campos punteros a singular
            • Totales
            • Condiciones de activo, visible y color en columna
            • Campos de tipo objeto
        • Conoce los límites
      • Imágenes
      • Buenas prácticas para el desarrollo en equipo
    • Análisis de bases de datos para aplicaciones de Velneo
      • Un centro de enseñanza
      • Facturas de un cliente
      • Repartos de obras de teatro
      • Galería de arte
      • Gestión de un colegio
      • Instalación de lunas para vehículos
      • Libros y autores
      • Tienda de discos
      • Últimos pedidos de un proveedor
      • Existencias por almacén y precios por cliente
      • Generación de tickets para un quiosco
      • Navegación por facturas
  • Velneo vDevelop Web
  • Velneo vAdmin
    • ¿Qué es Velneo vAdmin?
    • Gestión de usuarios
    • Gestión de aplicaciones
      • Soluciones
      • Instancias
      • Disco
    • Monitorización
      • Lista de comandos
    • Tareas
    • Acceso directo
    • Velneo vAdmin Web
  • Velneo vClient
    • ¿Qué es Velneo vClient?
    • Movilidad
    • Funcionalidades de Velneo vClient
      • Accesos directos y VRL
      • Cambiar idioma
      • Panel de procesos en 2º plano
      • Manejo de rejillas
        • Submenú de filtros
      • Uso de la rejilla avanzada
      • Manejo de cestas
      • Refrescos
      • Caché local
      • Edición de campos enlazados a maestro
      • Edición de campos de tipo fecha
      • Capturar imagen desde una cámara
      • Asignar impresoras lógicas
      • Actualización automática
      • Personalización de la ventana de conexión de Velneo vClient
      • Instalador personalizado de Velneo vClient
      • Ordenación de listas
  • Velneo vServer
    • ¿Qué es Velneo vServer?
    • Instalación y configuración
      • Activación de la licencia
      • Línea de comandos de Velneo vServer
      • Parámetros configurables de Velneo vServer
      • Estructura de directorios
    • Iniciar y detener Velneo vServer
    • Funcionalidades
      • Protocolo VATP
      • Protocolo VATPS
      • Multi-hilo
      • Integridad referencial
      • Refrescos terciarios
      • Sistema transaccional
      • Sistema de bloqueos
      • Tecnología bigkey
      • Hilo de control
    • Mensajes de log de sistema
    • vPacker
  • Velneo vInstallBuilder
    • ¿Qué es Velneo vInstallBuilder?
    • Configurar una instalación
    • Probar una instalación
    • Crear el instalable
    • Accesos directos
  • Velneo vModApache
    • ¿Qué es Velneo vModApache?
    • Instalación y configuración
    • Nomenclatura de objetos en urls
    • Uso de ficheros adjuntos
    • Caché local de Velneo vModApache
  • Velneo vDataClient
    • ¿Qué es Velneo vDataClient?
    • Iniciar Velneo vDataClient
    • Interfaz de Velneo vDataClient
    • Procesos
    • Utilidades
    • Acceso directo a una instancia de datos
  • Velneo vTranslator
    • ¿Qué es Velneo vTranslator?
    • Importación y exportación basada en XLIFF
    • Acceso directo a una solución
  • Velneo ODBC Driver
    • ¿Qué es velneo ODBC Driver?
    • Referencia de comandos SQL
  • Velneo vVersion
    • ¿Qué es Velneo vVersion?
  • Velneo vERP
    • ¿Qué es Velneo vERP?
    • Manual del programador
    • Documentación de la ApiRest
    • Novedades de la versión
  • Velneo vTutor
    • ¿Qué es vTutor?
    • Tutores de objetos básicos
      • Tutor de árboles visores de tablas arboladas
      • Tutor de búsquedas
      • Tutor de cestas
      • Tutor de formularios
      • Tutor de informes
      • Tutor de localizador básico
      • Tutor de marcos
      • Tutor de rejillas
      • Tutor de rejillas avanzadas
    • Tutores de objetos avanzados
      • Tutor de alternadores de lista
      • Tutor de comboview
      • Tutor de drag and drop
      • Tutor de eventos
      • Tutor de tablas de extensión y extensiones de ficha
      • Tutor de grabación de fichas
      • Tutor de gráficos
      • Tutor de impresión de informes
      • Tutor de lupas
      • Tutor de protocolo TCP/IP
      • Tutor de reemplazo
    • Tutores de controles
      • Tutor de botones de menú
      • Tutor de controles SVG
      • Tutor de edición numérica
      • Tutor de visor html dinámico
      • Tutor de vistas de datos de lista
    • Tutores de procesos y manejadores de evento avanzados
      • Tutor de cambio de marco
      • Tutor de comandos de interfaz y acciones
      • Tutor de importación y exportación de ficheros ASCII
      • Tutor de portapapeles
      • Tutor de procesos
      • Tutor de SDV
    • Tutores de scripts
      • QML: hola mundo
      • QML: tutor básico
      • QML: tutor de vistas
      • Tutor de XMLHttpRequest (webServices)
  • Velneo cloud
    • ¿Qué es Velneo Cloud?
    • Panel de control vServer cloud
      • URC
      • vServer
      • Apache
      • SFTP
      • Usuarios
    • Copias de seguridad
    • Velneo cloud API
      • Uso de Velneo cloud API
    • Explorador de archivos cloud sFTP
    • TCP en Velneo cloud
    • Velneo vModApache en cloud
    • SLA
    • Hora de los servidores en el cloud de Velneo
    • ¿Qué puedo hacer si tengo una incidencia en mi servidor cloud?
Con tecnología de GitBook
En esta página
  • Funciones
  • Enumeraciones
  • Documentación de funciones
  • Constructor
  • Funciones generales
  • Funciones de Input/Output
  • Funciones de operaciones
  • Funciones de edición
  • Funciones de textos (no soportado en todos los formatos)
  • Ejemplos
  • 1. Importar una imagen de disco
  • 2. Reducir el tamaño de una imagen incrustada en un control de edición de tipo objeto dibujo de un formulario

¿Te fue útil?

  1. Velneo vDevelop
  2. Scripts
  3. Lenguajes
  4. JavaScript
  5. Clases

VImage

Última actualización hace 4 años

¿Te fue útil?

Con esta clase podemos manejar imágenes independientes del hardware, permitiendo cargarlas y salvarlas en distintos formatos y de distintas fuentes. Dispone de funciones para modificar las imágenes como scaledToHeight que nos devuelve otra imagen a escala de la inicial y de la altura deseada. También dispone de funciones de modificación a nivel de pixel. También es usada como parámetro en funciones de otras clases como en ara indicar el icono de una pestaña.

Hay una serie de tipos de fichero soportados por defecto, pudiendo añadirse más mediante plugins. Los tipos de fichero soportados están en el enum de tipos de ficheros de esta clase.

Las funciones de manipulación de pixels dependen del formato de la imagen.

Si el formato es 32-bits a la función setPixel en el parámetro index_or_rgb le pasamos un valor 32-bits con el color rgb 0 rgba si maneja transparencias.

Si el formato es de 8-bits o monocromo el valor de index_or_rgb deberá ser el indice del color en la paleta de colores de la imagen.

Esta clase está disponible en las .

Funciones

Constructor

Función

Generales

Retorno

Función

Number

Number

Number

Numer

Numer

Boolean

Number

Boolean

void

void

Number

De Input/Output

Retorno

Función

Boolean

Boolean

Boolean

Boolean

Boolean

Boolean

De operaciones

Retorno

Función

VImage

VImage

VImage

VImage

VImage

VImage

De edición

Retorno

Función

void

void

Number

Number

void

De textos (no soportado en todos los formatos)

Retorno

Función

void

String

Enumeraciones

Modo de transformación

  • 0 = Transformación rápida: al escalar la imagen la transformación se realiza rápidamente, sin ningún tipo de suavizado.

  • 1 = Transformación suave: la imagen resultante se transforma utilizando el filtrado bilineal (Su función es aplicar las texturas, para cada uno de los puntos de una imagen en concordancia con los que le rodean, para de este modo lograr una mayor suavidad de las figuras).

Tipos de ficheros

  • BMP = Windows Bitmap (Read/Write)

  • GIF = Graphic Interchange Format (opcional) (Read)

  • JPG = Joint Photographic Experts Group (Read/Write)

  • JPEG = Joint Photographic Experts Group (Read/Write)

  • PNG = Portable Network Graphics (Read/Write)

  • PBM = Portable Bitmap (Read)

  • PGM = Portable Graymap (Read)

  • PPM = Portable Pixmap (Read/Write)

  • TIFF = Tagged Image File Format (Read/Write)

  • XBM = X11 Bitmap (Read/Write)

  • XPM = X11 Pixmap (Read/Write)

Modo de relación de aspecto

  • 0 = IgnoreAspectRatio

  • 1 = KeepAspectRatio

  • 2 = KeepAspectRatioByExpanding

Documentación de funciones

Constructor

VImage()

Constructor de la clase.

Funciones generales

Number bitPlaneCount()

Retorna el número de planos de bits de la imagen. El número de planos de bits de la imagen es el número de bits de información de color y transparencia para cada píxel. Este número es diferente de la profundidad de bits cuando el formato de imagen contiene bits que no se usan.

Number byteCount()

Retorna el número de bytes ocupado por los datos que componen la imagen.

Number depth()

Devuelve la profundidad de la imagen. la profundidad de la imagen es el número de bits usados para guardar información de un píxel, también denominado bits por píxel (bpp). Las profundidades soportadas son: 1, 8, 16, 24 y 32.

Numer dotsPerMeterX()

Devuelve el número de píxeles horizontales por metro (físico). Junto con dotsPerMeterY() este número define la escala y el aspecto de imagen pretendidos.

Numer dotsPerMeterY()

Devuelve el número de píxeles verticales por metro (físico). Junto con dotsPerMeterX() este número define la escala y el aspecto de imagen pretendidos.

Boolean hasAlphaChannel()

Devuelve true si la imagen tiene un formato que respeta el canal alfa, en caso contrario devuelve false.

Number height()

Devuelve la altura de la imagen en píxeles.

Boolean isNull()

Devuelve true si la imagen es nula. En caso contrario devuelve false. Una imagen nula tiene todos los parámetros a 0 y no tiene datos alojados.

void setDotsPerMeterX( Number x )

Establece el número de píxeles que ocupan horizontalmente un metro (físico).

void setDotsPerMeterY( Number y )

Establece el número de píxeles que ocupan verticalmente un metro (físico).

Number width()

Devuelve el ancho de la imagen en píxeles.

Funciones de Input/Output

Boolean load( String szPath )

Carga una imagen de disco correspondiente a la senda especificada. Deduce el formato tratando de leer la cabecera.

Parámetros:

  • szPath: cadena que contiene la senda de la imagen.

Boolean load( String szPath, String szFileType )

Carga una imagen de disco correspondiente a la senda especificada. Devuelve true si la imagen pudo ser cargada, en caso contrario devuelve false. En la carga trata de leer la imagen usando el formato especificado (PNG, JPG, etc.). Si no especificamos formato trata de leer la cabecera para deducir el formato.

Parámetros:

  • szPath: cadena que contiene la senda de la imagen.

  • szFileType: cadena que indica el formato de la imagen.

Boolean loadFromData( VByteArray baBuffer, String szFileType )

Parámetros:

  • szFileType: cadena que indica el formato de la imagen.

Boolean loadResource( String szIdRefDib )

Carga una imagen del proyecto.

Parámetros:

  • szIdRefDib: cadena que contiene el identificador referencia de la imagen en el proyecto (ALIAS/ID).

Boolean save( String szPath )

Guarda la imagen a un fichero. Se guardará en el formato que se corresponda con la extensión que definimos para el nombre del fichero.

Parámetros:

  • szPath: cadena que indica la senda del fichero para guardar la imagen.

Boolean save( String szPath, String szFileType, Number nCalidad = -1 )

Guarda la imagen a un fichero, usando el formato y la calidad que pasamos como parámetros. Si el formato es 0, se guardará en el formato que se corresponda con la extensión que definimos para el nombre del fichero. Devuelve true si la imagen ha sido guardada, en caso contrario devuelve false.

Parámetros:

  • szPath: cadena que indica la senda del fichero para guardar la imagen.

  • szFileType: formato de la imagen.

  • nCalidad: número que indica la calidad de la imagen. El factor de calidad debe estar entre 0 y 100, o -1. Especifica 0 para realizar la menor compresión, 100 para ficheros grandes sin comprimir y -1 (por defecto) para usar los valores por defecto.

VByteArray saveToData( String szFileType, Number nCalidad = -1 )

Parámetros:

  • szFileType: formato de la imagen.

  • nCalidad: número que indica la calidad de la imagen. El factor de calidad debe estar entre 0 y 100, o -1. Especifica 0 para realizar la menor compresión, 100 para ficheros grandes sin comprimir y -1 (por defecto) para usar los valores por defecto.

Funciones de operaciones

VImage copy( Number x, Number y, Number width, Number height )

Devuelve una imagen que es una subárea de la imagen original.

Parámetros:

  • x: número que indica la coordenada x dentro de la imagen.

  • y: número que indica la coordenada y dentro de la imagen.

  • width: número que indica el ancho del subárea.

  • height: número que indica el alto del subárea.

VImage copy()

Devuelve una copia de la imagen.

VImage mirrored( Boolean bHorizontal = false, Boolean bVertical = true )

Devuelve una imagen especular, bien en dirección horizontal o en vertical, dependiendo de los parámetros. La imagen se puede obtener transformada en ambas direcciones. La imagen original no se cambia.

Parámetros:

  • bHorizontal: booleano que indica la dirección horizontal para la imagen especular.

  • bVertical: booleano que indica la dirección vertical para la imagen especular.

VImage scaled( Number width, Number height, Number aspectRatio = arIgnore, Number transform = tmFast )

Devuelve una copia de la imagen escalada al rectángulo definido, el ratio de aspecto y el modo de transformación definidos como parámetro.

Parámetros:

  • width: número que indica el ancho del rectángulo.

  • height: número que indica el alto del rectángulo.

  • aspectRatio: número que indica la relación del alto y ancho final con respecto al original. Ver enum de modo de relacion de aspecto.

  • transform: número que indica el modo de transformación. Ver enum de modo de transformación.

VImage scaledToHeight( Number height, Number transform = tmFast )

Devuelve una copia de la imagen escalada. La imagen devuelta sera escalada a la altura definida como parámetro y de acuerdo al modo de transformación. La función calcula automáticamente el ancho de la imagen para que el ratio de aspecto de la imagen se mantenga.

Parámetros:

  • height: número que indica el alto del rectángulo.

  • transform: número que indica el modo de transformación. Ver enum de modo de transformación.

VImage scaledToWidth( Number width, Number transform = tmFast )

Devuelve una copia de la imagen escalada. La imagen devuelta será escalada al ancho definida como parámetro y de acuerdo al modo de transformación. La función calcula automáticamente el ancho de la imagen para que el ratio de aspecto de la imagen se mantenga.

Parámetros:

  • width: número que indica el ancho del rectángulo.

  • transform: número que indica el modo de transformación. Ver enum de de modo de transformación.

Funciones de edición

void fill( Number pixelValue )

Rellena la imagen entera con el valor dado. Si la profundidad de imagen es 1, únicamente el bit bajo es usado. Es decir, fill(0), fill(2), etc., rellenan la imagen con 0, fill(1), fill(3), rellenan la imagen con 1. De igual forma, si la profundidad de la imagen es 8, se usan los 8 bits bajos, al igual que en el caso de 16 bits.

void invertPixels( Number inverMode )

Invierte todos los valores correspondientes al pixel en la imagen.

Parámetros:

  • inverMode: número que indica el modo de inversión, válido únicamente para imágenes de profundidad 32 bits. El modo por defecto es InvertRgb, que no modifica el canal alfa. Si el modo es InvertRgba, los bits correspondientes al canal alfa también son invertidos.

Invertir una imagen de 8 bits significa reemplazar todos los píxeles con índice de color i con un píxel por el índice de color -i. Lo mismo sucede en el caso de las imágenes de 1 bit. La tabla de colores no se cambia.

Number pixel( Number x, Numer y )

Devuelve el color del píxel en la posición que pasamos como parámetro. Si la posición no es válida, el resultado es indefinido.

Advertencia: esta función consume muchos recursos si la usamos para manipulaciones masivas de píxeles.

Number pixelIndex( Number x, Numer y )

Devuelve el index del píxel en la posición que pasamos como parámetro. Si la posición no es válida, o la imagen no tiene paleta ( depth()

>

8), los resultados son indefinidos.

void setPixel( Number x, Number y, Number index_or_rgb )

Establece el valor del index del píxel o el color en la posición indicada como parámetro.

Parámetros:

  • x: número que indica la coordenada x del píxel en la imagen.

  • y: número que indica la coordenada y del píxel en la imagen.

  • index_or_rgb: número que indica el index (posición del color en la tabla o paleta de colores de la imagen) o color en formato rgb (Ver QRgb).

Si el formato de la imagen es monocromo o 8 bits, el index indicado debe tener un valor de los que contiene la tabla de colores de la imagen. En el resto de los casos el parámetro ha de ser el valor RGB. Si la posición no es válida o nos salimos de la paleta de colores de la imagen, el resultado es indefinido.

Advertencia: esta función consume muchos recursos si la usamos para manipulaciones masivas de píxeles.

Funciones de textos (no soportado en todos los formatos)

void setText( String szKey, String szText )

Establece el texto de la imagen y asocia éste con la clave que pasamos como parámetro. Si únicamente queremos guardar un bloque de texto (es decir, un comentario o una descripción corta), podemos dejar vacía la clave o usar una genérica como "Description". El texto de la imagen es embebido dentro los datos de la imagen cuando usamos la función save(). No todos los formatos de imagen soportan textos embebidos.

Parámetros:

  • szKey: cadena que indica la clave en la que se incluirá el texto.

  • szText: texto que se incluirá en la imagen.

String text( String szKey )

Devuelve el texto de la imagen asociado con la clave que pasamos como parámetro.

Parámetros:

  • szKey: cadena que indica la clave cuyo texto queremos recuperar. Si no especificamos clave, devuelve todo el texto que contenga la imagen, con cada pareja de clave y texto separados por un cambio de línea.

Ejemplos

1. Importar una imagen de disco

importClass( "VImage" );

// Lanzamos el cuadro de dialogo "Abrir fichero"
var path = theMainWindow.fileDialogGetOpenFileName( "Abrir imagen", "", "*.jpg;*.bmp;*.png");

if ( path.length > 0 )
{
    // Creamos una imagen y cargamos el fichero
    var img = new VImage();

    if ( img.load(path) )
    {
        // Cogemos el control FOTO y le pasamos la imagen
        var edFoto = theRoot.dataView().control( "ED_FOTO" );

        edFoto.setImage( img );
    }
    else
        alert("No se ha podido cargar la imagen: " + path);
}

2. Reducir el tamaño de una imagen incrustada en un control de edición de tipo objeto dibujo de un formulario

//Siempre que vamos a trabajar con imágenes debemos importar la clase VImage
importClass( "VImage" );

//Indicamos el control del formulario se corresponde con el control de edición del campo objeto dibujo
var edFoto = theRoot.dataView().control( "ED_FOTO" );

//En una variable guardamos la imagen contenida en el control anterior
var img = edFoto.image();

//Por último, redimiensionamos la imagen y la guardamos de nuevo en el control
//La función scaled permite reescalar la imagen
//La función setImage asignamos la imagen al control

edFoto.setImage(img.scaled(50,50,0,1));

()

()

()

()

()

()

()

()

()

( Number x )

( Number y )

()

( String szPath )

( String szPath, String szFileType )

( VByteArray baBuffer, String szFileType )

( String szIdRefDib )

( String szPath )

( String szPath, String szFileType, Number nCalidad = -1 )

( String szFileType, Number nCalidad = -1 )

( Number x, Number y, Number width, Number height )

()

( Boolean bHorizontal = false, Boolean bVertical = true )

( Number width, Number height, Number aspectRatio = arIgnore, Number transform = tmFast )

( Number height, Number transform = tmFast )

( Number width, Number transform = tmFast )

( Number pixelValue )

( Number inverMode )

( Number x, Numer y )

( Number x, Numer y )

( Number x, Number y, Number index_or_rgb )

( String szKey, String szText )

( String szKey )

Con esta clase podemos manejar imágenes independientes del hardware, permitiendo cargarlas y salvarlas en distintos formatos y de distintas fuentes. Dispone de funciones para modificar las imágenes como scaledToHeight que nos devuelve otra imagen a escala de la inicial y de la altura deseada. También dispone de funciones de modificación a nivel de pixel. También es usada como parámetro en funciones de otras clases en para indicar el icono de una pestaña, etc.

Carga una imagen de un objeto de la clase . Si no especificamos formato trata de leer la cabecera para deducir el formato.

baBuffer: buffer, objeto de la clase que contiene la imagen.

Devuelve un objeto de la clase de retorno devolverá true.

VRegister
extensiones de Velneo vDevelop
VRegister
VByteArray
VByteArray
VByteArray
VByteArray
VImage
bitPlaneCount
byteCount
depth
dotsPerMeterX
dotsPerMeterY
hasAlphaChannel
height
isNull
setDotsPerMeterX
setDotsPerMeterY
width
load
load
loadFromData
loadResource
save
save
saveToData
copy
copy
mirrored
scaled
scaledToHeight
scaledToWidth
fill
invertPixels
pixel
pixelIndex
setPixel
setText
text