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 defines the position and length 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 hair
- Type
int in [0, 3], default 0
- hair_type
Hair 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_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
1x – Render at full resolution.2
2x – Render at 50% resolution.4
4x – Render at 25% resolution.8
8x – 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
WIREFRAME
Wireframe – Display the object as wire edges.SOLID
Solid – Display in solid mode.MATERIAL
Material Preview – Display in Material Preview mode.RENDERED
Rendered – Display render preview.
- Type
enum in [‘WIREFRAME’, ‘SOLID’, ‘MATERIAL’, ‘RENDERED’], 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_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
ofSceneRenderView
, (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_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
ofSceneRenderView
, (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