Diferencias
Muestra las diferencias entre dos versiones de la página.
Ambos lados, revisión anteriorRevisión previaPróxima revisión | Revisión previa | ||
es:doc:xml_struct_elements_0.11 [07/01/2010 04:22] – alcarret | es:doc:xml_struct_elements_0.11 [20/11/2014 14:01] (actual) – editor externo 127.0.0.1 | ||
---|---|---|---|
Línea 1: | Línea 1: | ||
+ | ====== La estructura XML utilizada para describir los elementos en QElectroTech 0.11 y previos ====== | ||
+ | … o la guía del creador de elementos en XML. Esta página tiene por objeto describir la estructura XML utilizada para almacenar las definiciones de los elementos utilizados en QElectroTech. Estos direccionan a los desarrolladores de QET pero también a los no desarrolladores que querrían prescindir del editor de elemento. | ||
+ | |||
+ | |||
+ | ===== Ejemplo y estructura general de una definición de elemento | ||
+ | <code xml> | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | <name lang=" | ||
+ | <name lang=" | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | <polygon x1=" | ||
+ | < | ||
+ | <line x1=" | ||
+ | < | ||
+ | <polygon x1=" | ||
+ | <circle x=" | ||
+ | < | ||
+ | <text x=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | Este código XML representa un "motor asincrónico trifásico": | ||
+ | |||
+ | El doctype en primera línea no es muy importante en la medida en que un DTD no es suficiente para validar completamente una definición de elemento | ||
+ | |||
+ | El elemento XML principal es pues el tag " definition" | ||
+ | |||
+ | ==== Dimensiones del elemento | ||
+ | |||
+ | Una de las primeras cosas que deben precisarse en la definición de un elemento es su tamaño: anchura (width) y altura (height), en pixeles. Estas dos dimensiones deben ser totalidades múltiples de 10. Si este no es el caso, QET los redondeará a la decena superior | ||
+ | |||
+ | {{ doc: | ||
+ | |||
+ | ==== Punto de gancho (hotspot) del elemento ==== | ||
+ | |||
+ | El punto de gancho del elemento | ||
+ | ==== Orientación del elemento ==== | ||
+ | |||
+ | Es necesario a continuación definir cuáles son las orientaciones posibles del elemento. La orientación del elemento se utiliza en la instalación de los conductores pero también para impedir al usuario de volver un elemento en una dirección que no tendría sentido. El atributo de orientación es definido por una secuencia de 4 caracteres, cada carácter definiendo el comportamiento para una orientación. | ||
+ | |||
+ | * 1< | ||
+ | * 2< | ||
+ | * 3< | ||
+ | * 4< | ||
+ | |||
+ | Cada carácter puede tener el siguiente valor: | ||
+ | |||
+ | * d para " | ||
+ | * y para " | ||
+ | * n para " | ||
+ | Ejemplo : orientation=" | ||
+ | |||
+ | ==== Conexiones internas | ||
+ | |||
+ | Por defecto, no es posible conectar dos terminales de un mismo elemento. Este comportamiento puede cambiarse con el atributo " | ||
+ | |||
+ | ==== El resto de la definición | ||
+ | |||
+ | El resto de la definición se divide en dos partes: la primera es la definición de los nombres del elemento, | ||
+ | |||
+ | ===== Definir uno o más nombres para el elemento | ||
+ | |||
+ | Un elemento dado un nombre por lengua. Es pues posible definir tantos nombres que de traducciones posibles. Según la lengua del sistema (que puede ser diferente de las traducciones disponibles para QET), se indica el nombre adecuado y se elige. | ||
+ | El élément XML " | ||
+ | |||
+ | Los elementos " | ||
+ | |||
+ | ===== Dibujar y componer el elemento | ||
+ | |||
+ | La definición del dibujo del elemento es bastante próximo a la codificación de una imagen al formato SVG. Las partes del dibujo se dibujan en el mismo orden que los elementos XML, debe decirse que un elemento cubrirá eventualmente a sus antecesores. Se ignoran los elementos XML no válidos. | ||
+ | |||
+ | ==== Atributos de estilo | ||
+ | |||
+ | Para la mayoría de los elementos XML que representan una parte del dibujo, es posible definir atributos de estilo referentes, en particular, al tipo de característica y el relleno de estas partes de dibujo. | ||
+ | |||
+ | La utilización del atributo " | ||
+ | |||
+ | <code xml> | ||
+ | <circle x=" | ||
+ | </ | ||
+ | |||
+ | === Característica de Estilo | ||
+ | |||
+ | La característica de estilo se define con el estilo | ||
+ | |||
+ | * dashed (rayado): característica punteada | ||
+ | * normal [por defecto] : característica llena | ||
+ | |||
+ | === Característica de Color === | ||
+ | |||
+ | La característica de color se define con el estilo " | ||
+ | |||
+ | * white (blanco) : característica blanca | ||
+ | * black (negro) [por defecto]: característica negra | ||
+ | |||
+ | Este parámetro es aplicable también al texto | ||
+ | |||
+ | === Característica de Grosor | ||
+ | |||
+ | La característica de grosor se define con el estilo " | ||
+ | |||
+ | * thin (fino): característica fina, siempre indicado con un grosor de 1 pixel | ||
+ | * normal [por defecto] : característica normal | ||
+ | * none (ninguno) : característica no visible | ||
+ | |||
+ | === Relleno | ||
+ | |||
+ | El relleno se define con el estilo " | ||
+ | |||
+ | * white (blanco): relleno en blanco | ||
+ | * black (negro): relleno en negro | ||
+ | * none [por defecto] : no hay relleno | ||
+ | |||
+ | === El atributo antialiasing | ||
+ | |||
+ | Además del atributo " | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | El elemento con y sin antialiasing. A tener en cuenta que el antialiasing no es siempre deseable. | ||
+ | |||
+ | === Señal === | ||
+ | |||
+ | Los datos se expresan con relación a la señal que tiene por origen el punto de enganche (hotspot) y no la esquina superior izquierda del rectángulo que delimita el elemento. El eje x es horizontal y se dirige hacia la derecha. el eje y es vertical y se dirige hacia abajo. La unidad es el pixel. Se aceptan los valores reales | ||
+ | |||
+ | Vele no salir del rectángulo que delimita el elemento, bajo pena de bugs gráficos. | ||
+ | |||
+ | ==== Línea ==== | ||
+ | |||
+ | El elemento line (linea) acepta los siguientes atributos: | ||
+ | |||
+ | * x1 : abscisa de la primera extremidad de la línea | ||
+ | * y1 : ordenada de la primera extremidad de la línea | ||
+ | * x2 : abscisa de la segunda extremidad de la línea | ||
+ | * y2 : ordenada de la segunda extremidad de la línea | ||
+ | |||
+ | ==== Elipse | ||
+ | |||
+ | Una elipse es definida por el rectángulo en el cual se inserto. El elemento elipse acepta pues los siguientes atributos: | ||
+ | |||
+ | * x : abscisa de la esquina superior izquierda del rectángulo | ||
+ | * y : ordenada de la esquina superior izquierda del rectángulo | ||
+ | * width : anchura del rectángulo | ||
+ | * height : altura del rectángulo | ||
+ | |||
+ | |||
+ | ==== Círculo ==== | ||
+ | |||
+ | El elemento circle es definido por los siguientes atributos: | ||
+ | |||
+ | * x : abscisa de la esquina superior izquierda de la cuadratura del círculo | ||
+ | * y : ordenada de la esquina superior izquierda de la cuadratura del círculo | ||
+ | * diameter : diámetro del círculo | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ==== Arco ==== | ||
+ | |||
+ | Se define un arco de círculo como una porción de elipse. El elemento arco comparte pues atributos con la elipse: | ||
+ | |||
+ | * x : abscisa de la esquina superior izquierda del rectángulo | ||
+ | * y :ordenada de la esquina superior izquierda del rectángulo | ||
+ | * width : anchura del rectángulo | ||
+ | * height : altura del rectángulo | ||
+ | |||
+ | A estos atributos se añaden dos otros: | ||
+ | |||
+ | * start : ángulo inicial | ||
+ | * angle : amplitud (en grados) del arco de círculo; un valor positivo va en el sentido contrario de las agujas de un reloj | ||
+ | |||
+ | |||
+ | ==== Polígono ==== | ||
+ | |||
+ | El polígono es definido por una secuencia de puntos. El elemento polígono toma pues una serie de atributos de la siguiente forma: | ||
+ | <code xml> | ||
+ | <!-- Dessine un carré --> | ||
+ | <polygon x1=" | ||
+ | <!-- Dessine 3 côtés du carré --> | ||
+ | <polygon x1=" | ||
+ | </ | ||
+ | |||
+ | ==== Texto ==== | ||
+ | |||
+ | El elemento text acepta los siguientes atributos: | ||
+ | |||
+ | * x : abscisa del principio del texto | ||
+ | * y : ordenada del principio del texto | ||
+ | * text : texto que debe dibujarse | ||
+ | * size : tamaño que debe utilizarse para el orden del carácter | ||
+ | |||
+ | El orden utilizado es "Sans Serif" | ||
+ | |||
+ | ==== Borne (Terminal ) ==== | ||
+ | |||
+ | Los terminales (bornes) son los puntos de conexiones utilizados para conectar elementos el uno con el otro por intermedio de conductores. | ||
+ | |||
+ | Toman pues tres atributos: | ||
+ | |||
+ | * x : abscisa del terminal | ||
+ | * y : ordenada del terminal | ||
+ | * orientation : orientación del terminal = Norte (n), Sur (s), Este (e) y Oeste (w) | ||
+ | | ||
+ | | ||
+ | |||
+ | ==== Los campos de texto ==== | ||
+ | |||
+ | Los campos de texto son textos editables por el usuario; | ||
+ | |||
+ | Un campo de texto es un elemento XML " | ||
+ | |||
+ | Por defecto el campo de texto se implica para seguir siendo horizontal a pesar de las rotaciones sufridas por su elemento padre. Este comportamiento puede cambiarse con el atributo " |