PLUA

我们已将功能集成到Jetlua项目中，请访问https://github.com/tinybiggames/jetlua

Plua是轻量级和强大的吗？这将Luajit脚本集成到Delphi中，使您可以轻松地在Delphi应用程序中添加脚本层。无论您是构建动态软件，添加MOD支持，还是只是寻找一种使您的应用程序更灵活和可定制的方法，PLUA都可以通过简单，直接的API来成为可能。

？目录

• 介绍
• 关键功能
• ？潜在用途
• 入门
• ？安装
• ？用法示例
• 高级功能
• API概述
• ？贡献
• 执照

介绍

Plua提供桥梁？在Delphi和Luajit之间，提供了强大的脚本解决方案，以扩展您的Delphi项目的功能。借助PLUA，Delphi开发人员可以享受嵌入动态，快速且易于使用的脚本语言（例如Lua）的所有好处，同时利用Luajit来获得高性能？。

该库旨在使LUA尽可能无缝地集成到Delphi应用程序中，重点关注可用性，效率和最小的学习曲线？所有依赖项都直接编译到可执行文件中，从而消除了对外部DLL的需求，并使部署更简单，更可靠。

关键功能

• PLUA构建基于Luajit的燃烧快速性能：提供出色的速度，使其适用于至关重要的应用程序。
• 简单的API ：易于使用的API，用于注册Delphi例程和执行LUA脚本。
• 无缝互操作性：在Delphi和LUA环境之间毫不费力地传递数据。
• 交互式调试？：使用LUA脚本中的dbg()开始交互式调试。
• 自定义例程注册➕：轻松在Lua脚本可以调用的Delphi中添加自定义例程。
• 最小设置：仅需要几行代码才能开始。
• 脚本导入和捆绑吗？：使用自定义import命令将脚本组合在一起，将其编译到一个文件中，并选择将它们存储为完全独立的应用程序的EXE资源。
• 没有外部依赖性？：所有依赖关系都直接汇总到EXE中，因此没有外部DLL可以维护。

潜在用途

• 添加改装支持：通过允许用户创建mod来增强应用程序。
• 动态工作流程：创建具有脚本可脚本业务逻辑的灵活工作流程。
• 运行时灵活性⏱️：卸载逻辑到LUA脚本以修改运行时行为。
• 游戏开发？：使用功能强大的脚本层构建游戏或仿真引擎。

入门

本节将帮助您在Delphi环境中启动并运行PLUA。

先决条件

• Delphi 12 CE或更高
• Windows 10或更高？
• 在Windows 11 64位（23H2）上测试，Delphi 12.2✅

安装

1. 克隆或下载PLUA存储库。

2. 将PLUA源文件添加到您的Delphi项目。

3. ？下载最新版本的PLUA。

4. 将内容提取到您的项目目录。

5. ➕将PLUA src文件夹添加到Delphi的库路径。

6. 在您的项目中，在uses条款中包括PLUA 。要利用扩展名，请在uses条款中添加PLUA.Ext PLUA之后。

7. ？请参阅examples文件夹以获取详细的用法说明和PSFML库的演示。

就是这样！现在，您应该能够在Delphi项目中开始使用LUA脚本。

用法示例

以下是一些简单的示例，可以演示如何将PLUA整合到您的Delphi项目中：

加载和运行LUA脚本？

 var
  Lua: TLua;
begin
  Lua := TLua.Create();
  Lua.LoadString( ' print("Hello from Lua!") ' , False);
  Lua.Run();  
  Lua.Free();
end ;

注册在LUA中使用的Delphi例程？

 procedure MyDelphiRoutine (ALua: ILuaContext);
begin
  // Example routine that pushes a string result onto Lua stack
  ALua.PushValue( ' Hello from Delphi! ' );
end ;

var
  Lua: TLua;
begin
  Lua := TLua.Create();
  Lua.RegisterRoutine( ' DelphiRoutine ' , MyDelphiRoutine);
  Lua.LoadString( ' DelphiRoutine() ' , False);
  Lua.Run();
  Lua.Free();
end ;

从Delphi调用LUA函数？

 var
  Lua: TLua;
  Result: TLuaValue;
begin
  Lua := TLua.Create();
  Lua.LoadString( ' function greet() return "Hello from Lua!" end ' );
  Result := Lua.Call( ' greet ' , []);
  ShowMessage(Result.AsString);  
  Lua.Free();
end ;

高级功能

PLUA还支持高级功能，例如：

• 交互式调试？：在LUA代码中添加dbg()开始调试，可用于在运行时识别问题。
• 脚本导入：使用import将各种脚本文件捆绑到单个汇编单元中，这对于保存和加载编译的脚本作为资源很有用。
• 字节码编译？：使用CompileToStream()将LUA脚本编译为字节码，从而允许有效的包装和分发。

API概述

PLUA API的设计既强大又易于使用。以下是关键类和方法的快速参考：

tlua？

• 创建/破坏：管理LUA实例的生命周期。
• LOADSTREAM/LOADSTRING/LOADFILE ？：来自各种来源的LUA脚本。
• 跑步▶q ：执行加载脚本。
• 致电？：从Delphi调用LUA功能。
• registerRoutine➕ ：注册Delphi例程可从Lua呼叫。

iluacontext

• pushValue/getValue ：将值推到LUA堆栈的值或获取值。
• clearstack/popstack ？：有效地管理堆栈状态。
• settableFieldValue/getTableFieldValue ？：访问和操纵LUA表。

贡献

强烈鼓励对PLUA的贡献。请随时提交问题，建议新功能或创建拉动请求，以扩大脚本引擎的功能和鲁棒性。

执照

PLUA分布在？ BSD-3-clause许可证，允许在特定条件下进行或不进行修改的源和二进制形式的再分配和使用。有关更多详细信息，请参见许可证文件。

支持

• 问题
• 讨论
• 学习Delphi

---

我们希望PLUA帮助您的Delphi项目更具动态和灵活性。愉快的编码！ ？

用❤️在德尔菲制造