Setting render border coordinates

Blender has the ability to limit the scope of rendering – outlining a region the special render border and checking the Border checkbox on the Render – Dimensions tab in Properties window. If such frame is set – Blender render only a limited area of the image.

Render border
Render border

There are two ways to set render border via the Blender API:

  1. With the view3d.render_border operator:

This operator is used in the 3D VIEW context:

Border coordinates countdown starts from the top-left corner of all window (0,0) and ends in the lower-right corner with values correspond to the window size.

Border region coordinates for render_border operator
Border region coordinates for render_border operator
  1. With modifying scene properties – maximum and minimum border boundaries relatively to the rendering camera view:

In this case, the render border coordinates set as a percentage ratio to the resolution of the rendering scene (camera view). The render width and height are equal to one unit, and the render border coordinates are set as a proportion of it.

Render border region relatively camera view
Render border region relatively camera view

In both cases, to activate render border usage the Border checkbox turns on with: