The DarkMod Wiki - User contributions [en]

Adding New Decl Types

2006-12-15T22:00:12Z

66.206.81.84:

This is a summary of [http://www.doom3world.org/phpbb2/viewtopic.php?t=14797 Slinky's D3W tutorial].

#In '''SDK/framework/declmanager.h''', add a new type to the declType_t enumeration.
#In '''idGameLocal::Init()''', register your new decl type.
#:<pre><nowiki>declManager->RegisterDeclType( "nameofdecl", DECL_ENUMTYPE, idDeclAllocator<yourDeclClass> );</nowiki></pre>
#:The first argument is the keyword mappers can use to specify what kind of decl they're making. The second argument links it to the type you made in step 1, and the last argument is used to link it to the declClass you'll be making to parse and store your decl.
#Also in '''idGameLocal::Init()''', register the folders and file-types that will be searched for your decls.
#:<pre><nowiki>declManager->RegisterDeclFolder( "foldername", ".file_extension", DECL_ENUMTYPE );</nowiki></pre>
#:The first argument is the folder name to search, the second argument is the file extensions to search, and the last argument links it to the type you made in step 1.
#Modify '''idGameLocal::CacheDictionaryMedia()''' to precache any instances of your declaration specified in the spawnargs of an entity.
#Create your decl class, inheriting from '''idDecl'''.
##Create the class declaration... at a minimum, it should probably look something like this:
##:<pre><nowiki>class yourDeclClass : public idDecl
{
public:
yourDeclClass();
~yourDeclClass();

virtual size_t Size( void ) const;
virtual const char * DefaultDefinition( void ) const;
virtual void FreeData( void );
virtual bool Parse( const char *text, const int textLength );

protected:
idStr someOfYourDeclData;
int someMoreOfYourDeclData;

};</nowiki></pre>
##Define the class constructors/deconstructors. These can do whatever you like. You might want to consider calling '''FreeData()''' in the deconstructor.
##Define '''Size()'''. All decl classes need this.
##:<pre><nowiki>size_t yourDeclClass::Size() const
{
return sizeof(yourDeclClass);
}</nowiki></pre>
##Define '''DefaultDefinition()'''. This just returns the default declaration that is used if the mapper writes one that your function can't parse.
##:<pre><nowiki>const char *yourDeclClass::DefaultDefinition() const
{
return "{\n}\n";
}</nowiki></pre>
##:Be careful to ensure that the string returned is parsable by your '''Parse()''' function. Maybe Bad Stuff™ will happen if you don't.
##Define '''FreeData()'''. Each time '''Parse()''' is called, '''FreeData()''' is first called to reset your decl's state. This way, the decl manager can use an instance of your decl class to keep on parsing definitions until it succeeds, without having to delete it and create a new instance. Example definition:
##:<pre><nowiki>void yourDeclClass::FreeData()
{
someOfYourDeclData = "";
someMoreOfYourDeclData = 0;
}</nowiki></pre>
##Define '''Parse()'''. This is given an array of text, and its length, and is expected to parse it into data or give up. If '''true''' is returned, the decl manager will assume the parse was successful. If '''false''' is returned, the decl manager will assume the parse failed and a default definition was loaded. If you return false, you should probably call '''MakeDefault()''', which will parse the string returned by '''DefaultDefinition()'''.
##:<pre><nowiki>bool yourClassDecl::Parse( const char *text, const int textLength )
{
idLexer src;
idToken token;

src.LoadMemory( text, textLength, GetFileName(), GetLineNum() );
src.SetFlags( DECL_LEXER_FLAGS );

// Parse the string using the Lexer.
// Note that we will be given a block of text like so:
// nameofdecl asset/name
// {
// information
// }
// nameofdecl may be omitted if the decl manager is able to assume that the mapper
// was creating a decl of our type. (this is commonly the case with materials)
// We might also be able to parse information that comes after our decl, so we
// should be sure to stop parsing once we reach our outer closing brace.

if ( the parse failed )
{
src.Warning("Unable to parse the file.");
MakeDefault();
return false;
}

return true;
}</nowiki></pre>

Adding New Decl Types

2006-12-15T21:59:53Z

66.206.81.84:

This is a summary of [http://www.doom3world.org/phpbb2/viewtopic.php?t=14797 Slinky's D3W tutorial], so that we can still add declarations if something should happen to D3W.

#In '''SDK/framework/declmanager.h''', add a new type to the declType_t enumeration.
#In '''idGameLocal::Init()''', register your new decl type.
#:<pre><nowiki>declManager->RegisterDeclType( "nameofdecl", DECL_ENUMTYPE, idDeclAllocator<yourDeclClass> );</nowiki></pre>
#:The first argument is the keyword mappers can use to specify what kind of decl they're making. The second argument links it to the type you made in step 1, and the last argument is used to link it to the declClass you'll be making to parse and store your decl.
#Also in '''idGameLocal::Init()''', register the folders and file-types that will be searched for your decls.
#:<pre><nowiki>declManager->RegisterDeclFolder( "foldername", ".file_extension", DECL_ENUMTYPE );</nowiki></pre>
#:The first argument is the folder name to search, the second argument is the file extensions to search, and the last argument links it to the type you made in step 1.
#Modify '''idGameLocal::CacheDictionaryMedia()''' to precache any instances of your declaration specified in the spawnargs of an entity.
#Create your decl class, inheriting from '''idDecl'''.
##Create the class declaration... at a minimum, it should probably look something like this:
##:<pre><nowiki>class yourDeclClass : public idDecl
{
public:
yourDeclClass();
~yourDeclClass();

virtual size_t Size( void ) const;
virtual const char * DefaultDefinition( void ) const;
virtual void FreeData( void );
virtual bool Parse( const char *text, const int textLength );

protected:
idStr someOfYourDeclData;
int someMoreOfYourDeclData;

};</nowiki></pre>
##Define the class constructors/deconstructors. These can do whatever you like. You might want to consider calling '''FreeData()''' in the deconstructor.
##Define '''Size()'''. All decl classes need this.
##:<pre><nowiki>size_t yourDeclClass::Size() const
{
return sizeof(yourDeclClass);
}</nowiki></pre>
##Define '''DefaultDefinition()'''. This just returns the default declaration that is used if the mapper writes one that your function can't parse.
##:<pre><nowiki>const char *yourDeclClass::DefaultDefinition() const
{
return "{\n}\n";
}</nowiki></pre>
##:Be careful to ensure that the string returned is parsable by your '''Parse()''' function. Maybe Bad Stuff™ will happen if you don't.
##Define '''FreeData()'''. Each time '''Parse()''' is called, '''FreeData()''' is first called to reset your decl's state. This way, the decl manager can use an instance of your decl class to keep on parsing definitions until it succeeds, without having to delete it and create a new instance. Example definition:
##:<pre><nowiki>void yourDeclClass::FreeData()
{
someOfYourDeclData = "";
someMoreOfYourDeclData = 0;
}</nowiki></pre>
##Define '''Parse()'''. This is given an array of text, and its length, and is expected to parse it into data or give up. If '''true''' is returned, the decl manager will assume the parse was successful. If '''false''' is returned, the decl manager will assume the parse failed and a default definition was loaded. If you return false, you should probably call '''MakeDefault()''', which will parse the string returned by '''DefaultDefinition()'''.
##:<pre><nowiki>bool yourClassDecl::Parse( const char *text, const int textLength )
{
idLexer src;
idToken token;

src.LoadMemory( text, textLength, GetFileName(), GetLineNum() );
src.SetFlags( DECL_LEXER_FLAGS );

// Parse the string using the Lexer.
// Note that we will be given a block of text like so:
// nameofdecl asset/name
// {
// information
// }
// nameofdecl may be omitted if the decl manager is able to assume that the mapper
// was creating a decl of our type. (this is commonly the case with materials)
// We might also be able to parse information that comes after our decl, so we
// should be sure to stop parsing once we reach our outer closing brace.

if ( the parse failed )
{
src.Warning("Unable to parse the file.");
MakeDefault();
return false;
}

return true;
}</nowiki></pre>

Adding New Decl Types

2006-12-15T21:55:26Z

66.206.81.84:

This is a summary of [http://www.doom3world.org/phpbb2/viewtopic.php?t=14797 Slinky's D3W tutorial], so that we can still add declarations if something should happen to D3W.

#In '''SDK/framework/declmanager.h''', add a new type to the declType_t enumeration.
#In '''idGameLocal::Init()''', register your new decl type.
#:<pre>declManager->RegisterDeclType( "nameofdecl", DECL_ENUMTYPE, idDeclAllocator<yourDeclClass> );</pre>
#:The first argument is the keyword mappers can use to specify what kind of decl they're making. The second argument links it to the type you made in step 1, and the last argument is used to link it to the declClass you'll be making to parse and store your decl.
#Also in '''idGameLocal::Init()''', register the folders and file-types that will be searched for your decls.
#:<pre>declManager->RegisterDeclFolder( "foldername", ".file_extension", DECL_ENUMTYPE );</pre>
#:The first argument is the folder name to search, the second argument is the file extensions to search, and the last argument links it to the type you made in step 1.
#Modify '''idGameLocal::CacheDictionaryMedia()''' to precache any instances of your declaration specified in the spawnargs of an entity.
#Create your decl class, inheriting from '''idDecl'''.
##Create the class declaration... at a minimum, it should probably look something like this:
##:<pre>class yourDeclClass : public idDecl
##:{
##: public:
##: yourDeclClass();
##: ~yourDeclClass();
##:
##: virtual size_t Size( void ) const;
##: virtual const char * DefaultDefinition( void ) const;
##: virtual void FreeData( void );
##: virtual bool Parse( const char *text, const int textLength );
##:
##: protected:
##: idStr someOfYourDeclData;
##: int someMoreOfYourDeclData;
##:
##:};</pre>
##Define the class constructors/deconstructors. These can do whatever you like. You might want to consider calling '''FreeData()''' in the deconstructor.
##Define '''Size()'''. All decl classes need this.
##:<pre>size_t yourDeclClass::Size() const
##:{
##: return sizeof(yourDeclClass);
##:}</pre>
##Define '''DefaultDefinition()'''. This just returns the default declaration that is used if the mapper writes one that your function can't parse.
##:<pre>const char *yourDeclClass::DefaultDefinition() const
##:{
##: return "{\n}\n";
##:}</pre>
##:Be careful to ensure that the string returned is parsable by your '''Parse()''' function. Maybe Bad Stuff™ will happen if you don't.
##Define '''FreeData()'''. Each time '''Parse()''' is called, '''FreeData()''' is first called to reset your decl's state. This way, the decl manager can use an instance of your decl class to keep on parsing definitions until it succeeds, without having to delete it and create a new instance. Example definition:
##:<pre>void yourDeclClass::FreeData()
##:{
##: someOfYourDeclData = "";
##: someMoreOfYourDeclData = 0;
##:}</pre>
##Define '''Parse()'''. This is given an array of text, and its length, and is expected to parse it into data or give up. If '''true''' is returned, the decl manager will assume the parse was successful. If '''false''' is returned, the decl manager will assume the parse failed and a default definition was loaded. If you return false, you should probably call '''MakeDefault()''', which will parse the string returned by '''DefaultDefinition()'''.
##:<pre>bool yourClassDecl::Parse( const char *text, const int textLength )
##:{
##: idLexer src;
##: idToken token;
##:
##: src.LoadMemory( text, textLength, GetFileName(), GetLineNum() );
##: src.SetFlags( DECL_LEXER_FLAGS );
##:
##: // Parse the string using the Lexer.
##: // Note that we will be given a block of text like so:
##: // nameofdecl asset/name
##: // {
##: // information
##: // }
##: // nameofdecl may be omitted if the decl manager is able to assume that the mapper
##: // was creating a decl of our type. (this is commonly the case with materials)
##: // We might also be able to parse information that comes after our decl, so we
##: // should be sure to stop parsing once we reach our outer closing brace.
##:
##: if ( the parse failed )
##: {
##: src.Warning("Unable to parse the file.");
##: MakeDefault();
##: return false;
##: }
##:
##: return true;
##:}</pre>

Adding New Decl Types

2006-12-15T20:33:04Z

66.206.81.84:

This is a summary of [http://www.doom3world.org/phpbb2/viewtopic.php?t=14797 Slinky's D3W tutorial].

(under construction)

SDK

2006-12-15T20:32:00Z

66.206.81.84:

Various articles concerning SDK-related stuff:

* [[Adding new Cvars]]
* [[Adding Script Events to sys]]
* [[AI Debug Mode has large Impact on Soundprop Performance]]
* [[Calling Console Commands From SDK]]
* [[Clip Functions to check Specific Models]]
* [[Dynamically Resizing Models]]
* [[Eventdef System Does Not Like Optional Args]]
* [[Possible Code For Weapon Bob]]
* [[Raising/lowering Weapon from outside Player]]
* [[Saving and Restoring]]
* [[Savegame Files]]
* [[Spawn() might be run in D3Ed]]
* [[Adding New Decl Types]]

[[Category:SDK]]