chore: Convert sample job templates to use task chunking for After Effects, Blender, Houdini and KeyShot#181
Conversation
…fects, Blender, Houdini and KeyShot Signed-off-by: cheriech <58997764+Cherie-Chen@users.noreply.github.com>
github-actions
bot
added
the
waiting-on-maintainers
Signed-off-by: cheriech <58997764+Cherie-Chen@users.noreply.github.com>
| Generally, the project file should be within this directory to | ||
| ensure relative paths are preserved. | ||
| # After Effects Render with Contiguous Chunks | ||
|
|
There was a problem hiding this comment.
should we keep both one task and chunking to help the reader know they all work?
There was a problem hiding this comment.
"One task" in the original title was misleading, in my opinion. The old sample had 1 step rendering frames 0–50, which produced 51 tasks. The new sample preserves exactly the same frame range (0–50) and the same step and task count — nothing about what the job template does has changed. The only addition is the TASK_CHUNKING extension element in the template, which enables the chunking capability.
The title change was meant to more clearly reflect what this job template sample actually demonstrates.
|
|
||
| ## Features | ||
|
|
||
| - **Task Chunking**: Uses `CHUNK[INT]` with contiguous frame ranges for parallel rendering across multiple workers |
There was a problem hiding this comment.
This needs a small adjustment. The reason for chunking is to reduce overhead by running chunks of short-running tasks together instead of scheduling each one individually. Chunking reduces parallelism. Particularly our new adaptive chunking mode is about automatically load balancing work more efficiently.
| A simple job bundle that allows a user to select | ||
| a project file and enter a comp to render with aerender. | ||
| A job bundle that renders an After Effects composition using aerender | ||
| with task chunking for efficient parallel rendering. |
There was a problem hiding this comment.
This description is better than above, because it says "efficient parallel rendering" instead of just "parallel rendering".
| ensure relative paths are preserved. | ||
| # After Effects Render with Contiguous Chunks | ||
|
|
||
| This job bundle renders After Effects compositions using aerender with the [Task Chunking](https://github.com/OpenJobDescription/openjd-specifications/blob/mainline/rfcs/0001-task-chunking.md) extension for efficient parallel rendering. |
There was a problem hiding this comment.
I think a nice benefit of using the task chunking feature is that rendering job templates can standardize on a single Frames job parameter that supports both ranges like 1-50 and pickup frames like 5,7-9,32 where you just want to re-render selected frames, and chunking applies well to both. With the StartFrame/EndFrame approach, you can't do the pickup frames in a simple way.
There was a problem hiding this comment.
I have updated README in task_chunking sample folder to call out the benefits of task chunking and revised files in this PR.
Cherie-Chen
removed
the
waiting-on-maintainers
Signed-off-by: cheriech <58997764+Cherie-Chen@users.noreply.github.com>
4 participants
chore: Convert sample job templates to use task chunking for After Effects, Blender, Houdini and KeyShot
What was the problem/requirement? (What/Why)
Now we support Task Chunking, we should update our sample job templates to use it.
What was the solution? (How)
Convert sample job templates to use task chunking. In this PR, it converts sample job templates forAfter Effects, Blender, Houdini and KeyShot and more to come.
What is the impact of this change?
User will have sample job templates using task chunking for the DCC they are working with.
How was this change tested?
I submitted job using these job templates and here is the results:
Was this change documented?
Yes, this PR also included doc changes
By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.