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

PNGU Version : 0.1c

Programador : frontier

Más información : 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 imágen)

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

	5 - Si hay que cargar más imágenes volver al paso 2

	6 - PNGU_Release



NOTAS: 
------

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

- Es responsabilidad del usuario proporcionar búferes de memoria con el tamaño suficiente para albergar la imágen. Este tamaño depende de las dimensiones de la imágen y del formato de píxel en el que se pretenda descomprimirla. En los formatos YCbYCr, 4x4 RGB565 y 4x4 RGB5A3 el tamaño necesario en bytes es Ancho * Alto * 2. En los formatos RGBA8 y 4x4 RGBA8 el tamaño necesario en bytes es Ancho * Alto * 4. Tanto el ancho como el alto vienen expresados en píxeles.


- Por el momento PNGU sólo descodifica archivos PNG en formato RGB con 8 bits por canal. Es muy posible que otros formatos de imágen, 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 píxeles. Al descomprimir a RGBA8 se le asigna al canal alpha de todos los píxeles 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 imágen dentro de un búfer que contiene otra imágen de dimensiones iguales o mayores. Recibe las coordenadas X e Y donde se desea situar la imagen descomprimida, las dimensiones de la imágen a descomprimir, las dimensiones del buffer de destino y la dirección del mismo. Es responsabilidad del usuario asegurarse de que el búfer es lo bastante grande y que las coordenadas de destino no hagan que la imágen lo rebase. Por ejemplo, la llamada PNGU_DECODE_TO_COORDS_YCbYCr (0, 400, 300, 200, 640, 480, ptr) provocaría una excepción, ya que la imágen tiene 200 píxeles de alto y se pretende situarla a sólo 80 píxeles del límite inferior de la imágen de destino.



1 de mayo de 2008
