Rozdíly
Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.
Obě strany předchozí revizePředchozí verzeNásledující verze | Předchozí verze | ||
cs:doc:xml_struct_elements_0.3 [11/04/2010 17:07] – pavel | cs:doc:xml_struct_elements_0.3 [20/11/2014 14:01] (aktuální) – upraveno mimo DokuWiki 127.0.0.1 | ||
---|---|---|---|
Řádek 1: | Řádek 1: | ||
+ | ====== Skladba formátu XML používaného pro popis prvků v QElectroTechu ve verzi 0.3 ====== | ||
+ | ...nebo také průvodce vytvářením prvků v XML. Tyto stránky si kladou za cíl popsat stavbu XML používaného pro ukládání vymezení prvků používaných v programu QElectroTech. Obrací se na vývojáře QET, ale stejně tak i na ne-vývojáře, | ||
+ | |||
+ | ===== Příklad a obecná skladba vymezení prvku ===== | ||
+ | <code xml> | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | <name lang=" | ||
+ | <name lang=" | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | <polygon x1=" | ||
+ | < | ||
+ | <line x1=" | ||
+ | < | ||
+ | <polygon x1=" | ||
+ | <circle x=" | ||
+ | < | ||
+ | <text x=" | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | Tento kód XML představuje " | ||
+ | |||
+ | |||
+ | Ten doctype na prvním řádku není tolik důležitý při opatření, kdy DTD nepostačuje pro plné uznání vymezení prvku za platné. | ||
+ | |||
+ | Hlavní prvek XML je tedy značka " | ||
+ | |||
+ | ==== Rozměry prvku ==== | ||
+ | |||
+ | Jednou z prvních věcí, kterou je při vymezení prvku potřeba přesně určit, je jeho velikost: šířka (width) a výška (height) v pixelech. Tyto dva rozměry musí být celé násobky desíti. Pokud tomu tak není, QET je zaokrouhlí směrem nahoru (příklad: 50 pro 42 pixelů). Vymezují velikost a obdélník vymezující prvek. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | |||
+ | ==== Bod zachycení prvku (hotspot - aktivní bod) ==== | ||
+ | |||
+ | Bod zachycení prvku označuje bod spjatý s ukazovátkem myši při tažení a upuštění prvku. Musí se jednat o úplné souřadnice. " | ||
+ | |||
+ | ==== Směrování prvku ==== | ||
+ | |||
+ | Potom je třeba určit, jaká jsou možná směrování prvku. Natočení prvku se používá při rozmístění vodičů ale také pro zabránění uživateli otočit prvkem ve směru, který by nedával žádný smysl. Vlastnost směrování je stanovena řadou čtyř znaků, každý znak určuje chování pro jedno směrování. | ||
+ | |||
+ | * 1< | ||
+ | * 2< | ||
+ | * 3< | ||
+ | * 4< | ||
+ | |||
+ | Každá vlastnost může mít následující hodnotu: | ||
+ | |||
+ | * d pro " | ||
+ | * y pro " | ||
+ | * n pro " | ||
+ | |||
+ | Příklad: orientation=" | ||
+ | |||
+ | ==== Vnitřní spojení ==== | ||
+ | |||
+ | Ve výchozím nastavení není možné spojit dvě svorky téhož prvku. Toto chování lze změnit vlastností " | ||
+ | |||
+ | ==== Zbytek vymezení ==== | ||
+ | |||
+ | Zbytek vymezení se štěpí na dvě části: první je vymezení názvu nebo názvů prvku; prvek XML " | ||
+ | |||
+ | ===== Určení jednoho nebo několika názvů prvku ===== | ||
+ | |||
+ | Daný prvek má jen jeden název pro jeden jazyk. Je tedy možné stanovit kolik je možných překladů. Dle jazyka systému (který se od překladů, jež jsou dostupné pro QET, může lišit), je vybrán a zobrazen vhodný název. Uvnitř QET pracuje jen s názvy souborů. | ||
+ | |||
+ | Prvek XML " | ||
+ | |||
+ | Na prvky " | ||
+ | |||
+ | ===== Kreslit a sestavovat prvek ===== | ||
+ | |||
+ | Vymezení kresby prvku je dost blízké kódování obrázku ve formátu SVG. Části kresby jsou kresleny ve stejném pořadí jako prvky XML. Znamená to, že prvek případně přikryje své předchůdce. K neplatným prvkům XML se nepřihlíží. | ||
+ | |||
+ | ==== Vlastnosti stylu ==== | ||
+ | |||
+ | Pro většinu prvků XML představujících část kresby je možné stanovit vlastnosti stylu spočívající zejména na typu čáry a na výplni těchto částí kresby. | ||
+ | |||
+ | Použití vlastnosti " | ||
+ | |||
+ | <code xml> | ||
+ | <circle x=" | ||
+ | </ | ||
+ | === Styl čáry === | ||
+ | |||
+ | Styl čáry se určuje stylem " | ||
+ | |||
+ | * dashed: tečkovaná čára | ||
+ | * normal [výchozí]: | ||
+ | |||
+ | === Barva čáry === | ||
+ | |||
+ | Barva čáry se určuje stylem " | ||
+ | |||
+ | * white: bílá čára | ||
+ | * black [výchozí]: | ||
+ | |||
+ | Tento parametr se používá nejinak na text | ||
+ | |||
+ | === Šířka čáry === | ||
+ | |||
+ | Šířka čáry se určuje stylem " | ||
+ | |||
+ | * thin: tenká čára, vždy se zobrazuje o šířce 1 pixelu | ||
+ | * normal [výchozí]: | ||
+ | * none: čára není viditelná | ||
+ | |||
+ | === Výplň === | ||
+ | |||
+ | Výplň se určuje stylem " | ||
+ | |||
+ | * white: bílá výplň | ||
+ | * black: černá výplň | ||
+ | * none [výchozí]: | ||
+ | === Vlastnost vyhlazování === | ||
+ | |||
+ | Vedle vlastnosti " | ||
+ | |||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | DEL s a bez vyhlazování. Zaznamenejte, | ||
+ | |||
+ | === Značka === | ||
+ | |||
+ | Souřadnice se vyjadřují v poměru ke značce mající počátek v bodu uchycení (hotspot - aktivní bod) a ne v horním levém rohu obdélníku, | ||
+ | |||
+ | Veillez à ne pas sortir du rectangle délimitant l' | ||
+ | |||
+ | ==== Čára ==== | ||
+ | |||
+ | Prvek line přijímá následující vlastnosti: | ||
+ | |||
+ | * x1: úsečka (abscisa) prvního kraje čáry | ||
+ | * y1: pořadnice (ordináta) prvního kraje čáry | ||
+ | * x2: úsečka (abscisa) druhého kraje čáry | ||
+ | * y2: pořadnice (ordináta) druhého kraje čáry | ||
+ | * end1: typ konce prvního kraje | ||
+ | * length1: délka použitá při kreslení konce prvního kraje. Výchozí hodnotou je " | ||
+ | * end2: typ kraje pro druhý kraj | ||
+ | * length2: délka použitá při kreslení konce druhého kraje. Výchozí hodnotou je " | ||
+ | |||
+ | Možnými typy konců jsou: | ||
+ | ^ Konec | ||
+ | | Obvyklý | ||
+ | | Jednoduchá šipka | ||
+ | | Trojúhelníková šipka | ||
+ | | Kruh | " | ||
+ | | Čtverec | ||
+ | |||
+ | {{: | ||
+ | |||
+ | ==== Obdélník ==== | ||
+ | |||
+ | Obdélník je vymezen souřadnicemi svého levého horního rohu a svými rozměry (šířka a výška). Prvek tedy přesně přijme následující vlastnosti: | ||
+ | |||
+ | * x: úsečka (abscissa) levého horního rohu obdélníku | ||
+ | * y: pořadnice (ordináta) levého horního rohu obdélníku | ||
+ | * width: šířka obdélníku | ||
+ | * height: výška obdélníku | ||
+ | |||
+ | ==== Elipsa ==== | ||
+ | |||
+ | Elipsa je vymezena obdélníkem, | ||
+ | |||
+ | * x: úsečka (abscissa) levého horního rohu obdélníku | ||
+ | * y: pořadnice (ordináta) levého horního rohu obdélníku | ||
+ | * width: šířka obdélníku | ||
+ | * height: výška obdélníku | ||
+ | |||
+ | ==== Kruh ==== | ||
+ | |||
+ | Prvek kruhu je vymezen následujícími vlastnostmi: | ||
+ | |||
+ | * x: úsečka (abscissa) levého horního rohu kvadratury kruhu | ||
+ | * y: pořadnice (ordináta) levého horního rohu kvadratury kruhu | ||
+ | * diameter: průměr kruhu | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | ==== Oblouk ==== | ||
+ | |||
+ | Oblouk kruhu je vymezen jako část elipsy. Prvek oblouku tedy své vlastnosti sdílí s elipsou: | ||
+ | |||
+ | * x: úsečka (abscissa) levého horního rohu obdélníku | ||
+ | * y: pořadnice (ordináta) levého horního rohu obdélníku | ||
+ | * width: šířka obdélníku | ||
+ | * height: výška obdélníku | ||
+ | |||
+ | |||
+ | K těmto vlastnostem se přidávají dvě další: | ||
+ | |||
+ | * start: odchozí úhel: úhel "0 stupeň" | ||
+ | * angle: rozpětí (ve stupních) oblouku kruhu; kladná hodnota jde proti směru hodinových ručiček | ||
+ | |||
+ | ==== Mnohoúhelník ==== | ||
+ | |||
+ | Mnohoúhelník je vymezen řadou bodů. Prvek polygon si tedy bere řadu vlastností v následující podobě: x1, y1, x2, y2, x3, y3, x4, y4, atd... Ve výchozím nastavení je mnohoúhelník zavřený. Lze jej otevřít použitím nepovinné vlastnosti closed s hodnotou " | ||
+ | <code xml> | ||
+ | <!-- Dessine un carré --> | ||
+ | <polygon x1=" | ||
+ | <!-- Dessine 3 côtés du carré --> | ||
+ | <polygon x1=" | ||
+ | </ | ||
+ | |||
+ | ==== Text ==== | ||
+ | |||
+ | Prvek text přijímá následující vlastnosti: | ||
+ | |||
+ | * x: úsečka (abscissa) začátku textu | ||
+ | * y: pořadnice (ordináta) začátku textu | ||
+ | * text: text k nakreslení | ||
+ | * size: uživatelská velikost pro předpis znaku | ||
+ | |||
+ | Používaný předpis je "Sans Serif" | ||
+ | |||
+ | ==== Svorka ==== | ||
+ | |||
+ | Svorky jsou body používaného spojení pro připojování prvků mezi sebou vodiči. Vždy se kreslí poslední (tedy nad jinými částmi kresby), jakákoli je jejich poloha v souboru XML. | ||
+ | |||
+ | Mají tři vlastnosti: | ||
+ | |||
+ | * x: úsečka (abscissa) svorky | ||
+ | * y: pořadnice (ordináta) svorky | ||
+ | * orientation: | ||
+ | |||
+ | ==== Textová pole ==== | ||
+ | |||
+ | Textová pole jsou uživatelem upravovatelné text; změny provedené v textu jsou zaznamenány ve výkresu. | ||
+ | |||
+ | Textové pole je prvek XML " | ||
+ | |||
+ | Je možné určit úhel výchozího natočení textového pole pomocí vlastnosti " | ||
+ | |||
+ | Umístění a otáčení se uskutečňuje naproti **uprostřed levé strany textového pole**. | ||
+ | |||
+ | Ve výchozím nastavení se textové pole chová tak, že zůstává vodorovně navzdory tomu, že se jeho rodičovský prvek otáčí (říkáme o tom tedy, že nenásleduje otočení provedené rodičovským prvkem). Toto chování lze změnit pomocí vlastnosti " |