渲染

-- 一个优先级对应所有标签为 "tree" 的 sprites
local trees = render.predicate({"tree"})
-- 渲染 Sprite 1, 2 和 3
render.draw(trees)

-- 一个优先级对应所有标签为 "outlined" 的 sprites
local outlined = render.predicate({"outlined"})
-- 渲染 Sprite 1, 2 和 4
render.draw(outlined)

-- 一个优先级对应所有包含标签为 "outlined" 的且包含标签为 "tree" 的 sprites
local outlined_trees = render.predicate({"outlined", "tree"})
-- 渲染 Sprite 1 和 2
render.draw(outlined_trees)

msg.post("@render:", "use_stretch_projection", { near = -1, far = 1 })

msg.post("@render:", "use_fixed_fit_projection", { near = -1, far = 1 })

msg.post("@render:", "use_fixed_projection", { near = -1, far = 1, zoom = 2 })

msg.post("@render:", "use_camera_projection")

function init(self)
  -- 定义渲染优先级. 每个优先级的绘制不相干所以绘制时可以任意修改 OpenGL 的状态.
    self.predicates = create_predicates("tile", "gui", "text", "particle", "model")

    -- 创建和填充数据表将在 update() 中使用
    local state = create_state()
    self.state = state
    local camera_world = create_camera(state, "camera_world", true)
    init_camera(camera_world, get_stretch_projection)
    local camera_gui = create_camera(state, "camera_gui")
    init_camera(camera_gui, get_gui_projection)
    update_state(state)
end

function update(self)
    local state = self.state
     if not state.valid then
        if not update_state(state) then
            return
        end
    end

    local predicates = self.predicates
    -- clear screen buffers
    --
    render.set_depth_mask(true)
    render.set_stencil_mask(0xff)
    render.clear(state.clear_buffers)

    local camera_world = state.cameras.camera_world
    render.set_viewport(0, 0, state.window_width, state.window_height)
    render.set_view(camera_world.view)
    render.set_projection(camera_world.proj)


    -- render models
    --
    render.set_blend_func(render.BLEND_SRC_ALPHA, render.BLEND_ONE_MINUS_SRC_ALPHA)
    render.enable_state(render.STATE_CULL_FACE)
    render.enable_state(render.STATE_DEPTH_TEST)
    render.set_depth_mask(true)
    render.draw(predicates.model_pred)
    render.set_depth_mask(false)
    render.disable_state(render.STATE_DEPTH_TEST)
    render.disable_state(render.STATE_CULL_FACE)

     -- render world (sprites, tilemaps, particles etc)
     --
    render.set_blend_func(render.BLEND_SRC_ALPHA, render.BLEND_ONE_MINUS_SRC_ALPHA)
    render.enable_state(render.STATE_DEPTH_TEST)
    render.enable_state(render.STATE_STENCIL_TEST)
    render.enable_state(render.STATE_BLEND)
    render.draw(predicates.tile)
    render.draw(predicates.particle)
    render.disable_state(render.STATE_STENCIL_TEST)
    render.disable_state(render.STATE_DEPTH_TEST)

    -- debug
    render.draw_debug3d()

    -- render GUI
    --
    local camera_gui = state.cameras.camera_gui
    render.set_view(camera_gui.view)
    render.set_projection(camera_gui.proj)
    render.enable_state(render.STATE_STENCIL_TEST)
    render.draw(predicates.gui, camera_gui.frustum)
    render.draw(predicates.text, camera_gui.frustum)
    render.disable_state(render.STATE_STENCIL_TEST)
end

local MSG_CLEAR_COLOR =         hash("clear_color")
local MSG_WINDOW_RESIZED =      hash("window_resized")
local MSG_SET_VIEW_PROJ =       hash("set_view_projection")

function on_message(self, message_id, message)
  if message_id == MSG_CLEAR_COLOR then
      -- 根据消息命令清空屏幕.
      self.clear_color = message.color
  elseif message_id == MSG_SET_VIEW_PROJ then
      -- 焦点摄像机每一帧都发送 set_view_projection
      -- 消息到 @render 端口. 使用摄像机发来的数据可以
      -- 设置渲染视口 (及映射).
      camera.view = message.view
      self.camera_projection = message.projection or vmath.matrix4()
      update_camera(camera, state)
  end
end

-- 更改清屏颜色.
msg.post("@render:", "clear_color", { color = vmath.vector4(0.3, 0.4, 0.5, 0) })

-- "my_material" 现在将用于优先级关联的所有绘制调用
render.enable_material("my_material")
-- 谓词绘制的任何内容都将以 "my_render_target" 结尾
render.set_render_target("my_render_target")
render.draw(self.my_full_screen_predicate)
render.set_render_target(render.RENDER_TARGET_DEFAULT)
render.disable_material()

-- 将渲染目标结果纹理绑定到通过优先级渲染的任何内容
render.enable_texture(0, "my_render_target", render.BUFFER_COLOR0_BIT)
render.draw(self.my_tile_predicate)

local my_texture_resource = resource.create_texture("/my_texture.texture", tparams)
-- 注意: my_texture_resource 是资源路径的哈希值, 不能用作句柄!
local my_texture_handle = resource.get_texture_info(my_texture_resource)
-- my_texture_handle 包含纹理的信息, 比如宽度, 高度等等
-- 它还包含句柄, 这就是我们所需要的
msg.post("@render:", "set_texture", { handle = my_texture_handle.handle })

function on_message(self, message_id, message)
    if message_id == hash("set_texture") then
        self.my_texture = message.handle
    end
end

function update(self)
    -- 将自定义纹理绑定到绘制状态
    render.enable_texture(0, self.my_texture)
    -- 进行绘制..
end

local MSG_WINDOW_RESIZED =      hash("window_resized")
  
function on_message(self, message_id, message)
  if message_id == MSG_WINDOW_RESIZED then
    -- 窗体变化. message.width 与 message.height 保存了变化后的窗体尺寸.
  ...
  end
end

-- 绘制白线
local p1 = vmath.vector3(0, 0, 0)
local p2 = vmath.vector3(1000, 1000, 0)
local col = vmath.vector4(1, 1, 1, 1)
msg.post("@render:", "draw_line", { start_point = p1, end_point = p2, color = col } )  

-- 文字信息绘制
local pos = vmath.vector3(500, 500, 0)
msg.post("@render:", "draw_text", { text = "Hello world!", position = pos })