cpp
/
3DSoftwareRenderer-DFSPR
镜像来自 https://github.com/Dawoodoz/DFPSR.git


			
				
					
						
						
							1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
							<HTML>
	<BODY>
		<style>
			body { background-color: #FFFFEE; font-size: 14px; font-family: Arial;
			       color: #000000; margin: 0; padding-left: 10; padding-right: 10;
			       padding-top: 10; padding-bottom: 10px }
			A { font-size: 18px; font-family: Arial; color: #0000A0; text-decoration: none }
			A:hover { color: #000070; background: #AAffAA }
			A:active { color: #00A0A0 }
			.normal { font-size: 18px; color: #00A0A0 }
			.sub { font-size: 18px; color: #ffffdf; }
		</style>
<P>		<IMG SRC="Images/Title.png">
</P><P>		<A href="../Manual.html">Back to main page</A>
</P><P>		<b>Code convention for David Forsgren Piuva's Software Renderer</b>
</P><P>		To keep the style consistent, the style being used in the library is explained in this document.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		1. Use common sense!
</P><P>		If it looks wrong to human readers then it's wrong.
</P><P>		Don't defeat the purpose of any rule by taking it too far.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		2. Don't use iterators when there is any other way to accomplish the task.
</P><P>		You can't write efficient algorithms without knowing the data structures.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		3. Tabs for indentation then spaces for alignment.
</P><P>		It's the best of both worlds by both having variable length tabs
</P><P>		and correct alignment that works between lines of the same indentation.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		4. No dangling else, use explicit {} for safety.
</P><P>		Otherwise someone might add an extra statement and get random crashes.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		5. No hpp extensions, use h for all headers.
</P><P>		Could be either way, but this library uses *.h for compact naming, so keep it consistent.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		6. C-style casting for raw data manipulation and C++-style for high-level classes.
</P><P>		When using assembly intrinsics and raw pointer manipulation to alter the state of bits,
</P><P>		verbose high-level abstractions only make it harder to count CPU cycles in your head.
</P><P>		Always use the tool that makes sense for the problem you're trying to solve.
</P><P>		C++ style is for things that are abstracted on a higher level.
</P><P>		C style is for when a byte is just a byte and you just want to manipulate it in a specific way.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		7. Don't call member methods with "this" set to nullptr.
</P><P>		This would be undefined behaviour and may randomly crash.
</P><P>		Use global functions instead. They allow checking pointers for null
</P><P>		because they are explicit arguments declared by the programmer.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		8. Avoid using STD/STL directly in SDK examples.
</P><P>		Exposing types from the standard library should be done using an alias or wrapper in the dsr namespace.
</P><P>		This allow replacing the standard library without breaking backward compatibility.
</P><P>		The C++ standard libraries have broken backward compatibility before and it can happen again.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		9. Don't abuse the auto keyword everywhere just to make it look more "modern".
</P><P>		Explicit type safety is what makes compiled languages safer than scripting.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		10. No new line for opening brackets.
</P><P>		Makes the code more compact and decreases the risk of copy-paste errors.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		11. Don't fix the style of someone else's code if you can easily read it.
</P><P>		Especially if there's no style rule explicitly supporting the change.
</P><P>		Otherwise style changes will defeat the purpose by introducing more version conflicts.
</P><P>	<IMG SRC="Images/Border.png">
</P><P>		12. Don't change things that you don't know how to test.
</P><P>	<IMG SRC="Images/Border.png">
</P>	</BODY>
</HTML>