Funções de acesso a dados de alocação do RenderScript

Copia o número especificado de células de uma alocação para outra.

É preciso que as duas alocações sejam diferentes. O uso dessa função para copiar dentro da mesma alocação gera resultados indefinidos.

A função não valida se a contagem de deslocamento mais excede o tamanho de qualquer alocação. Se cuida.

Essa função só deve ser chamada entre alocações 1D. Não é possível chamá-lo em outras alocações.

Essa função não deve ser chamada de dentro de um kernel ou de qualquer função que possa ser chamada direta ou indiretamente de um kernel. Isso causaria um erro no momento da execução.

Copia uma região retangular de células de uma alocação para outra. (largura * altura) são copiadas.

É preciso que as duas alocações sejam diferentes. O uso dessa função para copiar dentro da mesma alocação gera resultados indefinidos.

A função não valida se a região de origem ou de destino excede o tamanho da respectiva alocação. Se cuida.

A função só deve ser chamada entre alocações 2D. Não é possível chamá-lo em outras alocações.

Essa função não deve ser chamada de dentro de um kernel ou de qualquer função que possa ser chamada direta ou indiretamente de um kernel. Isso causaria um erro no momento da execução.

Essa função retorna um vetor composto por células sucessivas da alocação. Ele pressupõe que a alocação contenha escalares.

O "X" no nome indica que valores sucessivos são extraídos ao aumentar o índice X. Atualmente, não há funções para conseguir valores sucessivos incrementando outras dimensões. Em vez disso, use várias chamadas para rsGetElementAt().

Por exemplo, ao chamar rsAllocationVLoadX_int4(a, 20, 30), um int4 composto por a[20, 30], a[21, 30], a[22, 30] e a[23, 30] é retornado.

Ao recuperar alocações tridimensionais, use a variante x, y, z. Da mesma forma, use a variante x, y para alocações bidimensionais e x para alocações monodimensionais.

Para fins de eficiência, essa função não valida as entradas. Tentar unir o índice X, exceder o tamanho da alocação ou usar índices incompatíveis com a dimensionalidade da alocação gera resultados indefinidos.

Veja também rsAllocationVStoreX().

Essa função armazena as entradas de um vetor em células sucessivas de uma alocação. Ele pressupõe que a alocação contenha escalares.

O "X" no nome indica que valores sucessivos são armazenados aumentando o índice X. No momento, não há funções para armazenar valores sucessivos que incrementam outras dimensões. Em vez disso, use várias chamadas para rsSetElementAt().

Por exemplo, ao chamar rsAllocationVStoreX_int3(a, v, 20, 30), v.x é armazenada em a[20, 30], v.y em a[21, 30] e v.z em a[22, 30].

Ao armazenar em alocações tridimensionais, use a variante x, y, z. Da mesma forma, use a variante x, y para alocações bidimensionais e x para alocações monodimensionais.

Para fins de eficiência, essa função não valida as entradas. Tentar unir o índice X, exceder o tamanho da alocação ou usar índices incompatíveis com a dimensionalidade da alocação gera resultados indefinidos.

Veja também rsAllocationVLoadX().

Essa função extrai uma única célula de uma alocação.

Ao recuperar alocações tridimensionais, use a variante x, y, z. Da mesma forma, use a variante x, y para alocações bidimensionais e x para alocações monodimensionais.

Essa função tem dois estilos. Um retorna o endereço do valor usando um valor nulo*, o outro retorna o valor real, por exemplo, rsGetElementAt() versus rsGetElementAt_int4(). Para tipos primitivos, use sempre o último, porque ele é mais eficiente.

Extrai o componente U de um único valor YUV de uma alocação 2D de YUVs.

Dentro de uma alocação, os componentes Y, U e V podem ser armazenados se planos diferentes e resoluções diferentes. As coordenadas x, y fornecidas aqui estão nas dimensões do plano Y.

Consulte rsGetElementAtYuv_uchar_Y().

Extrai o componente V de um único valor de YUV de uma alocação 2D de YUVs.

Dentro de uma alocação, os componentes Y, U e V podem ser armazenados se planos diferentes e resoluções diferentes. As coordenadas x, y fornecidas aqui estão nas dimensões do plano Y.

Consulte rsGetElementAtYuv_uchar_Y().

Extrai o componente Y de um único valor de YUV de uma alocação 2D de YUVs.

Dentro de uma alocação, os componentes Y, U e V podem ser armazenados se planos diferentes e resoluções diferentes. As coordenadas x, y fornecidas aqui estão nas dimensões do plano Y.

Consulte rsGetElementAtYuv_uchar_U() e rsGetElementAtYuv_uchar_V().

Busca um valor de uma alocação de textura da forma descrita pelo sampler.

Se a alocação for 1D, use a variante com ponto flutuante para o local. Para 2D, use a variante float2.

Consulte android.renderscript.Sampler para saber mais.

Essa função armazena um valor em uma única célula de uma alocação.

Ao armazenar em alocações tridimensionais, use a variante x, y, z. Da mesma forma, use a variante x, y para alocações bidimensionais e x para alocações monodimensionais.

Essa função tem dois estilos. Um transmite o valor a ser armazenado usando um void*, o outro tem o valor real como argumento, por exemplo, rsSetElementAt() versus rsSetElementAt_int4(). Para tipos primitivos, use sempre o último, porque ele é mais eficiente.

Veja também rsGetElementAt().