概览
RenderScript 的图形子系统在 API 级别 23 时已被移除。
摘要
已弃用类型 | |
---|---|
rs_blend_dst_func | 已弃用。混合目标函数 |
rs_blend_src_func | 已弃用。混合源函数 |
rs_cull_mode | 已弃用。剔除模式 |
rs_depth_func | 已弃用。深度函数 |
rs_font | 已弃用。字体的句柄 |
rs_mesh | 已弃用。网格的句柄 |
rs_primitive | 已弃用。如何解释网格顶点数据 |
rs_program_fragment | 已弃用。ProgramFragment 的句柄 |
rs_program_raster | 已弃用。ProgramRaster 的句柄 |
rs_program_store | 已弃用。ProgramStore 的句柄 |
rs_program_vertex | 已弃用。ProgramVertex 的句柄 |
类型
rs_blend_dst_func :混合目标函数
包含以下值的枚举: 编译 32 位时。API 级别 16 - 22
RS_BLEND_DST_ZERO = 0 | |
---|---|
RS_BLEND_DST_ONE = 1 | |
RS_BLEND_DST_SRC_COLOR = 2 | |
RS_BLEND_DST_ONE_MINUS_SRC_COLOR = 3 | |
RS_BLEND_DST_SRC_ALPHA = 4 | |
RS_BLEND_DST_ONE_MINUS_SRC_ALPHA = 5 | |
RS_BLEND_DST_DST_ALPHA = 6 | |
RS_BLEND_DST_ONE_MINUS_DST_ALPHA = 7 | |
RS_BLEND_DST_INVALID = 100 |
已弃用。请勿使用。
rs_blend_src_func :混合源函数
包含以下值的枚举: 编译 32 位时。API 级别 16 - 22
RS_BLEND_SRC_ZERO = 0 | |
---|---|
RS_BLEND_SRC_ONE = 1 | |
RS_BLEND_SRC_DST_COLOR = 2 | |
RS_BLEND_SRC_ONE_MINUS_DST_COLOR = 3 | |
RS_BLEND_SRC_SRC_ALPHA = 4 | |
RS_BLEND_SRC_ONE_MINUS_SRC_ALPHA = 5 | |
RS_BLEND_SRC_DST_ALPHA = 6 | |
RS_BLEND_SRC_ONE_MINUS_DST_ALPHA = 7 | |
RS_BLEND_SRC_SRC_ALPHA_SATURATE = 8 | |
RS_BLEND_SRC_INVALID = 100 |
已弃用。请勿使用。
rs_cull_mode :剔除模式
包含以下值的枚举: 编译 32 位时。API 级别 16 - 22
RS_CULL_BACK = 0 | |
---|---|
RS_CULL_FRONT = 1 | |
RS_CULL_NONE = 2 | |
RS_CULL_INVALID = 100 |
已弃用。请勿使用。
rs_depth_func :深度函数
包含以下值的枚举: 编译 32 位时。API 级别 16 - 22
RS_DEPTH_FUNC_ALWAYS = 0 | 始终绘制 |
---|---|
RS_DEPTH_FUNC_LESS = 1 | 如果传入深度值小于深度缓冲区中的值,则绘制 |
RS_DEPTH_FUNC_LEQUAL = 2 | 如果传入深度值小于或等于深度缓冲区中的值,则绘制 |
RS_DEPTH_FUNC_GREATER = 3 | 如果传入深度值大于深度缓冲区中的值,则绘制 |
RS_DEPTH_FUNC_GEQUAL = 4 | 如果传入深度值大于或等于深度缓冲区中的值,则绘制 |
RS_DEPTH_FUNC_EQUAL = 5 | 如果传入深度值等于深度缓冲区中的值,则绘制 |
RS_DEPTH_FUNC_NOTEQUAL = 6 | 如果传入深度值不等于深度缓冲区中的值,则绘制 |
RS_DEPTH_FUNC_INVALID = 100 | 无效深度函数 |
已弃用。请勿使用。
指定根据传入深度值与深度缓冲区中值的比较结果进行条件绘制。
rs_font :字体的句柄
rs_mesh :网格的句柄
rs_primitive :如何解释网格顶点数据
包含以下值的枚举: 编译 32 位时。API 级别 16 - 22
RS_PRIMITIVE_POINT = 0 | 顶点数据将渲染为一系列点 |
---|---|
RS_PRIMITIVE_LINE = 1 | 顶点对将渲染为线 |
RS_PRIMITIVE_LINE_STRIP = 2 | 顶点数据将渲染为连接的线条 |
RS_PRIMITIVE_TRIANGLE = 3 | 顶点将渲染为单个三角形 |
RS_PRIMITIVE_TRIANGLE_STRIP = 4 | 顶点将渲染为连接的三角形带,由前三个顶点定义,每个附加三角形由一个新顶点定义 |
RS_PRIMITIVE_TRIANGLE_FAN = 5 | 顶点将渲染为一系列三角形,所有三角形都共享第一个顶点作为原点 |
RS_PRIMITIVE_INVALID = 100 | 无效基元 |
已弃用。请勿使用。
描述渲染时网格顶点数据的解释方式
rs_program_fragment :ProgramFragment 的句柄
编译 32 位时。从 API 级别 23 及更高版本中移除
已弃用。请勿使用。
RenderScript ProgramFragment 对象的不透明句柄。请参阅:android.renderscript.ProgramFragment
rs_program_raster :ProgramRaster 的句柄
编译 32 位时。从 API 级别 23 及更高版本中移除
已弃用。请勿使用。
RenderScript ProgramRaster 对象的不透明句柄。请参阅:android.renderscript.ProgramRaster
rs_program_store :ProgramStore 的句柄
编译 32 位时。从 API 级别 23 及更高版本中移除
已弃用。请勿使用。
RenderScript ProgramStore 对象的不透明句柄。请参阅:android.renderscript.ProgramStore
rs_program_vertex :ProgramVertex 的句柄
编译 32 位时。从 API 级别 23 及更高版本中移除
已弃用。请勿使用。
RenderScript ProgramVertex 对象的不透明句柄。请参阅:android.renderscript.ProgramVertex
函数
rsgAllocationSyncAll :同步 Allocation 的内容
void rsgAllocationSyncAll(rs_allocation alloc); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
void rsgAllocationSyncAll(rs_allocation alloc, rs_allocation_usage_type source); | 编译 32 位时。API 级别 14 - 22 |
已弃用。请勿使用。
同步 Allocation 的内容。
如果指定了 source,则从 source 指定的内存空间同步。
如果未指定 source,则从其 SCRIPT 内存空间同步到其 HW 内存空间。
rsgBindColorTarget :设置颜色目标
void rsgBindColorTarget(rs_allocation colorTarget, uint slot); | 编译 32 位时。API 级别 14 - 22 |
已弃用。请勿使用。
设置所有后续渲染调用使用的颜色目标
rsgBindConstant :绑定常量 Allocation
void rsgBindConstant(rs_program_fragment ps, uint slot, rs_allocation c); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
void rsgBindConstant(rs_program_vertex pv, uint slot, rs_allocation c); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
参数
ps | 程序片段对象 |
---|---|
slot | 程序上常量缓冲区的索引 |
c | 要绑定的常量 |
pv | 程序顶点对象 |
已弃用。请勿使用。
将新的 Allocation 对象绑定到 ProgramFragment 或 ProgramVertex。该 Allocation 必须是 Program 的有效常量输入。
rsgBindDepthTarget :设置深度目标
void rsgBindDepthTarget(rs_allocation depthTarget); | 编译 32 位时。API 级别 14 - 22 |
已弃用。请勿使用。
设置所有后续渲染调用使用的深度目标
rsgBindFont :绑定字体对象
void rsgBindFont(rs_font font); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
参数
font | 要绑定的对象 |
---|
已弃用。请勿使用。
绑定用于所有后续字体渲染调用的字体对象
rsgBindProgramFragment :绑定 ProgramFragment
void rsgBindProgramFragment(rs_program_fragment pf); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
将新的 ProgramFragment 绑定到渲染上下文。
rsgBindProgramRaster :绑定 ProgramRaster
void rsgBindProgramRaster(rs_program_raster pr); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
将新的 ProgramRaster 绑定到渲染上下文。
rsgBindProgramStore :绑定 ProgramStore
void rsgBindProgramStore(rs_program_store ps); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
将新的 ProgramStore 绑定到渲染上下文。
rsgBindProgramVertex :绑定 ProgramVertex
void rsgBindProgramVertex(rs_program_vertex pv); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
将新的 ProgramVertex 绑定到渲染上下文。
rsgBindSampler :绑定 Sampler
void rsgBindSampler(rs_program_fragment fragment, uint slot, rs_sampler sampler); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
将新的 Sampler 对象绑定到 ProgramFragment。该 Sampler 将在匹配的 slot 上操作绑定的纹理。
rsgBindTexture :绑定纹理 Allocation
void rsgBindTexture(rs_program_fragment v, uint slot, rs_allocation alloc); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
将新的 Allocation 对象绑定到 ProgramFragment。该 Allocation 必须是 Program 的有效纹理。纹理的采样将由匹配 slot 上绑定的 Sampler 控制。
rsgClearAllRenderTargets :清除所有颜色和深度目标
void rsgClearAllRenderTargets(); | 编译 32 位时。API 级别 14 - 22 |
已弃用。请勿使用。
清除所有颜色和深度目标,并恢复渲染到帧缓冲区
rsgClearColor :从表面清除指定的颜色
void rsgClearColor(float r, float g, float b, float a); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
将渲染表面清除为指定的颜色。
rsgClearColorTarget :清除颜色目标
void rsgClearColorTarget(uint slot); | 编译 32 位时。API 级别 14 - 22 |
已弃用。请勿使用。
清除之前设置的颜色目标
rsgClearDepth :清除深度表面
void rsgClearDepth(float value); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
将深度表面清除为指定的值。
rsgClearDepthTarget :清除深度目标
void rsgClearDepthTarget(); | 编译 32 位时。API 级别 14 - 22 |
已弃用。请勿使用。
清除之前设置的深度目标
rsgDrawMesh :绘制网格
void rsgDrawMesh(rs_mesh ism); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
void rsgDrawMesh(rs_mesh ism, uint primitiveIndex); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
void rsgDrawMesh(rs_mesh ism, uint start, uint len); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
参数
ism | 要渲染的网格对象 |
---|---|
primitiveIndex | 对于包含多个基元组的网格,此参数指定要绘制的组的索引。 |
start | 范围内的起始索引 |
len | 要绘制的索引数量 |
已弃用。请勿使用。
使用当前上下文状态绘制网格。
如果指定了 primitiveIndex,则使用当前上下文状态绘制网格的一部分。
如果还指定了 start 和 len,则使用当前上下文状态绘制网格一部分的指定索引范围。
否则将渲染整个网格。
rsgDrawQuad :绘制四边形
void rsgDrawQuad(float x1, float y1, float z1, float x2, float y2, float z2, float x3, float y3, float z3, float x4, float y4, float z4); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
用于绘制简单四边形的低性能实用函数。不适用于绘制大量几何图形。
rsgDrawQuadTexCoords :绘制带纹理的四边形
void rsgDrawQuadTexCoords(float x1, float y1, float z1, float u1, float v1, float x2, float y2, float z2, float u2, float v2, float x3, float y3, float z3, float u3, float v3, float x4, float y4, float z4, float u4, float v4); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
用于绘制带纹理四边形的低性能实用函数。不适用于绘制大量几何图形。
rsgDrawRect :绘制矩形
void rsgDrawRect(float x1, float y1, float x2, float y2, float z); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
用于绘制简单矩形的低性能实用函数。不适用于绘制大量几何图形。
rsgDrawSpriteScreenspace :在屏幕空间绘制矩形
void rsgDrawSpriteScreenspace(float x, float y, float z, float w, float h); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
用于在屏幕空间绘制矩形的低性能函数。此函数使用默认的透传 ProgramVertex。任何绑定的 ProgramVertex 都将被忽略。此函数开销很大,不应在发布的应用程序中使用。
rsgDrawText :绘制文本字符串
void rsgDrawText(const char* text, int x, int y); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
void rsgDrawText(rs_allocation alloc, int x, int y); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
绘制给定字符串和位置的文本
rsgFontColor :设置字体颜色
void rsgFontColor(float r, float g, float b, float a); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
参数
r | 红色分量 |
---|---|
g | 绿色分量 |
b | 蓝色分量 |
a | Alpha 分量 |
已弃用。请勿使用。
为所有后续渲染调用设置字体颜色
rsgMeasureText :获取文本字符串的边界框
void rsgMeasureText(const char* text, int* left, int* right, int* top, int* bottom); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
void rsgMeasureText(rs_allocation alloc, int* left, int* right, int* top, int* bottom); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
返回文本相对于 (0, 0) 的边界框。left, right, top, bottom 中的任何一个都可以为 NULL
rsgMeshComputeBoundingBox :计算边界框
void rsgMeshComputeBoundingBox(rs_mesh mesh, float* minX, float* minY, float* min, float* maxX, float* maxY, float* maxZ); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
void rsgMeshComputeBoundingBox(rs_mesh mesh, float3* bBoxMin, float3* bBoxMax); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
计算网格对象的轴对齐边界框
rsgMeshGetIndexAllocation :返回包含索引数据的 Allocation
rs_allocation rsgMeshGetIndexAllocation(rs_mesh m, uint32_t index); | 编译 32 位时。API 级别 16 - 22 |
参数
m | 要获取数据的网格 |
---|---|
index | 索引 Allocation 的索引 |
返回
包含索引数据的 Allocation |
已弃用。请勿使用。
返回包含索引数据的 Allocation,如果只指定了基元,则返回 null Allocation
rsgMeshGetPrimitive :返回基元
rs_primitive rsgMeshGetPrimitive(rs_mesh m, uint32_t index); | 编译 32 位时。API 级别 16 - 22 |
参数
m | 要获取数据的网格 |
---|---|
index | 基元的索引 |
返回
描述网格如何渲染的基元 |
已弃用。请勿使用。
返回描述网格一部分如何渲染的基元
rsgMeshGetPrimitiveCount :返回索引集数量
uint32_t rsgMeshGetPrimitiveCount(rs_mesh m); | 编译 32 位时。API 级别 16 - 22 |
参数
m | 要获取数据的网格 |
---|
返回
网格中基元组的数量。这包括简单基元以及包含索引数据的 Allocation |
已弃用。请勿使用。
网格可以有多个索引集,此函数返回数量。
rsgMeshGetVertexAllocation :返回顶点 Allocation
rs_allocation rsgMeshGetVertexAllocation(rs_mesh m, uint32_t index); | 编译 32 位时。API 级别 16 - 22 |
参数
m | 要获取数据的网格 |
---|---|
index | 顶点 Allocation 的索引 |
返回
包含顶点数据的 Allocation |
已弃用。请勿使用。
返回作为网格一部分并包含顶点数据(例如位置、法线、纹理坐标)的 Allocation
rsgMeshGetVertexAllocationCount :返回顶点 Allocation 数量
uint32_t rsgMeshGetVertexAllocationCount(rs_mesh m); | 编译 32 位时。API 级别 16 - 22 |
参数
m | 要获取数据的网格 |
---|
返回
网格中包含顶点数据的 Allocation 数量 |
已弃用。请勿使用。
返回网格中包含顶点数据的 Allocation 数量
rsgProgramFragmentConstantColor :为固定功能仿真程序设置常量颜色
void rsgProgramFragmentConstantColor(rs_program_fragment pf, float r, float g, float b, float a); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
已弃用。请勿使用。
为固定功能仿真程序设置常量颜色。
rsgProgramRasterGetCullMode :获取程序光栅化剔除模式
rs_cull_mode rsgProgramRasterGetCullMode(rs_program_raster pr); | 编译 32 位时。API 级别 16 - 22 |
参数
pr | 要查询的程序光栅化 |
---|
已弃用。请勿使用。
获取程序光栅化剔除模式
rsgProgramRasterIsPointSpriteEnabled :获取程序光栅化点精灵状态
bool rsgProgramRasterIsPointSpriteEnabled(rs_program_raster pr); | 编译 32 位时。API 级别 16 - 22 |
参数
pr | 要查询的程序光栅化 |
---|
已弃用。请勿使用。
获取程序光栅化点精灵状态
rsgProgramStoreGetBlendDstFunc :获取程序存储混合目标函数
rs_blend_dst_func rsgProgramStoreGetBlendDstFunc(rs_program_store ps); | 编译 32 位时。API 级别 16 - 22 |
参数
ps | 要查询的程序存储 |
---|
已弃用。请勿使用。
获取程序存储混合目标函数
rsgProgramStoreGetBlendSrcFunc :获取程序存储混合源函数
rs_blend_src_func rsgProgramStoreGetBlendSrcFunc(rs_program_store ps); | 编译 32 位时。API 级别 16 - 22 |
参数
ps | 要查询的程序存储 |
---|
已弃用。请勿使用。
获取程序存储混合源函数
rsgProgramStoreGetDepthFunc :获取程序存储深度函数
rs_depth_func rsgProgramStoreGetDepthFunc(rs_program_store ps); | 编译 32 位时。API 级别 16 - 22 |
参数
ps | 要查询的程序存储 |
---|
已弃用。请勿使用。
获取程序存储深度函数
rsgProgramStoreIsColorMaskAlphaEnabled :获取程序存储 Alpha 分量颜色掩码
bool rsgProgramStoreIsColorMaskAlphaEnabled(rs_program_store ps); | 编译 32 位时。API 级别 16 - 22 |
参数
ps | 要查询的程序存储 |
---|
已弃用。请勿使用。
获取程序存储 Alpha 分量颜色掩码
rsgProgramStoreIsColorMaskBlueEnabled :获取程序存储蓝分量颜色掩码
bool rsgProgramStoreIsColorMaskBlueEnabled(rs_program_store ps); | 编译 32 位时。API 级别 16 - 22 |
参数
ps | 要查询的程序存储 |
---|
已弃用。请勿使用。
获取程序存储蓝分量颜色掩码
rsgProgramStoreIsColorMaskGreenEnabled :获取程序存储绿分量颜色掩码
bool rsgProgramStoreIsColorMaskGreenEnabled(rs_program_store ps); | 编译 32 位时。API 级别 16 - 22 |
参数
ps | 要查询的程序存储 |
---|
已弃用。请勿使用。
获取程序存储绿分量颜色掩码
rsgProgramStoreIsColorMaskRedEnabled :获取程序存储红分量颜色掩码
bool rsgProgramStoreIsColorMaskRedEnabled(rs_program_store ps); | 编译 32 位时。API 级别 16 - 22 |
参数
ps | 要查询的程序存储 |
---|
已弃用。请勿使用。
获取程序存储红分量颜色掩码
rsgProgramStoreIsDepthMaskEnabled :获取程序存储深度掩码
bool rsgProgramStoreIsDepthMaskEnabled(rs_program_store ps); | 编译 32 位时。API 级别 16 - 22 |
参数
ps | 要查询的程序存储 |
---|
已弃用。请勿使用。
获取程序存储深度掩码
rsgProgramStoreIsDitherEnabled :获取程序存储抖动状态
bool rsgProgramStoreIsDitherEnabled(rs_program_store ps); | 编译 32 位时。API 级别 16 - 22 |
参数
ps | 要查询的程序存储 |
---|
已弃用。请勿使用。
获取程序存储抖动状态
rsgProgramVertexGetProjectionMatrix :获取固定功能顶点程序的投影矩阵
void rsgProgramVertexGetProjectionMatrix(rs_matrix4x4* proj); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
参数
proj | 用于存储当前投影矩阵的矩阵 |
---|
已弃用。请勿使用。
获取当前绑定的固定功能顶点程序的投影矩阵。使用自定义顶点着色器调用此函数将导致错误。
rsgProgramVertexLoadModelMatrix :为绑定的固定功能顶点程序加载模型矩阵
void rsgProgramVertexLoadModelMatrix(const rs_matrix4x4* model); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
参数
model | 模型矩阵 |
---|
已弃用。请勿使用。
为当前绑定的固定功能顶点程序加载模型矩阵。使用自定义顶点着色器调用此函数将导致错误。
rsgProgramVertexLoadProjectionMatrix :为绑定的固定功能顶点程序加载投影矩阵
void rsgProgramVertexLoadProjectionMatrix(const rs_matrix4x4* proj); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
参数
proj | 投影矩阵 |
---|
已弃用。请勿使用。
为当前绑定的固定功能顶点程序加载投影矩阵。使用自定义顶点着色器调用此函数将导致错误。
rsgProgramVertexLoadTextureMatrix :为绑定的固定功能顶点程序加载纹理矩阵
void rsgProgramVertexLoadTextureMatrix(const rs_matrix4x4* tex); | 编译 32 位时。从 API 级别 23 及更高版本中移除 |
参数
tex | 纹理矩阵 |
---|
已弃用。请勿使用。
为当前绑定的固定功能顶点程序加载纹理矩阵。使用自定义顶点着色器调用此函数将导致错误。