LibFrameRecycler makes it easy to create frames and recycle them for re-use later. If you need to recreate frames on a regular basis, this library will make it easier to recycle the frames you create so that you don't stress the Rift API by creating and throwing away lots of frames.

Usage is quite simple:

-- Create a frame:
local frame = Library.LibFrameRecycler.CreateFrame(frameType, namePrefix, parent)

-- Recycle a frame:
Library.LibFrameRecycler.RecycleFrame(frame)

Recycling a frame will recycle all its child frames as well. So if you don't want that to happen, you must reparent the child frames, using frame:SetParent(newParent), before recycling the parent frame. Recycling a frame which was not created using the library's CreateFrame function will do nothing to that frame, but will try to recycle its children.

Once a frame has been recycled, if you call CreateFrame with the same frame type, it will reuse the recycled frame. Parent, all anchor points, width and height are cleared. Visibility, layer, strata, background color, mouse masking, mouseover unit, secure mode, font color, font size, text, enabled, skin, checked, orientation, range, position, thickness, selection, controller are reset to default values. Extra table members are removed.

If you want to see debug output of when new frames are created, frames are recycled and recycled frames are reused, turn on the library's debug flag:

Library.LibFrameRecycler.debug = true