-/*******************************************************************************
+/*****************************************************************************
* rsc_files.h: resources files manipulation functions
- * (c)1999 VideoLAN
- *******************************************************************************
- * This library describe a general format used to store 'resources'. Resources
+ * This library describes a general format used to store 'resources'. Resources
* can be anything, including pictures, audio streams, and so on.
- *******************************************************************************
+ *****************************************************************************
+ * Copyright (C) 1999, 2000 VideoLAN
+ *
+ * Authors: Vincent Seguin <seguin@via.ecp.fr>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
+ *****************************************************************************/
+
+/*****************************************************************************
* Requires:
* config.h
- * common.h
- *******************************************************************************/
+ * common.h
+ *****************************************************************************/
-/*******************************************************************************
+/*****************************************************************************
* Constants
- *******************************************************************************/
+ *****************************************************************************/
-/* Maximum length of a resource name (not including the final '\0') - this
+/* Maximum length of a resource name (not including the final '\0') - this
* constant should not be changed without extreme care */
#define RESOURCE_MAX_NAME 32
-/*******************************************************************************
+/*****************************************************************************
* resource_descriptor_t: resource descriptor
- *******************************************************************************
+ *****************************************************************************
* This type describe an entry in the resource table.
- *******************************************************************************/
+ *****************************************************************************/
typedef struct
{
- char psz_name[RESOURCE_MAX_NAME + 1]; /* name */
- u16 i_type; /* type */
- u64 i_offset; /* data offset */
- u64 i_size; /* data size */
+ char psz_name[RESOURCE_MAX_NAME + 1]; /* name */
+ u16 i_type; /* type */
+ u64 i_offset; /* data offset */
+ u64 i_size; /* data size */
} resource_descriptor_t;
/* Resources types */
-#define EMPTY_RESOURCE 0 /* empty place in table */
-#define PICTURE_RESOURCE 10 /* native video picture */
+#define EMPTY_RESOURCE 0 /* empty place in table */
+#define PICTURE_RESOURCE 10 /* native video picture */
-/*******************************************************************************
+/*****************************************************************************
* resource_file_t: resource file descriptor
- *******************************************************************************
+ *****************************************************************************
* This type describes a resource file and store it's resources table. It can
* be used through the *Resource functions, or directly with the i_file field.
- *******************************************************************************/
+ *****************************************************************************/
typedef struct
{
/* File informations */
- int i_file; /* file descriptor */
- int i_type; /* file type */
- boolean_t b_up_to_date; /* is file up to date ? */
- boolean_t b_read_only; /* read-only mode */
+ int i_file; /* file descriptor */
+ int i_type; /* file type */
+ boolean_t b_up_to_date; /* is file up to date ? */
+ boolean_t b_read_only; /* read-only mode */
/* Resources table */
- int i_size; /* table size */
- resource_descriptor_t * p_resource; /* resources table */
+ int i_size; /* table size */
+ resource_descriptor_t * p_resource; /* resources table */
} resource_file_t;
/* Resources files types */
-#define VLC_RESOURCE_FILE 0 /* VideoLAN Client resource file */
+#define VLC_RESOURCE_FILE 0 /* VideoLAN Client resource file */
-/*******************************************************************************
+/*****************************************************************************
* Prototypes
- *******************************************************************************/
+ *****************************************************************************/
resource_file_t * CreateResourceFile ( char *psz_filename, int i_type, int i_size, int i_mode );
resource_file_t * OpenResourceFile ( char *psz_filename, int i_type, int i_flags );
int UpdateResourceFile ( resource_file_t *p_file );
int SeekResource ( resource_file_t *p_file, char *psz_name, int i_type );
int ReadResource ( resource_file_t *p_file, char *psz_name, int i_type,
size_t max_size, byte_t *p_data );
-int WriteResource ( resource_file_t *p_file, char *psz_name, int i_type,
+int WriteResource ( resource_file_t *p_file, char *psz_name, int i_type,
size_t size, byte_t *p_data );