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.
CImage(void)
Létrehozza az objektumot, semmilyen más inicializáló hatása nincs.
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.
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.
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.
string getpencolor(void)
Visszaadja a vonalhúzás aktuális színét, amely alapértelmezetten fekete. (Fontos figyelmeztetés)
integer getpenwidth(void)
Visszaadja a vonalhúzás aktuális vastagságát, amely alapértelmezetten 1. (Fontos figyelmeztetés)
string getbrushcolor(void)
Visszaadja a kitöltés aktuális szinét, amely alapértelmezetten fehér. (Fontos figyelmeztetés)
integer getwidth()
Visszaadja a kép szélességét.
integer getheight()
Visszaadja a kép magasságát.
bool settext(string data)
A gettext metódus által visszaadott érték alapján visszaállítja az Image tartalmát. (Fontos figyelmeztetés)
void setpencolor(string color)
A megadott színűre állítja a vonalhúzás színét. (Fontos figyelmeztetés)
void setpenwidth(integer width)
A megadott színűre állítja a vonalhúzás vastagságát. (Fontos figyelmeztetés)
void setbrushcolor(string color)
A megadott színűre állítja a kitöltés színét. (Fontos figyelmeztetés)
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.
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)
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.
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)
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)
void textout(integer left, integer top, string text))
A megadott szöveget az aktuális font-al a megadott koordinátákhoz kiírja.
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)
void grayscale()
A képet szürke árnyalatosra konvertálja.
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!
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!
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!