RenderSettings(bpy_struct)#

base class — bpy_struct

class bpy.types.RenderSettings(bpy_struct)#

Rendering settings for a Scene data-block

bake#
Type:

BakeSettings, (readonly, never None)

bake_bias#

Bias towards faces further away from the object (in Blender units)

Type:

float in [0, 1000], default 0.001

bake_margin#

Extends the baked result as a post process filter

Type:

int in [0, 64], default 16

bake_margin_type#

Algorithm to generate the margin

  • ADJACENT_FACES Adjacent Faces – Use pixels from adjacent faces across UV seams.

  • EXTEND Extend – Extend border pixels outwards.

Type:

enum in [‘ADJACENT_FACES’, ‘EXTEND’], default ‘ADJACENT_FACES’

bake_samples#

Number of samples used for ambient occlusion baking from multires

Type:

int in [64, 1024], default 256

bake_type#

Choose shading information to bake into the image

  • NORMALS Normals – Bake normals.

  • DISPLACEMENT Displacement – Bake displacement.

Type:

enum in [‘NORMALS’, ‘DISPLACEMENT’], default ‘NORMALS’

bake_user_scale#

Instead of automatically normalizing to the range 0 to 1, apply a user scale to the derivative map

Type:

float in [0, 1000], default 0.0

border_max_x#

Maximum X value for the render region

Type:

float in [0, 1], default 1.0

border_max_y#

Maximum Y value for the render region

Type:

float in [0, 1], default 1.0

border_min_x#

Minimum X value for the render region

Type:

float in [0, 1], default 0.0

border_min_y#

Minimum Y value for the render region

Type:

float in [0, 1], default 0.0

dither_intensity#

Amount of dithering noise added to the rendered image to break up banding

Type:

float in [0, inf], default 1.0

engine#

Engine to use for rendering

Type:

enum in [‘BLENDER_EEVEE’], default ‘BLENDER_EEVEE’

ffmpeg#

FFmpeg related settings for the scene

Type:

FFmpegSettings, (readonly)

file_extension#

The file extension used for saving renders

Type:

string, default “”, (readonly, never None)

filepath#

Directory/name to save animations, # characters define the position and padding of frame numbers

Type:

string, default “”, (never None)

film_transparent#

World background is transparent, for compositing the render over another background

Type:

boolean, default False

filter_size#

Width over which the reconstruction filter combines samples

Type:

float in [0, 500], default 1.5

fps#

Framerate, expressed in frames per second

Type:

int in [1, 32767], default 24

fps_base#

Framerate base

Type:

float in [1e-05, 1e+06], default 1.0

frame_map_new#

How many frames the Map Old will last

Type:

int in [1, 900], default 100

frame_map_old#

Old mapping value in frames

Type:

int in [1, 900], default 100

hair_subdiv#

Additional subdivision along the curves

Type:

int in [0, 3], default 0

hair_type#

Curves shape type

Type:

enum in [‘STRAND’, ‘STRIP’], default ‘STRAND’

has_multiple_engines#

More than one rendering engine is available

Type:

boolean, default False, (readonly)

image_settings#
Type:

ImageFormatSettings, (readonly, never None)

is_movie_format#

When true the format is a movie

Type:

boolean, default False, (readonly)

line_thickness#

Line thickness in pixels

Type:

float in [0, 10000], default 1.0

line_thickness_mode#

Line thickness mode for Freestyle line drawing

  • ABSOLUTE Absolute – Specify unit line thickness in pixels.

  • RELATIVE Relative – Unit line thickness is scaled by the proportion of the present vertical image resolution to 480 pixels.

Type:

enum in [‘ABSOLUTE’, ‘RELATIVE’], default ‘ABSOLUTE’

metadata_input#

Where to take the metadata from

  • SCENE Scene – Use metadata from the current scene.

  • STRIPS Sequencer Strips – Use metadata from the strips in the sequencer.

Type:

enum in [‘SCENE’, ‘STRIPS’], default ‘SCENE’

motion_blur_position#

Offset for the shutter’s time interval, allows to change the motion blur trails

  • START Start on Frame – The shutter opens at the current frame.

  • CENTER Center on Frame – The shutter is open during the current frame.

  • END End on Frame – The shutter closes at the current frame.

Type:

enum in [‘START’, ‘CENTER’, ‘END’], default ‘CENTER’

motion_blur_shutter#

Time taken in frames between shutter open and close

Type:

float in [0, inf], default 0.5

motion_blur_shutter_curve#

Curve defining the shutter’s openness over time

Type:

CurveMapping, (readonly)

pixel_aspect_x#

Horizontal aspect ratio - for anamorphic or non-square pixel output

Type:

float in [1, 200], default 1.0

pixel_aspect_y#

Vertical aspect ratio - for anamorphic or non-square pixel output

Type:

float in [1, 200], default 1.0

preview_pixel_size#

Pixel size for viewport rendering

  • AUTO Automatic – Automatic pixel size, depends on the user interface scale.

  • 1 1× – Render at full resolution.

  • 2 2× – Render at 50% resolution.

  • 4 4× – Render at 25% resolution.

  • 8 8× – Render at 12.5% resolution.

Type:

enum in [‘AUTO’, ‘1’, ‘2’, ‘4’, ‘8’], default ‘AUTO’

resolution_percentage#

Percentage scale for render resolution

Type:

int in [1, 32767], default 100

resolution_x#

Number of horizontal pixels in the rendered image

Type:

int in [4, 65536], default 1920

resolution_y#

Number of vertical pixels in the rendered image

Type:

int in [4, 65536], default 1080

sequencer_gl_preview#

Display method used in the sequencer view

Type:

enum in Shading Type Items, default ‘SOLID’

simplify_child_particles#

Global child particles percentage

Type:

float in [0, 1], default 1.0

simplify_child_particles_render#

Global child particles percentage during rendering

Type:

float in [0, 1], default 0.0

simplify_gpencil#

Simplify Grease Pencil drawing

Type:

boolean, default False

simplify_gpencil_antialiasing#

Use Antialiasing to smooth stroke edges

Type:

boolean, default False

simplify_gpencil_modifier#

Display modifiers

Type:

boolean, default False

simplify_gpencil_onplay#

Simplify Grease Pencil only during animation playback

Type:

boolean, default False

simplify_gpencil_shader_fx#

Display Shader Effects

Type:

boolean, default False

simplify_gpencil_tint#

Display layer tint

Type:

boolean, default False

simplify_gpencil_view_fill#

Display fill strokes in the viewport

Type:

boolean, default False

simplify_shadows#

Resolution percentage of shadows in viewport

Type:

float in [0, 1], default 1.0

simplify_shadows_render#

Resolution percentage of shadows in viewport

Type:

float in [0, 1], default 1.0

simplify_subdivision#

Global maximum subdivision level

Type:

int in [0, 32767], default 6

simplify_subdivision_render#

Global maximum subdivision level during rendering

Type:

int in [0, 32767], default 0

simplify_volumes#

Resolution percentage of volume objects in viewport

Type:

float in [0, 1], default 1.0

stamp_background#

Color to use behind stamp text

Type:

float array of 4 items in [0, 1], default (0.0, 0.0, 0.0, 0.25)

stamp_font_size#

Size of the font used when rendering stamp text

Type:

int in [8, 64], default 12

stamp_foreground#

Color to use for stamp text

Type:

float array of 4 items in [0, 1], default (0.8, 0.8, 0.8, 1.0)

stamp_note_text#

Custom text to appear in the stamp note

Type:

string, default “”, (never None)

stereo_views#
Type:

bpy_prop_collection of SceneRenderView, (readonly)

threads#

Maximum number of CPU cores to use simultaneously while rendering (for multi-core/CPU systems)

Type:

int in [1, 1024], default 1

threads_mode#

Determine the amount of render threads used

  • AUTO Auto-Detect – Automatically determine the number of threads, based on CPUs.

  • FIXED Fixed – Manually determine the number of threads.

Type:

enum in [‘AUTO’, ‘FIXED’], default ‘AUTO’

use_bake_clear#

Clear Images before baking

Type:

boolean, default True

use_bake_lores_mesh#

Calculate heights against unsubdivided low resolution mesh

Type:

boolean, default False

use_bake_multires#

Bake directly from multires object

Type:

boolean, default False

use_bake_selected_to_active#

Bake shading on the surface of selected objects to the active object

Type:

boolean, default False

use_bake_user_scale#

Use a user scale for the derivative map

Type:

boolean, default False

use_border#

Render a user-defined render region, within the frame size

Type:

boolean, default False

use_compositing#

Process the render result through the compositing pipeline, if compositing nodes are enabled

Type:

boolean, default True

use_crop_to_border#

Crop the rendered frame to the defined render region size

Type:

boolean, default False

use_file_extension#

Add the file format extensions to the rendered file name (eg: filename + .jpg)

Type:

boolean, default True

use_freestyle#

Draw stylized strokes using Freestyle

Type:

boolean, default False

use_high_quality_normals#

Use high quality tangent space at the cost of lower performance

Type:

boolean, default False

use_lock_interface#

Lock interface during rendering in favor of giving more memory to the renderer

Type:

boolean, default False

use_motion_blur#

Use multi-sampled 3D scene motion blur

Type:

boolean, default False

use_multiview#

Use multiple views in the scene

Type:

boolean, default False

use_overwrite#

Overwrite existing files while rendering

Type:

boolean, default False

use_persistent_data#

Keep render data around for faster re-renders and animation renders, at the cost of increased memory usage

Type:

boolean, default False

use_placeholder#

Create empty placeholder files while rendering frames (similar to Unix ‘touch’)

Type:

boolean, default False

use_render_cache#

Save render cache to EXR files (useful for heavy compositing, Note: affects indirectly rendered scenes)

Type:

boolean, default False

use_sequencer#

Process the render (and composited) result through the video sequence editor pipeline, if sequencer strips exist

Type:

boolean, default True

use_sequencer_override_scene_strip#

Use workbench render settings from the sequencer scene, instead of each individual scene used in the strip

Type:

boolean, default False

use_simplify#

Enable simplification of scene for quicker preview renders

Type:

boolean, default False

use_simplify_normals#

Skip computing custom normals and face corner normals for displaying meshes in the viewport

Type:

boolean, default False

use_single_layer#

Only render the active layer. Only affects rendering from the interface, ignored for rendering from command line

Type:

boolean, default False

use_spherical_stereo#

Active render engine supports spherical stereo rendering

Type:

boolean, default False, (readonly)

use_stamp#

Render the stamp info text in the rendered image

Type:

boolean, default False

use_stamp_camera#

Include the name of the active camera in image metadata

Type:

boolean, default True

use_stamp_date#

Include the current date in image/video metadata

Type:

boolean, default True

use_stamp_filename#

Include the .blend filename in image/video metadata

Type:

boolean, default True

use_stamp_frame#

Include the frame number in image metadata

Type:

boolean, default True

use_stamp_frame_range#

Include the rendered frame range in image/video metadata

Type:

boolean, default False

use_stamp_hostname#

Include the hostname of the machine that rendered the frame

Type:

boolean, default False

use_stamp_labels#

Display stamp labels (“Camera” in front of camera name, etc.)

Type:

boolean, default False

use_stamp_lens#

Include the active camera’s lens in image metadata

Type:

boolean, default False

use_stamp_marker#

Include the name of the last marker in image metadata

Type:

boolean, default False

use_stamp_memory#

Include the peak memory usage in image metadata

Type:

boolean, default True

use_stamp_note#

Include a custom note in image/video metadata

Type:

boolean, default False

use_stamp_render_time#

Include the render time in image metadata

Type:

boolean, default True

use_stamp_scene#

Include the name of the active scene in image/video metadata

Type:

boolean, default True

use_stamp_sequencer_strip#

Include the name of the foreground sequence strip in image metadata

Type:

boolean, default False

use_stamp_time#

Include the rendered frame timecode as HH:MM:SS.FF in image metadata

Type:

boolean, default True

views#
Type:

RenderViews bpy_prop_collection of SceneRenderView, (readonly)

views_format#
  • STEREO_3D Stereo 3D – Single stereo camera system, adjust the stereo settings in the camera panel.

  • MULTIVIEW Multi-View – Multi camera system, adjust the cameras individually.

Type:

enum in [‘STEREO_3D’, ‘MULTIVIEW’], default ‘STEREO_3D’

frame_path(frame=-2147483648, preview=False, view='')#

Return the absolute path to the filename to be written for a given frame

Parameters:
  • frame (int in [-inf, inf], (optional)) – Frame number to use, if unset the current frame will be used

  • preview (boolean, (optional)) – Preview, Use preview range

  • view (string, (optional, never None)) – View, The name of the view to use to replace the “%” chars

Returns:

File Path, The resulting filepath from the scenes render settings

Return type:

string, (never None)

classmethod bl_rna_get_subclass(id, default=None)#
Parameters:

id (string) – The RNA type identifier.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)#
Parameters:

id (string) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

Inherited Properties#

Inherited Functions#

References#