Method _zoneInsert

Engine/source/scene/zones/sceneZoneSpaceManager.cpp:599–676

//-----------------------------------------------------------------------------

void SceneZoneSpaceManager::_zoneInsert( SceneObject* object, bool queryListInitialized ) 
{
   PROFILE_SCOPE( SceneZoneSpaceManager_zoneInsert );

   AssertFatal( object->mNumCurrZones == 0, "SceneZoneSpaceManager::_zoneInsert - Object already in zone list" );
   AssertFatal( object->getContainer() != NULL, "SceneZoneSpaceManager::_zoneInsert - Object must be in scene" );
   AssertFatal( !dynamic_cast< SceneRootZone* >( object ), "SceneZoneSpaceManager::_zoneInsert - Must not be called on SceneRootZone" );

   // If all we have is a single zone in the scene, then it must
   // be the outdoor zone.  Simply assign the object to it.  Also do this
   // if the object has global bounds on since we always assign these to
   // just the outdoor zone.  Finally, also do it for all object types that
   // we want to restrict to the outdoor zone.

   if( mNumActiveZones == 1 || object->isGlobalBounds() || object->getTypeMask() & OUTDOOR_OBJECT_TYPEMASK )
      _addToOutdoorZone( object );
   else
   {
      // Otherwise find all zones spaces that intersect with the object's
      // world box.

      if( !queryListInitialized )
         _queryZoneSpaces( object->getWorldBox() );

      // Go through the zone spaces and link all zones that the object
      // overlaps.

      bool outsideIncluded = true;
      const U32 numZoneSpaces = mZoneSpacesQueryList.size();
      for( U32 i = 0; i < numZoneSpaces; ++ i )
      {
         SceneZoneSpace* zoneSpace = dynamic_cast< SceneZoneSpace* >( mZoneSpacesQueryList[ i ] );
         if( !zoneSpace )
            continue;

         AssertFatal( zoneSpace != getRootZone(), "SceneZoneSpaceManager::_zoneInsert - SceneRootZone returned by zone space query" );

         // If we are inserting a zone space, then the query will turn up
         // the object itself at some point.  Skip it.

         if( zoneSpace == object )
            continue;

         // Find the zones that the object overlaps within
         // the zone space.

         U32 numZones = 0;
         U32 zones[ SceneObject::MaxObjectZones ];

         bool overlapsOutside = zoneSpace->getOverlappingZones( object, zones, numZones );
         AssertFatal( numZones != 0 || overlapsOutside,
            "SceneZoneSpaceManager::_zoneInsert - Object must be fully contained in one or more zones or intersect the outside zone" );

         outsideIncluded &= overlapsOutside; // Only include outside if *none* of the zones fully contains the object.

         // Link the object to the zones.

         for( U32 n = 0; n < numZones; ++ n )