image : Manejo de imágenes.

Funciones
imagen	image.load (string filename)
	Carga una imagen.
imagen	image.loadsprite (string filename, int width, int height)
	Carga una imágen, y la divide en "cuadros" o "sprites".
imagen	image.loadfrommemory (string data, string filetype)
	Carga una imágen, desde datos en memoria.
imagen	image.create (int width, int height, color col)
	Crea una imagen nueva.
nil	image.clear (imagen img, color col)
	Limpia una imagen. (La rellena de un color).
nil	image.blit (imagen img, number x, number y)
	Muestra en pantalla una imágen (entera).
nil	image.blit (imagen img, number x, number y, number ximage, number yimage, number width, number height)
	Muestra en pantalla una imágen (parte de la imágen).
nil	image.blitsprite (imagen img, number x, number y, int frame, int alfa)
	Muestra en pantalla un sprite.
nil	image.setframe (imagen img, int frame)
	Elegir el frame en un sprite.
nil	image.blend (imagen img, number x, number y, int alfa)
	Igual que el blit básico, pero con transparencia.
nil	image.fxadd (imagen img, number x, number y, int alfa)
	Igual que el blit básico, pero con efecto suma de colores.
nil	image.fxsub (imagen img, number x, number y, int alfa)
	Igual que el blit básico, pero con efecto resta de colores.
nil	image.fxtint (imagen img, number x, number y, color col)
	Igual que el blit básico, pero con efecto de tintado de imágen.
nil	image.resize (imagen img, int width, int height)
	Reescala una imágen.
nil	image.rotate (imagen img, number angulo)
	Rota una imágen sobre su centro.
nil	image.rotate (imagen img, number x, number y, number angulo)
	Rota una imágen sobre un punto.
nil	image.factorscale (imagen img, number factor)
	Escala una imágen, proporcionalmente a un factor de reescalado.
nil	image.pixel (imagen img, number x, number y, color col)
	Cambia el color de un pixel en una imágen.
color	image.pixel (imagen img, number x, number y)
	Devuelve el color de un píxel en una imágen.
nil	image.save (imagen img, string path)
	Guarda un objeto de imágen en un archivo PNG.
number	image.width (imagen img)
	Ancho de una imágen.
number	image.height (imagen img)
	Alto de una imágen.
nil	image.center (imagen img, number x, number y)
	Especifica el centro de una imágen.
nil	image.reset (imagen img)
	Resetea las propiedades modificadas. (Escala, rotación...).
nil	image.free (imagen img)
	Libera un objeto de imágen.

---

Descripción detallada

Con este módulo se cargarán y manejarán las imágenes en LuaDEV.
Formatos soportados: JPG, PNG, GIF

Tareas pendientes:

De imágen a imágen. (Mejorar y documentar)

---

Documentación de las funciones

imagen image.load

(

string

filename

)

Carga una imagen.

Parámetros:

filename

Ruta del archivo a cargar.

Devuelve:

Un objeto del tipo imágen.

imagen image.loadsprite	(	string	filename,
		int	width,
		int	height
	)

Carga una imágen, y la divide en "cuadros" o "sprites".

Ideal para personajes, o iconos, puesto que en una misma imagen se introducen todas las posturas o efectos.

Ejemplo:

testimage = image.load("test.png",10,10);

Carga la imagen test.png, y la divide en cuadros de 10x10 pixeles. De derecha a izquierda y de arriba a abajo. Al dibujar esta imagen, se dibujará sólo uno de los cuadros, no la imagen completa. Para cambiar de cuadro, usar image.setframe();

Aviso:
El cuadro se trata como si fuera una imagen, por lo tanto cualquier reescalado, rotación o demás, afectará solo al cuadro. Independientemente de cual cojamos.

Parámetros:

	filename	Ruta de la imagen a cargar.
	width	Ancho del cuadro a cortar.
	height	Alto del cuadro a cortar.

Devuelve:

Un objeto del tipo imágen.

imagen image.loadfrommemory	(	string	data,
		string	filetype
	)

Carga una imágen, desde datos en memoria.

Parámetros:

	data	Datos de la imagen, formato JPG, PNG o GIF.
	filetype	Uno de los siguientes: "JPG" - Los datos són una imágen JPG. "PNG" - Los datos són una imágen PNG. "GIF" - Los datos són una imágen GIF. Este parámetro es opcional. Por defecto es "PNG".

Devuelve:

Un objeto del tipo imágen.

imagen image.create	(	int	width,
		int	height,
		color	col
	)

Crea una imagen nueva.

Parámetros:

	width	Ancho de la imágen en píxeles.
	height	Alto de la imágen en píxeles.
	col	Color inicial de la imágen. Opcional. Por defecto es negro.

Devuelve:

Un objeto del tipo imágen.

nil image.clear	(	imagen	img,
		color	col
	)

Limpia una imagen. (La rellena de un color).

Parámetros:

	img	Imagen a limpiar.
	col	Color a usar.

Devuelve:

Nada.

nil image.blit	(	imagen	img,
		number	x,
		number	y
	)

Muestra en pantalla una imágen (entera).

Parámetros:

	img	Objeto de imágen a mostrar.
	x	Coordenada X.
	y	Coordenada Y.

Devuelve:

Nada.

nil image.blit	(	imagen	img,
		number	x,
		number	y,
		number	ximage,
		number	yimage,
		number	width,
		number	height
	)

Muestra en pantalla una imágen (parte de la imágen).

Parámetros:

	img	Objeto de imágen a mostrar.
	x	Coordenada X en la pantalla.
	y	Coordenada Y en la pantalla.
	ximage	Coordenada X en la imagen.
	yimage	Coordenada Y en la imagen.
	width	Ancho a mostrar.
	height	Alto a mostrar.

Devuelve:

Nada.

nil image.blitsprite	(	imagen	img,
		number	x,
		number	y,
		int	frame,
		int	alfa
	)

Muestra en pantalla un sprite.

Parámetros:

	img	Objeto de imágen a mostrar.
	x	Coordenada X en la pantalla.
	y	Coordenada Y en la pantalla.
	frame	Número del frame a mostrar. ( De 0 a NUMFRAMES )
	alfa	Transparencia. Opcional. Por defecto 255.

Devuelve:

Nada.

nil image.setframe	(	imagen	img,
		int	frame
	)

Elegir el frame en un sprite.

Parámetros:

	img	Objeto de imágen.
	frame	Número de frame a elegir.

Devuelve:

Nada.

nil image.blend	(	imagen	img,
		number	x,
		number	y,
		int	alfa
	)

Igual que el blit básico, pero con transparencia.

Parámetros:

	img	Objeto de imágen.
	x	Coordenada X en la pantalla.
	y	Coordenada Y en la pantalla.
	alfa	Transparencia. Opcional. Por defecto 255.

Devuelve:

Nada.

nil image.fxadd	(	imagen	img,
		number	x,
		number	y,
		int	alfa
	)

Igual que el blit básico, pero con efecto suma de colores.

Parámetros:

	img	Objeto de imágen.
	x	Coordenada X en la pantalla.
	y	Coordenada Y en la pantalla.
	alfa	Transparencia. Opcional. Por defecto 255.

Devuelve:

Nada.

nil image.fxsub	(	imagen	img,
		number	x,
		number	y,
		int	alfa
	)

Igual que el blit básico, pero con efecto resta de colores.

Parámetros:

	img	Objeto de imágen.
	x	Coordenada X en la pantalla.
	y	Coordenada Y en la pantalla.
	alfa	Transparencia. Opcional. Por defecto 255.

Devuelve:

Nada.

nil image.fxtint	(	imagen	img,
		number	x,
		number	y,
		color	col
	)

Igual que el blit básico, pero con efecto de tintado de imágen.

Parámetros:

	img	Objeto de imágen.
	x	Coordenada X en la pantalla.
	y	Coordenada Y en la pantalla.
	col	Color a usar en el tintado.

Devuelve:

Nada.

nil image.resize	(	imagen	img,
		int	width,
		int	height
	)

Reescala una imágen.

Parámetros:

	img	Objeto de imágen.
	width	Nuevo ancho.
	height	Nuevo alto.

Devuelve:

Nada.

nil image.rotate	(	imagen	img,
		number	angulo
	)

Rota una imágen sobre su centro.

Parámetros:

	img	Objeto de imágen.
	angulo	Ángulo en grados.

Devuelve:

Nada.

nil image.rotate	(	imagen	img,
		number	x,
		number	y,
		number	angulo
	)

Rota una imágen sobre un punto.

Parámetros:

	img	Objeto de imágen.
	x	Posición del centro en X.
	y	Posición del centro en Y.
	angulo	Ángulo en grados.

Devuelve:

Nada.

nil image.factorscale	(	imagen	img,
		number	factor
	)

Escala una imágen, proporcionalmente a un factor de reescalado.

Ejemplos: factor 200 = 200% del tamaño. (el doble) factor 50 = 50% del tamaño. (la mitad)

Parámetros:

	img	Objeto de imágen.
	factor	Factor, en %.

Devuelve:

Nada.

nil image.pixel	(	imagen	img,
		number	x,
		number	y,
		color	col
	)

Cambia el color de un pixel en una imágen.

Parámetros:

	img	Objeto de imágen.
	x	Posición del píxel en X.
	y	Posición del píxel en Y.
	col	Nuevo color para el píxel.

Devuelve:

Nada.

color image.pixel	(	imagen	img,
		number	x,
		number	y
	)

Devuelve el color de un píxel en una imágen.

Parámetros:

	img	Objeto de imágen.
	x	Posición del píxel en X.
	y	Posición del píxel en Y.

Devuelve:

El color del píxel en esa posición.

nil image.save	(	imagen	img,
		string	path
	)

Guarda un objeto de imágen en un archivo PNG.

Parámetros:

	img	Objeto de imágen.
	path	Ruta del archivo destino.

Devuelve:

Nada.

number image.width

(

imagen

img

)

Ancho de una imágen.

Parámetros:

img

Objeto de imágen.

Devuelve:

Devuelve el ancho de la imágen en píxeles.

number image.height

(

imagen

img

)

Alto de una imágen.

Parámetros:

img

Objeto de imágen.

Devuelve:

Devuelve el alto de la imágen en píxeles.

nil image.center	(	imagen	img,
		number	x,
		number	y
	)

Especifica el centro de una imágen.

Si no se especifican ni x, ni y, se utilizará el centro de la imágen. Por defecto, una imagen viene centrada en 0,0.

Parámetros:

	img	Objeto de imágen.
	x	Posición del centro en X.
	y	Posición del centro en Y.

Devuelve:

Nada.

nil image.reset

(

imagen

img

)

Resetea las propiedades modificadas. (Escala, rotación...).

Parámetros:

img

Objeto de imágen.

Devuelve:

Nada.

nil image.free

(

imagen

img

)

Libera un objeto de imágen.

Parámetros:

img

Objeto de imágen a liberar.

Devuelve:

Nada.