En ocasiones es muy útil poder colocar los variados elementos que utilizan nuestros juegos dentro de un solo archivo, y mejor aún, comprimido. Muchísimos juegos hacen uso de esta opción, como por ejemplo el Quake, Half-Life, Unreal, etc.

En este tutorial explicaremos como utilizar la librería UnRarLib para estos fines, creando una interfaz que será similar a la clase ifstream y manejará recursos comprimidos y no comprimidos de modo transparente al usuario.

Compresores y empaquetadores

Es bueno diferenciar estas dos tareas que puede o no implementar la misma aplicación. Los usuarios de Windows están acostumbrados a comprimir y empaquetar mediante herramientas tipo WinZIP, WinRAR, WinACE o similares por lo tanto la operación comprimir + empaquetar la entienden como sólo una; los usuarios Solaris, Digital Unix o Linux probablemente tengan más en claro que son dos tareas bien diferenciadas, usualmente en esta plataforma se utiliza una aplicación llamada gzip para comprimir y otra llamada tar para empaquetar.

La librería que utilizaremos en esta nota nos permite realizar ambas operaciones con la facilidad extra de poder crear los empaquetados y modificar con la aplicación WinRAR 2.x (la versión 3 utiliza un algoritmo de compresión distinto NO compatible hasta el momento con la librería UnRarLib, la versión 2.9 del WinRAR puede ser descargada libremente).

El sitio oficial de la librería es http://www.unrarlib.org/ y debemos mencionar que no es realmente una librería, su distribución se basa en un archivo fuente unrarlib.c y su cabecera unrarlib.h que adjuntaremos a nuestro programa, claro que muy fácilmente podríamos crear una librería de enlace dinámico con estos archivos pero no es nuestra intención.

Las funciones de la librería UnRarLib

unrarlib_get
La primera de ellas es la función unrarlib_get, esta función descomprime un elemento determinado dentro de un archivo del tipo rar a memoria.

int urarlib_get(void *output, unsigned long *size, char *filename, void *rarfile, char *libpassword);

output : Buffer de memoria donde se colocará el elemento descomprimido.
size : Tamaño total en bytes del elemento descomprimido.
filename : Nombre del archivo tipo rar que posee el elemento a descomprimir.
libpassword : Contraseña del archivo tipo rar (si es que se encuentra protegido mediante contraseña).

Retorna cero si se produjo algún error o un número distinto a cero si se logró descomprimir el elemento de modo satisfactorio.

unrarlib_list

La función unrarlib_list coloca el contenido de un archivo del tipo rar en una estructura definida por la librería, de este modo es posible conocer cual será el tamaño de un elemento descomprimido en memoria y de este modo poder solicitar la cantidad de memoria que corresponda.

int urarlib_list(void *rarfile, ArchiveList_struct *list);

rarfile : Nombre del archivo tipo rar que deseamos inspeccionar.
list : Estructura en la cual la librería colocará la información del contenido del archivo. La librería unrarlib es la encargada de asignar memoria para el puntero.

Retorna la cantidad de elementos que posee el archivo rar.

unrarlib_freelist

Una vez que hemos utilizado el contenido del puntero del tipo ArchiveList_struct deberemos eliminar su contenido (la memoria originalmente fue solicitada por la función unrarlib_list), para esto deberemos invocar la tercer función de la librería unrarlib llamada unrarlib_freelist que posee el siguiente prototipo:

void urarlib_freelist(ArchiveList_struct *list);

list : Puntero pasado originalmente a la función unrarlib_list que deseamos liberar.

La estructura ArchiveList_struct

La estructura ArchiveList_struct es el nodo de una lista enlazada que arma la función unrarlib_list, posee básicamente un elemento del tipo RAR20_archive_entry y luego un puntero a otra estructura del tipo ArchiveList_struct.


| typedef struct archivelist
| {
| struct RAR20_archive_entry item;
| struct archivelist *next;
| } ArchiveList_struct;


La estructura RAR20_archive_entry


| struct RAR20_archive_entry
| {
| char *Name;
| UWORD NameSize;
| UDWORD PackSize;
| UDWORD UnpSize;
| UBYTE HostOS;
| UDWORD FileCRC;
| UDWORD FileTime;
| UBYTE UnpVer;
| UBYTE Method;
| UDWORD FileAttr;
| };


Name : Nombre del elemento.
NameSize : Cantidad de caracteres que posee el nombre del elemento.
PackSize : Tamaño en bytes del elemento comprimido.
UnpSize : Tamaño en bytes del elemento descomprimido.
HostOS : Indica 0 si el archivo fue comprimido en plataforma MS-DOS, 1: OS/2, 2: Win32 y 3: Unix.
FileCRC : Chequeo de redundancia cíclica del archivo.
FileTime : Fecha del archivo.
FileAttr : Atributos del archivo.

Pages: 1 2 3