Categories - reference/utility

random(v1=None, v2=None)

変数もしくはパラメータに設定可能なランダムな数を返す。
何も設定しないと、0.0から1.0のfloating-point (decimal) を返す。 一つだけ設定されると 0.0から設定値の間の数を返す。 2つ設定されると、1番目と2番目の設定値の間の数を返す。

random()コマンドは色々な操作の為に有用である 例えば"ランダムなカラーからランダムな長さの線へ"というように。

注意
スクリプトが実行する度に新しいランダム値を返す。
カスタムなrandom seedを設定することでvariationをlockすることができる。

from random import seed
seed(0)

var(name, type, default, min, max)

変数とスライダー,テキストフィールド, チェックボックスといったユーザーインターフェースとの接続を作るその変数シートである。
Pythonを通して変数を作る最も便利な方法がVariables Menuである。

このように作られた変数はglobal namespaceの一部になり、他の変数と同じようにアクセス出来る。

size(w, h)

キャンバスのサイズをポイントでセットする。
最初のパラメータが幅、2番目が高さをセットする。

このコマンドを使用するなら、スクリプトの最初の行で使用すべきである。 スクリプトの途中でサイズをセットするのは不合理である。

設定値は"inch", "cm" or "mm"で乗算することが可能である。
規定の変数WIDTHとHEIGHTはキャンバスサイズを得るために使用できる。

grid(cols, rows, colsize=1, rowsize=1)

grid()コマンドは繰り返し可能なオブジェクトを返す、 (例えばrange()コマンドのよう)ループの為にトラバースすることの出来る何かを。
grid()はより複雑で、とてもパワフルなコマンドである。

最初の2つコマンドはコラムの数とgridの行数を定義する。

次の2つのパラメーターはオプションで、セル一つの幅と高さをセットする。
ループ用の各繰り返しは、カレントのcolumnとrowのオフセットが返される。

choice(list)

パラメータで指定されたlistからランダムに一つアイテムを返す。
choice()コマンドの使用は、不鮮明なlist[random(len(list)]の代替手段である。