贴图系统

请确保您拥有v3.3.0+的PixelsWorld

通过这一章，您能快速了解并学习使用PixelsWorld的贴图系统。

• newTex
• delTex
• getSize
• swapTex
• drawTo
• castTex
• blendTex
• copyTex
• fetchTex
• savePNG,loadPNG,saveEXR,loadEXR,saveRAW,loadRAW
• rotateTex,flipTex,resizeTex,trimTex

贴图id

在PixelsWorld中，贴图是用一个整数（贴图id）来表示的。PixelsWorld提供的基础贴图id如下：

您还可以自己创建贴图id，方法后述

基本流程

通常Ae送给PixelsWorld一张图片，PixelsWorld先把图片放在INPUT中，进行计算后，把结果放在OUTPUT贴图中。当一切指令结束后会把OUTPUT贴图送给Ae当作结果。

TEMP的作用

因为OpenGL不支持同时读取和写入同一个贴图，所以PixelsWorld提供了TEMP用来存储上一次glsl,shadertoy,等函数绘制的结果。你可以在着色器中使用getColor(PW_TEMP_LAYER,uv);来采样TEMP的颜色。

创建贴图

使用newTex(width,height)来创建贴图，将返回贴图id（一个随机整数值）。

删除贴图

使用delTex(id)来删除指定贴图。

通常您无需手动删除，PixelsWorld会在每一帧结束时删除所有贴图。但在不需要一个贴图的时候提前释放其占用的显存仍然是个很好的习惯。

获取尺寸

使用getSize(id)来获取贴图尺寸。

version3()
mytex = newTex(512,256)
w,h = getSize(mytex)
println("Width of mytex is: " .. w)
println("Height of mytex is: " .. h)

交换贴图

使用swapTex(id1,id2)来交换id1和id2代表的贴图。

version3()
tex1 = newTex(128,128)
tex2 = newTex(256,256)
w,h = getSize(tex1)
println("tex1 size: " .. w .. ", ".. h)
swapTex(tex1,tex2)
w,h = getSize(tex1)
println("tex1 size after swapped: " .. w .. ", ".. h)

设定绘制贴图

使用drawTo(id)来更改绘制贴图。绘制贴图默认为OUTPUT，注意PixelsWorld最后只会把OUTPUT当作结果送给Ae，下面三种方法可以输送其它贴图的结果至OUTPUT：

1. drawTo(OUTPUT)+image
2. castTex
3. swapTex

投射贴图

使用castTex(toTexId,fromTexId)来把像素从fromTexId投射到toTexId，例如您可以把参数层0PARAM0投射到输出贴图OUTPUT上：

version3()
castTex(OUTPUT,PARAM0)

您还可以指定投射贴图的范围（以贴图左上角为原点）：

• castTex(toTexId,fromTexId,to1x,to1y,to2x,to2y)
• castTex(toTexId,fromTexId,to1x,to1y,to2x,to2y,from1x,from1y,from2x,from2y)

省略范围时默认使用整个贴图

混合贴图

使用blendTex(toTexId,fromTexId,blendRule)来使用混合规则blendRule把贴图fromTex贴到贴图toTex上。

1. blendRule可以为NORMAL,ADD,SUBTRACT,MULTIPLY,DIVIDE,MAX,MIN中的任意一个。
2. blendRule可以为字符串，规则如下：
   • A代表toTexId输入像素
   • B代表fromTexId输入像素
   • C代表toTexId输出像素 例如：您可以使用下面的代码来把输入贴图和参数层0的图片用加法混合。

version3()
castTex(OUTPUT,INPUT) -- Cast INPUT texture to OUTPUT firstly. 
blendTex(OUTPUT,PARAM0,"C=A+B") -- Blend PARAM0 to OUTPUT.

实际上这里的字符串会被处理成GLSL代码，"C=A+B"在内部将变成下面的代码：

#version 330 core
out vec4 outColor;
in vec2 uv;
in vec2 uv2;
uniform sampler2D inLayerA;
uniform sampler2D inLayerB;
void main(){
    vec4 A = texture(inLayerA,uv);
    vec4 B = texture(inLayerB,uv2);
    vec4 C = A;
    C=A+B // Your blend rule is combined here. 
    ;
    outColor = C;
}

跟castTex一样，blendTex也支持贴图范围指定的混色：

• blendTex(toTexId,fromTexId,blendRule,to1x,to1y,to2x,to2y)
• blendTex(toTexId,fromTexId,blendRule,to1x,to1y,to2x,to2y,from1x,from1y,from2x,from2y)

拷贝贴图

使用copyTex(refTexId)来拷贝贴图，返回被拷贝的新贴图。

获取任意时间图层像素

使用fetchTex(layerId, time)来获取某时间下指定图层的贴图，返回抓取来的贴图id。

• layerId: 只可以输入PARAM0~PARAM9。
• time: 图层时间（浮点数，单位为秒）

• 注意：使用这个函数可能会造成Ae的缓存错误，请时常清理缓存。
• v3.4.3+新增函数。

读取和保存贴图

使用savePNG(utf8Path,texId),loadPNG(utf8Path)来保存、读取PNG图片。

使用saveEXR(utf8Path,texId),loadEXR(utf8Path)来保存、读取EXR图片。

使用saveRAW(utf8Path,texId),loadRAW(utf8Path)来保存、读取MiLai原生的未经压缩的内存原图。

以下是受PixelsWorld支持的图片规格细节：

读取PNG图片到场景：

version3()
local mypng = loadPNG([[d:\test.png]]) -- Replace to your path. 
castTex(OUTPUT,mypng) -- Cast pixels from mypng to OUTPUT.

保存PNG图片到本地：

version3()

--Draw something to OUTPUT
move(width/2,height/2)
rotate(time)
triangle()
--End drawing. 

savePNG([[d:\test.png]],OUTPUT) -- Save OUTPUT as PNG to local disc. Replace to your path here.

• 把PNG换成EXR即可保存、读取EXR图片。
• 保存到某些位置需要管理员权限。

修整贴图

使用rotateTex(texId,times)来旋转90*times度贴图，rotateTex(texId)等价于rotateTex(texId,1)

使用flipTex(texId,flipV)来镜像翻转贴图，其中flipV为布尔值，flipV为true时垂直镜像，false时水平镜像。

使用resizeTex(texId,width,height)来缩放贴图。

使用trimTex(texId,p1x,p1y,p2x,p2y)来裁剪贴图。p1x,p1y,p2x,p2y是以贴图左上角为原点的坐标。