Rendering check
Sample Count Limit
Checks whether Cycles render samples are higher than recommended for the current output resolution.
Why this check exists
Helps prevent wasted render time. Sample count should be matched to your target output resolution — higher resolutions reveal more surface detail and benefit from a larger sample budget to keep noise controlled, while lower resolutions don't need as many samples to look clean. Setting samples higher than necessary for your resolution just adds render time without improving the final image.
Behavior
| Module |
rendering/sample_count_limit.py
|
|---|---|
| Included with | Core |
| Severity | Warning |
| Automatic fix | Yes |
| Fix behavior | An automatic fix is available. |
| User settings | Yes |
| Selection support | Object |
Settings
| Setting | ID | Type | Default | Description |
|---|---|---|---|---|
| Maximum Samples at 720p |
samples_720p
|
int | 256 |
Maximum recommended Cycles samples for output up to 1280 × 720.
Min: 1 · Max: 100000
|
| Maximum Samples at 1080p |
samples_1080p
|
int | 512 |
Maximum recommended Cycles samples for output up to 1920 × 1080.
Min: 1 · Max: 100000
|
| Maximum Samples at 1440p |
samples_1440p
|
int | 768 |
Maximum recommended Cycles samples for output up to 2560 × 1440.
Min: 1 · Max: 100000
|
| Maximum Samples at 4K |
samples_4k
|
int | 1024 |
Maximum recommended Cycles samples for output up to 3840 × 2160.
Min: 1 · Max: 100000
|
| Allow Automatic Fix |
allow_auto_fix
|
bool | True |
Allow the check to reduce the scene sample count to the recommended value.
|