Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


ScheduleReadOnly<T>(T, TransformAccessArray, int, JobHandle)

Schedules an IJobParallelForTransform job with read-only access to the transform data.
Read time 1 minuteLast updated a month ago

Definition

public static JobHandle ScheduleReadOnly<T>(this T jobData, TransformAccessArray transforms, int batchSize, JobHandle dependsOn = default) where T : struct, IJobParallelForTransform

Parameters

jobData

T
The job to schedule.

The TransformAccessArray to run the job on.

batchSize

Granularity in which workstealing is performed. For example, a value of 32 means the job queue will steal 32 iterations and then perform them in an efficient inner loop.

dependsOn

A JobHandle containing any jobs that must finish executing before this job begins. You can combine multiple jobs with JobHandle.CombineDependencies. Use dependencies to ensure that two jobs that read or write to the same data don't run in parallel.

Returns

Type

Description

JobHandleThe handle identifying the scheduled job, which you can use as a dependency for a later job or to ensure completion on the main thread.

Remarks

This method provides better parallelization because it can read all transforms in parallel instead of just parallelizing over different hierarchies. Transforms aren't guaranteed to be valid when this scheduling mode is used. Invalid transform references in the input array are still processed. Use TransformAccess.isValid to check whether a specific instance is valid.