Grafika #
Súčasťou zapojení vytváraných v CircuitMacros môžu byť aj lineárne a plošné grafické objekty vykreslované pomocou príkazov jazuka dpic. Čiara sa využíva na prepájanie prvkov zapojenia, ďaľšie grafické tvary môžeme využiť na doplnenie zapojenia alebo zvýraznenie niektorých častí. Rovnako môžeme pomocou nich vytvárať rôzne blokové zapojenia alebo vývojové diagramy.
Poznámka
Základné grafické objekty (line, spline, arc, box, circle, ellipse, move, arrow) sú príkazmi jazyka dpic a majú preto inú formu zápisu ako makrá definované v CircuitMacros, ktoré sú naprogramované s využitím týchto príkazov. Program na vykreslenie zapojenia preto pozostáva z makier pre vykreslovanie komplikovanejších prvkov ako aj príkazov dpic pre kreslenie jednoduchých objektov.
Všeobecný formát pre definíciu grafických objektov v dpic má tvar
[reference:] object [atribútes] [placement] [parameters] [string]
reference - označenie objektu pre prístup k jeho parametrom
object - grafický objekt (line, box ...)
atribútes - tvar objektu (šípky ...)
placement - umiestnenie objektu
parameters - parametre zobrazenia (dotted, dashed ...)
string - text ktorý sa zobrazí v geometrickom strede objektu
Čiary #
Definovanie čiary je možné niekoľkými spôsobmi. V súradnicovej sústave môžeme zadať polohu absolútne dvojicou (x,y). alebo smerom kreslenia a dĺžkou relatívne voči poslednej polohe, ktorá je obsahom premennej Here. Pri prácu so súradnicami môžeme využívať vektorovú aritmetiku. Vykreslením čiary sa aktualizuje hodnota Here na polohu koncového bodu čiary.
[reference:] line [atribútes] [linespec] [string]
attributes - <-|<->|-> vykreslenie šípky na konci čiary
linespec - from position | to position | direction [ expr ]
| linespec linespec
| linespec then linespec
string - text vykreslený v strede čiary
Príklad použitia
L1: line -> from (1,1) to (2,2) "line L1"
L1: - referencia
-> - atribút, šipka na konci čiary
from (1,1) to (2,2) - placement, umiestnenie objektu na ploche
"line L1" - text v geometrickom strede objektu
Nasledujúce príklady ukazuje niekoľko možností použitia čiary.
Origin: Here
line from (1,1) to (3,2); # A. absolutne polohy bodov, nastavuje
# poziciu Here na konc. bod
line from Here to (4,2); # B. ciara od aktualnej pozicie
line to (5,3); # C. to iste od posledneho bodu
line to Here + (0,1); # D. relativne od poslednej pozicie
line left_ 2; # E. relativne zadanim smeru v jednej osi
line left_ 1 up_ 1; # F. relativne v dvoch osiach
# G. zadanim postupnosti bodov
line from (6,1) to (7,2) to (8,1) to (9,2); {"G" above};
# H. postupnostou relativnych krokov
line -> from (6,5) right_ 1 then right_ 1 down_ 2 then right_ 1 up_ 1;
Poznámka
Všimnite si v predchádzajúcom príklade, že relatívnu pozíciu môžeme zadať nielen v kolmých smeroch right_, left_, up_, down_
line right_ 2;
ale aj ich kombináciu, ktorá vykreslí šikmú čiaru
line right_ 2 down_ 1;
Krivky #
Krivky môžeme kresliť rôznymi spôsobmi, pre krivky definované ako spline môžeme nastaviť parametrom tvar krivky (tension parameter). Čiary aj krivky môžeme modifikovať parametrami dashed a dotted, za ktorými môže nasledovať numerická hodnota udávajúca hustotu čiarok alebo bodiek, skutočné závisí od zvolenej mierky obrázku. Pri krivkách nie je možné vykresliť v ich definícii text na ich konci ako pri čiare.
[reference:] spline [t] [atribútes] [linespec]
t - napätie (tension) krivky v rozsahu 0...1
attributes - <-|<->|-> vykreslenie šípky na konci krivky
linespec - from position | to position | direction [ expr ]
| linespec linespec
| linespec then linespec
Príklad použitia kriviek
# I. spline krivka, súradnic rovnake ako pri čiare
spline from (1,1.5) right_ 1 up_ 1 then right_ 1 down_ 1 then right_ 1 down_ 2 then up_ 3;
# J. obojstranná šipka na krivke
spline <-> from (6,1) to (7,4) to (8,1) to (9.5,3);
# K. Parameter tension
spline 1.4 from (6, 3.5) up_ 2 then right_ 2 then down_ 2 dashed .08;
spline 1.0 from (6, 3.5) up_ 2 then right_ 2 then down_ 2;
spline 0.6 from (6, 3.5) up_ 2 then right_ 2 then down_ 2 dotted .05;
Atribúty lineárnych prvkov #
Pre čiaru a splajnovú krivku sú definované štandardné atribúty, ku ktorým sa pristupuje referenciou na objekt a operátorom .
.start .s - bod v ktorom bol začiatok kreslenia
.end .e - bod v ktorom skončilo kreslenie
.center .c - geometrický stred prvku
Každý atribút reprezentuje súradnicu v tvare dvojice hodnôt (x,y). Príklad použitia atribútov
L: line to (1,1);
L.center - je ekvivalentom (L.center.x, L.center.y)
alebo (L.c.x, L.c.y)
(L.s, L.e) - je ekvivalentom (L.s.x, L.e.y)
Šípky #
Ako je uvedené v defínícii čiar a kriviek, na ich koncoch môžeme v prípade potreby vykresliť šípku doplnením atribútov <-, <->, -> alebo príkazom arrow, ktorý umožňuje nastavenie parametrov šíky
[reference:] arrow [atribútes] [linespec] [parameters]
attributes - <-|<->|-> vykreslenie šípky na konci čiary
linespec - from position | to position | direction [ expr ]
| linespec linespec
| linespec then linespec
parameters - tvar a veľkosť šípky
thick - hrúbka čiary (0.8)
ht - výška šípky (0.1)
wid - šírka šípky (0.05)
Príklady použitia
arrow -> from (0,0) to (1,1) thick 2 ht 0.5 wid 0.5
arrow from (1,4) right_ 2; {"K" ljust}; # K. sipka menom
arrow -> from (1,4.5) right_ 2; {"L" ljust}; # L. sipka smerom doprava
arrow <- from (1, 5) right_ 2; {"M" ljust}; # M. sipka smerom dolava
Obddĺžnik, kružnica a elipsa #
Definícia plošných objektov má tvar
[reference:] box [at pos] [wid x] [ht y] [parameters] [string]
[reference:] circle [at pos] [rad r] [parameters] [string]
[reference:] ellipse [at pos] [wid x] [ht y] [parameters] [string]
at pos - poloha stredu objektu
wid - šírka
ht - výška
rad - polomer
parameters - parametre zobrazenia
strin - text v strede objektu
Pri zadaní príkazu vykreslenia objektu tento zadáme len menom bez parametrov, objekt sa vykreslí s prednastavenými (default) hodnotami.
Atribúty plošných prvkov #
Pri obryse plošných objektov sú atribúty definované podľa svetových strán.
.ne .se .nw .sw
.t .top .north .n
.b .bot .bottom .south .s
.right .r .east .e
.left .l .west .w
.start
.end
.center .centre .c
Kruhový oblúk #
Kruhový oblúk je objekt, ktorý zdiela atribútu lineárnych ako aj plošných objektov. Oblúk je definovaný smerom a pomocou dvoch alebo troch bodov
arc [atribútes] cw|ccw from position to position [with .c at centre]
atribútes - <-|<->|-> vykreslenie šípky na konci oblúka
cw|ccw - smer oblúka
position - súradnice počiatočného a koncového bodu oblúka
centre - súradnice stredu kružnice oblúka
Bez zadaného stedu je oblúk vykreslený ako polkružnica so stredom medzi koncovými bodmi oblúka.
P1: (1, 1);
P2: (4, 4);
P3: (3.5, 1.5)
# označenie
circle rad 0.1 at P1; # zaciatok
circle rad 0.1 at P2; # koniec
rad 0.1 at P3; # stred A2
color_red;
A1: arc cw from P1 to P2 # obluk A1 bez zadaného stredu
"A1" at A1.nw above rjust;
L1: line from P1 to P2 dashed;
circle rad 0.1 at L1.c; # stred A1
color_blue
A2: arc -> cw from P1 to P2 with .c at P3
line from P1 to P3 dashed;
line from P2 to P3 dashed;
"A2" at A2.nw above rjust;
Obr. 41 Vykreslenie kruhového oblúku#