Merge branch 'master' of https://github.com/20tab/UnrealEnginePython

Author: Roberto De Ioris

tutorials/PlottingGraphsWithMatplotlibAndUnrealEnginePython.md

@@ -1,8 +1,21 @@
 # Plotting Graphs with Matplotlib and Unreal Engine Python
 
+In this tutorial we will see how to use third party python modules in your Unreal Engine projects.
+
+The module of choice is 'matplotlib' https://matplotlib.org/.
+
+From the official site:
+
+>Matplotlib is a Python 2D plotting library which produces publication quality figures in a variety of hardcopy formats and interactive environments across platforms. Matplotlib can be used in Python scripts, the Python and IPython shell, the jupyter notebook, web application servers, and four graphical user interface toolkits.
+
+So our objective will be plotting graphs into Unreal Engine textures asset, both in the editor (to pre-generate assets) and during gameplay (to dynamically update texture-graph data)
 
 ## Creating the project
 
+First step is obviously creating a new project.
+
+We will use the third person template
+
 ![ThirdPerson Template](https://github.com/20tab/UnrealEnginePython/blob/master/tutorials/PlottingGraphsWithMatplotlibAndUnrealEnginePython_Assets/third_person.png)
 
 ## Installing the Python plugin
@@ -60,6 +73,30 @@ ue.open_editor_for_asset(texture)
 
 ## Our project: Plotting a Pie chart tracking overlap events
 
+Our objective is to have a special blueprint in our level exposing 3 cube in 3 different colors.
+
+Whenever you overlap one of the cubes with your character, their internal counter is incremented.
+
+A pie chart "carpet" is on the floor, and it is updated with overlap-counters data (the more you overlap a cube, the bigger will be its slice in the chart)
+
+### Setting up materials
+
+We need 4 materials and 1 material instance for the project:
+
+* a completely red material (just link a constant vector3 to base color)
+
+* a completely green material
+
+* a completely blue material
+
+* a material with a texture parameter linked to base color
+
+* an instance of the previous material exoosing the texture parameter (so it can be updated at runtime)
+
+### The "pie chart carpet" blueprint
+
+
+
 ```python
 import unreal_engine as ue
 from unreal_engine.enums import EPixelFormat
@@ -95,3 +132,69 @@ class PlotComponent:
         self.fig.canvas.draw()
         self.texture.texture_set_data(self.fig.canvas.buffer_rgba())
 ```
+
+### The "Plotter Platforms"
+
+### Playing it
+
+### Writing a simple unit test
+
+Sorry, i will never stop telling you how important unit tests are, so, even if we have deloped a really simple script, we will write a unit test too :)
+
+We need to test that when a 'ComponentOverlap' event is triggered on a cube, the right counter is incremented:
+
+```python
+import unittest
+import unreal_engine as ue
+from unreal_engine.classes import Blueprint
+
+class TestPlotterPlatform(unittest.TestCase):
+
+    def setUp(self):
+        ue.allow_actor_script_execution_in_editor(True)
+        ue.begin_transaction('test')
+        self.world = ue.get_editor_world()
+        self.blueprint = ue.load_object(Blueprint, '/Game/PlotterPlatforms.PlotterPlatforms')
+
+    def tearDown(self):
+        ue.end_transaction()
+        ue.editor_undo()
+        ue.allow_actor_script_execution_in_editor(False)
+
+    def test_red_cube_overlap(self):
+        actor = self.world.actor_spawn(self.blueprint.GeneratedClass)
+        self.assertEqual(actor.RedCubeCounter, 0)
+        actor.RedCube.broadcast('OnComponentBeginOverlap')
+        self.assertEqual(actor.RedCubeCounter, 1)
+        self.assertEqual(actor.GreenCubeCounter, 0)
+        self.assertEqual(actor.BlueCubeCounter, 0)
+
+    def test_green_cube_overlap(self):
+        actor = self.world.actor_spawn(self.blueprint.GeneratedClass)
+        self.assertEqual(actor.GreenCubeCounter, 0)
+        actor.GreenCube.broadcast('OnComponentBeginOverlap')
+        self.assertEqual(actor.RedCubeCounter, 0)
+        self.assertEqual(actor.GreenCubeCounter, 1)
+        self.assertEqual(actor.BlueCubeCounter, 0)
+
+    def test_blue_cube_overlap(self):
+        actor = self.world.actor_spawn(self.blueprint.GeneratedClass)
+        self.assertEqual(actor.BlueCubeCounter, 0)
+        actor.BlueCube.broadcast('OnComponentBeginOverlap')
+        self.assertEqual(actor.RedCubeCounter, 0)
+        self.assertEqual(actor.GreenCubeCounter, 0)
+        self.assertEqual(actor.BlueCubeCounter, 1)
+
+if __name__ == '__main__':
+    unittest.main(exit=False)
+```
+
+You can run the unit test with:
+
+```python
+ue.sandbox_exec('test_plotter_platforms.py')
+```
+
+the 'sanbox' execution, ensures a clean python subinterpeter is initialized, instead of clobberign the main one.
+
+Check how the test setUp and tearDown methods, ensure your world is cleaned up at the end (using the transaction api of unreal engine: https://github.com/20tab/UnrealEnginePython/blob/master/docs/Transactions_API.md) 

tutorials/PlottingGraphsWithMatplotlibAndUnrealEnginePython_Assets/test_plotter_platforms.py

@@ -0,0 +1,43 @@
+import unittest
+import unreal_engine as ue
+from unreal_engine.classes import Blueprint
+
+class TestPlotterPlatform(unittest.TestCase):
+
+    def setUp(self):
+        ue.allow_actor_script_execution_in_editor(True)
+        ue.begin_transaction('test')
+        self.world = ue.get_editor_world()
+        self.blueprint = ue.load_object(Blueprint, '/Game/PlotterPlatforms.PlotterPlatforms')
+
+    def tearDown(self):
+        ue.end_transaction()
+        ue.editor_undo()
+        ue.allow_actor_script_execution_in_editor(False)
+
+    def test_red_cube_overlap(self):
+        actor = self.world.actor_spawn(self.blueprint.GeneratedClass)
+        self.assertEqual(actor.RedCubeCounter, 0)
+        actor.RedCube.broadcast('OnComponentBeginOverlap')
+        self.assertEqual(actor.RedCubeCounter, 1)
+        self.assertEqual(actor.GreenCubeCounter, 0)
+        self.assertEqual(actor.BlueCubeCounter, 0)
+
+    def test_green_cube_overlap(self):
+        actor = self.world.actor_spawn(self.blueprint.GeneratedClass)
+        self.assertEqual(actor.GreenCubeCounter, 0)
+        actor.GreenCube.broadcast('OnComponentBeginOverlap')
+        self.assertEqual(actor.RedCubeCounter, 0)
+        self.assertEqual(actor.GreenCubeCounter, 1)
+        self.assertEqual(actor.BlueCubeCounter, 0)
+
+    def test_blue_cube_overlap(self):
+        actor = self.world.actor_spawn(self.blueprint.GeneratedClass)
+        self.assertEqual(actor.BlueCubeCounter, 0)
+        actor.BlueCube.broadcast('OnComponentBeginOverlap')
+        self.assertEqual(actor.RedCubeCounter, 0)
+        self.assertEqual(actor.GreenCubeCounter, 0)
+        self.assertEqual(actor.BlueCubeCounter, 1)
+
+if __name__ == '__main__':
+    unittest.main(exit=False)