mirror of
https://github.com/bkaradzic/bgfx.git
synced 2026-02-17 20:52:36 +01:00
Add bindings for C3 Lang (#3456)
* Added bindings for C3 lang * Fix sub-struct generation. Fix empty struct. Fix doc comments. These issues didn't allow the c3 compilation * Add @extern for each function to match C API * Add gen suffix to keep naming consistency
This commit is contained in:
Jaziel Guerrero
3211
bindings/c3/bgfx.c3
Normal file
3211
bindings/c3/bgfx.c3
Normal file
File diff suppressed because it is too large
Load Diff
395
scripts/bindings-c3.lua
Normal file
395
scripts/bindings-c3.lua
Normal file
@@ -0,0 +1,395 @@
|
||||
local codegen = require "codegen"
|
||||
local idl = codegen.idl "bgfx.idl"
|
||||
|
||||
local c3_template = [[
|
||||
/*
|
||||
* Copyright 2011-2025 Branimir Karadzic. All rights reserved.
|
||||
* License: https://github.com/bkaradzic/bgfx/blob/master/LICENSE
|
||||
*/
|
||||
|
||||
/*
|
||||
*
|
||||
* AUTO GENERATED! DO NOT EDIT!
|
||||
*
|
||||
*/
|
||||
module bgfx;
|
||||
|
||||
$types
|
||||
$funcs
|
||||
]]
|
||||
|
||||
local function hasPrefix(str, prefix)
|
||||
return prefix == "" or str:sub(1, #prefix) == prefix
|
||||
end
|
||||
|
||||
local function hasSuffix(str, suffix)
|
||||
return suffix == "" or str:sub(-#suffix) == suffix
|
||||
end
|
||||
|
||||
local function convert_type_0(arg)
|
||||
|
||||
if hasPrefix(arg.ctype, "uint64_t") then
|
||||
return arg.ctype:gsub("uint64_t", "ulong")
|
||||
elseif hasPrefix(arg.ctype, "int64_t") then
|
||||
return arg.ctype:gsub("int64_t", "long")
|
||||
elseif hasPrefix(arg.ctype, "uint32_t") then
|
||||
return arg.ctype:gsub("uint32_t", "uint")
|
||||
elseif hasPrefix(arg.ctype, "int32_t") then
|
||||
return arg.ctype:gsub("int32_t", "int")
|
||||
elseif hasPrefix(arg.ctype, "uint16_t") then
|
||||
return arg.ctype:gsub("uint16_t", "ushort")
|
||||
elseif hasPrefix(arg.ctype, "bgfx_view_id_t") then
|
||||
return arg.ctype:gsub("bgfx_view_id_t", "ushort")
|
||||
elseif hasPrefix(arg.ctype, "uint8_t") then
|
||||
return arg.ctype:gsub("uint8_t", "char")
|
||||
elseif hasPrefix(arg.ctype, "uintptr_t") then
|
||||
return arg.ctype:gsub("uintptr_t", "uptr")
|
||||
elseif arg.ctype == "bgfx_caps_gpu_t" then
|
||||
return arg.ctype:gsub("bgfx_caps_gpu_t", "uint")
|
||||
elseif arg.ctype == "const char*" then
|
||||
return "const ZString"
|
||||
elseif hasSuffix(arg.fulltype, "Handle") then
|
||||
return arg.fulltype
|
||||
elseif arg.ctype == "..." then
|
||||
return "..."
|
||||
elseif arg.ctype == "va_list"
|
||||
or arg.fulltype == "bx::AllocatorI*"
|
||||
or arg.fulltype == "CallbackI*"
|
||||
or arg.fulltype == "ReleaseFn" then
|
||||
return "void*"
|
||||
elseif arg.fulltype == "const ViewId*" then
|
||||
return "ushort*"
|
||||
end
|
||||
|
||||
return arg.fulltype
|
||||
end
|
||||
|
||||
local function convert_type(arg)
|
||||
local ctype = convert_type_0(arg)
|
||||
ctype = ctype:gsub("::Enum", "")
|
||||
ctype = ctype:gsub("const ", "")
|
||||
ctype = ctype:gsub(" &", "*")
|
||||
ctype = ctype:gsub("&", "*")
|
||||
return ctype
|
||||
end
|
||||
|
||||
local converter = {}
|
||||
local yield = coroutine.yield
|
||||
local indent = ""
|
||||
|
||||
local gen = {}
|
||||
|
||||
function gen.gen()
|
||||
local r = c3_template:gsub("$(%l+)", function(what)
|
||||
local tmp = {}
|
||||
for _, object in ipairs(idl[what]) do
|
||||
local co = coroutine.create(converter[what])
|
||||
local any
|
||||
while true do
|
||||
local ok, v = coroutine.resume(co, object)
|
||||
assert(ok, debug.traceback(co, v))
|
||||
if not v then
|
||||
break
|
||||
end
|
||||
table.insert(tmp, v)
|
||||
any = true
|
||||
end
|
||||
if any and tmp[#tmp] ~= "" then
|
||||
table.insert(tmp, "")
|
||||
end
|
||||
end
|
||||
return table.concat(tmp, "\n")
|
||||
end)
|
||||
return r
|
||||
end
|
||||
|
||||
local combined = { "State", "Stencil", "Buffer", "Texture", "Sampler", "Reset" }
|
||||
|
||||
for _, v in ipairs(combined) do
|
||||
combined[v] = {}
|
||||
end
|
||||
|
||||
local lastCombinedFlag
|
||||
|
||||
local function FlagBlock(typ)
|
||||
local format = "0x%08x"
|
||||
local enumType = " : const uint"
|
||||
if typ.bits == 64 then
|
||||
format = "0x%016x"
|
||||
enumType = " : const ulong"
|
||||
elseif typ.bits == 16 then
|
||||
format = "0x%04x"
|
||||
enumType = " : const ushort"
|
||||
end
|
||||
|
||||
yield("enum " .. typ.name .. "Flags" .. enumType)
|
||||
yield("{")
|
||||
|
||||
for idx, flag in ipairs(typ.flag) do
|
||||
|
||||
if flag.comment ~= nil then
|
||||
if idx ~= 1 then
|
||||
yield("")
|
||||
end
|
||||
|
||||
for _, comment in ipairs(flag.comment) do
|
||||
yield("\t// " .. comment)
|
||||
end
|
||||
end
|
||||
|
||||
local flagName = string.upper(flag.name)
|
||||
yield( "\t"
|
||||
.. flagName
|
||||
.. string.rep(" ", 22 - #(flagName))
|
||||
.. " = "
|
||||
.. string.format(flag.format or format, flag.value)
|
||||
.. ","
|
||||
)
|
||||
end
|
||||
|
||||
if typ.shift then
|
||||
yield("\t"
|
||||
.. "Shift"
|
||||
.. string.rep(" ", 22 - #("Shift"))
|
||||
.. " = "
|
||||
.. flag.shift
|
||||
)
|
||||
end
|
||||
|
||||
-- generate Mask
|
||||
if typ.mask then
|
||||
yield(""
|
||||
.. "Mask"
|
||||
.. string.rep(" ", 22 - #("Mask"))
|
||||
.. " = "
|
||||
.. string.format(format, flag.mask)
|
||||
)
|
||||
end
|
||||
|
||||
yield("}")
|
||||
end
|
||||
|
||||
local function lastCombinedFlagBlock()
|
||||
if lastCombinedFlag then
|
||||
local typ = combined[lastCombinedFlag]
|
||||
if typ then
|
||||
FlagBlock(combined[lastCombinedFlag])
|
||||
yield("")
|
||||
end
|
||||
lastCombinedFlag = nil
|
||||
end
|
||||
end
|
||||
|
||||
local enum = {}
|
||||
|
||||
local function convert_array(member)
|
||||
if string.find(member.array, "::") then
|
||||
return string.format("[%d]", enum[member.array])
|
||||
else
|
||||
return member.array
|
||||
end
|
||||
end
|
||||
|
||||
local function convert_struct_member(member, substruct)
|
||||
local type = convert_type(member)
|
||||
local namespace = ""
|
||||
|
||||
if substruct ~= nil and substruct[type] ~= nil and substruct[type].namespace ~= nil then
|
||||
namespace = substruct[type].namespace
|
||||
end
|
||||
|
||||
if member.array then
|
||||
return namespace .. type .. convert_array(member) .. " " .. member.name
|
||||
else
|
||||
return namespace .. type .. " " .. member.name
|
||||
end
|
||||
end
|
||||
|
||||
function converter.types(typ)
|
||||
if typ.handle then
|
||||
lastCombinedFlagBlock()
|
||||
|
||||
yield("struct " .. typ.name .. " {")
|
||||
yield(" ushort idx;")
|
||||
yield("}")
|
||||
elseif hasSuffix(typ.name, "::Enum") then
|
||||
lastCombinedFlagBlock()
|
||||
|
||||
local enumType = " : uint"
|
||||
if typ.bits == 64 then
|
||||
enumType = " : ulong"
|
||||
elseif typ.bits == 16 then
|
||||
enumType = " : ushort"
|
||||
end
|
||||
|
||||
yield("enum " .. typ.typename .. enumType)
|
||||
yield("{")
|
||||
for idx, enum in ipairs(typ.enum) do
|
||||
|
||||
if enum.comment ~= nil then
|
||||
if idx ~= 1 then
|
||||
yield("")
|
||||
end
|
||||
|
||||
for _, comment in ipairs(enum.comment) do
|
||||
yield("\t// " .. comment)
|
||||
end
|
||||
end
|
||||
|
||||
yield("\t" .. string.upper(enum.name) .. ",")
|
||||
end
|
||||
yield("");
|
||||
yield("\tCOUNT")
|
||||
yield("}")
|
||||
|
||||
enum["[" .. typ.typename .. "::Count]"] = #typ.enum
|
||||
|
||||
elseif typ.bits ~= nil then
|
||||
local prefix, name = typ.name:match "(%u%l+)(.*)"
|
||||
if prefix ~= lastCombinedFlag then
|
||||
lastCombinedFlagBlock()
|
||||
lastCombinedFlag = prefix
|
||||
end
|
||||
local combinedFlag = combined[prefix]
|
||||
if combinedFlag then
|
||||
combinedFlag.bits = typ.bits
|
||||
combinedFlag.name = prefix
|
||||
local flags = combinedFlag.flag or {}
|
||||
combinedFlag.flag = flags
|
||||
local lookup = combinedFlag.lookup or {}
|
||||
combinedFlag.lookup = lookup
|
||||
for _, flag in ipairs(typ.flag) do
|
||||
local flagName = name .. flag.name:gsub("_", "")
|
||||
local value = flag.value
|
||||
if value == nil then
|
||||
-- It's a combined flag
|
||||
value = 0
|
||||
for _, v in ipairs(flag) do
|
||||
value = value | assert(lookup[name .. v], v .. " is not defined for " .. flagName)
|
||||
end
|
||||
end
|
||||
lookup[flagName] = value
|
||||
table.insert(flags, {
|
||||
name = flagName,
|
||||
value = value,
|
||||
comment = flag.comment,
|
||||
})
|
||||
end
|
||||
|
||||
if typ.shift then
|
||||
table.insert(flags, {
|
||||
name = name .. "Shift",
|
||||
value = typ.shift,
|
||||
format = "%d",
|
||||
comment = typ.comment,
|
||||
})
|
||||
end
|
||||
|
||||
if typ.mask then
|
||||
-- generate Mask
|
||||
table.insert(flags, {
|
||||
name = name .. "Mask",
|
||||
value = typ.mask,
|
||||
comment = typ.comment,
|
||||
})
|
||||
lookup[name .. "Mask"] = typ.mask
|
||||
end
|
||||
else
|
||||
FlagBlock(typ)
|
||||
end
|
||||
elseif typ.struct ~= nil then
|
||||
if typ.comments ~= nil then
|
||||
for _, line in ipairs(typ.comments) do
|
||||
yield("// " .. line)
|
||||
end
|
||||
end
|
||||
|
||||
if #typ.struct > 0 then
|
||||
if typ.namespace ~= nil then
|
||||
yield("struct " .. typ.namespace .. typ.name)
|
||||
yield("{")
|
||||
for _, member in ipairs(typ.struct) do
|
||||
if member.comment ~= nil then
|
||||
for _, line in ipairs(member.comment) do
|
||||
yield("\t// " .. line)
|
||||
end
|
||||
end
|
||||
|
||||
yield(
|
||||
indent .. "\t" .. convert_struct_member(member) .. ";"
|
||||
)
|
||||
end
|
||||
yield("}")
|
||||
else
|
||||
yield("struct " .. typ.name)
|
||||
yield("{")
|
||||
for _, member in ipairs(typ.struct) do
|
||||
if member.comment ~= nil then
|
||||
for _, line in ipairs(member.comment) do
|
||||
yield("\t// " .. line)
|
||||
end
|
||||
end
|
||||
|
||||
yield(
|
||||
indent .. "\t" .. convert_struct_member(member, typ.substruct) .. ";"
|
||||
)
|
||||
end
|
||||
yield("}")
|
||||
end
|
||||
else
|
||||
yield("alias " .. typ.name .. " = any;")
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
function converter.funcs(func)
|
||||
|
||||
if func.cpponly then
|
||||
return
|
||||
elseif func.cppinline and not func.conly then
|
||||
return
|
||||
end
|
||||
|
||||
if func.comments ~= nil then
|
||||
for _, line in ipairs(func.comments) do
|
||||
yield("// " .. line)
|
||||
end
|
||||
|
||||
for _, arg in ipairs(func.args) do
|
||||
if arg.comment ~= nil then
|
||||
local comment = table.concat(arg.comment, " ")
|
||||
|
||||
yield("// "
|
||||
.. arg.name
|
||||
.. " : `"
|
||||
.. comment
|
||||
.. "`"
|
||||
)
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
local args = {}
|
||||
if func.this ~= nil then
|
||||
args[1] = func.this_type.type .. "* _this"
|
||||
end
|
||||
for _, arg in ipairs(func.args) do
|
||||
table.insert(args, convert_type(arg) .. " " .. arg.name)
|
||||
end
|
||||
yield("extern fn " .. convert_type(func.ret) .. " " .. func.cname
|
||||
.. "(" .. table.concat(args, ", ") .. ") @extern(\"bgfx_" .. func.cname .. "\");" )
|
||||
end
|
||||
|
||||
function gen.write(codes, outputfile)
|
||||
local out = assert(io.open(outputfile, "wb"))
|
||||
out:write(codes)
|
||||
out:close()
|
||||
print("Generating: " .. outputfile)
|
||||
end
|
||||
|
||||
if (...) == nil then
|
||||
-- run `lua bindings-cs.lua` in command line
|
||||
print(gen.gen())
|
||||
end
|
||||
|
||||
return gen
|
||||
@@ -83,6 +83,9 @@ newaction {
|
||||
|
||||
local ziggen = require "bindings-zig"
|
||||
ziggen.write(ziggen.gen(), "../bindings/zig/bgfx.zig")
|
||||
|
||||
local c3gen = require "bindings-c3"
|
||||
c3gen.write(c3gen.gen(), "../bindings/c3/bgfx.c3")
|
||||
end
|
||||
|
||||
os.exit()
|
||||
|
||||
Reference in New Issue
Block a user