Yamyam: 1版をインポートしました

2018-06-28T18:42:35Z

1版をインポートしました

wiki>Brecht: moved Dev:2.5/Py/Scripts/Guidelines/Layouts to Dev:Py/Scripts/Guidelines/Layouts: remove version namespace

2015-12-27T19:24:36Z

moved Dev:2.5/Py/Scripts/Guidelines/Layouts to Dev:Py/Scripts/Guidelines/Layouts: remove version namespace

新規ページ

== Why Code Guidelines? ==

- Layout files are new in 2.5x, so it's the right time to write and keep them clean.

- Modifying the layout is also interesting for artists. Keep the code as readable as possible is important for them.
Also coders who don't work on these files should be able to learn the code as fast as possible.

== Which scripts? ==
These guidelines are for every official python script which use buttons inside of blenders interface. So, all button files inside of release/ui. And other scripts (for Render integration...like Povray in release/io) which are bundled with Blender.

== Assignments ==
Keep assignement names consistent:

<source lang="text">
"row" for a row layout
"col" for a column layout
"flow" for a column_flow layout.

Please also use these names for split layouts. For example col = split.column().

Use "sub" for sublayouts,
and if you need more subsub etc.
</source>

== Example Code ==

Some examples how it should look.

=== The Basic Code of each panel ===

<source lang="python">
class MATERIAL_PT_material(MaterialButtonsPanel):
bl_label = "Shading"

def draw(self, context):
layout = self.layout

mat = context.material
ob = context.object
slot = context.material_slot
space = context.space_data
</source>

First define the layout.

Empty line.

Define all context you need for the panel. Use short and easy assignement names.

===Layout Split Code ===

<source lang="python">
split = layout.split()

col = split.column()
col.prop(mat, "alpha", slider=True)
col.prop(mat, "ambient", slider=True)
col.prop(mat, "emit")
col.prop(mat, "translucency", slider=True)

col = split.column()
col.prop(mat, "z_transparency")
col.prop(mat, "shadeless")
col.prop(mat, "tangent_shading")
col.prop(mat, "cubic", slider=True)
</source>

If you need a sublayout because of align, greying out or something else,
use sub as assignement name:

<source lang="python">
sub = col.column(align=True)
sub.prop(mat, "bla")
</source>

First define the split.

Empty line.

Now pack every column in 1 block, this improves the readability.
Sub layout blocks can be separated as well if this improves the readability.

=== Greying out ===

<source lang="python">
#For greying out first define the active/enabled condition, then put the buttons there:

#Right:
sub = col.column()
sub.active = tex.distance_metric == 'MINKOVSKY'
sub.prop(tex, "minkovsky_exponent", text="Exponent")

#Wrong:
sub = col.column()
sub.prop(tex, "minkovsky_exponent", text="Exponent")
sub.active = tex.distance_metric == 'MINKOVSKY'

</source>

[[Category:Script]]

← 古い版	2018年6月28日 (木) 18:42時点における版
(相違点なし)

Dev:Py/Scripts/Guidelines/Layouts - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Brecht: moved Dev:2.5/Py/Scripts/Guidelines/Layouts to Dev:Py/Scripts/Guidelines/Layouts: remove version namespace

Yamyam: 1版をインポートしました