• Announcements

    • khawk

      Download the Game Design and Indie Game Marketing Freebook   07/19/17

      GameDev.net and CRC Press have teamed up to bring a free ebook of content curated from top titles published by CRC Press. The freebook, Practices of Game Design & Indie Game Marketing, includes chapters from The Art of Game Design: A Book of Lenses, A Practical Guide to Indie Game Marketing, and An Architectural Approach to Level Design. The GameDev.net FreeBook is relevant to game designers, developers, and those interested in learning more about the challenges in game development. We know game development can be a tough discipline and business, so we picked several chapters from CRC Press titles that we thought would be of interest to you, the GameDev.net audience, in your journey to design, develop, and market your next game. The free ebook is available through CRC Press by clicking here. The Curated Books The Art of Game Design: A Book of Lenses, Second Edition, by Jesse Schell Presents 100+ sets of questions, or different lenses, for viewing a game’s design, encompassing diverse fields such as psychology, architecture, music, film, software engineering, theme park design, mathematics, anthropology, and more. Written by one of the world's top game designers, this book describes the deepest and most fundamental principles of game design, demonstrating how tactics used in board, card, and athletic games also work in video games. It provides practical instruction on creating world-class games that will be played again and again. View it here. A Practical Guide to Indie Game Marketing, by Joel Dreskin Marketing is an essential but too frequently overlooked or minimized component of the release plan for indie games. A Practical Guide to Indie Game Marketing provides you with the tools needed to build visibility and sell your indie games. With special focus on those developers with small budgets and limited staff and resources, this book is packed with tangible recommendations and techniques that you can put to use immediately. As a seasoned professional of the indie game arena, author Joel Dreskin gives you insight into practical, real-world experiences of marketing numerous successful games and also provides stories of the failures. View it here. An Architectural Approach to Level Design This is one of the first books to integrate architectural and spatial design theory with the field of level design. The book presents architectural techniques and theories for level designers to use in their own work. It connects architecture and level design in different ways that address the practical elements of how designers construct space and the experiential elements of how and why humans interact with this space. Throughout the text, readers learn skills for spatial layout, evoking emotion through gamespaces, and creating better levels through architectural theory. View it here. Learn more and download the ebook by clicking here. Did you know? GameDev.net and CRC Press also recently teamed up to bring GDNet+ Members up to a 20% discount on all CRC Press books. Learn more about this and other benefits here.
Sign in to follow this  
Followers 0
Juliean

Forward declaration - how far to go?

12 posts in this topic

Hello,

 

I'm just about to step through my code to replace some unnecessary #includes with forward declaration to speed up compile time. However, I'm looking for some advice or guideline on how far I should take this. Consider this class:

 

#pragma once
#include "GfxDef.h"
#include "Render/RenderStates.h"
#include "Render/StateGroup.h"

namespace acl
{
	namespace gfx
	{
		class IMesh
		{
		public:

			virtual ~IMesh(void) = 0 {}

			virtual unsigned int GetStateCount(void) const = 0;
			virtual const render::StateGroup** GetStates(void) const = 0;
			virtual const render::DrawCall& GetDraw(void) const = 0;
		};
	}
}

 

Obviously, this interface doesn't need to know anything about eigther StageGroup or DrawCall, so forward declaration would obviously do. However I need to include the header files whenever I want to use the interface. Furthermore, if I implement a class using this interface, I can still use the (existing) forward declaration, but at some point I will need to include the header files again, probably in the application code. Whats preferable in this case? When should I use forward declaration or when should I still include header files in such a use case?

0

Share this post


Link to post
Share on other sites

This is arguable and really depends on a lot of factors.  I personally take it as far as possible because it is easier to add includes later than it is to try and clean them up after they have been in use for a while. Saying that though, I also try to match my namespace/classes to obvious include paths.  For instance, if I forward reference IMesh a lot then I need to use it in an implementation somewhere, what would the include path be?  For my usual method of working: "acl/gfx/IMesh.hpp" would be the path and file name following the pattern I use.  I started using this pattern fairly strictly after a couple SDK's began using it and I saw how nice and clean it kept things in most cases.  Yes, you end up with a lot more includes in the cpp's themselves, but the headers remain significantly cleaner and more understandable in the long run.  As long as the headers are easy to simply "know" what to include, there is no real hassle, if it is hunt and peck, that's bad news.

 

Of course, others disagree and I won't argue.  My only comment is in significant code bases, I have seen no need to use precompiled headers in many cases as they didn't gain much speed when the includes are kept as clean as possible.

Edited by AllEightUp
2

Share this post


Link to post
Share on other sites
An intermediate is having a header that contains the forward declarations for another header. So if you have foo.h then foo_fwd.h that has the forward declarations and relevant typedefs for the classes that appear in foo.h. At least in my opinion, this really only has value for template classes, but I've seen people use it for non template classes that are in nested namespaces as well.
1

Share this post


Link to post
Share on other sites

I also try to match my namespace/classes to obvious include paths. For instance, if I forward reference IMesh a lot then I need to use it in an implementation somewhere, what would the include path be? For my usual method of working: "acl/gfx/IMesh.hpp" would be the path and file name following the pattern I use. I started using this pattern fairly strictly after a couple SDK's began using it and I saw how nice and clean it kept things in most cases.

 

Yep, this is just the way I handle it. Well, currently the main directory is namend "editor, any chance of renaming it without have to import every file into the MSVC solution explorer manually?

 

Thanks to all of you for the advice, so I'm going for full forward declaration.

 

You should always prefer forward declaration as it will also avoid circular dependencies which are never fun to resolve.

 

Yeah, had quite a time with those. Didn't think I can un-include the header files when I forward declare though, but now I do. Thanks again, all of you.

0

Share this post


Link to post
Share on other sites

For compilation-time-with-header-files blues, you really should be looking at setting up pre-compiled headers instead.  Longer term that's going to be of far more benefit to you.

1

Share this post


Link to post
Share on other sites

For compilation-time-with-header-files blues, you really should be looking at setting up pre-compiled headers instead. Longer term that's going to be of far more benefit to you.

 

Interesting, reading about them all the time but havn't cared about them until now. I'm going to have a read how to set them up in Visual Studio 2012. So you suggest using precompiled headers instead of forward declaration, or as an addition?

0

Share this post


Link to post
Share on other sites
Precompiled headers work best for headers that rarely change. So you generally just put system headers, standard library headers and third party library headers in a precompiled header file. You use things like forward declarations to make your own headers that change more frequently compile more quickly.
0

Share this post


Link to post
Share on other sites

Okay, I see, since I'm not using that much third-party libs (just directx and some standard-libaries, of course), I'm not going through the trouble right now.

 

But just another question, since I'm designing my "engine" with use by other users in mind, and seperate from the game I'm developing, how would I go about that? Obviously most third-party libs I know at least offer the convenience of being able to do things like:

 

#include "Gui/Toolbar.h"

	//create game widget button
	gui::ToolButton* pCreate = pToolbar->AddButton(L"Frame/New.png");
	pCreate->SigReleased.Connect(this, &SceneToolbarCtrl::OnCreateGameObject);

Now with the new forward declaration method, I'd need to also include "Gui/ToolButton.h". Thats a little inconvenient, which doesn't matter for the lib itself, but should I really expect the user to include everything in advance of his compile time, or is there some prefered solution for this?

0

Share this post


Link to post
Share on other sites
One option is to create helper headers for each subsystem of your library. In your case, you could have a gui.h header that just includes all the other headers that have items that live in the gui namespace.
1

Share this post


Link to post
Share on other sites

Ok, that makes sense. It would still rather be considered a good design if I and my fictional team were still using the seperate headers in the actual game project, right?

0

Share this post


Link to post
Share on other sites

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!


Register a new account

Sign in

Already have an account? Sign in here.


Sign In Now
Sign in to follow this  
Followers 0