********************************************************************************************

PNGU Version : 0.1c

Programador : frontier

Ms informacin : http://frontier-dev.net

********************************************************************************************


Uso de PNGU:
------------

Cargar una imagen con PNGU requiere llamar a las siguientes funciones:

	1 - PNGU_Init

	2 - PNGU_SelectFileFromBuffer / PNGU_SelectFileFromWiiSD

	3 - PNGU_GetImageProperties (puede omitirse si se conocen de antemano las dimensiones de la imgen)

	4 - PNGU_DecodeToYCbYCr / PNGU_DecodeToRGBA8 / PNGU_DecodeTo4x4RGB565 / PNGU_DecodeTo4x4RGB5A3 / PNGU_DecodeTo4x4RGBA8 / PNGU_DECODE_TO_COORDS_YCbYCr

	5 - Si hay que cargar ms imgenes volver al paso 2

	6 - PNGU_Release



NOTAS: 
------

- Para desactivar todo acceso al lector SD frontal hay que comentar o eliminar la instruccin "PNGU_USE_WII_SD" en el archivo "pngu.h".

- Es responsabilidad del usuario proporcionar bferes de memoria con el tamao suficiente para albergar la imgen. Este tamao depende de las dimensiones de la imgen y del formato de pxel en el que se pretenda descomprimirla. En los formatos YCbYCr, 4x4 RGB565 y 4x4 RGB5A3 el tamao necesario en bytes es Ancho * Alto * 2. En los formatos RGBA8 y 4x4 RGBA8 el tamao necesario en bytes es Ancho * Alto * 4. Tanto el ancho como el alto vienen expresados en pxeles.


- Por el momento PNGU slo descodifica archivos PNG en formato RGB con 8 bits por canal. Es muy posible que otros formatos de imgen, en especial RGBA8, carguen correctamente, pero no se ha probado. Al descomprimir a RGB5A3 se le asigna al bit de transparencia el valor 1 en todos los pxeles. Al descomprimir a RGBA8 se le asigna al canal alpha de todos los pxeles el valor 'defaul_alpha' proporcionado por el usuario.

- La macro PNGU_DECODE_TO_COORDS_YCbYCr invoca a PNGU_DecodeToYCbYCr y se usa para descomprimir, en unas coordenadas determinadas, una imgen dentro de un bfer que contiene otra imgen de dimensiones iguales o mayores. Recibe las coordenadas X e Y donde se desea situar la imagen descomprimida, las dimensiones de la imgen a descomprimir, las dimensiones del buffer de destino y la direccin del mismo. Es responsabilidad del usuario asegurarse de que el bfer es lo bastante grande y que las coordenadas de destino no hagan que la imgen lo rebase. Por ejemplo, la llamada PNGU_DECODE_TO_COORDS_YCbYCr (0, 400, 300, 200, 640, 480, ptr) provocara una excepcin, ya que la imgen tiene 200 pxeles de alto y se pretende situarla a slo 80 pxeles del lmite inferior de la imgen de destino.



1 de mayo de 2008
