Функции и типы вызова ядра RenderScript,Функции и типы вызова ядра RenderScript

Запускает ядро ​​при нулевом или более распределении входных данных. Они передаются после аргумента 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 не требуется выделение входных или выходных данных. Если передаются выделения, они должны соответствовать количеству аргументов и возвращаемому значению, ожидаемому функцией ядра. Распределение вывода присутствует тогда и только тогда, когда ядро ​​имеет непустое возвращаемое значение.

Например,
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.

Вы можете получить доступ к контексту ядра, добавив в функцию ядра специальный параметр с именем «context» типа rs_kernel_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);
//...
}


Эта функция возвращает 0, если измерение Array0 отсутствует.

Возвращает индекс в измерении Array1 обрабатываемой ячейки, как указано в предоставленном контексте ядра. См. rsGetArray0 () для объяснения контекста.

Возвращает 0, если измерение Array1 отсутствует.

Возвращает индекс в измерении Array2 обрабатываемой ячейки, как указано в предоставленном контексте ядра. См. rsGetArray0 () для объяснения контекста.

Возвращает 0, если измерение Array2 отсутствует.

Возвращает индекс в измерении Array3 обрабатываемой ячейки, как указано в предоставленном контексте ядра. См. rsGetArray0 () для объяснения контекста.

Возвращает 0, если измерение Array3 отсутствует.

Возвращает размер измерения Array0 для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если измерение Array0 отсутствует.

Возвращает размер измерения Array1 для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если измерение Array1 отсутствует.

Возвращает размер измерения Array2 для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если измерение Array2 отсутствует.

Возвращает размер измерения Array3 для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если измерение Array3 отсутствует.

Если ядро ​​выполняет итерацию по кубической карте, эта функция возвращает true, если присутствует более одной грани. Во всех остальных случаях он возвращает false. См. rsGetDimX () для объяснения контекста.

rsAllocationGetDimFaces () аналогичен, но возвращает 0 или 1 вместо логического значения.

Возвращает количество уровней детализации для указанного контекста ядра. Это полезно для MIP-карт. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если уровень детализации не используется.

rsAllocationGetDimLOD () аналогичен, но возвращает 0 или 1 вместо фактического количества уровней.

Возвращает размер измерения X для указанного контекста ядра.

Контекст ядра содержит общие характеристики перебираемых выделений и редко используемые индексы, такие как индекс Array0.

Вы можете получить к нему доступ, добавив в функцию ядра специальный параметр с именем «context» типа rs_kernel_context. Например
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
uint32_t size = rsGetDimX(context); //...


Чтобы получить размерность конкретного распределения, используйте rsAllocationGetDimX ().

Возвращает размер измерения X для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если измерение Y отсутствует.

Чтобы получить размерность конкретного распределения, используйте rsAllocationGetDimY ().

Возвращает размер измерения Z для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если размер Z отсутствует.

Чтобы получить размерность конкретного распределения, используйте rsAllocationGetDimZ ().

Возвращает грань, на которой находится обрабатываемая ячейка, как указано в предоставленном контексте ядра. См. rsGetArray0 () для объяснения контекста.

Возвращает RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X, если размер грани отсутствует.

Возвращает индекс в измерении «Уровни детализации» обрабатываемой ячейки, как указано в предоставленном контексте ядра. См. rsGetArray0 () для объяснения контекста.

Возвращает 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 не требуется выделение входных или выходных данных. Если передаются выделения, они должны соответствовать количеству аргументов и возвращаемому значению, ожидаемому функцией ядра. Распределение вывода присутствует тогда и только тогда, когда ядро ​​имеет непустое возвращаемое значение.

Например,
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.

Вы можете получить доступ к контексту ядра, добавив в функцию ядра специальный параметр с именем «context» типа rs_kernel_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);
//...
}


Эта функция возвращает 0, если измерение Array0 отсутствует.

Возвращает индекс в измерении Array1 обрабатываемой ячейки, как указано в предоставленном контексте ядра. См. rsGetArray0 () для объяснения контекста.

Возвращает 0, если измерение Array1 отсутствует.

Возвращает индекс в измерении Array2 обрабатываемой ячейки, как указано в предоставленном контексте ядра. См. rsGetArray0 () для объяснения контекста.

Возвращает 0, если измерение Array2 отсутствует.

Возвращает индекс в измерении Array3 обрабатываемой ячейки, как указано в предоставленном контексте ядра. См. rsGetArray0 () для объяснения контекста.

Возвращает 0, если измерение Array3 отсутствует.

Возвращает размер измерения Array0 для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если измерение Array0 отсутствует.

Возвращает размер измерения Array1 для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если измерение Array1 отсутствует.

Возвращает размер измерения Array2 для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если измерение Array2 отсутствует.

Возвращает размер измерения Array3 для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если измерение Array3 отсутствует.

Если ядро ​​выполняет итерацию по кубической карте, эта функция возвращает true, если присутствует более одной грани. Во всех остальных случаях он возвращает false. См. rsGetDimX () для объяснения контекста.

rsAllocationGetDimFaces () аналогичен, но возвращает 0 или 1 вместо логического значения.

Возвращает количество уровней детализации для указанного контекста ядра. Это полезно для MIP-карт. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если уровень детализации не используется.

rsAllocationGetDimLOD () аналогичен, но возвращает 0 или 1 вместо фактического количества уровней.

Возвращает размер измерения X для указанного контекста ядра.

Контекст ядра содержит общие характеристики перебираемых выделений и редко используемые индексы, такие как индекс Array0.

Вы можете получить к нему доступ, добавив в функцию ядра специальный параметр с именем «context» типа rs_kernel_context. Например
int4 RS_KERNEL myKernel(int4 value, rs_kernel_context context) {
uint32_t size = rsGetDimX(context); //...


Чтобы получить размерность конкретного распределения, используйте rsAllocationGetDimX ().

Возвращает размер измерения X для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если измерение Y отсутствует.

Чтобы получить размерность конкретного распределения, используйте rsAllocationGetDimY ().

Возвращает размер измерения Z для указанного контекста ядра. См. rsGetDimX () для объяснения контекста.

Возвращает 0, если размер Z отсутствует.

Чтобы получить размерность конкретного распределения, используйте rsAllocationGetDimZ ().

Возвращает грань, на которой находится обрабатываемая ячейка, как указано в предоставленном контексте ядра. См. rsGetArray0 () для объяснения контекста.

Возвращает RS_ALLOCATION_CUBEMAP_FACE_POSITIVE_X, если размер грани отсутствует.

Возвращает индекс в измерении «Уровни детализации» обрабатываемой ячейки, как указано в предоставленном контексте ядра. См. rsGetArray0 () для объяснения контекста.

Возвращает 0, если измерение «Уровни детализации» отсутствует.