CameraStackService provides a camera stack of objects that can report a camera state. This allows a composable camera system for a variety of situations that arise, and lets systems interop with each other
npm install @quenty/camera --save
- Minor VR support
- Support for composable camera types
- Support for interpolation between camera nodes
- Support for touch and gamepad support and controls
- Support for camera shake
CameraState is an immutable camera system used for camera interpolation. Designed to make camera effects easy, it trades some efficiency and speed for making a not confusing camera system.
Camera state stores internal state of Coordinate frames as quaternions. This means that the classic lerp equation. Operations have been overridden to make this easier to work with.
Ok. It's not entirely immutable. They are kind of lazy, that is, reading data doesn't affect the state of them. There are no required update loops or anything for the most part.
Camera effect API
Current Camera Effects have the following API available. Adding new effects means that these two should follow the same API specifications
Returns a new Summed camera and adds the two effects together. This is used for combining effects
Indexing the CameraEffect should return the current camera state. This means that state is easy to index.
In previous versions, the following will also work. However, this is no longer true.
This will return a
!!! warning Note that eventually we plan to deprecate everything but .CameraState
This class tracks the current camera ROBLOX uses and lets it maintain how it operates using a
- Should call
- Only one should exist at once per client (not enforced in code, however)
This class takes two arguments and returns the summation of the two
- Arguments can be either
CameraStateor a CameraEffect, assuming the effect has a
This classes allows the effects of a camera to be faded / varied based upon a spring
- Starts at 0 percent effect
Here is sample usage of using just a subcomponent. Recommendation is to use full camera stack service.
local RunService = game:GetService("RunService") local Workspace = game:GetService("Workspace") local FadeBetweenCamera3 = require(modules.FadeBetweenCamera3) local CustomCameraEffect = require(modules.CustomCameraEffect) local CameraState = require(modules.CameraState) local defaultCamera = require(modules.DefaultCamera).new() defaultCamera:BindToRenderStep() -- capture roblox camera automatically local targetCamera = CustomCameraEffect.new(function() local target = CameraState.new() target.CFrame = CFrame.new(0, 100, 0) target.FieldOfView = 70 return target end) local faded = FadeBetweenCamera3.new(defaultCamera, targetCamera) faded.Speed = 5 RunService:BindToRenderStep("CameraStackUpdateInternal", Enum.RenderPriority.Camera.Value + 75, function() faded.CameraState:Set(Workspace.CurrentCamera) end) -- Input local mouse = game.Players.LocalPlayer:GetMouse() local visible = false mouse.Button1Down:Connect(function() visible = not visible if visible then faded.Target = 1 else faded.Target = 0 end end)