UPBGE: Implement physics and logic object activity culling.

The activity culling helps to disable the physics or logic
of an object depending of its distance to the nearest camera.

From user side options were added in both UI and python API
to control this feature. In UI the activity culling is put
in three level, scene, camera, object. The two first level
are enabled as default and the last disabled. Also the object
panel expose option to enabled physics or logic culling with
a different radius.
In python the attribute activityCulling is added to these
three levels and KX_GameObject receive four attributes to
enabled physics and logic culling and controlling their
radius.

In internal sources the activity culling info are stored into
KX_GameObject::ActivityCullingInfo which is owned by in
KX_GameObject::m_activityCullingInfo.

To suspend logic we suspend from SCA_IObject calling Suspend
and Resume but in the same time we need to suspend animation
as they are independant of logic and that it will be hard
to control them when the object doesn't run its logic.
To do so BL_ActionManager implement a suspend flag which disallow
any task creation in KX_Scene::UpdateAnimations.

Thanks for youle's work on this.

Author: youle31

doc/python_api/rst/bge_types/bge.types.KX_Camera.rst

@@ -83,6 +83,12 @@ base class --- :class:`KX_GameObject`
 
       :type: boolean
 
+   .. attribute:: activityCulling
+
+      True if this camera is used to compute object distance for object activity culling.
+
+      :type: boolean
+
    .. attribute:: projection_matrix
 
       This camera's 4x4 projection matrix.

doc/python_api/rst/bge_types/bge.types.KX_GameObject.rst

@@ -300,6 +300,32 @@ base class --- :class:`SCA_IObject`
 
       :type: boolean
 
+   .. attribute:: physicsCulling
+
+      True if the object suspends its physics depending on its nearest distance to any camera.
+
+      :type: boolean
+
+   .. attribute:: logicCulling
+
+      True if the object suspends its logic and animation depending on its nearest distance to any camera.
+
+      :type: boolean
+
+   .. attribute:: physicsCullingRadius
+
+      Suspend object's physics if this radius is smaller than its nearest distance to any camera
+      and :data:`physicsCulling` set to `True`.
+
+      :type: float
+
+   .. attribute:: logicCullingRadius
+
+      Suspend object's logic and animation if this radius is smaller than its nearest distance to any camera
+      and :data:`logicCulling` set to `True`.
+
+      :type: float
+
    .. attribute:: position
 
       The object's position. [x, y, z] On write: local position, on read: world position

doc/python_api/rst/bge_types/bge.types.KX_Scene.rst

@@ -113,18 +113,12 @@ base class --- :class:`EXP_PyObjectPlus`
 
       :type: boolean
 
-   .. attribute:: activity_culling
+   .. attribute:: activityCulling
 
-      True if the scene is activity culling.
+      True if the scene allow object activity culling.
 
       :type: boolean
 
-   .. attribute:: activity_culling_radius
-
-      The distance outside which to do activity culling. Measured in manhattan distance.
-
-      :type: float
-
    .. attribute:: dbvt_culling
 
       True when Dynamic Bounding box Volume Tree is set (read-only).

release/datafiles/locale

@@ -151,8 +151,8 @@ def draw(self, context):
         col.prop(cam, "lod_factor", text="Distance Factor")
 
 
-class DATA_PT_frustum_culling(CameraButtonsPanel, Panel):
-    bl_label = "Frustum Culling"
+class DATA_PT_culling(CameraButtonsPanel, Panel):
+    bl_label = "Culling"
     COMPAT_ENGINES = {'BLENDER_GAME'}
 
     @classmethod
@@ -163,9 +163,16 @@ def draw(self, context):
         layout = self.layout
         cam = context.camera
 
-        row = layout.row()
-        row.prop(cam, "show_frustum")
-        row.prop(cam, "override_culling")
+        split = layout.split()
+
+        col = split.column()
+        col.label(text="Frustum Culling:")
+        col.prop(cam, "show_frustum")
+        col.prop(cam, "override_culling")
+
+        col = split.column()
+        col.label(text="Object Activity:")
+        col.prop(cam, "use_object_activity_culling")
 
 
 class DATA_PT_camera_stereoscopy(CameraButtonsPanel, Panel):
@@ -365,7 +372,7 @@ def draw_display_safe_settings(layout, safe_data, settings):
     DATA_PT_lens,
     DATA_PT_camera,
     DATA_PT_levels_of_detail,
-    DATA_PT_frustum_culling,
+    DATA_PT_culling,
     DATA_PT_camera_stereoscopy,
     DATA_PT_camera_dof,
     DATA_PT_camera_display,

release/scripts/addons

@@ -526,12 +526,19 @@ def draw(self, context):
             sub = col.row()
             sub.prop(gs, "deactivation_time", text="Time")
 
-            col = layout.column()
+            split = layout.split()
+
+            col = split.column()
+            col.label(text="Culling:")
             col.prop(gs, "use_occlusion_culling", text="Occlusion Culling")
             sub = col.column()
             sub.active = gs.use_occlusion_culling
             sub.prop(gs, "occlusion_culling_resolution", text="Resolution")
 
+            col = split.column()
+            col.label(text="Object Activity:")
+            col.prop(gs, "use_activity_culling")
+
         else:
             split = layout.split()
 
@@ -901,6 +908,33 @@ def draw(self, context):
         layout.label(text="Predefined Bound:")
         layout.prop(game, "predefined_bound", "")
 
+class OBJECT_PT_activity_culling(ObjectButtonsPanel, Panel):
+    bl_label = "Activity Culling"
+    COMPAT_ENGINES = {'BLENDER_GAME'}
+
+    @classmethod
+    def poll(cls, context):
+        ob = context.object
+        return context.scene.render.engine in cls.COMPAT_ENGINES and ob.type not in {'CAMERA'}
+
+    def draw(self, context):
+        layout = self.layout
+        activity = context.object.game.activity_culling
+
+        split = layout.split()
+
+        col = split.column()
+        col.prop(activity, "use_physics", text="Physics")
+        sub = col.column()
+        sub.active = activity.use_physics
+        sub.prop(activity, "physics_radius")
+
+        col = split.column()
+        col.prop(activity, "use_logic", text="Logic")
+        sub = col.column()
+        sub.active = activity.use_logic
+        sub.prop(activity, "logic_radius")
+
 class OBJECT_PT_levels_of_detail(ObjectButtonsPanel, Panel):
     bl_label = "Levels of Detail"
     COMPAT_ENGINES = {'BLENDER_GAME'}
@@ -968,6 +1002,7 @@ def draw(self, context):
     DATA_PT_shadow_game,
     OBJECT_MT_lod_tools,
     OBJECT_MT_culling,
+    OBJECT_PT_activity_culling,
     OBJECT_PT_levels_of_detail,
 )
 

release/scripts/startup/bl_ui/properties_data_camera.py

@@ -71,6 +71,7 @@ void BKE_camera_init(Camera *cam)
 	cam->drawsize = 0.5f;
 	cam->ortho_scale = 6.0;
 	cam->flag |= CAM_SHOWPASSEPARTOUT;
+	cam->gameflag = GAME_CAM_OBJECT_ACTIVITY_CULLING;
 	cam->passepartalpha = 0.5f;
 	cam->lodfactor = 1.0f;
 

release/scripts/startup/bl_ui/properties_game.py

@@ -784,7 +784,7 @@ void BKE_scene_init(Scene *sce)
 
 	sce->gm.gravity = 9.8f;
 	sce->gm.physicsEngine = WOPHY_BULLET;
-	sce->gm.mode = 32; //XXX ugly harcoding, still not sure we should drop mode. 32 == 1 << 5 == use_occlusion_culling 
+	sce->gm.mode = WO_ACTIVITY_CULLING | WO_DBVT_CULLING;
 	sce->gm.occlusionRes = 128;
 	sce->gm.ticrate = 60;
 	sce->gm.maxlogicstep = 5;

source/blender/blenkernel/intern/camera.c

@@ -45,6 +45,7 @@
 #include "DNA_screen_types.h"
 #include "DNA_mesh_types.h"
 #include "DNA_material_types.h"
+#include "DNA_world_types.h"
 
 #include "BKE_main.h"
 
@@ -253,4 +254,14 @@ void blo_do_versions_upbge(FileData *fd, Library *lib, Main *main)
 			}
 		}
 	}
+
+	if (!MAIN_VERSION_UPBGE_ATLEAST(main, 2, 2)) {
+		for (Scene *scene = main->scene.first; scene; scene = scene->id.next) {
+			scene->gm.mode |= WO_ACTIVITY_CULLING;
+		}
+
+		for (Camera *camera = main->camera.first; camera; camera = camera->id.next) {
+			camera->gameflag |= GAME_CAM_OBJECT_ACTIVITY_CULLING;
+		}
+	}
 }