spritegn.h

   1 /*
   2 Copyright (C) 1996-1997 Id Software, Inc.
   3
   4 This program is free software; you can redistribute it and/or
   5 modify it under the terms of the GNU General Public License
   6 as published by the Free Software Foundation; either version 2
   7 of the License, or (at your option) any later version.
   8
   9 This program is distributed in the hope that it will be useful,
  10 but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  12
  13 See the GNU General Public License for more details.
  14
  15 You should have received a copy of the GNU General Public License
  16 along with this program; if not, write to the Free Software
  17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  18
  19 */
  20 //
  21 // spritegn.h: header file for sprite generation program
  22 //
  23
  24 // **********************************************************
  25 // * This file must be identical in the spritegen directory *
  26 // * and in the Quake directory, because it's used to       *
  27 // * pass data from one to the other via .spr files.        *
  28 // **********************************************************
  29
  30 //-------------------------------------------------------
  31 // This program generates .spr sprite package files.
  32 // The format of the files is as follows:
  33 //
  34 // dsprite_t file header structure
  35 // <repeat dsprite_t.numframes times>
  36 //   <if spritegroup, repeat dspritegroup_t.numframes times>
  37 //     dspriteframe_t frame header structure
  38 //     sprite bitmap
  39 //   <else (single sprite frame)>
  40 //     dspriteframe_t frame header structure
  41 //     sprite bitmap
  42 // <endrepeat>
  43 //-------------------------------------------------------
  44
  45 #define SPRITE_VERSION  1
  46 #define HALFLIFESPRITE_VERSION  2
  47 #define SPRITE32_VERSION        32
  48
  49 // TODO: shorten these?
  50 typedef struct {
  51         int                     ident;
  52         int                     version;
  53         int                     type;
  54         float           boundingradius;
  55         int                     width;
  56         int                     height;
  57         int                     numframes;
  58         float           beamlength;
  59         synctype_t      synctype;
  60 } dsprite_t;
  61
  62 #define SPR_VP_PARALLEL_UPRIGHT         0
  63 #define SPR_FACING_UPRIGHT                      1
  64 #define SPR_VP_PARALLEL                         2
  65 #define SPR_ORIENTED                            3
  66 #define SPR_VP_PARALLEL_ORIENTED        4
  67
  68 typedef struct {
  69         int                     origin[2];
  70         int                     width;
  71         int                     height;
  72 } dspriteframe_t;
  73
  74 typedef struct {
  75         int                     numframes;
  76 } dspritegroup_t;
  77
  78 typedef struct {
  79         float   interval;
  80 } dspriteinterval_t;
  81
  82 typedef enum { SPR_SINGLE=0, SPR_GROUP } spriteframetype_t;
  83
  84 typedef struct {
  85         spriteframetype_t       type;
  86 } dspriteframetype_t;
  87
  88 #define IDSPRITEHEADER  (('P'<<24)+('S'<<16)+('D'<<8)+'I')
  89                                                                                                                 // little-endian "IDSP"
  90