Modern GMod FX

Signature rules

x, y, w, h values are active-frame local pixels. Optional stroke always means fill, stroke, strokeWidth. Advanced calls copy and normalize style records, so keep caller-owned tables mutable on your side only.

• Name(...)compact helper for common draw paths
• NameEx(..., style)table API for effects, per-corner values, masks, and patterns
• nilomit optional paint, stroke, or effect fields cleanly

Frame scope

Call StartPanel / EndPanel inside panel paint, or StartScreen / EndScreen inside HUD paint. Shapes draw immediately; text commands are recorded and flushed at the frame end.

function PANEL:Paint(w, h)
    MGFX.StartPanel(self, w, h)
    MGFX.RoundedBoxEx(0, 0, w, h, {
        radius = 10,
        fill = Color(20, 24, 32, 230),
    })
    MGFX.Text("Loadout", "DermaLarge", 16, 14, color_white)
    MGFX.EndPanel()
end

Primitive styles

Use RoundedBoxEx, ChamferBoxEx, LineEx, and shape Ex calls when the draw needs glow, shadow, pattern, per-corner radius, or named fields.

• radiusnumber or corner table: tl, tr, br, bl
• cutsnumber or corner table clamped to half the smaller side
• fillColor or MGFX gradient record
• patternStripePattern or SmokePattern for supported shape paths

Image sources and fitting

source may be a material path, Material-like object, or texture-like object. Use fit for layout, crop or uv for source region, and position for cover/contain alignment.

Text and dynamic values

Use RegisterTextFont for font aliases, DefineTextStyle for reusable effect records, and PrewarmText for stable labels. dynamic = true keeps changing values on the composer route.

MGFX.TextEx(scoreText, "MGFXScoreStat", x, y, nil,
    TEXT_ALIGN_RIGHT, TEXT_ALIGN_TOP, {
        fill = MGFX.LinearGradient(0, 0, 1, 0,
            Color(255, 255, 255), Color(130, 210, 255)),
        glow = {size = 4, color = Color(80, 170, 255, 110)},
        dynamic = true,
    })

Paint values

Paint records are plain values passed into explicit slots. Shapes use fill and optional pattern; progress widgets split visible paint into track, fill, trackPattern, and fillPattern.

local fill = MGFX.LinearGradientStops(0, 0, 1, 0, {
    {0.00, Color(80, 170, 255)},
    {0.55, Color(90, 220, 180)},
    {1.00, Color(255, 210, 110)},
})

MGFX.ProgressBarEx(x, y, w, 10, value, {
    radius = 5,
    track = Color(255, 255, 255, 22),
    fill = fill,
    fillPattern = MGFX.StripePattern({
        color = Color(255, 255, 255, 42),
        spacing = 10,
        width = 1.5,
    }),
})