favorite

Development Fund

Support Blender Core Development with a monthly contribution.
theaters

Blender Studio

The creators who share. Access production content and knowledge from the Open Movies.
code

Blender Developer Blog

Latest news and updates on Blender development.
people

Get Involved

Join the community and help with design, development, docs and more.
bar_chart

Open Data

A platform to collect and display the Blender Benchmark results.
menu_book

Blender Docs

Documentation on Blender's features, tools and API.

Blender Conference

The yearly event that brings together the Blender community in one place.
download

Get Blender

Download the latest Blender version, or try the beta!

Videos

User Interfaces

17th April 2020

info License: CC-BY

lock_open Free

flag Report Problem

Author

Sybren A. Stüvel

Buttons, panels, and menus. In this chapter of Scripting for Artists, Sybren shows the basics of creating your own user interface in Blender.

  • Finding existing UI code: 00:55
  • Ingredients of a Panel: 01:42
  • Different import styles: 03:00
  • Monkey Grid panel: 04:09
  • Adding operator buttons: 06:03
  • Basic layout tweaks: 09:21
  • Adding scene and object properties: 10:20
  • Conditional drawing: 13:26
  • Adding operators to menus: 15:30

4 Comments

Join to comment publicly.

Samuel Bernou

19th April 2020 - 13:39

A very clear and resourceful video. Even after making 30+ addons I learned a few things. e.g: I will certainly use columns starting now ;), thanks Doc.

Tijm Lanjouw

20th July 2020 - 13:15

Thanks for the tutorial. But how do I make the x, y and size values be defined by user input in the panel? I tried:

    def draw(self, context): #draw panel
        col = self.layout.column(align=True)
        props = col.operator('mesh.monkey_grid',
            text = 'Generate Grid',
            icon = 'MONKEY')

        col.label(text="Column Two:")
        col.prop(props, 'count_x')
        col.prop(props, 'count_y')
        col.prop(props, 'size')

The fields with the default paramaters show up in the panel, but I'm not able to change them. My guess is that I have to work with variables. I tried a couple of things, but I failed. Anyone?

Sybren A. Stüvel

4th August 2020 - 15:53

*@Tijm Lanjouw* You have to define the user-editable properties somewhere else. If they are to be saved within the blend file, you typically would add them to bpy.types.Scene. If they are temporary, you typically add them to bpy.types.WindowManager. You can then use them to assign for example props.count_x = context.scene.my_monkey_grid_count_x.

You cannot use operator properties with layout.prop().

Ludwig Heijden

2nd January 2021 - 22:40

@Sybren A. Stüvel For those searching, this is explained better in chapter 11 ;)