godot-lportal/README.md

godot-lportal

Portal rendering module for Godot Work in progress, not yet fully functional

Current status

Refactoring LRooms and LPortals outside the scene graph (they will be lists on LRoomManager). This is both for optimization purposes and to make it easier to store fast data on the nodes, instead of using Object metadata.

Roadmap

• Auto conversion of named room spatials and portal mesh instances to LRoom and LPortal DONE
• Auto creation of mirror portals DONE
• Recursive determine visibility DONE
• Prevent memory allocations (use pools for plane vectors) DONE
• Add support for objects moving between rooms - cameras, players, physics etc - DONE
• Refactor code, moving LRooms and LPortals outside scene graph
• Handle special cases (multiple portals views into room etc)
• Cleanup code, Optimize
• Investigate multiple passes (shadows, lights)

Instructions

This is all subject to change, but to give a rough idea of the current process:

• Make a list of spatials for each room under a parent spatial (which will become the room manager)
• Name the rooms 'room_kitchen', where kitchen is your room name
• Place your objects within the room as children of the room
• Also place portals inside the rooms
• Portals should be MeshInstances, and convex polygons (e.g. you can create a plane and move it into position for a door)
• Portals should be named 'portal_hall', where hall is the name of the room the portal should link to
• Portals only need to be made in one of the adjoining rooms, the system will automatically create the mirror image portal

Once this structure is set up in the scene graph:

• Convert the parent of the rooms to an LRoomManager node
• At game / level start, call 'rooms_convert' method on the LRoomManager. This will convert room and portal spatials to LRooms and LPortals, and make portals 2 way.
• Call 'rooms_set_camera()' on LRoomManager to set which camera is used for visibility determination (this is useful for debugging)

Dynamic objects (DOBs) like players, boxes etc are handled slightly differently. You currently can maintain them outside the roomlist, but instead of adding them to the rooms directly, you call:

• void register_dob(Node * pDOB); to register with room system, so the DOB will be culled as part of the system. This will automatically move the DOB between rooms when it crosses portals.