內容目录

上一个主题

RecordZoomMode Enum

下一个主题

RendererAPI Enum

Renderer Class

Description

Augmenter是一个渲染器,用于渲染camera图像。它通常在渲染线程中使用。

Constructor

C: void easyar_Renderer__ctor(easyar_Renderer * * Return)
C++11: Renderer()
Traditional C++: Renderer()
Java: public Renderer()
Objective-C: + (easyar_Renderer *) create
Swift (since EasyAR SDK 2.1.0): public convenience init()

chooseAPI

切换图形API。这个函数通常不需要手动调用。

C: void easyar_Renderer_chooseAPI(easyar_Renderer * This, easyar_RendererAPI api)
C++11: void chooseAPI(RendererAPI api)
Traditional C++: void chooseAPI(RendererAPI api)
Java: public native void chooseAPI(/* RendererAPI */ int api)
Objective-C: - (void)chooseAPI:(easyar_RendererAPI)api
Swift (since EasyAR SDK 2.1.0): public func chooseAPI(_ api: RendererAPI) -> Void

setDevice

设置渲染设备。这个函数通常不需要手动调用。

C: void easyar_Renderer_setDevice(easyar_Renderer * This, void * device)
C++11: void setDevice(void * device)
Traditional C++: void setDevice(void * device)
Java: public native void setDevice(long device)
Objective-C: - (void)setDevice:(void *)device
Swift (since EasyAR SDK 2.1.0): public func setDevice(_ device: OpaquePointer) -> Void

render

渲染当前frame到当前绑定的FBO。这个方法应该在需要显示camera背景的每帧被调用。

viewport是Vec4I数据,和输入glViewPort的参数{left, top, width, height}类似。

C: bool easyar_Renderer_render(easyar_Renderer * This, easyar_Drawable * frame, easyar_Vec4I viewport)
C++11: bool render(std::shared_ptr<Drawable> frame, Vec4I viewport)
Traditional C++: bool render(Drawable * frame, Vec4I viewport)
Java: public native boolean render(Drawable frame, Vec4I viewport)
Objective-C: - (bool)render:(easyar_Drawable *)frame viewport:(easyar_Vec4I *)viewport
Swift (since EasyAR SDK 2.1.0): public func render(_ frame: Drawable?, _ viewport: Vec4I) -> Bool

renderToTexture

渲染当前frame到贴图。这个方法应该在需要显示camera背景的每帧被调用。

在OpenGL中, texture 应该被设为 texture id, 通常在C++中可以使用reinterpret_cast 将其转换成void*。

C: bool easyar_Renderer_renderToTexture(easyar_Renderer * This, easyar_Drawable * frame, void * texture)
C++11: bool renderToTexture(std::shared_ptr<Drawable> frame, void * texture)
Traditional C++: bool renderToTexture(Drawable * frame, void * texture)
Java: public native boolean renderToTexture(Drawable frame, long texture)
Objective-C: - (bool)renderToTexture:(easyar_Drawable *)frame texture:(void *)texture
Swift (since EasyAR SDK 2.1.0): public func renderToTexture(_ frame: Drawable?, _ texture: OpaquePointer) -> Bool

renderErrorMessage

渲染错误信息到当前绑定的FBO。

如果key验证出错,可以使用这个方法将错误信息渲染到屏幕。

如果key验证出错,返回true。

C: bool easyar_Renderer_renderErrorMessage(easyar_Renderer * This, easyar_Vec4I viewport)
C++11: bool renderErrorMessage(Vec4I viewport)
Traditional C++: bool renderErrorMessage(Vec4I viewport)
Java: public native boolean renderErrorMessage(Vec4I viewport)
Objective-C: - (bool)renderErrorMessage:(easyar_Vec4I *)viewport
Swift (since EasyAR SDK 2.1.0): public func renderErrorMessage(_ viewport: Vec4I) -> Bool

renderErrorMessageToTexture

渲染错误信息到贴图。

如果key验证出错,可以使用这个方法将错误信息渲染到屏幕。

如果key验证出错,返回true。

C: bool easyar_Renderer_renderErrorMessageToTexture(easyar_Renderer * This, void * texture)
C++11: bool renderErrorMessageToTexture(void * texture)
Traditional C++: bool renderErrorMessageToTexture(void * texture)
Java: public native boolean renderErrorMessageToTexture(long texture)
Objective-C: - (bool)renderErrorMessageToTexture:(void *)texture
Swift (since EasyAR SDK 2.1.0): public func renderErrorMessageToTexture(_ texture: OpaquePointer) -> Bool