DjVu Jegyzetek létrehozása (annotations)

A DjVu dokumentum tartalmazhat bizonyos vonalas ábrákat: téglalap, ellipszis, vonal, tetszőleges poligon, melyeknek lehet vonal színe, vonalstílusa, megjegyzése és linkje (oldalszámra, belső fájlnévre vagy URL-re).

Ilyen elemeket legkönnyebben a DjVu Soloval és a Document Expresszel készíthetünk. A két program által támogatott elemekben vannak bizonyos különbségek!

Lehetséges alakzatok és tulajdonságaik

Minden jegyzethez tartozhat egy URL, egy megjegyzés és egy alakzat. Az URL-hez tartozhat még a HTML target attribútumnak megfelelő megnyitási lehetőség.

Alakzatok:

A koordinátákat az oldal bal alsó sarkából, pixleben mérjük, az ELFORGATOTT oldal rendszerében.

A polygont a definíciban nem kell lezárni a kiindulópontba, de lezártan fog megjelenni. (Szerkesztés közben nem lezártként jelenik meg.)

A DjVu3Spec.djvu dokumentum szerint a következő formák és tulajdonságok használhatók (X-el jelölt mezők):

rect oval poly line text Leírás
Keret1 (none)
(xor)
(border szín)
X X X X X Nincs keret
Logikai kizáró vagy2
Vonal (1 pixel)
(shadow_in vastagság)3
(shadow_out vastagság)
(shadow_ein vastagság)
(shadow_eout vastagság)
X 3D-s benyomódás (1-32 pixel)
3D-s kinyomódás
Lapos szélű keret befelé
Lapos szélű keret kifelé
Láthatóság (border_avis)4 X X X Mindig látható (különben csak egér alatt)
Kitöltés (hilite szín)
(opacity áttetszőség)
X Kitöltés színe #RRGGBB
Felület áttetszősége
Vonal (arrow)
(width vastagság)
(lineclr szín)
X Legyen nyíl a végén
Vonal vastagsága (alapértelmezés: 1)
Vonal színe #RRGGBB (alapértelmezés: fekete)
Szöveg (backclr szín)
(textclr szín)
(pushpin)
X Kitöltés színe (alapértelmezés: átlátszó)
Szöveg színe (alapértelmezés: fekete)
Összecsukható szövegdoboz

1 A keret fajták közül csak egy adható meg, nem lehet egyszerre shadow és color
2 XOR esetén a szín nem adható meg, a dokumentum színeit forgatja át
3 shadow_* vastagság a Document Express felülete szerint "pt", bár csak csak 6-ig engedi meg, a specifikáció szerint pixel
4 border_avis: ALways VIsible szavakból

Az egyes elemek a fájlban való definíciójuk sorrendje alapján fedik egymást (későbbi fentebb), így a programokban az "előre hozás" "hátra tolás" tulajdonképpen a sorrendjüket módosítja.

DjVuLibre DjView 4.10-ben a pushpin-es szövegdobozt nem tudom kinyitni. Az egyes elemek tooltipjét pedig nem rakja ki, ha a egy nagyobb téglalap van alattuk (annak szövegét írja ki).

Jegyzetek dsed formátuma

Hasonlóan a tartalomjegyzék készítéséhez itt is szöveges djvused adatfájlokba nyerhetjük ki vagy tölthetjük vissza az adatokat. Bár a koordináták miatt ezeknek az adatoknak a szerkesztése inkább a fentebb említett grafikus felületű programokkal valósítható meg.

Példa Document Expresszel létrehozott jegyzetek kiíratása:

djvused -e 'select 2; print-ant' basic_annotation.djvu 

Kimenete:

(mode color)
(maparea "" "" (line 797 5184 560 4256) (lineclr #4169E1))
(maparea "" "" (line 1112 4598 1312 4398) (lineclr #4169E1))
(maparea "" "" (rect 1758 3869 596 375) (shadow_in 1) 
    (border_avis) (hilite #FF0000) (opacity 44))
(maparea "http://www.djvu.hu/" "" (oval 1889 5243 631 444) 
    (border #FF00FF) (border_avis))

Próba DjVu Soloval létrehozott jegyzetek (ez egy sorban jött ki, valószínűleg az mindegy). Nem tud URL nélküli objektumot létrehozni!

(maparea (url "" "" ) "This is a highliight (always visible)"
    (rect 445 5052 599 586 )
    (shadow_in 3 ) (border_avis ) (hilite #FFFF00 ) )
(maparea "http://www.djvu.hu/" "This is a rectangle link" 
    (rect 1325 5180 916 449 ) (border #0000FF ) )
(maparea "Enter Your URL here" "Circle no link maybe?" 
    (oval 2500 4999 459 428 ) (xor ) ) 
(maparea "#10" "Polygon. Page link." (poly 3253 5390 3169 4964
    3314 4783 3569 4748 3671 5065 3534 5333 3354 5386 )
    (border #0000FF ) (border_avis ) )
A cikk legutóbb frissítve: 2015/11/20