Recent changes to Adding_KDIS_To_A_New-Existing_Project_Manually

Adding_KDIS_To_A_New/Existing_Project_Manually modified by Karl Jones

Karl Jones — Fri, 27 Jun 2014 12:06:15 -0000

--- v13
+++ v14
@@ -114,13 +114,10 @@

     DIS_VERSION=6 

-    **Note:** Only DIS version 5 and 6 are currently supported, version 7 will be available in the future. 
+    **Note:** Only DIS version 5, 6 and 7 are currently supported. 

 [[img src=VS20085.png]] 
-
-  
-

 ##### IMPORT_KDIS & EXPORT_KDIS

Adding_KDIS_To_A_New/Existing_Project_Manually modified by Karl Jones

Karl Jones — Fri, 27 Jun 2014 12:06:15 -0000

--- v12
+++ v13
@@ -1,7 +1,6 @@
-Note: This guide is a little deprecated now, KDIS now requires certain files to be added/removed depending on the protocol version. I will try to update this page in the future and list the files that are required however I recommend you use Cmake to generate your project and then examine the generated project files if you still want a manually created project. 
+**Note: This guide is a little deprecated now, KDIS now requires certain files to be added/removed depending on the protocol version. I will try to update this page in the future and list the files that are required however I recommend you use Cmake to generate your project and then examine the generated project files if you still want a manually created project.**

-  
-
+****

 [TOC]

Adding_KDIS_To_A_New/Existing_Project_Manually modified by Karl Jones

Karl Jones — Fri, 27 Jun 2014 12:06:14 -0000

--- v11
+++ v12
@@ -1,8 +1,13 @@
+Note: This guide is a little deprecated now, KDIS now requires certain files to be added/removed depending on the protocol version. I will try to update this page in the future and list the files that are required however I recommend you use Cmake to generate your project and then examine the generated project files if you still want a manually created project. 
+
+  
+
+
 [TOC]

 ## Windows - Visual Studio 2008 Express C++

-    Here is how to add KDIS to your Visual Studio project. Although i use Visual Studio 2008 in this guide the steps are exactly the same for Visual Studio 2003/2005/2008/2010. 
+    Here is how to add KDIS to your Visual Studio project. Although I use Visual Studio 2008 in this guide the steps are exactly the same for Visual Studio 2003/2005/2008/2010. 

 ### Add KDIS Files

@@ -135,7 +140,3 @@

     I plan to write a linux guide in the future, for the moment the windows guide should answer most questions. 
     Note: From version **1-15-0** you need to add the rt (librt) library when building KDIS on Linux, this is for the timestamp auto calc feature which uses clock_gettime for a more accurate timestamp. To include the library on gcc adding a -lrt to the link options should do the trick. 
-
-## Windows/Linux - NetBeans C++
-
-COMING SOON

Adding_KDIS_To_A_New/Existing_Project_Manually modified by Karl Jones

Karl Jones — Fri, 27 Jun 2014 12:06:14 -0000

--- v10
+++ v11
@@ -6,7 +6,9 @@

 ### Add KDIS Files

-    First we need to add the KDIS files. We have 2 choices here. 
+    First we need to add the KDIS files. If you are linking against a libary version of KDIS (dll or lib) then this part is optional. 
+
+We have 2 choices here. 

 #### Option 1: The Quick But Messy Way

Adding_KDIS_To_A_New/Existing_Project_Manually modified by Karl Jones

Karl Jones — Fri, 27 Jun 2014 12:06:14 -0000

--- v9
+++ v10
@@ -2,7 +2,7 @@

 ## Windows - Visual Studio 2008 Express C++

-    Here is how to add KDIS to your Visual Studio project. Although i use Visual Studio 2008 in this guide the steps are exactly the same for Visual Studio 2003/2005. 
+    Here is how to add KDIS to your Visual Studio project. Although i use Visual Studio 2008 in this guide the steps are exactly the same for Visual Studio 2003/2005/2008/2010. 

 ### Add KDIS Files

Adding_KDIS_To_A_New/Existing_Project_Manually modified by Karl Jones

Karl Jones — Fri, 27 Jun 2014 12:06:14 -0000

--- v8
+++ v9
@@ -131,7 +131,8 @@

 ## Linux - KDevelop C++

-COMING SOON 
+    I plan to write a linux guide in the future, for the moment the windows guide should answer most questions. 
+    Note: From version **1-15-0** you need to add the rt (librt) library when building KDIS on Linux, this is for the timestamp auto calc feature which uses clock_gettime for a more accurate timestamp. To include the library on gcc adding a -lrt to the link options should do the trick. 

 ## Windows/Linux - NetBeans C++

Adding_KDIS_To_A_New/Existing_Project_Manually modified by Karl Jones

Karl Jones — Fri, 27 Jun 2014 12:06:14 -0000

--- v7
+++ v8
@@ -88,7 +88,7 @@

 [[img src=VS20084.png]] 

-    **Note**: The directory you should add to your project is the directory that contains the directory called KDIS which contains 3 subfolders called DataTypes, Extras and PDU. You may find that this folder is inside of an other folder called KDIS. 
+    **Note**: The directory you should add to your project is the directory that contains the 2 sub directories called KDIS and Examples. 

     We can now include KDIS files without having to add the whole path.

Adding_KDIS_To_A_New/Existing_Project_Manually modified by Karl Jones

Karl Jones — Fri, 27 Jun 2014 12:06:14 -0000

--- v6
+++ v7
@@ -88,10 +88,7 @@

 [[img src=VS20084.png]] 

-    **Note**: The KDIS folder you should add to your project is the folder that contains 3 subfolders called DataTypes, Extras and PDU. You may find that this folder is inside of an other folder called KDIS. 
-
-  
-
+    **Note**: The directory you should add to your project is the directory that contains the directory called KDIS which contains 3 subfolders called DataTypes, Extras and PDU. You may find that this folder is inside of an other folder called KDIS. 

     We can now include KDIS files without having to add the whole path.

Adding_KDIS_To_A_New/Existing_Project_Manually modified by Karl Jones

Karl Jones — Fri, 27 Jun 2014 12:06:14 -0000

--- v5
+++ v6
@@ -88,6 +88,8 @@

 [[img src=VS20084.png]] 

+    **Note**: The KDIS folder you should add to your project is the folder that contains 3 subfolders called DataTypes, Extras and PDU. You may find that this folder is inside of an other folder called KDIS. 
+

Adding_KDIS_To_A_New/Existing_Project_Manually modified by Karl Jones

Karl Jones — Fri, 27 Jun 2014 12:06:13 -0000

--- v4
+++ v5
@@ -2,15 +2,17 @@

 ## Windows - Visual Studio 2008 Express C++

-Here is how to add KDIS to your Visual Studio project. Although i use Visual Studio 2008 in this guide the steps are exactly the same for Visual Studio 2003/2005. 
+    Here is how to add KDIS to your Visual Studio project. Although i use Visual Studio 2008 in this guide the steps are exactly the same for Visual Studio 2003/2005. 

 ### Add KDIS Files

-First we need to add the KDIS files. We have 2 choices here. 
+    First we need to add the KDIS files. We have 2 choices here. 

 #### Option 1: The Quick But Messy Way

-If you have extracted the KDIS zip file you should have a folder structure like this: 
+    If you have extracted the KDIS zip file you should have a folder structure like this: 
+
+    

   * KDIS_vx-x-x 
     * KDIS 
@@ -19,82 +21,95 @@

-Drag the KDIS folder into your Visual Studio project side bar. 
+    Drag the KDIS folder into your Visual Studio project side bar. 

 [[img src=VS20081.png]] 

-When we drag the folder into Visual Studio it extracts all *.h and *.cpp files for us and places them into _Source_ and _Header_ folders. If you are planning on building against a .lib version of KDIS you can delete the _Source_ folder. This approach is quick but what if we want to maintain the KDIS folder hierarchy? 
+
+
+    When we drag the folder into Visual Studio it extracts all *.h and *.cpp files for us and places them into _Source_ and _Header_ folders. If you are planning on building against a .lib version of KDIS you can delete the _Source_ folder. 
+
+    This approach is quick but what if we want to maintain the KDIS folder hierarchy? 

 #### Option 2: The Slightly Longer But Neater Way

-In this approach we want to maintain the KDIS folder hierarchy, I recommend doing this as it will make things much easier to find when you start using KDIS. 
+    In this approach we want to maintain the KDIS folder hierarchy, I recommend doing this as it will make things much easier to find when you start using KDIS. 

-First we want to create the folder hierarchy. 
+    First we want to create the folder hierarchy. 

-Right click on the visual studio project in the solutions explorer and choose Add -> New Filter 
+    Right click on the visual studio project in the solutions explorer and choose Add -> New Filter 

-Call the filter _KDIS_. 
+    Call the filter _KDIS_. 

-Now right click on the KDIS filter/folder that you just created and create a new filter, call this one _DataTypes_. Repeat this until you have the whole folder hierarchy. 
+    Now right click on the KDIS filter/folder that you just created and create a new filter, call this one _DataTypes_. 
+
+    Repeat this until you have the whole folder hierarchy. 

 [[img src=VS20082.png]] 

-We now need to add the files to the folders. 

-Right click on the filter/folder _KDIS_ and select Add -> Existing Item 

-Navigate to the KDIS folder and select the files that are in the root. 
+    We now need to add the files to the folders. 
+
+    Right click on the filter/folder _KDIS_ and select Add -> Existing Item 
+
+    Navigate to the KDIS folder and select the files that are in the root. 

 [[img src=VS20083.png]] 

-Now right click on the filter/folder DataTypes and add all the .cpp/.h files. Repeat this for all the filters/folders we created. 

-**Note** If you are planning on building againt a .lib version of KDIS you dont need to include the cpp files. 
+
+    Now right click on the filter/folder DataTypes and add all the .cpp/.h files. 
+    Repeat this for all the filters/folders we created. 
+
+    **Note** If you are planning on building againt a .lib version of KDIS you dont need to include the cpp files. 

 ### Project Settings

 #### Additional Include Directories

-KDIS should now compile but with many messages/warnings. 
+    KDIS should now compile but with many messages/warnings. 

-We need to make a few more changes to our project. 
+    We need to make a few more changes to our project. 

-First we should add the KDIS folder to the projects _Additional Include Directories_. 
+    First we should add the KDIS folder to the projects _Additional Include Directories_. 

-Project -> Properties(Alt + F7) 
+    Project -> Properties(Alt + F7) 

 [[img src=VS20084.png]] 

-We can now include KDIS files without having to add the whole path. 

-E.G 

-#include "KDIS/KDataStream.h" 
+    We can now include KDIS files without having to add the whole path. 
+
+    E.G 
+
+    #include "KDIS/KDataStream.h" 

 #### Preprocessor Definitions

-We now need to define our _Preprocessor Definitions_
+    We now need to define our _Preprocessor Definitions_

 ##### DIS_VERSION=X

-We should tell KDIS what version of DIS we want to support. 
+    We should tell KDIS what version of DIS we want to support. 

-E.G 
+    E.G 

-DIS_VERSION=6 
+    DIS_VERSION=6 

-**Note:** Only DIS version 5 and 6 are currently supported, version 7 will be available in the future. 
+    **Note:** Only DIS version 5 and 6 are currently supported, version 7 will be available in the future. 

 [[img src=VS20085.png]] 
@@ -104,13 +119,16 @@

 ##### IMPORT_KDIS & EXPORT_KDIS

-If you plan to use KDIS as a .dll then define IMPORT_KDIS in the _Preprocessor Definitions_. If you want to build KDIS into a .dll then define EXPORT_KDIS. 
+    If you plan to use KDIS as a .dll then define IMPORT_KDIS in the _Preprocessor Definitions_. 

-**Note:** Do not define both EXPORT_KDIS and IMPORT_KDIS in the same project, this will cause an error. 
+    If you want to build KDIS into a .dll then define EXPORT_KDIS. 
+
+    **Note:** Do not define both EXPORT_KDIS and IMPORT_KDIS in the same project, this will cause an error. 

 ##### KDIS_USE_ENUM_DESCRIPTORS

-This will enable Enum Descriptors in your project. You can read more about them [ here.](Converting_Enumerations_Into_Their_String_Values_Tutorial_) 
+    This will enable Enum Descriptors in your project. 
+    You can read more about them [ here.](Converting_Enumerations_Into_Their_String_Values_Tutorial_) 

 ## Linux - KDevelop C++