[DEPRECATED] CalcView Priority System

C.V.P.S.

CVPS is a library/system that allows you to create CalcView hook camera manipulation mods without every camera mod breaking the other one, while also allowing you to have Layered CalcViews on top of the highest priority "Base" CalcView. (Useful for viewbob, breathing, etc.)

This is achieved by running only the highest priority CalcView hook and then adding to it the returned data from all the "Layered" ones.

The point of this library is to allow devs to create camera mods that do not interfere with each other in jarring ways.

For Developers

The library is contained inside a global table named "CalcViewPS" and runs a hook called "CalcViewPS_Initialized" when it has loaded.

[b]ENUMs[/b]
CalcViewPS.PerspectiveENUM = {
    FIRSTPERSON = 1,
    THIRDPERSON = 2,
    TOPDOWN = 3,
    ISOMETRIC = 4,
    OTHER = 5
}

[b]Argument Explanations[/b]
name - Unique string ID for the hook

func - The function to be ran if the hook is of the highest priority, or is a layered hook. Works like normal CalcView, function must return a table like a normal CalcView hook would.
In the case of the hook being layered, the hook should not be layering the returned values on top of the provided base position, angles and FOV. The library already takes care of the layering.

priority - The priority number the hook should have. The higher it is, the bigger the chance it will be the "camera" that is running. Value is clamped to be between -100000 and 100000

perspective - The perspective ENUM for the hook. Layered hooks will only be applied if they have the same perspective ENUM as the current running Base hook. This can be one of the ENUMs above or a number.

[b]Functions[/b]
CalcViewPS.Add(name, func, priority, perspective) - Adds a "Base" hook to the queue with the specified priority.

CalcViewPS.AddToTop(name, func, perspective) - Adds a "Base" hook to the queue above the current highest priority hook. (Priority 9000 if one does not exist.)

CalcViewPS.AddToBottom(name, func, perspective) - Adds a "Base" hook to the queue below the current lowest priority hook. (Priority -9000 if one does not exist.)

CalcViewPS.AddLayered(name, func, perspective) - Adds a "Layered" hook to the table, which will be layered on top of the current running "Base" hook.

CalcViewPS.Remove(name) - Removes "Base" hook with the specified id from the queue

CalcViewPS.RemoveLayered(name) - Removes "Layered" hook with the specified id from the layered hooks table.

CalcViewPS.GetLowestPriority() - Returns the lowest priority number that is present in the current "Base" hook queue.

CalcViewPS.GetLowestPriorityHook() - Returns the table of the lowest priority "Base" hook in the queue. Returns nil if no hooks exist.

CalcViewPS.GetHighestPriority() - Returns the highest priority number that is present in the current "Base" hook queue.

CalcViewPS.GetLowestPriority() - Returns the table of the highest priority "Base" hook in the queue. Returns nil if no hooks exist.