CImage
A nevének megfelelően egy képet képes eltárolni, amely (a rendszer többi részéhez hasonlóan) jpg, png illetve bmp lehet.
konstruktor
CImage(void)
Létrehozza az objektumot, semmilyen más inicializáló hatása nincs.
Metódusok
LoadFromFile
bool loadfromfile(string filename)
A megadott nevű fájlt beolvassa. Amennyiben a megadott fájlnév nem tartalmaz “\”-t vagy ”/”-t, akkor a megadott nevet a témakönyvtárban szereplő egyik fájlnak tekinti. Ha a filename nem tartalmaz ”:”-ot, akkor az alkalmazás gyökérkönyvtárához képest relatív a cím, egyébként abszolút címet feltételez (ez a stratégia egyébként teljesen megegyezik a SCREEN_XML-ben megadott képek elérési útjának kezelésével).
Sikeres végrehajtás esetén a visszatérési érték true ellenkező esetben false.
SaveToFile
bool savetofile(string filename)
A megadott nevű fájlba menti az Image tartalmát. Nem ad automatikusan kiterjesztést! Sikeres végrehajtás esetén a visszatérési érték true ellenkező esetben false.
GetText
mixed gettext(void)
Visszaadja az Image tartalmát string formájában, amit aztán bármilyen helyen tárolhatunk, ahol (nagy) stringeket el tudunk tárolni. A visszaadott érték már base64 kódolással kódolt, ezért további kódolás felesleges. Hiba esetén a visszaadott érték false.
GetPenColor
string getpencolor(void)
Visszaadja a vonalhúzás aktuális színét, amely alapértelmezetten fekete. (Fontos figyelmeztetés)
GetPenWidth
integer getpenwidth(void)
Visszaadja a vonalhúzás aktuális vastagságát, amely alapértelmezetten 1. (Fontos figyelmeztetés)
GetBrushColor
string getbrushcolor(void)
Visszaadja a kitöltés aktuális szinét, amely alapértelmezetten fehér. (Fontos figyelmeztetés)
GetWidth
integer getwidth()
Visszaadja a kép szélességét.
GetHeight
integer getheight()
Visszaadja a kép magasságát.
SetText
bool settext(string data)
A gettext metódus által visszaadott érték alapján visszaállítja az Image tartalmát. (Fontos figyelmeztetés)
SetPenColor
void setpencolor(string color)
A megadott színűre állítja a vonalhúzás színét. (Fontos figyelmeztetés)
SetPenWidth
void setpenwidth(integer width)
A megadott színűre állítja a vonalhúzás vastagságát. (Fontos figyelmeztetés)
SetBrushColor
void setbrushcolor(string color)
A megadott színűre állítja a kitöltés színét. (Fontos figyelmeztetés)
SetFont
void setfont(string style [, int size [, string color [, string name]]])
A TextOut metódus által használt font-ot lehet beállítani ezzel a metódussal. Minden paraméterre igaz, hogy csak akkor lesz figyelembe véve, ha üres stringtől illetve nullától eltérő értéke van.
A style paraméter adja meg a font stílusát (mint a Label konponensnél, kivéve, hogy a normál stílusra való visszaállást itt nem az üres stringgel, hanem mondjuk a ”-”-al lehet elérni).
A size-al a font méretét, a color-al a font szinét a name paraméterrel pedig értelemszerűen a font nevét adhatjuk meg.
Draw
boolean draw(CImage im, integer left, integer top)
Az im paraméterként megadott rámásolja az aktuális képre a left, top pozíciókba. (Fontos figyelmeztetés)
Line
void line(integer x1, integer y1, integer x2, integer y2 [, integer x3, integer y3 [, … ]])
Az x1,y1 pozíciókból vonalat húz az x2,y2 pozícióba majd onnan a x3, y3 pozíciókba és így tovább az aktuális vonal beállításokkal. (Fontos figyelmeztetés)
void line (array points)
Ebben a formában meghívva a points tömbnek egy kétdimenziós tömbnek kell lennie, amely minden eleme egy két elemű tömb, ami az x és y koordinátáját adja a vonal következő pozíciójának.
Ellipse
void ellipse(integer left, integer top, integer right, integer bottom [, boolean filled = false])
A left,top és right,bottom koordináták által megadott téglalapba írható ellipszist rajzolja meg az aktuális vonal beállításokkal. Amennyiben a filled paraméter igaz, akkor az ellipszist ki is tölti az aktuális kitöltő paraméterek szerint. (Fontos figyelmeztetés)
Rectangle
void rectangle(integer left, integer top, integer right, integer bottom [, boolean filled = false])
A left,top és right,bottom koordináták által megadott téglalapot rajzolja meg az aktuális vonal beállításokkal. Amennyiben a filled paraméter igaz, akkor az ellipszist ki is tölti az aktuális kitöltő paraméterek szerint. (Fontos figyelmeztetés)
TextOut
void textout(integer left, integer top, string text))
A megadott szöveget az aktuális font-al a megadott koordinátákhoz kiírja.
Resize
void resize(integer width, integer height)
A képet a megadott méretűre méretezi át. (Fontos figyelmeztetés)
void resize(float multi)
A képet a multi-szorosára nagyítja illetve kicsinyíti. (Fontos figyelmeztetés)
GrayScale
void grayscale()
A képet szürke árnyalatosra konvertálja.
BarCode39
bool barcode39(string value, int width, int height, bool writestr = false)
A value érték Code39-es vonalkódját generálja le. A image szélességét és magasságát a width és height paraméter határozza meg. Amennyiben a writestr paraméter true, akkor a szöveg kiírásra kerül az eredmény image-re.
A Code39 egyik jellegzetessége, hogy az első és utolsó jelnek “*”-nak kell lennie, amit a függvénynek nem kell átadni, azt automatikusan hozzáilleszti a szöveghez (a szöveges kiíráskor ez nem kerül feltüntetésre)
A visszatérési érték true, ha a művelet sikeres és false, ha sikertelen. Sikertelen lehet akkor is, ha a megadott szélességbe nem fér ki a megadott szöveg (azaz egy vonal szélessége nem érné el az 1 pixelt), ezért a szélesség megadására ügyelni kell!
BarEAN13
bool barean13(string value, int width, int height, bool writestr = false)
A value érték EAN-13-as vonalkódját generálja le. A image szélességét és magasságát a width és height paraméter határozza meg. Amennyiben a writestr paraméter true, akkor a szöveg kiírásra kerül az eredmény image-re.
Ez a kód a termékek azonosítására általánosan használt vonalkód. Fő jellemzője, hogy kötelezően 13 számjegyet kell tartalmaznia (nem lehetnek benne más karakterek és pontosan 13 jegyűnek kell lennie)
A visszatérési érték true, ha a művelet sikeres és false, ha sikertelen. Sikertelen lehet akkor is, ha a megadott szélességbe nem fér ki a megadott szöveg (azaz egy vonal szélessége nem érné el az 1 pixelt), ezért a szélesség megadására ügyelni kell!
BarCode128
bool barcode128(string value, int width, int height, bool writestr = false)
A value érték Code128-as vonalkódját generálja le. A image szélességét és magasságát a width és height paraméter határozza meg. Amennyiben a writestr paraméter true, akkor a szöveg kiírásra kerül az eredmény image-re.
Ennek a kódnak a fő jellemzője, hogy kis- és nagybetűket valamint számokat is tartalmazhat valamint, hogy a csak számokat tartalmazó vonalkódokat különösen tömören tudja megjeleníteni.
A visszatérési érték true, ha a művelet sikeres és false, ha sikertelen. Sikertelen lehet akkor is, ha a megadott szélességbe nem fér ki a megadott szöveg (azaz egy vonal szélessége nem érné el az 1 pixelt), ezért a szélesség megadására ügyelni kell!