Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
74 changes: 40 additions & 34 deletions DTrackPlugin.uplugin
Original file line number Diff line number Diff line change
@@ -1,34 +1,40 @@
{
"FileVersion": 1,
"Version": 1,
"VersionName": "0.7.3",
"FriendlyName": "DTrack Plugin",
"Description": "Plugin for the ART DTrack tracking system.",
"Category": "Virtual Production",
"CreatedBy": "Advanced Realtime Tracking GmbH",
"CreatedByURL": "https://ar-tracking.com",
"DocsURL": "https://github.com/ar-tracking/UnrealDTrackPlugin",
"MarketplaceURL": "",
"SupportURL": "https://ar-tracking.com/",
"EngineVersion": "4.25.0",
"CanContainContent": false,
"Installed" : true,
"Modules": [
{
"Name": "DTrackPlugin",
"Type": "Runtime",
"WhitelistPlatforms": [ "Win64" ]
},
{
"Name": "DTrackInput",
"Type": "Runtime",
"WhitelistPlatforms": [ "Win64" ]
}
],
"Plugins": [
{
"Name": "LiveLink",
"Enabled": true
}
]
}
{
"FileVersion": 3,
"Version": 1,
"VersionName": "0.7.3",
"FriendlyName": "DTrack Plugin",
"Description": "Plugin for the ART DTrack tracking system.",
"Category": "Virtual Production",
"CreatedBy": "Advanced Realtime Tracking GmbH",
"CreatedByURL": "https://ar-tracking.com",
"DocsURL": "https://github.com/ar-tracking/UnrealDTrackPlugin",
"MarketplaceURL": "",
"SupportURL": "https://ar-tracking.com/",
"EngineVersion": "5.0",
"CanContainContent": false,
"Installed": true,
"Modules": [
{
"Name": "DTrackPlugin",
"Type": "Runtime",
"LoadingPhase": "Default",
"WhitelistPlatforms": [
"Win64"
]
},
{
"Name": "DTrackInput",
"Type": "Runtime",
"LoadingPhase": "Default",
"WhitelistPlatforms": [
"Win64"
]
}
],
"Plugins": [
{
"Name": "LiveLink",
"Enabled": true
}
]
}
16 changes: 8 additions & 8 deletions Readme.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,29 @@
# DTrack Plugin for Unreal Engine 4
# DTrack Plugin for Unreal Engine 5

This is a plug-in for the Unreal Engine with the purpose of native integration of the [Advanded Realtime Tracking][1] _DTrack_ and _DTrack2_ tracking solutions. It injects data into the engine through LiveLink. Data can be accessed through Blueprint or C++. The plugin currently supports the DTrack body`6d`and flystick`6df2`data format.


## Prerequisites

- Unreal Engine 4.23 or later
- Unreal Engine 5.0.1. It also works for Unreal4 from Unreal 4.23 and later
- Windows
- Microsoft Visual Studio 2015 or later (Express or Community Edition should suffice)
- Microsoft Visual Studio 2022 for UE5 and Visual Studio 2017 and 2019 for UE4 (Express or Community Edition should suffice)


## Installation

### Preparation

- Adapt the _.uplugin_ file to the version of your _UnrealEditor_:<br>The `EngineVersion` key in the file _DTrackPlugin.uplugin_ comes with a default value corresponding to the latest tested _UE4Editor_ version (e.g. `"EngineVersion": "4.25.0"`).<br>If you are using an _UE4Editor_ version with a different minor version number (e.g. 4.23 instead of 4.25), you should adjust this value (e.g. to `"EngineVersion": "4.23.0"`).
- Adapt the _.uplugin_ file to the version of your _UnrealEditor_:<br>The `EngineVersion` key in the file _DTrackPlugin.uplugin_ comes with a default value corresponding to the latest tested _UE4Editor_ version (e.g. `"EngineVersion": "5.0.1"` or `"EngineVersion": "4.25.0"`).<br>If you are using an _UE4Editor_ version with a different minor version number (e.g. 4.23 instead of 4.25), you should adjust this value (e.g. to `"EngineVersion": "4.23.0"`).

### Install into the global Engine plugin folder
- Compile the plugin manually:<br> *&lt;UE4Dir&gt;\Engine\Build\BatchFiles\RunUAT.bat* BuildPlugin -Plugin=*/Path/to/DTrackPlugin.uplugin* -TargetPlatforms=Win64 -Package=*&lt;OutDir&gt;* -Rocket
- Copy *&lt;OutDir&gt;* to *&lt;UE4Dir&gt;\Engine\Plugins\DTrackPlugin*
- Compile the plugin manually:<br> *&lt;UE5Dir&gt;\Engine\Build\BatchFiles\RunUAT.bat* BuildPlugin -Plugin=*/Path/to/DTrackPlugin.uplugin* -TargetPlatforms=Win64 -Package=*&lt;OutDir&gt;* -Rocket
- Copy *&lt;OutDir&gt;* to *&lt;UE5Dir&gt;\Engine\Plugins\DTrackPlugin*



### Alternatively, install into your local project plugin folder
- Open the UE4Editor and create an Unreal C++ project
- Open the UE5Editor and create an Unreal C++ project
- Copy the plugin to *&lt;project&gt;\Plugins\DTrackPlugin*
- Compilation then takes place automatically when starting your Unreal project

Expand Down Expand Up @@ -80,4 +80,4 @@ The mapping of Flystick buttons and joystick is listed in *DTrackFlystickInputDe



[1]: https://ar-tracking.com/
[1]: https://ar-tracking.com/
10 changes: 4 additions & 6 deletions Source/DTrackPlugin/Private/DTrackLiveLinkSource.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -69,18 +69,16 @@ FText FDTrackLiveLinkSource::GetSourceStatus() const {



#if ENGINE_MINOR_VERSION >= 24
TSubclassOf<ULiveLinkSourceSettings> FDTrackLiveLinkSource::GetSettingsClass() const {
#if ENGINE_MAJOR_VERSION == 5 || (ENGINE_MINOR_VERSION>=23)
TSubclassOf<ULiveLinkSourceSettings> FDTrackLiveLinkSource::GetSettingsClass() const {
return UDTrackLiveLinkSourceSettings::StaticClass();
}
#else
}
#else
UClass* FDTrackLiveLinkSource::GetCustomSettingsClass() const {
return UDTrackLiveLinkSourceSettings::StaticClass();
}
#endif



void FDTrackLiveLinkSource::OnSettingsChanged(ULiveLinkSourceSettings* InSettings, const FPropertyChangedEvent& InPropertyChangedEvent) {

if (InSettings != nullptr && InSettings == m_source_settings.Get()) {
Expand Down
2 changes: 1 addition & 1 deletion Source/DTrackPlugin/Public/DTrackLiveLinkSource.h
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ class DTRACKPLUGIN_API FDTrackLiveLinkSource : public ILiveLinkSource
virtual FText GetSourceMachineName() const override;
virtual FText GetSourceStatus() const override;

#if ENGINE_MINOR_VERSION >= 24
#if ENGINE_MAJOR_VERSION == 5 || (ENGINE_MINOR_VERSION>=24)
virtual TSubclassOf<ULiveLinkSourceSettings> GetSettingsClass() const override;
#else
virtual UClass* GetCustomSettingsClass() const;
Expand Down