Ĝenerala prezento

Kreo de dosiero cyloop.

Sintakso : cylcree [nomo_dosiero_cyloop]

cylcree estas interaga komisio kiu demandas al la uzanto difini ĉiujn karakteristikojn de dosiero cyloop antaŭ ol krei tiun dosieron.

La nomo de la dosiero cyloop por krei povas esti pasinta en parametro (kun aŭ sen la sufikso .cyl).
Manke de tiu parametro, la komisio cylcree komencas per demandi la nomon de la dosiero por krei.

Poste komencas serion de demandoj/respondoj kiuj permesas al la uzanto difini ĉiujn karakteristikojn de la dosiero cyloop ke li volas krei.

Por pli ol detaloj sur la kreo de dosiero cyloop, vidi tiun paĝon retejo.

Afiŝado de la strukturo kaj de la enhavo de dosiero cyloop.

Sintakso : cyldump [nomo_dosiero_cyloop]

cyldump afiŝas la malsamajn karakteristikojn de dosiero cyloop :
La nomo de dosiero cyloop por afiŝadi povas esti pasinta en parametro (kun aŭ sen la sufikso .cyl).
Manke de tiu parametro, la komisio cyldump komencas per demandi la nomon de tiu dosiero.

Inkremento de variablo de tipo nombrilo.

Sintakso : cylincr nomo_dosiero_cyloop

La parametro nomo_dosiero_cyloop estas deviga.

cylincr permesas inkrementi la variablon de la dosiero nomo_dosiero_cyloop al la komuna momento de la kuranta ciklo, kiam tiu variablo estas de tipo nombrilo.

La inkremento de la nombrilo estas sistema dum la unua alvoko de cylincr por nova momento de la ciklo.

Tiel de aliaj alvokoj de cylincr ekestas dum la sama momento de la ciklo, ili estos enskribitaj en konton aŭ ignoritaj laŭ la karakteristikoj de la variablo.

De sama, okaze de ŝanĝo de ciklo ekde la antaŭa alvoko de cylincr, kalkulo de ekvilibreco estas plenumita sur la datumoj de la antaŭaj cikloj jam enmemorigitaj, kiam tiu kalkulo estis antaŭvidita por la variablo.

Inserto de nova valoro en variablo kiu ne estas tipon nombrilo

Sintakso : cyladdval nomo_dosiero_cyloop valoro

La parametroj nomo_dosiero_cyloop kaj valoro estas devigaj.

cyladdval permesas aldoni la datumon valoro al la variablo de la dosiero nomo_dosiero_cyloop al la komuna momento de la kuranta ciklo, kiam tiu variablo ne estas tipo nombrilo.

La aldono de la datumo estas sistema dum la unua alvoko de cyladdval por nova momento de la ciklo.

Tiel de aliaj alvokoj de cyladdval ekestas dum la sama momento de la ciklo, ili estos enskribitaj en konton aŭ ignoritaj laŭ la karakteristikoj de la variablo.

De sama, okaze de ŝanĝo de ciklo ekde la antaŭa alvoko de cyladdval, kalkulo de ekvilibreco estas plenumita sur la datumoj de la antaŭaj cikloj jam enmemorigitaj, kiam tiu kalkulo estis antaŭvidita por la variablo.

Generacio de grafikaĵoj ekde dosiero cyloop

Sintakso : cylgraph nomo_dosiero_cyloop nomo_dosiero_bildo ĝeneralaj_ebloj priskriboj_strekitaj
La parametroj nomo_dosiero_cyloop kaj nomo_dosiero_bildo estas devigaj.

cylgraph generas bildon nomo_dosiero_bildo ekde la dosiero nomo_dosiero_cyloop.

Ĝeneralaj ebloj

Tiuj unuaj ebloj estas ĉiuj fakultativaj kaj povas aperi en ajna ordo. Ili koncernas la posedaĵojn de la bildo generita. -h permesas precizigi la alton grafikaĵo_alton en pikseloj de la grafikaĵo integrita al la bildo generita.
Per difekto, tiu alto estas de 100 pikseloj, krom se la totala alto de la bildo estas fiksita al suba valoro.

-w permesas precizigi la larĝon grafikaĵo_larĝon en pikseloj de la grafikaĵo integrita al la bildo generita.
Per difekto, tiu larĝo estas de 400 pikseloj, krom se la totala larĝo de la bildo estas fiksita al suba valoro.

-H permesas precizigi la alton bildo_alton en pikseloj de la bildo.
Per difekto, tiu alto estas de 50 pikseloj pliaj kiuj la alto de la grafikaĵo.

-W permesas precizigi la larĝon bildo_larĝon en pikseloj de la bildo.
Per difekto, tiu larĝo estas de 100 pikseloj pliaj kiuj la larĝo de la grafikaĵo. Koncerne al la elektita larĝo, ŝi estas ĉiam rondigita al la oblo de 8 supera.

-T permesas plialdoni supre bildon generitan la titolo titolas_bildon

-p petu afiŝi la vertikalan ŝtuparon de la grafikaĵo sub la formo de procentoj, prefere ol sub la formo de krudaj ciferecaj valoroj.

Priskribo de la strekitaj

La priskribo de la strekitaj estas konstituita de serio de ebloj havante la sekvan formon : La ebloj kiuj sekvas permesas ĉiun priskribi iu strekita inkludita en la grafikaĵo.

Povas esti pluraj strekitaj (ĝis 12). En tiu kazo, la malsamaj strekita estas enmetitaj en la grafikaĵo en la ordo en kiu ili estas menciitaj. Kiam pluraj strekitaj rajdas sin en la grafikaĵo, estas la lasta strekita kiu prioritatas kaj kiu donos al la pikselon lian koloron.

-tdiko koloro -a koloro -mtdiko koloro -ma koloro -Mtdiko koloro -Ma koloro

Formatoj de bildo

La komisio cylgraph povas generi de la bildoj en multnombra formato.
La formato de la bildo generita dependas de la sufikso de la dosiero nomo_dosiero_bildo pasinta en parametro.

Tamen, kun la celo multnombra zeloto formatoj de bildo, la komisio cylgraph apelaciita al la komisio convert de la projekto ImageMagick.

Manke de tiu komisio, la bildoj estas generitaj al la formato bmp kaj la nomoj de la dosiero bildo finas sin per la sufikso .bmp

Agordo : la dosiero sysfont

La dosiero sysfont estas dosiero laŭvola sistemo de la projekto cyloop.

Li devas esti kreita tiel necesa al la momento de la instalo de cyloop.

Tiu dosiero ne estas utile ke kiam la komputilo ne uzas la ludon de karakteroj UTF-8 (tio estas kiam la variablo de medio $LANG ne finas sin per UTF-8).

En tiu kazo, li estas uzita de la komisio cylgraph kun la celo uzi la bonan ludon de karakteroj por enmeti tekston en la grafikaĵoj generitaj.

Enplantado

Se la komisioj ekzekuteblaj de la projekto Cyloop estas enplantitaj en /usr/bin preskaŭ la aliaj komisioj de la mastruma sistemo, la dosiero sysfont devas esti enplantita en /usr/share/cyloop

En la kontraŭa kazo, li devas esti enplantita en la sama repertuaro kiu la dosieroj ekzekuteblaj de la projekto Cyloop estas : (...)/cyloop/bin

Enhavita

La enhavo de la dosiero sysfont limigas sin en la nomo de dosiero degelo (sen alia karaktero antaŭ aŭ poste ĉefe de la blankoj).

La nomoj de dosieroj ebla degelo estas :

iso8859-2iso8859-3 iso8859-4iso8859-5
iso8859-6iso8859-7 iso8859-8iso8859-9
iso8859-10iso8859-11 iso8859-13iso8859-14
iso8859-15iso8859-16 windows-1252

La nomo iso8859-1 estas same permesita, sed la dosiero sysfont ne estas necesa se oni uzas tiun ludon de karakteroj, ĉar estas la ludo de karakteroj implicite.