Difference between revisions of "RenderTarget"

From GiderosMobile
 
(3 intermediate revisions by 2 users not shown)
Line 11: Line 11:
  
 
=== Example ===
 
=== Example ===
'''Using as texture and updating RenderTarget'''
+
'''Using a texture and updating RenderTarget'''
<source lang="lua">
+
<syntaxhighlight lang="lua">
 
--original bitmap
 
--original bitmap
 
local source = Bitmap.new(Texture.new("crate.png", true))
 
local source = Bitmap.new(Texture.new("crate.png", true))
Line 34: Line 34:
 
rt:draw(source)
 
rt:draw(source)
 
end)
 
end)
</source>
+
</syntaxhighlight>
  
 
{|-
 
{|-
Line 42: Line 42:
 
[[RenderTarget:clear]] ''clears rendered texture''<br/><!--GIDEROSMTD:RenderTarget:clear(color,alpha,x,y,width,height) clears rendered texture-->
 
[[RenderTarget:clear]] ''clears rendered texture''<br/><!--GIDEROSMTD:RenderTarget:clear(color,alpha,x,y,width,height) clears rendered texture-->
 
[[RenderTarget:draw]] ''renders provided object''<br/><!--GIDEROSMTD:RenderTarget:draw(sprite,x,y) renders provided object-->
 
[[RenderTarget:draw]] ''renders provided object''<br/><!--GIDEROSMTD:RenderTarget:draw(sprite,x,y) renders provided object-->
 +
[[RenderTarget:generateMipmap]] ''recomputes mipmaps''<br/><!--GIDEROSMTD:RenderTarget:generateMipmap() recomputes mipmaps-->
 
[[RenderTarget:getPixel]] ''returns single pixels color and alpha channel''<br/><!--GIDEROSMTD:RenderTarget:getPixel(x,y) returns single pixels color and alpha channel-->
 
[[RenderTarget:getPixel]] ''returns single pixels color and alpha channel''<br/><!--GIDEROSMTD:RenderTarget:getPixel(x,y) returns single pixels color and alpha channel-->
 
[[RenderTarget:getPixels]] ''returns buffer containing color and alpha data from provided rectangle''<br/><!--GIDEROSMTD:RenderTarget:getPixels(x,y,w,h) returns buffer containing color and alpha data from provided rectangle-->
 
[[RenderTarget:getPixels]] ''returns buffer containing color and alpha data from provided rectangle''<br/><!--GIDEROSMTD:RenderTarget:getPixels(x,y,w,h) returns buffer containing color and alpha data from provided rectangle-->

Latest revision as of 12:56, 30 April 2024

Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2013.06
Inherits from: TextureBase

Description

RenderTarget is a texture on which provided Sprite hierarchy can be rendered.

It can be used in any case in which Texture can be used.

Example

Using a texture and updating RenderTarget

--original bitmap
local source = Bitmap.new(Texture.new("crate.png", true))

--render target
local rt = RenderTarget.new(source:getWidth(), source:getHeight())

--bitmap with rendertarget as texture
local bmp = Bitmap.new(rt)
bmp:setPosition(200, 0)
stage:addChild(bmp)

--updating source updated Bitmap
local frame = 0
stage:addEventListener(Event.ENTER_FRAME, function(event)
	local r = math.sin(frame * 0.03) * 0.3 + 0.7
	local g = math.sin(frame * 0.04) * 0.3 + 0.7
	local b = math.sin(frame * 0.05) * 0.3 + 0.7
	source:setColorTransform(r, g, b, 1)
	frame = frame + 1
	rt:draw(source)
end)

Methods

RenderTarget.new creates a new RenderTarget object
RenderTarget:clear clears rendered texture
RenderTarget:draw renders provided object
RenderTarget:generateMipmap recomputes mipmaps
RenderTarget:getPixel returns single pixels color and alpha channel
RenderTarget:getPixels returns buffer containing color and alpha data from provided rectangle
RenderTarget:save saves content of RenderTarget as image

Events

Constants