Skip to content

docs: Add Cinema 4D Tile Rendering support doc - #260

Closed
gianelli-lagos-aws wants to merge 5 commits into
aws-deadline:mainlinefrom
gianelli-lagos-aws:tile_rendering_doc
Closed

docs: Add Cinema 4D Tile Rendering support doc#260
gianelli-lagos-aws wants to merge 5 commits into
aws-deadline:mainlinefrom
gianelli-lagos-aws:tile_rendering_doc

Conversation

@gianelli-lagos-aws

Copy link
Copy Markdown
Contributor

Fixes: #210

This PR is related to #256.

What was the problem/requirement? (What/Why)

Add doc that explains how to use tile rendering.

What was the solution? (How)

Added a doc that contains the instructions on how to use tile rendering in Cinema 4D.

What is the impact of this change?

Customers will be able to use tile rendering.


By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Signed-off-by: Lagos Gonzales <214008711+gianelli-lagos-aws@users.noreply.github.com>
@gianelli-lagos-aws
gianelli-lagos-aws requested a review from a team as a code owner July 24, 2025 16:59
Comment thread docs/tile_rendering/tile_rendering.md Outdated
Comment thread docs/tile_rendering/tile_rendering.md
### Platform Compatibility

* Tile rendering works on both Windows and Linux environments

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of multiple headers with a single bullet point in each, can we just have one list of supported flows (OS platforms, multi-pass, multiple output types, file formats), and then one list of unsupported flows (Redshift camera, render tokens).

Also, do we support the Redshift renderer when a physical camera is used? That's a pretty easy workaround to still support Redshift even if Redshift cameras don't work.

For the specific instructions about multi-pass outputs, can we just include them in the step by step instructions?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I agree, I will see how I can improve the layout there.
I will check to see if we support the Redshift renderer when a physical camera is used and let you know!
I also agree that the multi-pass output instructions can go in the actual instructions. Thank you!

Comment thread docs/tile_rendering/tile_rendering.md Outdated
* Set "Tiles per Axis" (between 2-5, where 5x5 creates 25 tiles)
* Set "Reference Camera" by dragging your default camera to this field
* Check "Use Tiling" to enable tile rendering
* ![Render Tiles attributes](images/render_tiles_attributes.png)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: does it look better if images are outside the bullet points i.e. unindented?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes! I will update it.

Comment thread docs/tile_rendering/tile_rendering.md Outdated

#### Configure Render Settings

1. Go to "Render Settings" and set "Renderer" to "Physical"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar note as above - it would be great if we could use Redshift, just with a physical camera

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yep, I will look into it!

Comment thread docs/tile_rendering/tile_rendering.md Outdated
* ![Render settings frame configuration](images/render_settings_frames.png)
3. In the "Save" tab:
* Set the file path to your desired output folder
* Choose either "REGULAR IMAGE" or "MULTI-PASS IMAGE"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Or both?

@gianelli-lagos-aws gianelli-lagos-aws Jul 24, 2025

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yep! I will update it.

Comment thread docs/tile_rendering/tile_rendering.md Outdated

* If you select both "REGULAR IMAGE" and "MULTI-PASS IMAGE" as save options:
* Both outputs will be stitched separately, resulting in two final images
* File naming is critical: ensure regular image filenames alphabetically precede multi-pass filenames

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we share an example here? Also is there a reason why regular image filenames should always precede multi-pass filenames?

@gianelli-lagos-aws gianelli-lagos-aws Jul 24, 2025

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, i can add an image of the outputs in the case both are selected. Regular image filenames should always precede multi-pass filenames because the first files are expected to be regular outputs since stitching OutputPath goes first and then MultiPassPath goes.

Comment thread docs/tile_rendering/tile_rendering.md Outdated
Comment on lines +71 to +75
2. In the "Output" tab:
* Set "Frame Range" to Manual
* Set "From" to 0
* Set "To" to (number of tiles - 1)
* ![Render settings frame configuration](images/render_settings_frames.png)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm, the submitter would be calculating this no?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, I need to update this doc with that information after writing the code. Thank you!

Comment thread docs/tile_rendering/tile_rendering.md Outdated
### Access Results

1. Once the job completes, download the output
2. Open the output folder to find the "stitched_output.tif" file containing your final rendered image

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the name of the stitched output always "stitched_output"? Regardless of the name of the actual output files?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, there could either be "stitched_output" or "stitched_multipass" or both. Currently, I do not take into consideration the names of the files.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm, maybe we should mention "stitched_multipass" too (if customers are using multipass)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh okay! Yes.

Signed-off-by: Lagos Gonzales <214008711+gianelli-lagos-aws@users.noreply.github.com>
Comment thread docs/tile_rendering/tile_rendering.md Outdated

When you enable tile rendering, the submitter automatically:
* Adds `conda-forge` to the Conda channels
* Adds `ffmpeg` to the Conda packages (required for tile stitching)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you describe what ffmpeg is?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello! Yes I can add that information, thank you! :)

@anika-suman-amazon
anika-suman-amazon self-requested a review July 25, 2025 16:55
Signed-off-by: Lagos Gonzales <214008711+gianelli-lagos-aws@users.noreply.github.com>
Signed-off-by: Lagos Gonzales <214008711+gianelli-lagos-aws@users.noreply.github.com>

@karthikbekalp karthikbekalp left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Few nits now that we have confirmed that we are able to render with Redshift renderer as well.

Comment thread docs/tile_rendering/tile_rendering.md Outdated

### Current Limitations

* Using a Redshift renderer and camera

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe using a Redshift renderer is no longer an issue?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, I need to update this! Thank you.

Comment thread docs/tile_rendering/tile_rendering.md Outdated

#### Configure Render Settings

1. Go to "Render Settings" and set "Renderer" to "Physical"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe this is no longer a requirement now that we have confirmed that it works with Redshift renderer too on a Physical camera?
Also, can you double check if all the different render engines work? Physical, Standard etc with this feature?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, I need to update this and I will test the other renderers. Ty!

Comment thread docs/tile_rendering/tile_rendering.md Outdated
#### Set Up Camera

1. Add a default camera object to your scene
2. Ensure the camera is using the Physical renderer

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we don't need this anymore?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yep! It must be physical camera.

Comment thread docs/tile_rendering/tile_rendering.md Outdated
### Access Results

1. Once the job completes, download the output
2. Open the output folder to find the "stitched_output.tif" file containing your final rendered image

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm, maybe we should mention "stitched_multipass" too (if customers are using multipass)

Comment thread docs/tile_rendering/tile_rendering.md Outdated
1. Once the job completes, download the output
2. Open the output folder to find the "stitched_output.tif" file containing your final rendered image

**File Size:** The final stitched image maintains the same dimensions and file size as a normal render - tile rendering doesn't affect the final image quality or size, only the rendering process.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if we need this line or maybe we should add this to the "what is tile rendering" section?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think adding it to the "what is tile rendering" section would be better! Ty!


### Supported Features

* Job submission is supported from Windows and Mac workstations

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we want to mention that these are the instructions for SMF and not CMF?

Because it will only work on CMF if customers have already installed ffmpeg?

### Current Limitations

* Using a Redshift renderer and camera
* Adding Render Tokens to the output paths

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Discussed offline about this, we should be able to fix this with a regex

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, that will be a follow up after this version is completed.

Signed-off-by: Lagos Gonzales <214008711+gianelli-lagos-aws@users.noreply.github.com>
@sonarqubecloud

Copy link
Copy Markdown

@gianelli-lagos-aws
gianelli-lagos-aws marked this pull request as draft July 30, 2025 23:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants