View source for Static Function Libraries, Your Own Version of UE4 C++, No Engine Compile Times

==Overview==

''Original Author:'' [[User:Rama|Rama]] ([[User talk:Rama|talk]])

Dear Community,

Building up your own static library of functions enables you to create your own version of UE4 C++ without having to modify the engine code and recompile it constantly.

A static library can have FORCEINLINE functions as well as .cpp functions that utilize your entire Game's compiled header structure!

  Whenever you have a core function that you want to use in many classes, 
  you can make it into a Static Library function 
  so it can be used any time anywhere!

==MyStaticLibrary.h==
<syntaxhighlight lang="cpp">
#pragma once

#include "MyStaticLibrary.generated.h"

UCLASS() 
class UMyStaticLibrary : public UObject
{
	GENERATED_UCLASS_BODY()
	
	//FORCEINLNE function
	static FORCEINLINE bool IsValid(AActor* TheActor)
	{
		if(!TheActor) return false;
		if(!TheActor->IsValidLowLevel()) return false;
		return true;
	}
	
	//cpp function
	static int32 ComplicatedGameDataAnalysis();
};
</syntaxhighlight>

==MyStaticLibrary.cpp==
<syntaxhighlight lang="cpp">
// Copyright 1998-2013 Epic Games, Inc. All Rights Reserved.

#include "VictoryGame.h"

//////////////////////////////////////////////////////////////////////////
// MyStaticLibrary

UMyStaticLibrary::UMyStaticLibrary(const FObjectInitializer& ObjectInitializer)
	: Super(ObjectInitializer)
{
	
}

int32 UMyStaticLibrary::ComplicatedGameDataAnalysis()
{
	//Do lots of stuff that requires the entire Game's compiled header source,
	//  involving lots of your custom project-specific classes,
	//    classes that have not been compiled in the .h of this library 
	//    since they depend on it.
        return 9000;
}
</syntaxhighlight>

==Example Usage==

In any class, in the .h, or the .cpp, anywhere really (if the class depends on your static library

<syntaxhighlight lang="cpp">
//Anywhere, in .h or .cpp, in any class! 
if(UMyStaticLibrary::IsValid(MyCharacter))
{
  //Celebrate
  ClientMessage( FString::FromInt(UMyStaticLibrary::ComplicatedGameDataAnalysis()) );
}
</syntaxhighlight>

==Include==

All of the classes that want to use your Static Library must include it

<syntaxhighlight lang="cpp">
#include "MyStaticLibrary.h"
</syntaxhighlight>

==Why UObject?==
Because then you can also define USTRUCTS() in your static library, the very best place for them, if many classes want to use them!

===USTRUCT() Library===
<syntaxhighlight lang="cpp">

//My 2D Rectangle data type
//  because this is defined in your static library that all your classes depend on,
//  you can use this USTRUCT() data type in any class, even in  .h FORCEINLINE functions!

USTRUCT()
struct FVRect
{
	GENERATED_USTRUCT_BODY()
	
	UPROPERTY()
	FVector2D Min;
	
	UPROPERTY()
	FVector2D Max;
	
	//overloaded constructor
	FVRect(const FVector2D& VPoint1, const FVector2D& VPoint2)
	{
		//drag topleft to bottom right
		if(VPoint1.X < VPoint2.X &&
			VPoint1.Y < VPoint2.Y
		){
			Min 	= VPoint1;
			Max 	= VPoint2;
		}
		
		//drag from bottom right to top left
		else if(VPoint1.X > VPoint2.X &&
			VPoint1.Y > VPoint2.Y
		){
			Min 	= VPoint2;
			Max 	= VPoint1;
		}
		
		//drag from bottom left to top right
		else if(VPoint1.X < VPoint2.X &&
			VPoint1.Y > VPoint2.Y
		){
			Min 	= FVector2D(VPoint1.X, VPoint2.Y);
			Max 	= FVector2D(VPoint2.X, VPoint1.Y);
		}
		
		//etc...
	}
	
	//base constructor
	FVRect()
	{
		Min = FVector2D(0,0);
		Max = FVector2D(500,500);
	}
};

USTRUCT()
struct FQuadVRect
{
	GENERATED_USTRUCT_BODY()
	
	UPROPERTY()
	FVRect Rects[4];

        //base constructor
	FQuadVRect()
	{
	}
};

//And many
//many
//many
//many more USTRUCTS() !

UCLASS() 
class UMyStaticLibrary : public UObject
{
	GENERATED_UCLASS_BODY()

};
</syntaxhighlight>

==Related Tutorials==

[[Linking_Static_Libraries_Using_The_Build_System|Linking Static Libraries Using The Build System]]

Great tutorial by [[User:Bob Gneu|Bob Gneu]]!

==Summary==

Now you have an easy way to write your own version of UE4 C++ to include essential project-specific function tools,

  without having to recompile the entire engine code constantly!

Enjoy!

[[User:Rama|Rama]] ([[User talk:Rama|talk]])

[[Category:Code]]