Lua API: Függvények#

set_debug#

set_debug(boolean debug_on)

Paraméterek:

debug_on – Adjon át egy értéket, amely vagy true (hibakeresés be), vagy false (hibakeresés ki) értékre értékelődik ki

Visszatérési értékek:

nincs

Kapcsolja be vagy ki a hibakeresést. Amikor a hibakeresés be van kapcsolva, a kamera megpróbál szöveges és képi hibakeresési információt küldeni a soros porton keresztül. Kapcsolja ki a hibakeresést, amint egy program befejeződött, a teljesítmény javítása érdekében.

print#

Használat: print("a message") / print("one plus one is ", 1+1)

Paraméterek:

Adjon át annyi értéket, amennyit szeretne.

Visszatérési értékek:

nincs

Hibakereső függvény, értékek kiírására szolgál. A CMUcam3 az ennek a függvénynek átadott összes értéket elküldi a CamScripter Eclipse pluginnek, ahol azok a konzolterületen jelennek meg.

turn_on_led#

turn_on_led(integer led_number)

Paraméterek:

led_number A bekapcsolandó CMUcam3 LED száma. A 0, 1, 2 az egyetlen érvényes érték.

Visszatérési értékek:

nincs

Kapcsolja be a CMUcam3 egyik LED-jét.

turn_off_led#

turn_off_led(integer led_number)

Paraméterek:

led_number A bekapcsolandó CMUcam3 LED száma. A 0, 1, 2 az egyetlen érvényes érték.

Visszatérési értékek:

nincs

Kapcsolja ki a CMUcam3 egyik LED-jét.

take_picture#

take_picture()

Paraméterek:

nincs

Visszatérési értékek:

nincs

Készítsen egy képet a CMUcam3-mal, és töltse be a képpuffert (pixbuf).

save_picture#

save_picture(string filename)

Paraméterek:

filename A fájlnév, amellyel megpróbálja menteni a képet.

Visszatérési értékek:

nincs

Mentse el a képpufferben jelenleg lévő képet az átadott fájlnévvel. A fájlnévnek érvényes FAT16 fájlnévnek kell lennie <8.3>, különben hiba lesz visszaadva. Ha már létezik fájl a megadott fájlnévvel, az felül lesz írva. Vegye figyelembe, hogy ez a függvény önmagában nem készít képet - a save_picture meghívása előtt meg kell hívnia a take_picture-t.

file_exists#

file_exists(string filename)

Paraméterek:

filename

Visszatérési értékek:

logikai érték, amely jelzi, hogy a fájl létezik-e

Ellenőrizze, hogy van-e fájl az MMC/SD-kártyán az átadott fájlnévvel.

camera_set_resolution#

camera_set_resolution(integer resolution)

Paraméterek:

resolution A kamera új felbontása

Visszatérési értékek:

nincs

Állítsa be a CMUcam3 felbontását. A felbontásnak vagy nagynak, vagy alacsonynak kell lennie (lásd a Camera Resolution konstansokat a Lua API: Konstansok oldalon).

camera_set_colorspace#

camera_set_colorspace(integer space)

Paraméterek:

space A kamera új felbontása, vagy CC3_COLORSPACE_YCRCB VAGY CC3_COLORSPACE_RGB kell legyen

Visszatérési értékek:

nincs

Állítsa be a CMUcam3 színterét vagy YCRCB-re, vagy RGB-re (az RGB az alapértelmezett). Lásd még: Lua API: Konstansok.

wait#

wait(integer ms)

Paraméterek:

ms A várakozandó ezredmásodpercek száma

Visszatérési értékek:

nincs

Várjon ms ezredmásodpercet.

pixbuf_set_coi#

pixbuf_set_coi(integer coi)

Visszatérési értékek:

nincs

Állítsa be a kamera érdeklődésre számot tartó csatornáit. Meghatározza, hogy a kamera mely csatornákat rögzítse a képek készítésekor. A COI kisebb értékeinek beállítása felgyorsíthatja a képfeldolgozást. A COI érvényes értékei a Lua API: Konstansok oldal Channel of Interest konstansai között találhatók.

pixbuf_read_rows#

pixbuf_read_rows(image img, integer num_rows)

Paraméterek:

img Egy képobjektum, amelybe a pixbuf sorai beolvasásra kerülnek, num_rows A beolvasandó sorok száma

Visszatérési értékek:

A sikeresen beolvasott sorok száma

Másoljon num_rows sort a kamera képpufferéből (pixbuf) az átadott image objektumba.

pixbuf_get_width#

pixbuf_get_width()

Paraméterek:

nincs

Visszatérési értékek:

A pixbuf szélessége pixelekben

Kérje le a képpuffer (pixbuf) szélességét. A képpuffernek betöltöttnek kell lennie a hívás előtt, akár a take_picture, akár a show_picture meghívásával.

pixbuf_get_height#

pixbuf_get_height()

Paraméterek:

nincs

Visszatérési értékek:

A pixbuf magassága pixelekben

Kérje le a képpuffer (pixbuf) magasságát. A képpuffernek betöltöttnek kell lennie a hívás előtt, akár a take_picture, akár a show_picture meghívásával.

pixel_new#

pixel_new()

Paraméterek:

nincs

Visszatérési értékek:

Egy új pixel adatszerkezet

Létrehoz és visszaad egy új pixel-adatszerkezetet. A szerkezetről szóló részletekért lásd a pixel dokumentációt. Lásd még a pixbuf_get_pixel és a get_pixel függvényt a pixel szerkezet használatához.

get_pixel#

get_pixel(pixel pxl, integer x, integer y)

Paraméterek:

pxl A pixel adatszerkezet, amelybe a pixelértékeket tárolni kell. x, y A lekérendő pixel x és y koordinátái a képpufferen belül.

Visszatérési értékek:

nincs, a pixelértékek az átadott pixel-ben tárolódnak

Kérjen le egyetlen pixel objektumot a CMUcam3 képpufferéből (pixbuf). Az x-nek és az y-nak kisebbnek kell lennie a pixbuf_get_width, illetve a pixbuf_get_height értéknél. Ha a take_picture nem került meghívásra egy kép pixbufban való tárolásához, ez a függvény nem fog hibázni, de a pixel objektumba beszúrt értékek szemét lesznek.

image_new#

image_new(integer width, integer height)

Paraméterek:

width A kép szélessége, height A kép magassága

Visszatérési értékek:

Egy új image adatszerkezet.

Kérjen le egy új image adatszerkezetet az átadott szélességgel, magassággal és pixsize-zal. Az image adatszerkezetek használatáról szóló további információért lásd az image dokumentációt.

Kérjen le egy pixel objektumot az átadott image adatszerkezetből. A pixel RGB-értékei az átadott pixel adatszerkezetbe kerülnek tárolásra. Az x paraméternek kisebbnek kell lennie az image szélességénél, az y-nak pedig kisebbnek kell lennie az image magasságánál.

framediff_new#

framediff_new(integer template_width, integer template_height)

Paraméterek:

template_width A sablon szélessége, amelyen a különbség-számítást végezzük, template_height A sablon magassága

Visszatérési értékek:

Egy új framediff adatszerkezet

Kérjen le egy új framediff adatszerkezetet az átadott sablonszélességgel és -magassággal. A framediff szerkezeteket általában a CMUcam3-mal készített két képkocka közötti különbség kiértékelésére használják, de további információért lásd a framediff dokumentációt.

framediff_scanline_start#

framediff_scanline_start(framediff fd)

Paraméterek:

fd A használandó framediff objektum

Visszatérési értékek:

1-et ad vissza sikeresség esetén.

Inicializál mindent, ami a framediff_scanline használatával történő képkockakülönbség-számításhoz szükséges. Gondoskodik arról, hogy legyen egy current_template beállítva a framediff szerkezetben (vagy betölti az aktuális sablont, ha a framediff:get_load_frame() igaz).

framediff_scanline#

framediff_scanline(image img, framediff fd)

Paraméterek:

img Egy image adatszerkezet, fd Egy framediff adatszerkezet

Visszatérési értékek:

1-et ad vissza sikeresség esetén

Lekéri az összes pixelt az img-ből, és betölti őket a megfelelő helyre a framediff szerkezetben, hogy a két sablon (current_template és previous_template) összehasonlítható legyen. Ha az fd:get_load_frame igaz, akkor az img pixeleit a previous template helyre tölti be. Ha az fd:get_load_frame hamis, akkor az img pixeleit a current_template-be tölti be.

framediff_scanline_finish#

framediff_scanline_finish(framediff fd)

Paraméterek:

fd A használandó framediff adatszerkezet

Visszatérési értékek:

1-et ad vissza, ha a művelet sikeres volt.

Összehasonlítja a két sablont (current_template és previous_template) a framediff adatszerkezetben, és kiszámítja a különböző pixelek számát, ezt az értéket a framediff:get_num_pixels helyen tárolva.

clear_graphics#

clear_graphics()

Paraméterek:

nincs

Visszatérési értékek:

nincs

Törölje a CamScripter grafikus képernyőjét.

tracker_track_color#

tracker_track_color(tracker theTracker)

Paraméterek:

a tracker objektum, amelyet a színkövetéshez használnak, a beállítandó kívánt RGB-értékkel beállítva.

Visszatérési értékek:

logikai érték, amely jelzi, hogy a követés meg tudott-e történni. Igazat ad vissza akkor is, ha a színt nem találta meg – csak akkor ad vissza hamisat, ha hiba történt.

Kövessen egy színt a CMUcam3-ban az átadott tracker objektum használatával. A take_picture()-t meg kell hívni, mielőtt megpróbálna színt követni. Elemzi a képpuffert, és értékeket állít be a tracker objektumban, hogy egy befoglaló keretet adjon a színhez, és egy (x, y) értéket, amely a szín súlypontját képviseli. További részletekért lásd a tracker dokumentációt.