Skip to content

Panel Meta

Panel management system for the Lilia framework.

Overview

The panel meta table provides comprehensive functionality for managing VGUI panels, UI interactions, and panel operations in the Lilia framework. It handles panel event listening, inventory synchronization, UI updates, and panel-specific operations. The meta table operates primarily on the client side, with the server providing data that panels can listen to and display. It includes integration with the inventory system for inventory change notifications, character system for character data display, network system for data synchronization, and UI system for panel management. The meta table ensures proper panel event handling, inventory synchronization, UI updates, and comprehensive panel lifecycle management from creation to destruction.

liaListenForInventoryChanges

Purpose

Sets up event listeners for inventory changes on a panel

When Called

When a UI panel needs to respond to inventory modifications, typically during panel initialization

Parameters

  • inventory (unknown): The inventory object to listen for changes on
  • inventory (unknown): The inventory object to listen for changes on

Returns

  • Nothing

Realm

Client

Example Usage

Low Complexity: 

-- Simple: Set up inventory listening for a basic panel
panel:liaListenForInventoryChanges(playerInventory)

Medium Complexity: 

-- Medium: Set up inventory listening with conditional setup
if playerInventory then
    characterPanel:liaListenForInventoryChanges(playerInventory)
end

High Complexity: 

-- High: Set up inventory listening for multiple panels with error handling
local panels = {inventoryPanel, characterPanel, equipmentPanel}
for _, pnl in ipairs(panels) do
    if IsValid(pnl) and playerInventory then
        pnl:liaListenForInventoryChanges(playerInventory)
    end
end

liaDeleteInventoryHooks

Purpose

Removes inventory change event listeners from a panel

When Called

When a panel no longer needs to listen to inventory changes, during cleanup, or when switching inventories

Parameters

  • id (optional): The specific inventory ID to remove hooks for, or nil to remove all hooks

Returns

  • Nothing

Realm

Client

Example Usage

Low Complexity: 

-- Simple: Remove hooks for a specific inventory
panel:liaDeleteInventoryHooks(inventoryID)

Medium Complexity: 

-- Medium: Clean up hooks when closing a panel
if IsValid(panel) then
    panel:liaDeleteInventoryHooks()
end

High Complexity: 

-- High: Clean up multiple panels with different inventory IDs
local panels = {inventoryPanel, equipmentPanel, storagePanel}
local inventoryIDs = {playerInvID, equipmentInvID, storageInvID}
for i, pnl in ipairs(panels) do
    if IsValid(pnl) then
        pnl:liaDeleteInventoryHooks(inventoryIDs[i])
    end
end

setScaledPos

Purpose

Sets the position of a panel with automatic screen scaling

When Called

When positioning UI elements that need to adapt to different screen resolutions

Parameters

  • x (unknown): The horizontal position value to be scaled
  • x (unknown): The horizontal position value to be scaled
  • y (unknown): The vertical position value to be scaled
  • y (unknown): The vertical position value to be scaled

Returns

  • Nothing

Realm

Client

Example Usage

Low Complexity: 

-- Simple: Position a button at scaled coordinates
button:setScaledPos(100, 50)

Medium Complexity: 

-- Medium: Position panel based on screen dimensions
local x = ScrW() * 0.5 - 200
local y = ScrH() * 0.3
panel:setScaledPos(x, y)

High Complexity: 

-- High: Position multiple panels with responsive layout
local panels = {mainPanel, sidePanel, footerPanel}
local positions = {
    {ScrW() * 0.1, ScrH() * 0.1},
    {ScrW() * 0.7, ScrH() * 0.1},
    {ScrW() * 0.1, ScrH() * 0.8}
}
for i, pnl in ipairs(panels) do
    if IsValid(pnl) then
        pnl:setScaledPos(positions[i][1], positions[i][2])
    end
end

setScaledSize

Purpose

Sets the size of a panel with automatic screen scaling

When Called

When sizing UI elements that need to adapt to different screen resolutions

Parameters

  • w (unknown): The width value to be scaled
  • w (unknown): The width value to be scaled
  • h (unknown): The height value to be scaled
  • h (unknown): The height value to be scaled

Returns

  • Nothing

Realm

Client

Example Usage

Low Complexity: 

-- Simple: Set panel size with scaled dimensions
panel:setScaledSize(400, 300)

Medium Complexity: 

-- Medium: Set size based on screen proportions
local w = ScrW() * 0.8
local h = ScrH() * 0.6
panel:setScaledSize(w, h)

High Complexity: 

-- High: Set sizes for multiple panels with responsive layout
local panels = {mainPanel, sidePanel, footerPanel}
local sizes = {
    {ScrW() * 0.7, ScrH() * 0.6},
    {ScrW() * 0.25, ScrH() * 0.6},
    {ScrW() * 0.95, ScrH() * 0.1}
}
for i, pnl in ipairs(panels) do
    if IsValid(pnl) then
        pnl:setScaledSize(sizes[i][1], sizes[i][2])
    end
end