API ReferenceGE ExtensionsClient
PostFx Utilities
Utility module for loading and saving post-processing effect preset files via file dialogs.
Utility module for loading and saving post-processing effect preset files via file dialogs.
Overview
Returns a standard M module with two functions for managing .postfx preset files. Uses editor_fileDialog for native file browser integration and delegates to postFxModule for actual preset serialization.
Public API
| Function | Args | Returns | Description |
|---|---|---|---|
M.loadPresets | - | - | Opens file dialog to select and load a .postfx preset file |
M.savePresets | - | - | Opens file dialog to save current post effect settings as .postfx |
Usage Example
-- Load a preset file via dialog
local utils = require("client/postFx/utils")
utils.loadPresets()
-- Save current settings
utils.savePresets()Internal Flow
-- Load flow:
-- 1. editor_fileDialog.openFile() → user picks file
-- 2. Callback receives {filepath, path}
-- 3. postFxModule.loadPresetFile(filepath)
-- Save flow:
-- 1. editor_fileDialog.saveFile() → user picks destination
-- 2. Callback receives {filepath, path}
-- 3. postFxModule.savePresetFile(filepath)State
| Variable | Type | Description |
|---|---|---|
lastUsedFolder | string | Remembers last directory for file dialogs (starts as "/") |
Dependencies
editor_fileDialog- Native file open/save dialogspostFxModule- PostEffect preset serialization (load/save.postfxfiles)
Notes
- File filter is
{"Post Effect Settings", ".postfx"} - The last-used folder persists within the session but not across restarts
- Both functions log at info level with tag
'postfx'
See Also
- PostFx SSAO - SSAO settings (saveable via presets)
- PostFx Light Ray - Light ray settings (saveable via presets)