IMAGE LIBRARY A Programming Language Manual

img_info ( lib: Images, file: ../src/gs/gslib_img.cpp ) int, int, int img_info( img ) IN ptr img image OUT int width int height int bpp Returns information of img image.  C/C++ source code void gsImgInfo(gsVM* vm) { guard(gsImgInfo); if(!gs_ckptr(vm,0)) return; tImg* img = (tImg*)gs_toptr(vm,0); if(!img) return; gs_pushint(vm, img->m_width); gs_pushint(vm, img->m_height); gs_pushint(vm, img->m_bpp); } img_setshader ( lib: Images, file: ../src/gs/gslib_img.cpp ) img_setshader( shader ) IN int shader new shader to set Set current drawing shader.  C/C++ source code void gsImgSetShader(gsVM* vm) { guard(gsImgSetShader); if(!gs_ckint(vm,0)) return; ImgSetShader((ImgShader)gs_toint(vm,0)); unguard(); } img_getshader ( lib: Images, file: ../src/gs/gslib_img.cpp ) int img_getshader( ) OUT int current shader  C/C++ source code void gsImgGetShader(gsVM* vm) { guard(gsImgGetShader); gs_pushint(vm, ImgGetShader()); unguard(); } img_create ( lib: Images, file: ../src/gs/gslib_img.cpp ) ptr img_create( width, height, bpp ) IN int width int height int bpp OUT ptr image Creates a new image.  C/C++ source code void gsImgCreate(gsVM* vm) { guard(gsImgCreate); if( !gs_ckint(vm,0) || !gs_ckint(vm,1) ) return; int w = gs_toint(vm,0); int h = gs_toint(vm,1); int bpp = 32; if( gs_params(vm)>2 && gs_ckint(vm,2) ) bpp = gs_toint(vm,2); tImg* img = gs_new tImg(); img->m_width = w; img->m_height = h; img->m_bpp = bpp; ImgCreate(*img); if(!ImgValid(*img)) { gs_delete(img); img = NULL; } gs_pushptr(vm, img); unguard(); } img_destroy ( lib: Images, file: ../src/gs/gslib_img.cpp ) img_destroy( image ) IN ptr image Destroys an image.  C/C++ source code void gsImgDestroy(gsVM* vm) { guard(gsImgDestroy); if(!gs_ckptr(vm,0)) return; tImg* img = (tImg*)gs_toptr(vm,0); if(!img) return; ImgDestroy(*img); unguard(); } img_flip ( lib: Images, file: ../src/gs/gslib_img.cpp ) img_flip( image ) IN ptr image Flip an image.  C/C++ source code void gsImgFlip(gsVM* vm) { guard(gsImgFlip); if(!gs_ckptr(vm,0)) return; tImg* img = (tImg*)gs_toptr(vm,0); if(!img) return; ImgFlip(*img); unguard(); } img_save ( lib: Images, file: ../src/gs/gslib_img.cpp ) int img_save( image, filepath ) IN ptr image str filepath file path to save to OUT int 1=success, 0=fail Saves an image to a file in TGA format.  C/C++ source code void gsImgSave(gsVM* vm) { guard(gsImgSave); if(!gs_ckptr(vm,0) || !gs_ckstr(vm,1)) return; tImg* img = (tImg*)gs_toptr(vm,0); if(!img) return; int ok = ImgSave(*img, gs_tostr(vm,1)) ? 1 : 0; gs_pushint(vm, ok); unguard(); } img_load ( lib: Images, file: ../src/gs/gslib_img.cpp ) ptr img_load( filepath ) IN str filepath file path to save to OUT ptr image Loads an image from a TGA file. Returns null if not found.  C/C++ source code void gsImgLoad(gsVM* vm) { guard(gsImgLoad); if(!gs_ckstr(vm,0)) return; tImg* img = gs_new tImg(); if(!ImgLoad(*img, gs_tostr(vm,0))) { gs_delete(img); img = NULL; } gs_pushptr(vm, img); unguard(); } img_fill ( lib: Images, file: ../src/gs/gslib_img.cpp ) img_fill( image, color ) IN ptr image tab color Fill an image with a color.  C/C++ source code void gsImgFill(gsVM* vm) { guard(gsImgFill); if(!gs_ckptr(vm,0) || !gs_ckcolor(vm, 1)) return; tImg* img = (tImg*)gs_toptr(vm,0); if(!img) return; dword color = gs_tocolor(vm, 1); ImgFill(*img, color); unguard(); } img_getpixel ( lib: Images, file: ../src/gs/gslib_img.cpp ) tab img_getpixel( image, x, y ) IN ptr image int x int y OUT tab color Read the pixel color from given coordinates.  C/C++ source code void gsImgGetPixel(gsVM* vm) { guard(gsImgGetPixel); if(!gs_ckptr(vm,0) || !gs_ckint(vm, 1) || !gs_ckint(vm, 2)) return; tImg* img = (tImg*)gs_toptr(vm,0); if(!img) return; dword color = ImgGetPixel(*img, gs_toint(vm, 1), gs_toint(vm, 2)); gs_pushcolor(vm, color); unguard(); } img_setpixel ( lib: Images, file: ../src/gs/gslib_img.cpp ) img_setpixel( image, x, y, color ) IN ptr image int x int y tab color Write the pixel color at given coordinates.  C/C++ source code void gsImgSetPixel(gsVM* vm) { guard(gsImgSetPixel); if(!gs_ckptr(vm,0) || !gs_ckint(vm, 1) || !gs_ckint(vm, 2) || !gs_ckcolor(vm, 3)) return; tImg* img = (tImg*)gs_toptr(vm,0); if(!img) return; ImgSetPixel(*img, gs_toint(vm, 1), gs_toint(vm, 2), gs_tocolor(vm, 3)); unguard(); } img_drawbar ( lib: Images, file: ../src/gs/gslib_img.cpp ) img_drawbar( img, x, y, w, h, color ) IN ptr img int x int y int w width int h height tab color Draw a filled rectangle with given color. Using current shader.  C/C++ source code void gsImgDrawBar(gsVM* vm) { guard(gsImgDrawBar); if(!gs_ckptr(vm,0) || !gs_ckint(vm, 1) || !gs_ckint(vm, 2) || !gs_ckint(vm, 3) || !gs_ckint(vm, 4) || !gs_ckcolor(vm, 5)) return; tImg* img = (tImg*)gs_toptr(vm,0); if(!img) return; ImgDrawBar(*img, gs_toint(vm, 1), gs_toint(vm, 2), gs_toint(vm, 3), gs_toint(vm, 4), gs_tocolor(vm, 5)); unguard(); } img_blit ( lib: Images, file: ../src/gs/gslib_img.cpp ) img_blit( imgsrc, x, y, w, h, imgdst, dx, dy, color ) IN ptr imgsrc image source to copy from int x source x int y source y int w source width int h source height ptr imgdst image destination to copy into int dx destination x int dy destination y tab color multiply color (optional) Copy a part of an image into another image. Using current shader. Multiply source colors with given color.  C/C++ source code void gsImgBlit(gsVM* vm) { guard(gsImgBlit); if(!gs_ckptr(vm,0) || !gs_ckint(vm, 1) || !gs_ckint(vm, 2) || !gs_ckint(vm, 3) || !gs_ckint(vm, 4) || !gs_ckptr(vm, 5) || !gs_ckint(vm, 6) || !gs_ckint(vm, 7)) return; tImg* img = (tImg*)gs_toptr(vm,0); if(!img) return; tImg* imgdst = (tImg*)gs_toptr(vm,5); if(!imgdst) return; dword color = 0xffffffff; if( gs_params(vm) > 8 && gs_ckcolor(vm,8) ) color = gs_tocolor(vm,8); ImgBlit(*img, gs_toint(vm, 1), gs_toint(vm, 2), gs_toint(vm, 3), gs_toint(vm, 4), *imgdst, gs_toint(vm, 6), gs_toint(vm, 7), color); unguard(); } fnt_open ( lib: Images, file: ../src/gs/gslib_img.cpp ) int fnt_open( filepath, size, flags ) IN str filepath font file path int size font size int flags font flags OUT int 1=success, 0=fail Opens a font file for current use. See Font Flags Ex: fnt_open("font.ttf", 10, FNT_FLAG_BOLD | FNT_FLAG_ANTI_ALIASING);  C/C++ source code void gsFntOpen(gsVM* vm) { guard(gsFntOpen); if(!gs_ckstr(vm,0) || !gs_ckint(vm,1)) return; int flags = FONT_FLAG_ANTI_ALIASING; if( gs_params(vm) > 2 && gs_ckint(vm,2) ) flags = gs_toint(vm,2); int ok = FontOpen(gs_tostr(vm,0), gs_toint(vm,1), flags) ? 1 : 0; gs_pushint(vm, ok); unguard(); } fnt_close ( lib: Images, file: ../src/gs/gslib_img.cpp ) fnt_close( ) Closes the current opened font file.  C/C++ source code void gsFntClose(gsVM* vm) { guard(gsFntClose); FontClose(); unguard(); } fnt_info ( lib: Images, file: ../src/gs/gslib_img.cpp ) int, int fnt_info( ) OUT int height int baseline Get current font info.  C/C++ source code void gsFntInfo(gsVM* vm) { guard(gsFntInfo); gs_pushint(vm, FontGetHeight()); gs_pushint(vm, FontGetBaseline()); unguard(); } fnt_setspacing ( lib: Images, file: ../src/gs/gslib_img.cpp ) fnt_setspacing( spaceX, spaceY ) IN int spaceX int spaceY Set current font spacing.  C/C++ source code void gsFntSetSpacing(gsVM* vm) { guard(gsFntSetSpacing); if(!gs_ckint(vm,0) || !gs_ckint(vm,1)) return; FontSetSpacing(gs_toint(vm,0), gs_toint(vm,1)); unguard(); } fnt_getspacing ( lib: Images, file: ../src/gs/gslib_img.cpp ) int, int fnt_getspacing( ) OUT int spaceX int spaceY Get current font spacing.  C/C++ source code void gsFntGetSpacing(gsVM* vm) { guard(gsFntGetSpacing); int sx, sy; FontGetSpacing(sx, sy); gs_pushint(vm, sx); gs_pushint(vm, sy); unguard(); } fnt_usekerning ( lib: Images, file: ../src/gs/gslib_img.cpp ) fnt_usekerning( useKerning ) IN int useKerning If current should use kerning.  C/C++ source code void gsFntUseKerning(gsVM* vm) { guard(gsFntUseKerning); if(!gs_ckint(vm,0)) return; FontUseKerning(gs_toint(vm,0) != 0); unguard(); } fnt_gettextmetrics ( lib: Images, file: ../src/gs/gslib_img.cpp ) int, int fnt_gettextmetrics( w, h, text, wrap ) IN int w width int h height str text int wrap (optional) OUT int width int height Get width and height needed to fit a given text.  C/C++ source code void gsFntGetTextMetrics(gsVM*vm) { guard(gsFntGetTextMetrics); if(!gs_ckint(vm,0) || !gs_ckint(vm,1) || !gs_ckstr(vm,2)) return; bool wrap = false; if( gs_params(vm) > 3 && gs_ckint(vm,3) ) wrap = gs_toint(vm,3) != 0; int w = gs_toint(vm, 0); int h = gs_toint(vm, 1); FontGetTextMetrics(w, h, gs_tostr(vm,2), gs_size(vm,2), wrap); gs_pushint(vm, w); gs_pushint(vm, h); unguard(); } fnt_rendertext ( lib: Images, file: ../src/gs/gslib_img.cpp ) fnt_rendertext( img, x, y, w, h, text, color, wrap, align ) IN ptr img destination image int x int y int w width int h height str text tab color int wrap 0=no (default), 1=yes (optional) int align -1=left (default), 0=center, 1=right (optional) Draw given text with color into the img image, inside the given area.  C/C++ source code void gsFntRenderText(gsVM*vm) { guard(gsFntRenderText); if(!gs_ckptr(vm,0) || !gs_ckint(vm,1) || !gs_ckint(vm,2) || !gs_ckint(vm,3) || !gs_ckint(vm,4) || !gs_ckstr(vm,5) || !gs_ckcolor(vm,6)) return; tImg* img = (tImg*)gs_toptr(vm,0); if(!img) return; bool wrap = false; if( gs_params(vm) > 7 && gs_ckint(vm,7) ) wrap = gs_toint(vm,7) != 0; int align = -1; if (gs_params(vm) > 8 && gs_ckint(vm, 8)) align = gs_toint(vm, 8); int x = gs_toint(vm, 1); int y = gs_toint(vm, 2); int w = gs_toint(vm, 3); int h = gs_toint(vm, 4); FontRenderText(*img, x, y, w, h, gs_tostr(vm,5), gs_size(vm,5), gs_tocolor(vm,6), wrap, align); unguard(); } COLOR ( lib: Images, file: ../src/gs/gslib_img.cpp ) tab COLOR( hex ) IN str hex hexadecimal color OUT tab color Convert form hexadecimal to a color table. A table color can be indexed with special indexes .r .g .b .a Ex: color.a is the same as color[3]  C/C++ source code void gsColor(gsVM* vm) { guard(gsColor); if(!gs_ckstr(vm,0)) return; dword color = 0; cchar* str = gs_tostr(vm,0); sscanf(gs_tostr(vm,0), "%x", &color); gs_pushcolor(vm, color); unguard(); } color_hex ( lib: Images, file: ../src/gs/gslib_img.cpp ) str color_hex( color ) IN tab color OUT str hexadecimal color Convert form color table to hexadecimal.  C/C++ source code void gsColorHex(gsVM* vm) { guard(gsColorHex); if(!gs_ckcolor(vm,0)) return; dword color = gs_tocolor(vm, 0); char sz[10]; snprintf(sz, 9, "%08x", color); gs_pushstr(vm, sz); unguard(); } IMG_SHADER_COPY ( lib: Images, file: ../src/gs/gslib_img.cpp ) IMG_SHADER_COPY Shader for direct RGBA copy. IMG_SHADER_COPY_RGB ( lib: Images, file: ../src/gs/gslib_img.cpp ) IMG_SHADER_COPY_RGB Shader for direct RGB copy only. IMG_SHADER_COPY_A ( lib: Images, file: ../src/gs/gslib_img.cpp ) IMG_SHADER_COPY_A Shader for direct A (alpha) copy only. IMG_SHADER_ALPHA_BLEND ( lib: Images, file: ../src/gs/gslib_img.cpp ) IMG_SHADER_ALPHA_BLEND Shader for blending source with destination based on destination alpha (RGB): DST = SRC * SRC.A + DST * (1 - SRC.A) IMG_SHADER_ALPHA_ADD ( lib: Images, file: ../src/gs/gslib_img.cpp ) IMG_SHADER_ALPHA_ADD Additive shader (RGB): DST = DST + SRC. IMG_SHADER_ALPHA_SUB ( lib: Images, file: ../src/gs/gslib_img.cpp ) IMG_SHADER_ALPHA_SUB Subtractive shader (RGB): DST = DST - SRC. IMG_SHADER_ALPHA_MUL ( lib: Images, file: ../src/gs/gslib_img.cpp ) IMG_SHADER_ALPHA_MUL Multiplicative shader (RGB): DST = DST * SRC; IMG_SHADER_ALPHA_MUL2X ( lib: Images, file: ../src/gs/gslib_img.cpp ) IMG_SHADER_ALPHA_MUL2X Multiplicative shader 2X (RGB): DST = DST * SRC * 2; FNT_FLAG_BOLD ( lib: Images, file: ../src/gs/gslib_img.cpp ) FNT_FLAG_BOLD Bold flag for font open. FNT_FLAG_ITALIC ( lib: Images, file: ../src/gs/gslib_img.cpp ) FNT_FLAG_ITALIC Italic flag for font open. FNT_FLAG_ANTI_ALIASING ( lib: Images, file: ../src/gs/gslib_img.cpp ) FNT_FLAG_ANTI_ALIASING Antialiasing flags for font open.