RenderScript 커널 호출 함수 및 유형

0개 이상의 입력 할당에 대해 커널을 실행합니다. rs_kernel 인수 뒤에 전달됩니다. 지정된 커널이 값을 반환하면 출력 할당을 마지막 인수로 지정해야 합니다. 모든 입력 할당과 출력 할당(있는 경우)은 차원이 동일해야 합니다.

이는 동기 함수입니다. 이 함수 호출은 입력 할당의 모든 셀에 대해 모든 작업이 완료된 후에만 반환됩니다. 커널 함수가 값을 반환하면 호출은 모든 결과가 출력 할당에 기록될 때까지 대기합니다.

API 수준 23까지는 지정된 스크립트에서 커널이 'root'라는 커널로 암시적으로 지정되며 단일 입력 할당만 사용할 수 있습니다. API 수준 24부터는 커널 인수로 지정된 대로 임의의 커널 함수를 사용할 수 있습니다. 스크립트 인수가 삭제됩니다. 커널은 현재 스크립트에 정의되어야 합니다. 또한 둘 이상의 입력을 사용할 수 있습니다.

예:
float __attribute__((kernel)) square(float a) {
  return a * a;
}

void compute(rs_allocation ain, rs_allocation aout) {
  rsForEach(square, ain, aout);
}



커널을 실행하는 내부 API입니다.

rsForeach와 유사한 방식으로 커널을 실행합니다. 하지만 이 함수는 입력의 모든 셀을 처리하는 대신 옵션에 지정된 색인 공간의 하위 공간에 있는 셀만 처리합니다. 색인 공간이 옵션에 의해 명시적으로 지정되었으므로 이 API를 사용하는 커널 실행에 입력 또는 출력 할당이 필요하지 않습니다. 할당이 전달되는 경우 할당은 인수의 수와 커널 함수에서 예상되는 반환 값과 일치해야 합니다. 커널에 비 void 반환 값이 있는 경우에만 출력 할당이 존재합니다.

예:
rs_script_call_t opts = {0};
opts.xStart = 0;
opts.xEnd = dimX;
opts.yStart = 0;
opts.yEnd = dimY / 2;
rsForEachWithOptions(foo, &opts, out, out);


제공된 커널 컨텍스트에 지정된 대로 처리 중인 셀의 Array0 차원에 있는 색인을 반환합니다.

커널 컨텍스트에는 반복 중인 할당의 일반적인 특성과 Array0 색인과 같이 거의 사용되지 않는 색인이 포함되어 있습니다.

커널 함수에 rs_kernel_context 유형의 특수 매개변수 'context'를 추가하면 커널 컨텍스트에 액세스할 수 있습니다. 예:
short RS_KERNEL myKernel(short value, uint32_t x, rs_kernel_context context) {
  // The current index in the common x, y, z dimensions are accessed by
  // adding these variables as arguments. For the more rarely used indices
  // to the other dimensions, extract them from the kernel context:
  uint32_t index_a0 = rsGetArray0(context);
  //...
}


이 함수는 Array0 차원이 없으면 0을 반환합니다.

제공된 커널 컨텍스트에 지정된 대로 처리 중인 셀의 Array1 차원에서 색인을 반환합니다. 컨텍스트 설명은 rsGetArray0()을 참고하세요.

배열1 차원이 없으면 0을 반환합니다.

제공된 커널 컨텍스트에 지정된 대로 처리 중인 셀의 Array2 차원에서 색인을 반환합니다. 컨텍스트 설명은 rsGetArray0()을 참고하세요.

배열2 차원이 없으면 0을 반환합니다.

제공된 커널 컨텍스트에 지정된 대로 처리 중인 셀의 Array3 차원에서 색인을 반환합니다. 컨텍스트 설명은 rsGetArray0()을 참고하세요.

Array3 차원이 없으면 0을 반환합니다.

지정된 커널 컨텍스트의 Array0 차원 크기를 반환합니다. 컨텍스트 설명은 rsGetDimX()를 참고하세요.

배열0 차원이 없으면 0을 반환합니다.

지정된 커널 컨텍스트의 Array1 차원 크기를 반환합니다. 컨텍스트 설명은 rsGetDimX()를 참고하세요.

배열1 차원이 없으면 0을 반환합니다.

지정된 커널 컨텍스트의 Array2 차원 크기를 반환합니다. 컨텍스트 설명은 rsGetDimX()를 참고하세요.

배열2 차원이 없으면 0을 반환합니다.

지정된 커널 컨텍스트의 Array3 차원 크기를 반환합니다. 컨텍스트 설명은 rsGetDimX()를 참고하세요.

Array3 차원이 없으면 0을 반환합니다.

커널이 큐브맵을 반복하는 경우 얼굴이 2개 이상 있으면 이 함수는 true를 반환합니다. 그 외 모든 경우에는 false를 반환합니다. 컨텍스트에 관한 설명은 rsGetDimX()를 참고하세요.

rsAllocationGetDimFaces()는 유사하지만 부울 대신 0 또는 1을 반환합니다.

지정된 커널 컨텍스트의 세부정보 수준 수를 반환합니다. 이는 밉맵에 유용합니다. 컨텍스트 설명은 rsGetDimX()를 참고하세요.

세부정보 수준이 사용되지 않으면 0을 반환합니다.

rsAllocationGetDimLOD()도 비슷하지만, 실제 레벨 수 대신 0 또는 1을 반환합니다.

지정된 커널 컨텍스트의 X 차원 크기를 반환합니다.

커널 컨텍스트에는 반복 중인 할당의 일반적인 특성과 Array0 색인과 같이 거의 사용되지 않는 색인이 포함되어 있습니다.

커널 함수에 rs_kernel_context 유형의 특수 매개변수 'context'를 추가하면 액세스할 수 있습니다. 예:
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
  uint32_t size = rsGetDimX(context); //...


특정 할당의 측정기준을 가져오려면 rsAllocationGetDimX()를 사용하세요.

지정된 커널 컨텍스트의 X 차원 크기를 반환합니다. 컨텍스트 설명은 rsGetDimX()를 참고하세요.

Y 차원이 없으면 0을 반환합니다.

특정 할당의 측정기준을 가져오려면 rsAllocationGetDimY()를 사용하세요.

지정된 커널 컨텍스트의 Z 차원 크기를 반환합니다. 컨텍스트 설명은 rsGetDimX()를 참고하세요.

Z 차원이 없으면 0을 반환합니다.

특정 할당의 차원을 가져오려면 rsAllocationGetDimZ()를 사용합니다.

처리 중인 셀이 발견된 얼굴을 제공된 커널 컨텍스트에 지정된 대로 반환합니다. 컨텍스트 설명은 rsGetArray0()을 참고하세요.

얼굴 크기가 없으면 RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X를 반환합니다.

제공된 커널 컨텍스트에 지정된 대로 처리 중인 셀의 세부정보 수준 측정기준에 있는 색인을 반환합니다. 컨텍스트 설명은 rsGetArray0()을 참고하세요.

세부정보 수준 측정기준이 없으면 0을 반환합니다.