/* Copyright (C) 2002 Dominic Clifton. This file is part of GtkRadiant. GtkRadiant 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. GtkRadiant 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 GtkRadiant; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */ // // Sprite Model Plugin // // Code by Hydra aka Dominic Clifton // // Based on MD3Model source code by SPoG // /* Overview ======== Why ? ----- It allows the user to see a graphical representation of the entity in the 3D view (maybe 2D views later) where the entity would just otherwise be a non-descriptive coloured box. It is designed to be used with the entity view set to WireFrame (as the sprite images are rendered in the middle of the entity's bbox. How ? ----- Implemented as a model module, without any ISelect stuff. For an entity to use an image (instead of a model) you just update the entity defintion file so that the eclass_t's modelpath is filled in with a relative path and filename of an image file. e.g: baseq3/scripts/entities.def =========================== \/\*QUAKED ammo_bfg (.3 .3 1) (-16 -16 -16) (16 16 16) SUSPENDED ... -------- MODEL FOR RADIANT ONLY - DO NOT SET THIS AS A KEY -------- model="sprites/powerups/ammo/bfgam.bmp"\*\/ valve/scripts/halflife.fgd ========================== @PointClass iconsprite("sprites/lightbulb.spr") base(Target, Targetname, Light) = light : "Invisible lightsource" [ ... ] What image formats are supported ? ---------------------------------- This module can load any image format that there is an active image module for. For q3 this would be bmp, tga and jpg. For Half-Life this would be hlw and spr. Version History =============== v0.1 - 27/May/2002 - Created an inital implementation of a sprite model plugin. According to the powers that be, it seems creating a model plugin is hackish. It works ok, but there is no way to attach models (sprites if you will) to non-fixedsize entities (like func_bombtarget) Also, I can't get the alpha map stuff right so I had to invert the alpha mask in the spr loader so that 0xff = not drawn pixel. ToDo ==== * make sprites always face the camera (is this done in camwindow.cpp ?) * maybe add an option to scale the sprites in the prefs ? * un-hack the default fall-though to "sprite" model version (see m_version) * maybe convert to a new kind of class not based on model. * allow sprites on non-fixedsize ents * fix reversed alpha map in spr loader * allow an entity to have both an .md? and a sprite model. */ #include "plugin.h" #include "spritemodel.h" // ============================================================================= // Globals // function tables _QERFuncTable_1 __QERTABLENAME; OpenGLBinding g_QglTable; _QERShadersTable g_ShadersTable; // ============================================================================= // SYNAPSE #include "synapse.h" char *supportedmodelformats[] = {"spr","bmp","tga","jpg","hlw",NULL}; // NULL is list delimiter static void add_model_apis( CSynapseClient& client ){ char **ext; for ( ext = supportedmodelformats; *ext != NULL; ext++ ) { client.AddAPI( MODEL_MAJOR, *ext, sizeof( _QERPlugModelTable ) ); } } static bool model_is_supported( const char* extension ){ char **ext; for ( ext = supportedmodelformats; *ext != NULL; ext++ ) { if ( stricmp( extension,*ext ) == 0 ) { return true; } } return false; } void init_filetypes(){ char **ext; for ( ext = supportedmodelformats; *ext != NULL; ext++ ) { GetFileTypeRegistry()->addType( MODEL_MAJOR, filetype_t( "sprite", *ext ) ); } } extern CSynapseServer* g_pSynapseServer; class CSynapseClientModel : public CSynapseClient { public: // CSynapseClient API bool RequestAPI( APIDescriptor_t *pAPI ); const char* GetInfo(); const char* GetName(); CSynapseClientModel() { } virtual ~CSynapseClientModel() { } bool OnActivate(){ init_filetypes(); // see todo list above. return true; } }; CSynapseServer* g_pSynapseServer = NULL; CSynapseClientModel g_SynapseClient; extern "C" CSynapseClient * SYNAPSE_DLL_EXPORT Synapse_EnumerateInterfaces( const char *version, CSynapseServer *pServer ){ if ( strcmp( version, SYNAPSE_VERSION ) ) { Syn_Printf( "ERROR: synapse API version mismatch: should be '" SYNAPSE_VERSION "', got '%s'\n", version ); return NULL; } g_pSynapseServer = pServer; g_pSynapseServer->IncRef(); Set_Syn_Printf( g_pSynapseServer->Get_Syn_Printf() ); add_model_apis( g_SynapseClient ); // see todo list above. g_SynapseClient.AddAPI( PLUGIN_MAJOR, "sprite", sizeof( _QERPluginTable ) ); g_SynapseClient.AddAPI( RADIANT_MAJOR, NULL, sizeof( g_FuncTable ), SYN_REQUIRE, &g_FuncTable ); g_SynapseClient.AddAPI( QGL_MAJOR, NULL, sizeof( g_QglTable ), SYN_REQUIRE, &g_QglTable ); g_SynapseClient.AddAPI( SHADERS_MAJOR, "*", sizeof( g_ShadersTable ), SYN_REQUIRE, &g_ShadersTable ); return &g_SynapseClient; } bool CSynapseClientModel::RequestAPI( APIDescriptor_t *pAPI ){ if ( !strcmp( pAPI->major_name, MODEL_MAJOR ) ) { _QERPlugModelTable* pTable = static_cast<_QERPlugModelTable*>( pAPI->mpTable ); if ( !strcmp( pAPI->minor_name, "sprite" ) ) { pTable->m_pfnLoadModel = &LoadSpriteModel; return true; } } Syn_Printf( "ERROR: RequestAPI( '%s' ) not found in '%s'\n", pAPI->major_name, GetInfo() ); return false; } #include "version.h" const char* CSynapseClientModel::GetInfo(){ return "Sprite Model module built " __DATE__ " " RADIANT_VERSION; } const char* CSynapseClientModel::GetName(){ return "sprite"; }