Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente | ||
doc:xml_struct_elements_0.2 [16/02/2009 23:07] – édition externe 127.0.0.1 | doc:xml_struct_elements_0.2 [20/11/2014 14:02] (Version actuelle) – modification externe 127.0.0.1 | ||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
+ | ====== La structure XML utilisée pour décrire les éléments dans QElectroTech 0.2 ====== | ||
+ | ...ou le guide du créateur d' | ||
+ | |||
+ | ===== Exemple et structure générale d'une définition d' | ||
+ | <code xml> | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | <name lang=" | ||
+ | <name lang=" | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | <polygon x1=" | ||
+ | < | ||
+ | <line x1=" | ||
+ | < | ||
+ | <polygon x1=" | ||
+ | <circle x=" | ||
+ | < | ||
+ | <text x=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | Ce code XML représente un " | ||
+ | |||
+ | Le doctype en première ligne n'est pas très important dans la mesure où une DTD n'est pas suffisante pour valider complètement une définition d' | ||
+ | |||
+ | L' | ||
+ | ==== Dimensions de l' | ||
+ | |||
+ | L'une des premières choses à préciser lors de la définition d'un élément est sa taille : largeur (width) et hauteur (height), en pixels. Ces deux dimensions doivent être des entiers multiples de 10. Si ce n'est pas le cas, QET les arrondira à la dizaine supérieure (exemple : 50 pour 42 pixels). Elles déterminent la taille et le rectangle délimitant de l' | ||
+ | |||
+ | {{ schema_xml_element1.png |Schema explicatif}} | ||
+ | |||
+ | ==== Point d' | ||
+ | |||
+ | Le point d' | ||
+ | ==== Orientation de l' | ||
+ | |||
+ | Il faut ensuite définir quelles sont les orientations possibles de l' | ||
+ | |||
+ | * 1< | ||
+ | * 2< | ||
+ | * 3< | ||
+ | * 4< | ||
+ | |||
+ | Chaque caractère peut avoir la valeur suivante : | ||
+ | |||
+ | * d pour " | ||
+ | * y pour " | ||
+ | * n pour " | ||
+ | |||
+ | Exemple : orientation=" | ||
+ | |||
+ | ==== Connexions internes ==== | ||
+ | |||
+ | Par défaut, il n'est pas possible de relier deux bornes d'un même élément. Ce comportement peut être changé avec l' | ||
+ | |||
+ | ==== Le reste de la définition ==== | ||
+ | |||
+ | Le reste de la définition est scindé en deux parties : la première est la définition du ou des noms de l' | ||
+ | |||
+ | ===== Définir un ou plusieurs noms pour l' | ||
+ | |||
+ | Un élément donné n'a qu'un nom par langue. Il est donc possible de définir autant de noms que de traductions possibles. Selon la langue du système (qui peut être différente des traductions disponibles pour QET), le nom adéquat est choisi et affiché. En interne, QET ne manipule que des noms de fichiers. | ||
+ | |||
+ | L' | ||
+ | |||
+ | Les éléments " | ||
+ | |||
+ | ===== Dessiner et composer l' | ||
+ | |||
+ | La définition du dessin de l' | ||
+ | ==== Attributs de style ==== | ||
+ | |||
+ | Pour la plupart des éléments XML représentant une partie du dessin, il est possible de définir des attributs de style portant notamment sur le type de trait et le remplissage de ces parties de dessin. | ||
+ | |||
+ | L' | ||
+ | |||
+ | <code xml> | ||
+ | <circle x=" | ||
+ | </ | ||
+ | === Style du trait === | ||
+ | |||
+ | Le style de trait se définit avec le style " | ||
+ | |||
+ | * dashed : trait pointillé | ||
+ | * normal [par défaut] : trait plein | ||
+ | |||
+ | === Couleur du trait === | ||
+ | |||
+ | La couleur du trait se définit avec le style " | ||
+ | |||
+ | * white : trait blanc | ||
+ | * black [par défaut] : trait noir | ||
+ | |||
+ | Ce paramètre s' | ||
+ | |||
+ | === Epaisseur du trait === | ||
+ | |||
+ | L' | ||
+ | |||
+ | * thin: trait fin, toujours affiché avec une épaisseur de 1 pixel | ||
+ | * normal [par défaut] : trait normal | ||
+ | * none : trait non visible | ||
+ | |||
+ | === Remplissage === | ||
+ | |||
+ | Le remplissage se définit avec le style " | ||
+ | |||
+ | * white : remplissage en blanc | ||
+ | * black : remplissage en noir | ||
+ | * none [par défaut] : pas de remplissage | ||
+ | |||
+ | === L' | ||
+ | |||
+ | En plus de l' | ||
+ | |||
+ | {{ antialiasing.png |Antialiasing}}\\ | ||
+ | |||
+ | === Repère === | ||
+ | |||
+ | Les coordonnées sont exprimées par rapport au repère ayant pour origine le point d' | ||
+ | |||
+ | Veillez à ne pas sortir du rectangle délimitant l' | ||
+ | ==== Ligne ==== | ||
+ | |||
+ | L' | ||
+ | |||
+ | * x1 : abscisse de la première extrémité de la ligne | ||
+ | * y1 : ordonnée de la première extrémité de la ligne | ||
+ | * x2 : abscisse de la seconde extrémité de la ligne | ||
+ | * y2 : ordonnée de la seconde extrémité de la ligne | ||
+ | * end1 : type d' | ||
+ | * length1 : longueur utilisée pour dessiner l' | ||
+ | * end2 : type d' | ||
+ | * length2 : longueur utilisée pour dessiner l' | ||
+ | |||
+ | Les types d' | ||
+ | ^ Embout | ||
+ | | normal | ||
+ | | Flèche simple | ||
+ | | Flèche triangulaire | ||
+ | | cercle | ||
+ | | carré | ||
+ | |||
+ | {{: | ||
+ | ==== Rectangle ==== | ||
+ | |||
+ | Un rectangle est défini par les coordonnées de son coin supérieur gauche et par ses dimensions (largeur et hauteur). L' | ||
+ | |||
+ | * x : abscisse du coin supérieur gauche du rectangle | ||
+ | * y : ordonnée du coin supérieur gauche du rectangle | ||
+ | * width : largeur du rectangle | ||
+ | * height : hauteur du rectangle | ||
+ | |||
+ | ==== Ellipse ==== | ||
+ | |||
+ | Une ellipse est définie par le rectangle dans lequel elle s' | ||
+ | |||
+ | * x : abscisse du coin supérieur gauche du rectangle | ||
+ | * y : ordonnée du coin supérieur gauche du rectangle | ||
+ | * width : largeur du rectangle | ||
+ | * height : hauteur du rectangle | ||
+ | |||
+ | ==== Cercle ==== | ||
+ | |||
+ | L' | ||
+ | |||
+ | * x : abscisse du coin superieur gauche de la quadrature du cercle | ||
+ | * y : ordonnee du coin superieur gauche de la quadrature du cercle | ||
+ | * diameter : diametre du cercle | ||
+ | |||
+ | {{ ellipse-circle-arc.png |Ellipse, cercle et arc}} | ||
+ | |||
+ | ==== Arc ==== | ||
+ | |||
+ | Un arc de cercle est défini comme étant une portion d' | ||
+ | |||
+ | * x : abscisse du coin supérieur gauche du rectangle | ||
+ | * y : ordonnée du coin supérieur gauche du rectangle | ||
+ | * width : largeur du rectangle | ||
+ | * height : hauteur du rectangle | ||
+ | |||
+ | À ces attributs s'en ajoutent deux autres : | ||
+ | |||
+ | * start : angle de depart : l' | ||
+ | * angle : étendue (en degrés) de l'arc de cercle ; une valeur positive va dans le sens contraire des aiguilles d'une montre | ||
+ | |||
+ | ==== Polygone ==== | ||
+ | |||
+ | Le polygone est définie par une suite de points. L" | ||
+ | <code xml> | ||
+ | <!-- Dessine un carré --> | ||
+ | <polygon x1=" | ||
+ | <!-- Dessine 3 côtés du carré --> | ||
+ | <polygon x1=" | ||
+ | </ | ||
+ | |||
+ | ==== Texte ==== | ||
+ | |||
+ | L' | ||
+ | |||
+ | * x : abscisse du début du texte | ||
+ | * y : ordonnée du début du texte | ||
+ | * text : texte à dessiner | ||
+ | * size : taille à utiliser pour la police de caractère | ||
+ | |||
+ | Le police utilisée est "Sans Serif" | ||
+ | |||
+ | ==== Borne ==== | ||
+ | |||
+ | Les bornes sont les points de connexions utilisées pour raccorder des éléments entre eux par l' | ||
+ | |||
+ | Ils prennent donc trois attributs : | ||
+ | |||
+ | * x : abscisse de la borne | ||
+ | * y : ordonnée de la borne | ||
+ | * orientation : orientation de la borne = Nord (n), Sud (s), Est (e) ou Ouest (w) | ||
+ | |||
+ | ==== Les champs de texte ==== | ||
+ | |||
+ | Les champs de texte sont des textes éditables par l' | ||
+ | |||
+ | Un champ de texte est un élément XML " | ||
+ | |||
+ | Par défaut, le champ de texte se comporte de manière à rester horizontal malgré les rotations subies par son élément parent (on dit alors qu'il ne suit pas les rotations de son élément parent). Ce comportement peut être changé avec l' |