Skip to content

图文信息模块管理接口 Graphics

具体函数名及描述如下:

序号函数名函数描述
1MakeGraphicsText(...)创建文字板信息
2MakeflotageText(...)创建漂浮文字信息
3MakeGraphicsProgress(...)创建进度条信息
4MakeGraphicsArrowToPos(...)生成指向位置的箭头数据
5MakeGraphicsLineToPos(...)生成指向位置的线数据
6MakeGraphicsSurfaceToPos(...)生成指向位置的面数据
7MakeGraphicsArrowToActor(...)生成指向对象的箭头数据
8MakeGraphicsLineToActor(...)生成指向对象的线数据
9MakeGraphicsSurfaceToActor(...)生成指向对象的面数据
10MakeGraphicsImage(...)生成图片信息
11CreateGraphicsTxtByPos(...)创建图文信息
12CreateGraphicsTxtByActor(...)在生物身上创建文字板
13CreateflotageTextByPos(...)在位置上创建漂浮文字
14CreateflotageTextByActor(...)在生物身上创建漂浮文字
15CreateGraphicsProgressByPos(...)在位置上创建进度条
16CreateGraphicsProgressByActor(...)在生物身上创建进度条
17RemoveGraphicsByPos(...)删除位置上的图文信息
18RemoveGraphicsByObjID(...)删除生物的图文信息
19UpdateGraphicsTextById(...)更新图文信息的文字内容
20UpdateGraphicsProgressById(...)更新进度条的进度
21CreateGraphicsArrowByActorToPos(...)创建生物指向位置的箭头
22CreateGraphicsArrowByActorToActor(...)创建生物指向生物的箭头
23CreateGraphicsArrowByPosToPos(...)创建位置指向位置的箭头
24CreateGraphicsArrowByPosToActor(...)创建位置指向生物的箭头
25CreateGraphicsLineByActorToPos(...)创建生物与位置的线
26CreateGraphicsLineByActorToActor(...)创建指向生物的线
27CreateGraphicsLineByPosToPos(...)创建位置指向位置的线
28CreateGraphicsLineByPosToActor(...)创建位置指向生物的线
29CreateGraphicsSurfaceByActorToPos(...)创建生物与位置的面
30CreateGraphicsSurfaceByActorToActor(...)创建生物与生物的引导面
31CreateGraphicsSurfaceByPosToPos(...)创建位置指向位置的面
32CreateGraphicsSurfaceByPosToActor(...)创建位置指向生物的面
33ReplaceAllGraphics(...)将src相关的所有图文信息,转移到des身上
34CreateGraphicsImageByPos(...)在位置上创建图像
35CreateGraphicsImageByActor(...)在生物上创建图像
36GetInnerGraphicsOffset(...)获取玩家昵称或称号的偏移高度 玩家脚本调用

MakeGraphicsText

  • 参数及类型:
  • 返回值及类型:
    • info:table文本信息内容
  • 该方法的主要作用: 创建文字板信息
  • 具体使用案例如下:
lua
    local data = Graphics:MakeGraphicsText([=[123]=], 16, 0, 1, true)

MakeflotageText

  • 参数及类型:
  • 返回值及类型:
    • info:table漂浮文字信息内容
  • 该方法的主要作用: 创建漂浮文字信息
  • 具体使用案例如下:
lua
    local data = Graphics:MakeflotageText([=[123]=], 16, 1)

MakeGraphicsProgress

  • 参数及类型:
  • 返回值及类型:
    • info:table进度条信息内容
  • 该方法的主要作用: 创建进度条信息
  • 具体使用案例如下:
lua
    local data = Graphics:MakeGraphicsProgress(100, 100, [=[0xf44336]=], 1)

MakeGraphicsArrowToPos

  • 参数及类型:
  • 返回值及类型:
    • info:table箭头信息内容
  • 该方法的主要作用: 生成指向位置的箭头数据
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local data = Graphics:MakeGraphicsArrowToPos(x + 10, y, z, 1, [=[0xf44336]=], 1)

MakeGraphicsLineToPos

  • 参数及类型:
  • 返回值及类型:
    • info:table线信息内容
  • 该方法的主要作用: 生成指向位置的线数据
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local data = Graphics:MakeGraphicsLineToPos(x + 10, y, z, 1, [=[0xf44336]=], 1)

MakeGraphicsSurfaceToPos

  • 参数及类型:
  • 返回值及类型:
    • info:table面信息内容
  • 该方法的主要作用: 生成指向位置的面数据
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local data = Graphics:MakeGraphicsSurfaceToPos(x + 10, y, z, 1, [=[0xf44336]=], 1)

MakeGraphicsArrowToActor

  • 参数及类型:
  • 返回值及类型:
    • info:table箭头信息内容
  • 该方法的主要作用: 生成指向对象的箭头数据
  • 具体使用案例如下:
lua
    local data = Graphics:MakeGraphicsArrowToActor(Player:GetHostUin(), 1, [=[0xf44336]=], 1)

MakeGraphicsLineToActor

  • 参数及类型:
  • 返回值及类型:
    • info:table线信息内容
  • 该方法的主要作用: 生成指向对象的线数据
  • 具体使用案例如下:
lua
    local data = Graphics:MakeGraphicsLineToActor(Player:GetHostUin(), 1, [=[0xf44336]=], 1)

MakeGraphicsSurfaceToActor

  • 参数及类型:
  • 返回值及类型:
    • info:table面信息内容
  • 该方法的主要作用: 生成指向对象的面数据
  • 具体使用案例如下:
lua
    local data = Graphics:MakeGraphicsSurfaceToActor(Player:GetHostUin(), 1, [=[0xf44336]=], 1)

MakeGraphicsImage

  • 参数及类型:
  • 返回值及类型:
    • info:table图片信息内容
  • 该方法的主要作用: 生成图片信息
  • 具体使用案例如下:
lua
    local data = Graphics:MakeGraphicsImage([=[0_10004]=], 1, 100, 1)

CreateGraphicsTxtByPos

  • 参数及类型:
    • x,y,z:number方块坐标
    • graphicInfo:table图文信息
    • x2:numberX坐标偏移(缺省参数)
    • y2:numberY坐标偏移(缺省参数)
  • 返回值及类型:
  • 该方法的主要作用: 创建图文信息
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local data = Graphics:CreateGraphicsTxtByPos(x, y, z, Graphics:MakeGraphicsText([=[123]=], 16, 0, 1, true), 0 , 100)

CreateGraphicsTxtByActor

  • 参数及类型:
    • objid:number对象objid
    • info:table图文信息
    • dir:table方向值(x,y,z)
    • offest:number方向偏移距离
    • x2:numberX坐标偏移(缺省参数)
    • y2:numberY坐标偏移(缺省参数)
  • 返回值及类型:
  • 该方法的主要作用: 在生物身上创建文字板
  • 具体使用案例如下:
lua
    local data = Graphics:CreateGraphicsTxtByActor(Player:GetHostUin(), Graphics:MakeGraphicsText([=[123]=], 16, 0, 1, true),  {x = 0, y = 1, z = 0}, 20)

CreateflotageTextByPos

  • 参数及类型:
    • x,y,z:number方块坐标
    • info:table图文信息
    • x2:numberX坐标偏移(缺省参数)
    • y2:numberY坐标偏移(缺省参数)
  • 返回值及类型:
  • 该方法的主要作用: 在位置上创建漂浮文字
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local data = Graphics:CreateflotageTextByPos(x, y, z, Graphics:MakeflotageText([=[123]=], 16, 1))

CreateflotageTextByActor

  • 参数及类型:
    • objid:number对象objid
    • info:table图文信息
    • dir:table方向值(x,y,z)
    • offest:number方向偏移距离
    • x2:numberX坐标偏移(缺省参数)
    • y2:numberY坐标偏移(缺省参数)
  • 返回值及类型:
  • 该方法的主要作用: 在生物身上创建漂浮文字
  • 具体使用案例如下:
lua
    local data = Graphics:CreateflotageTextByActor(Player:GetHostUin(), Graphics:MakeflotageText([=[123]=], 16, 1), {x = 0, y = 1, z = 0}, 100)

CreateGraphicsProgressByPos

  • 参数及类型:
    • x,y,z:number方块坐标
    • info:table图文信息
    • x2:numberX坐标偏移(缺省参数)
    • y2:numberY坐标偏移(缺省参数)
  • 返回值及类型:
  • 该方法的主要作用: 在位置上创建进度条
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local data = Graphics:CreateGraphicsProgressByPos(x, y, z, Graphics:MakeGraphicsProgress(100, 100, [=[0xf44336]=], 1))

CreateGraphicsProgressByActor

  • 参数及类型:
    • objid:number对象ID
    • info:table图文信息
    • dir:table方向值(x,y,z)
    • offest:number方向偏移距离
    • x2:numberX坐标偏移(缺省参数)
    • y2:numberY坐标偏移(缺省参数)
  • 返回值及类型:
  • 该方法的主要作用: 在生物身上创建进度条
  • 具体使用案例如下:
lua
    local data = Graphics:CreateGraphicsProgressByActor(Player:GetHostUin(), Graphics:MakeGraphicsProgress(100, 100, [=[0xf44336]=], 1), {x = 0, y = 1, z = 0}, 100)

RemoveGraphicsByPos

  • 参数及类型:
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 删除位置上的图文信息
  • 具体使用案例如下:
lua
    local result = Graphics:RemoveGraphicsByPos(x, y, z, 11, GraphicsType.Progress)

RemoveGraphicsByObjID

  • 参数及类型:
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 删除生物的图文信息
  • 具体使用案例如下:
lua
    local result = Graphics:RemoveGraphicsByObjID(Player:GetHostUin(), 11, GraphicsType.Progress)

UpdateGraphicsTextById

  • 参数及类型:
    • graphid:number文字板实例ID
    • title:number文本内容
    • fontsize:number字体大小
    • apha:number不透明度
    • isync:bool是否同步到客机(间隔N帧刷新只需要最后一次传true即可)
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 更新图文信息的文字内容
  • 具体使用案例如下:
lua
    local txtgraphis1 = Graphics:CreateGraphicsTxtByPos(0, 8, 0, Graphics:MakeGraphicsText([=[创建的文本]=], 16, 0, 1, true), 0 , 100)

    local txtgraphis2 = Graphics:CreateGraphicsTxtByPos(1, 8, 0, Graphics:MakeGraphicsText([=[创建的文本]=], 16, 0, 1, true), 0 , 100)

    if txtgraphis1 and txtgraphis2 then

        self:ThreadWait(1)

        -- 图文信息更新 一般用于间隔一段时间同步

        Graphics:UpdateGraphicsTextById(txtgraphis1, "更新的文本1",20,0.5,false) -- 更新文本内容 字体 透明度 

        Graphics:UpdateGraphicsTextById(txtgraphis2, "更新的文本2",20,0.5,true) -- 更新文本内容 字体 透明度 (最后一次传入true会同步到其他客户端)

    end

    local txtgraphis3 = Graphics:CreateGraphicsTxtByPos(4, 8, 0, Graphics:MakeGraphicsText("动态文本",16, 0, 1, true), 0 , 100)

	if txtgraphis3 then

        local extendparam = {1,2,3}

        -- 脚本添加自动刷新图文信息功能

        local function getvalues(extendparam) --参数信息是添加监听时传入的参数

            return tostring(math.random(1, 9999))

        end

		Listen:AddGraphicsListenParam(txtgraphis3,{getvalues},extendparam) -- 添加自动刷新函数  extparam 扩展参数会传递到刷新函数里面

	end

UpdateGraphicsProgressById

  • 参数及类型:
    • graphid:number文字板实例ID
    • val1:number当前值
    • val2:number最大值
    • isync:bool是否同步到客机(间隔N帧刷新只需要最后一次传true即可)
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 更新进度条的进度
  • 具体使用案例如下:
lua
    local prograhics1 = Graphics:CreateGraphicsProgressByPos(0, 7, 0, Graphics:MakeGraphicsProgress(100, 100, [=[0xf44336]=], 1))

    local prograhics3 = Graphics:CreateGraphicsProgressByPos(4, 7, 0, Graphics:MakeGraphicsProgress(100, 100, [=[0xf44336]=], 1))

    if prograhics1 and prograhics3 then

        self:ThreadWait(1)

        Graphics:UpdateGraphicsProgressById(prograhics1, 10,200,false) -- 更新进度条的最小值和最大值

        Graphics:UpdateGraphicsProgressById(prograhics3, 30,40,true) -- 更新进度条的最小值和最大值 (最后一次传入true会同步到其他客户端)

    end

	local prograhics2 = Graphics:CreateGraphicsProgressByPos(-4, 7, 0, Graphics:MakeGraphicsProgress(10, 20, [=[0xf40000]=], 1, true))

	if prograhics2 then

		local extendparam = {1,2,3}

        -- 脚本添加自动刷新图文信息功能

        local function getvalues()

            return math.random(1, 20), math.random(20, 40) -- 最小值 最大值

        end

		Listen:AddGraphicsListenParam(prograhics2,{getvalues},extendparam) -- 添加自动刷新函数  extparam 扩展参数会传递到刷新函数里面

	end

CreateGraphicsArrowByActorToPos

  • 参数及类型:
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建生物指向位置的箭头
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local isSuccess = Graphics:CreateGraphicsArrowByActorToPos(Player:GetHostUin(), Graphics:MakeGraphicsArrowToPos(x + 10, y, z, 1, [=[0xf44336]=], 1), {x = 0, y = 1, z = 0}, 20)

CreateGraphicsArrowByActorToActor

  • 参数及类型:
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建生物指向生物的箭头
  • 具体使用案例如下:
lua
    local isSuccess = Graphics:CreateGraphicsArrowByActorToActor(Player:GetHostUin(), Graphics:MakeGraphicsArrowToActor(Player:GetHostUin(), 1, [=[0xf44336]=], 1), {x = 0, y = 1, z = 0}, 20)

CreateGraphicsArrowByPosToPos

  • 参数及类型:
    • pos:table位置坐标(x,y,z)
    • info:table图文信息
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建位置指向位置的箭头
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local isSuccess = Graphics:CreateGraphicsArrowByPosToPos({x = x, y = y, z = z}, Graphics:MakeGraphicsArrowToPos(x + 10, y, z, 1, [=[0xf44336]=], 1))

CreateGraphicsArrowByPosToActor

  • 参数及类型:
    • pos:table位置坐标(x,y,z)
    • info:table图文信息
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建位置指向生物的箭头
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local isSuccess = Graphics:CreateGraphicsArrowByPosToActor({x = x, y = y, z = z}, Graphics:MakeGraphicsArrowToActor(Player:GetHostUin(), 1, [=[0xf44336]=], 1))

CreateGraphicsLineByActorToPos

  • 参数及类型:
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建生物与位置的线
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local isSuccess = Graphics:CreateGraphicsLineByActorToPos(Player:GetHostUin(), Graphics:MakeGraphicsLineToPos(x + 10, y, z, 1, [=[0xf44336]=], 1), {x = 0, y = 1, z = 0}, 20)

CreateGraphicsLineByActorToActor

  • 参数及类型:
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建指向生物的线
  • 具体使用案例如下:
lua
    local isSuccess = Graphics:CreateGraphicsLineByActorToActor(Player:GetHostUin(), Graphics:MakeGraphicsLineToActor(Player:GetHostUin(), 1, [=[0xf44336]=], 1), {x = 0, y = 1, z = 0}, 20)

CreateGraphicsLineByPosToPos

  • 参数及类型:
    • pos:table位置坐标(x,y,z)
    • info:table图文信息
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建位置指向位置的线
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local isSuccess = Graphics:CreateGraphicsLineByPosToPos({x = x, y = y, z = z}, Graphics:MakeGraphicsLineToPos(x + 10, y, z, 1, [=[0xf44336]=], 1))

CreateGraphicsLineByPosToActor

  • 参数及类型:
    • pos:table位置坐标(x,y,z)
    • info:table图文信息
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建位置指向生物的线
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local isSuccess = Graphics:CreateGraphicsLineByPosToActor({x = x, y = y, z = z}, Graphics:MakeGraphicsLineToActor(Player:GetHostUin(), 1, [=[0xf44336]=], 1))

CreateGraphicsSurfaceByActorToPos

  • 参数及类型:
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建生物与位置的面
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local isSuccess = Graphics:CreateGraphicsSurfaceByActorToPos(Player:GetHostUin(), Graphics:MakeGraphicsSurfaceToPos(x + 10, y, z, 1, [=[0xf44336]=], 1), {x = 0, y = 1, z = 0}, 20)

CreateGraphicsSurfaceByActorToActor

  • 参数及类型:
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建生物与生物的引导面
  • 具体使用案例如下:
lua
    local isSuccess = Graphics:CreateGraphicsSurfaceByActorToActor(Player:GetHostUin(), Graphics:MakeGraphicsSurfaceToActor(Player:GetHostUin(), 1, [=[0xf44336]=], 1), {x = 0, y = 1, z = 0}, 20)

CreateGraphicsSurfaceByPosToPos

  • 参数及类型:
    • pos:table位置坐标(x,y,z)
    • info:table图文信息
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建位置指向位置的面
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local isSuccess = Graphics:CreateGraphicsSurfaceByPosToPos({x = x, y = y, z = z}, Graphics:MakeGraphicsSurfaceToPos(x + 10, y, z, 1, [=[0xf44336]=], 1))

CreateGraphicsSurfaceByPosToActor

  • 参数及类型: pos:table:位置坐标(x|y|z)info:table:图文信息
  • 返回值及类型:
    • ret:bool成功(true)
  • 该方法的主要作用: 创建位置指向生物的面
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local isSuccess = Graphics:CreateGraphicsSurfaceByPosToActor({x = x, y = y, z = z}, Graphics:MakeGraphicsSurfaceToActor(Player:GetHostUin(), 1, [=[0xf44336]=], 1))

ReplaceAllGraphics

  • 参数及类型:
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 将src相关的所有图文信息,转移到des身上
  • 具体使用案例如下:
lua
    local objs = GameObject:CreatePrefab(ObjType.Mob, 3400, 12,8,12, 1) -- 创建两个游戏内生物

    if objs and #objs > 0 then

        objid2 = objs[1]:GetId()

        result = Graphics:ReplaceAllGraphics(objid1,objid2)

        print("result", result)

    end

CreateGraphicsImageByPos

  • 参数及类型:
    • x,y,z:number方块坐标
    • info:table图文信息
    • x2:numberX坐标偏移(缺省参数)
    • y2:numberY坐标偏移(缺省参数)
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 在位置上创建图像
  • 具体使用案例如下:
lua
    local x, y, z = Actor:GetPosition(Player:GetHostUin())

    local isSuccess = Graphics:CreateGraphicsImageByPos(x, y, z, Graphics:MakeGraphicsImage([=[0_10004]=], 1, 100, 1))

CreateGraphicsImageByActor

  • 参数及类型:
    • objid:number对象ID
    • info:table图文信息
    • dir:table方向值(x,y,z)
    • offest:number方向偏移距离
    • x2:numberX坐标偏移(缺省参数)
    • y2:numberY坐标偏移(缺省参数)
  • 返回值及类型:
    • ret:bool是否成功
  • 该方法的主要作用: 在生物上创建图像
  • 具体使用案例如下:
lua
    local isSuccess = Graphics:CreateGraphicsImageByActor(Player:GetHostUin(), Graphics:MakeGraphicsImage([=[0_10004]=], 1, 100, 1), {x = 0, y = 1, z = 0}, 20)

GetInnerGraphicsOffset

  • 参数及类型:
  • 返回值及类型:
    • ret:number高度值(未展示 0)
  • 该方法的主要作用: 获取玩家昵称或称号的偏移高度 玩家脚本调用
  • 具体使用案例如下:
lua
    Graphics:GetInnerGraphicsOffset(Player:GetHostUin(), PlayerNameType.Nick, function (height)

        if height == 0 then

            print("未展示")

        else

            print("高度", height)

        end

    end)