Rendering
Where: Rendering/ — subprojects GfxBase, GfxCore, GfxRender, RbxG3D, g3d,
AppDraw, ShaderCompiler, plus VR SDKs LibOVR, OpenVR, VrApi.
Rendering is layered: a thin device abstraction at the bottom, scene rendering in the middle, engine draw code at the top.
GfxBase — the engine-side foundation
Rendering/GfxBase/: types the engine talks to, independent of the actual graphics API.
| File | Role |
|---|---|
ViewBase.cpp | Base view — render job inputs (viewport, camera) |
Adorn.cpp, AdornSurface.cpp, AdornBillboarder.cpp, AdornBillboarder2D.cpp, ViewportBillboarder.cpp | The adornment system — wireframes, selection boxes, billboards, 2D overlays |
IAdornableCollector.cpp | Collects adornables for a frame |
GfxPart.cpp | Renderable part proxy |
RenderCaps.cpp | Hardware capability detection |
RenderSettings.cpp, RenderStats.cpp | Quality settings & frame statistics |
FrameRateManager.cpp | FPS throttling/management |
FileMeshData.cpp | Mesh data loading |
PartIdentifier.cpp | Per-part identification for batching |
GfxCore — the device layer
Rendering/GfxCore/ wraps the actual graphics APIs behind one interface:
Device.cpp,DeviceCreate.cpp— device creation & management- Backend implementations in
D3D9/,D3D11/andGL/(withnglewfor the OpenGL extension wrangler) Texture.cpp,Shader.cpp,Geometry.cpp,Framebuffer.cpp,States.cpp,Resource.cpp— resources of each type, per backendpix.cpp— PIX profiling instrumentation hooks (DirectX)
Per the README: the D3D9 path works (a suspected text-render bug turned out to never have existed), while D3D11 does not initialize yet. Modern backends (D3D12/Vulkan) are on the roadmap. OpenGL is the Unix/mobile path.
GfxRender — the scene renderer
Rendering/GfxRender/ turns the DataModel into draw calls:
CullableSceneNode.cpp— culling hierarchyFastCluster.cpp— the part-cluster fast path (terrain/many parts)GeometryGenerator.cpp— procedural geometry (wedges, cylinders…)- Particle/effect emitters:
Emitter.cpp,CustomEmitter.cpp,ExplosionEmitter.cpp EnvMap.cpp— environment/sky reflection mappingAdornRender.cpp— renders the adornment stream
Post-processing
Screen-space post effects live in SceneManager.cpp (an internal Blur and ImageProcess
pass built on ScreenSpaceEffect::renderBlur and the Blur3FS/Blur5FS/Blur7FS +
ImageProcessFS shaders in shaders/source/screenspace.hlsl), driven per frame through
SceneManager::setPostProcess(...).
The user-facing API is the PostEffect hierarchy in App/v8datamodel/PostEffect.h
(PostEffect is the abstract base with Enabled; BlurEffect adds Size, a blur radius
of 0–56 px, default 24). Each frame RenderView::presetPostProcess resolves the active
blur: among the enabled BlurEffects parented to Lighting (applies to everyone) or to
Workspace.CurrentCamera (local only), only one is applied — the greatest Size wins.
On Durango the legacy PlatformService.BlurIntensity (plus its brightness/contrast/
grayscale/tint image processing) is combined with max() so the Xbox app shell keeps
working. The blur is applied to the rendered 3D image before 2D GUI is drawn, so
GuiObjects stay sharp; large sizes iterate the separable Gaussian blur (variances add)
since a single shader kernel only covers ±15 px. Note the blur shaders are excluded from
the glsles (OpenGL ES 2.0) shader pack (shaders/shaders.json), so on those low-end
devices BlurEffect is gracefully inert.
RbxG3D and g3d
Rendering/g3d/ is G3D (Grimshaw's Graphics3D), the graphics math/scene library the 2010s
engine leaned on (vectors, matrices, G3DCore.h compatibility in App/util).
Rendering/RbxG3D/ is the Roblox integration layer on top of it. (The graphics3D and
RbxG3D projects are both on the "builds" list.)
AppDraw — engine → renderer glue
Rendering/AppDraw/ (Draw.cpp, DrawAdorn.cpp, HitTest.cpp, headers in include/)
implements how engine primitives actually get drawn and picked. This is where part visuals,
selection highlights and mouse hit-testing meet.
Shaders
Shader sources live in shaders/ at the repo root and are compiled with the scripts
buildshaders.bat (Windows) / buildshaders.sh (Unix) through the
Rendering/ShaderCompiler/ project (glsl-optimizer / hlsl2glsl in Library/ translate HLSL
sources to GLSL for the OpenGL path). See Content.
VR
Rendering/LibOVR/ (Oculus PC SDK), Rendering/OpenVR/ (Valve) and Rendering/VrApi/
(GearVR/mobile) expose headset rendering and tracking of the era.
Frame pacing
Rendering runs as RenderJobs on the TaskScheduler
(BaseRenderJob.cpp in App/v8datamodel/, client-side render job in
WindowsClient/RenderJob.cpp), coordinated with FrameRateManager and the cyclic executive.