dxx-rebirth/include/iff.h

128 lines
4.7 KiB
C

/*
THE COMPUTER CODE CONTAINED HEREIN IS THE SOLE PROPERTY OF PARALLAX
SOFTWARE CORPORATION ("PARALLAX"). PARALLAX, IN DISTRIBUTING THE CODE TO
END-USERS, AND SUBJECT TO ALL OF THE TERMS AND CONDITIONS HEREIN, GRANTS A
ROYALTY-FREE, PERPETUAL LICENSE TO SUCH END-USERS FOR USE BY SUCH END-USERS
IN USING, DISPLAYING, AND CREATING DERIVATIVE WORKS THEREOF, SO LONG AS
SUCH USE, DISPLAY OR CREATION IS FOR NON-COMMERCIAL, ROYALTY OR REVENUE
FREE PURPOSES. IN NO EVENT SHALL THE END-USER USE THE COMPUTER CODE
CONTAINED HEREIN FOR REVENUE-BEARING PURPOSES. THE END-USER UNDERSTANDS
AND AGREES TO THE TERMS HEREIN AND ACCEPTS THE SAME BY USE OF THIS FILE.
COPYRIGHT 1993-1998 PARALLAX SOFTWARE CORPORATION. ALL RIGHTS RESERVED.
*/
/*
* $Source: /cvsroot/dxx-rebirth/d1x-rebirth/include/iff.h,v $
* $Revision: 1.1.1.1 $
* $Author: zicodxx $
* $Date: 2006/03/17 19:46:20 $
*
* Header for IFF routines
*
* $Log: iff.h,v $
* Revision 1.1.1.1 2006/03/17 19:46:20 zicodxx
* initial import
*
* Revision 1.1.1.1 1999/06/14 22:02:15 donut
* Import of d1x 1.37 source.
*
* Revision 1.12 1994/11/07 21:26:53 matt
* Added new function iff_read_into_bitmap()
*
* Revision 1.11 1994/05/06 19:37:38 matt
* Improved error handling and checking
*
* Revision 1.10 1994/04/16 20:12:54 matt
* Made masked (stenciled) bitmaps work
*
* Revision 1.9 1994/04/13 23:46:00 matt
* Added function, iff_errormsg(), which returns ptr to error message.
*
* Revision 1.8 1994/04/13 23:27:10 matt
* Put in support for anim brushes (.abm files)
*
* Revision 1.7 1994/04/06 23:08:02 matt
* Cleaned up code; added prototype (but no new code) for anim brush read
*
* Revision 1.6 1994/01/22 14:40:59 john
* Fixed bug with declareations.
*
* Revision 1.5 1994/01/22 14:23:13 john
* Added global vars to check transparency
*
* Revision 1.4 1993/10/27 12:47:42 john
* Extended the comments
*
* Revision 1.3 1993/09/22 19:17:20 matt
* Fixed handling of pad byte in ILBM/PPB body - was writing pad byte to
* destination buffer.
*
* Revision 1.2 1993/09/08 19:23:25 matt
* Added additional return code, IFF_BAD_BM_TYPE
*
* Revision 1.1 1993/09/08 14:24:21 matt
* Initial revision
*
*
*/
#ifndef _IFF_H
#define _IFF_H
#include "pstypes.h"
#include "gr.h"
//Prototypes for IFF library functions
int iff_read_bitmap(char *ifilename,grs_bitmap *bm,int bitmap_type,ubyte *palette);
//reads an IFF file into a grs_bitmap structure. fills in palette if not null
//returns error codes - see IFF.H. see GR.H for bitmap_type
//MEM DETAILS: This routines assumes that you already have the grs_bitmap
//structure allocated, but that you don't have the data for this bitmap
//allocated. In other words, do this:
// grs_bitmap * MyPicture;
// MALLOC( MyPicture, grs_bitmap, 1);
// iff_read_bitmap( filename, MyPicture, BM_LINEAR, NULL );
// ...do whatever with your bitmap ...
// gr_free_bitmap( MyPicture );
// exit(0)
//like iff_read_bitmap(), but reads into a bitmap that already exists,
//without allocating memory for the bitmap.
int iff_read_into_bitmap(char *ifilename,grs_bitmap *bm, sbyte *palette);
//read in animator brush (.abm) file
//fills in array of pointers, and n_bitmaps.
//returns iff error codes. max_bitmaps is size of array.
int iff_read_animbrush(char *ifilename,grs_bitmap **bm,int max_bitmaps,int *n_bitmaps,ubyte *palette);
// After a read
extern ubyte iff_transparent_color;
extern ubyte iff_has_transparency; // 0=no transparency, 1=iff_transparent_color is valid
int iff_write_bitmap(char *ofilename,grs_bitmap *bm,ubyte *palette);
//writes an IFF file from a grs_bitmap structure. writes palette if not null
//returns error codes - see IFF.H.
//function to return pointer to error message
const char *iff_errormsg(int error_number);
//Error codes for read & write routines
#define IFF_NO_ERROR 0 //everything is fine, have a nice day
#define IFF_NO_MEM 1 //not enough mem for loading or processing
#define IFF_UNKNOWN_FORM 2 //IFF file, but not a bitmap
#define IFF_NOT_IFF 3 //this isn't even an IFF file
#define IFF_NO_FILE 4 //cannot find or open file
#define IFF_BAD_BM_TYPE 5 //tried to save invalid type, like BM_RGB15
#define IFF_CORRUPT 6 //bad data in file
#define IFF_FORM_ANIM 7 //this is an anim, with non-anim load rtn
#define IFF_FORM_BITMAP 8 //this is not an anim, with anim load rtn
#define IFF_TOO_MANY_BMS 9 //anim read had more bitmaps than room for
#define IFF_UNKNOWN_MASK 10 //unknown masking type
#define IFF_READ_ERROR 11 //error reading from file
#define IFF_BM_MISMATCH 12 //bm being loaded doesn't match bm loaded into
#endif