I spent a bit of time going through the Doom3 source code. It’s probably the cleanest and nicest looking code I’ve ever seen.<\/p><\/blockquote>\n
Doom 3\u00a0<\/span>is a\u00a0<\/span>video game\u00a0developed by\u00a0<\/span>id Software<\/a>\u00a0and published by\u00a0<\/span>Activision<\/a>.<\/span>The game was a \u00a0commercial success for id Software; with more than 3.5 million copies of the game were sold.<\/p>\n On November 23, 2011 id Software maintained the tradition and it released the source code<\/a> of their previous engine. This source code was reviewed by many developers, here’s as example the feedback from fabien (orginal source<\/a>):<\/span><\/p>\n Doom 3 BFG is written in C++, a language so vast that it can be used to generate great code but also abominations that will\u00a0make your eyes bleed. Fortunately id Software settled for a C++ subset close to “C with Classes” which flows down the brain with little resistance:<\/p>\n Many C++ experts don’t\u00a0recommend any more the “C with classes” approach. However, Doom3 was developed between 2000 and 2004, what could explain \u00a0the no use of modern C++ mechanisms.<\/p>\n Let’s go inside its source code using CppDepend<\/a> and discover what makes it so special.<\/p>\n Doom3 is modularized using few\u00a0projects, here\u2019s the list of its projects, and some statistics about their types:<\/span><\/p>\n And here’s the dependency graph to show the relation between them:<\/span><\/p>\n Doom3 defines many global functions.\u00a0However, most of the treatments are implemented in classes.<\/p>\n The data model is defined using structs. To have a concrete idea of using structs\u00a0in the source code, the metric view above shows them as blue rectangles.<\/p>\n In the Metric View, the code base is represented through a Treemap. Treemapping is a method for displaying tree-structured data by using nested rectangles. The tree structure used \u00a0is the usual code hierarchy:<\/p>\n As we can observe many structs are defined, for example \u00a0more than 40% of DoomDLL types are structs. They are systematically used to define the data model. This practice is adopted by many projects, \u00a0this approach has a big drawback in case of multithreaded applications. Indeed, structs with public fields are not immutable.<\/p>\n There is one important argument in favor of using immutable objects: It dramatically simplifies concurrent programming. Think about it, why does writing proper multithreaded programming is a hard task? Because it is hard to synchronize threads access to resources (objects or others OS resources). Why it is hard to synchronize these accesses? Because it is hard to guarantee that there won\u2019t be race conditions between the multiple write accesses and read accesses done by multiple threads on multiple objects. What if there are no more write accesses? In other words, what if the state of the objects accessed by threads, doesn\u2019t change? There is no more need for synchronization!<\/p>\n Let’s search for classes having at least one base class:<\/p>\n Almost 40% of stucts and classes have a base class. And generally in OOP one of the benefits of inheritance is the polymorphism, here are in blue the virtual methods defined\u00a0in the source code:<\/p>\n More than 30% of methods are virtual. Few of them are virtual pure and here’s the list of all abstract classes defined:<\/p>\n Only 52 are defined abstract classes, 35 of them are defined as pure interfaces,i.e. all their virtual methods are pure.<\/p>\n Let’s search for methods using RTTI<\/p>\n Only very few methods use RTTI.<\/p>\n To resume \u00a0only basic concepts of OOP are used, no advanced design patterns used, no overuse of interfaces and abstract classes, limited use of RTTI and data are defined as structs.<\/p>\n Until now nothing special differentiate this code from\u00a0many others using “C with Classes” and criticized by many C++ developers.<\/p>\n Here are some interesting choices of their developers to help us understand its secret:<\/p>\n 1 – Provides a common base class with useful services.<\/strong><\/p>\n Many classes inherits from the idClass:<\/p>\n The idClass\u00a0\u00a0provides the following services:<\/p>\n 2- Make easy the string manipulation<\/strong><\/p>\n Generally the string is the most used type in a project, many treatments are done using them, and we need functions to manipulate them.<\/p>\n Doom3 defines the idstr class which contains almost all useful methods to manipulate strings, no need to define your own method as the case of many string classes provided by other frameworks.<\/p>\n 3- The source code is highly decoupled with the GUI framework (MFC)<\/strong><\/p>\n In many projects using MFC, the code is highly coupled with their types, and you can find types\u00a0from MFC everywhere in the code.<\/p>\n In Doom3, The code\u00a0is highly decoupled with MFC, only GUI classes has direct dependency with it. As shown by this following CQLinq query:<\/p>\n This choice has a big impact on the productivity. Indeed, only the Gui developers must care about\u00a0the MFC framework, and for the other developers it’s not mandatory to waste time with MFC.<\/span><\/p>\n 4- It provides a very good utility library (idlib)<\/strong><\/p>\n In almost all projects the most used types are utility classes, as shown by the result of this following query:<\/p>\n As we can observe the most used are utilities ones. If \u00a0C++ developers don’t\u00a0use a good framework for utilities, they spend most of their developement time to fight with the technical layer.<\/p>\n idlib provides useful classes with all needed methods to treat string, containers, and memory. Which facilitate the work of developers and let them focus more on the game\u00a0logic.<\/p>\n 5- The implementation is very easy to understand<\/strong><\/p>\n Doom3 implements a hard coded compiler, and as known by C++ developers, it’s not an easy task to develop parsers and compilers. However, the implementation of the Doom3 is very easy to understand\u00a0and its\u00a0code is very clean.<\/p>\n Here’s the dependency graph of the classes used by the compiler:<\/p>\n And here’s a code snippet from the compiler source code:<\/p>\n We already study the code source of many parsers and compiler. But it’s the first time we discover a compiler with a source\u00a0code\u00a0very easy to be understood, it’s the same for the whole Doom3 source code. It’s magic. When we explore the Doom3 source code, we can’t say: WOW it’s beautiful!<\/p>\n Summary<\/strong><\/p>\n Even if the Doom3 \u00a0design choices are very basic, but its designers make many decisions to let developers focus more on the game logic, and facilitate\u00a0all the technical layer stuff. Which\u00a0increase a lot the productivity.<\/p>\n However when using “C with Classes”, you have\u00a0to know exactly what you are doing. You have to be expert like Doom3 developers. It’s not recommended for a beginner to take risk and ignore the Modern C++ recommendations.<\/p>\n","protected":false},"excerpt":{"rendered":" If you search on\u00a0the web for the best\u00a0C++ source code. The Doom3 source code is mentioned\u00a0many times, with testimonials \u00a0like this one. I spent a bit of time going through the Doom3 source code. It’s probably the cleanest and nicest looking code I’ve ever seen. Doom 3\u00a0is a\u00a0video game\u00a0developed by\u00a0id Software\u00a0and published by\u00a0Activision.The game was … Continue reading “Doom3 is the proof that “keep it simple” works.”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[7,6,8],"class_list":["post-11","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-c","tag-doom","tag-keep-it-simple"],"_links":{"self":[{"href":"https:\/\/cppdepend.com\/blog\/wp-json\/wp\/v2\/posts\/11","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cppdepend.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/cppdepend.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/cppdepend.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/cppdepend.com\/blog\/wp-json\/wp\/v2\/comments?post=11"}],"version-history":[{"count":1,"href":"https:\/\/cppdepend.com\/blog\/wp-json\/wp\/v2\/posts\/11\/revisions"}],"predecessor-version":[{"id":12,"href":"https:\/\/cppdepend.com\/blog\/wp-json\/wp\/v2\/posts\/11\/revisions\/12"}],"wp:attachment":[{"href":"https:\/\/cppdepend.com\/blog\/wp-json\/wp\/v2\/media?parent=11"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cppdepend.com\/blog\/wp-json\/wp\/v2\/categories?post=11"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cppdepend.com\/blog\/wp-json\/wp\/v2\/tags?post=11"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
\n
![\"doom5\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom5.png\")
<\/a><\/p>\n![\"doom2\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom2.png\")
<\/a><\/p>\n\n
![\"doom13\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom13.png\")
<\/p>\n![\"doom6\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom6.png\")
<\/a><\/p>\n![\"doom7\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom7.png\")
<\/a><\/p>\n![\"doom9\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom9.png\")
<\/a><\/p>\n![\"doom8\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom8.png\")
<\/a><\/p>\n![\"doom17\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom17.png\")
<\/a><\/p>\n![\"doom10\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom10.png\")
<\/a><\/p>\n\n
![\"doom11\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom11.png\")
<\/a><\/p>\n![\"doom3\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom3.png\")
<\/a><\/p>\n![\"doom4\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom4.png\")
<\/a><\/p>\n![\"doom16\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom16.png\")
<\/a><\/p>\n![\"doom15\"](\"http:\/\/www.codergears.com\/Blog\/wp-content\/uploads\/doom15.png\")
<\/a><\/p>\n