YoScript3の標準ライブラリ関数一覧
この記事について
この記事は、Scratchの中でC言語っぽいコードが書けるプロジェクト「YoScript3」の公式リファレンス（のようなもの）です。
かなり項目が多いのでctrl+Fの使用を強く推奨します。
YoScript3のリンクはこちら。
https://scratch.mit.edu/projects/810011049
数学的な演算
基本的なものは以下の通りです。
・足し算「A + B」
・引き算「A - B」
・掛け算「A * B」
・割り算「A / B」
・余剰（割り算の余り）「A % B」
・等値「A == B」
・不等「A != B」
・大なり「A > B」
・小なり「A < B」
・単項プラス「+A」
・炭鉱マイナス「-A」
・アドレス「&A」
・関節参照「*A」
配列、ビット演算、文字列はまだ実装していません。
abs(x)
絶対値を返します。
floor(x)
xを小数点以下切り捨てした値を返します。
ceil(x)
xを小数点以下切り上げした値を返します。
sqrt(x)
xの平方根を返します。
sin(x)
角度xのサインを返します。
cos(x)
角度xのコサインを返します。
tan(x)
角度xのタンジェントを返します。
asin(x)
角度xのアークサインを返します。
acos(x)
角度xのアークコサインを返します。
atan(x)
角度xのアークタンジェントを返します。
ln(x)
xの自然対数を返します。
log(x)
xを底とする数値の対数を返します。
exp(x)
定数eを底とするxのべき乗を返します。
hypot(x, y)
(0, 0)から(x, y)までの距離を測ります。
lerp(A, B, t)
二点aとbの間を、時間tで線形補間します。
tは 0.0 (0%) から 1.0 (100%) までの値を基本的には指定しますが、その範囲を超えても問題ありません。
max(A, B)
AかBのどちらか大きい方の値を返します。
min(A, B)
AかBのどちらか小さい方の値を返します。
pow(base, power)
数値のべき乗を返します。
pi()
円周率を返します。（実際には円周率πの近似値である数値 3.14159265358979323846 を返します。）
乱数
random()
0.0~1.0までの乱数を返します。
random_int(min, max)
minからmaxまでの乱数を返します。
変数の操作
※これらの関数は、引数の先頭に「&」を付ける必要があります。
swap(&A, &B)
変数の値を入れ替えます。
random_liner(&A)
Aをシード値として新たな乱数を生成し、Aに代入します。
動き
set_pos(x, y)
座標を(x, y)にします。
set_direction(x)
角度をxに向けます。
※x=0のとき、スクラッチの表示では90度になります。
set_rotation_style(x)
回転方法を設定します。以下はその指定方法です。
x=1のとき、自由に回転
x=2のとき、左右のみ
x=3のとき、回転しない
ペン
基本的に描画はこれに頼ることになります。
クローンを使って描画することも一応考えておりますが、実装はかなり先になりそうです。
pen_down()
ペンを下ろします。
pen_up()
ペンを上げます。
set_pen_size(x)
ペンの大きさをxにします。
set_pen_color(x)
ペンの色をxにします。RGBAで指定します。
set_pen_brightness(x)
ペンの明るさをxにします。
set_pen_saturation(x)
ペンの鮮やかさをxにします。
set_pen_transparency(x)
ペンの透明度をxにします。
pen_reset()
ペンの状態を初期化します。初期値は以下の通りです。
・色 = 0
・鮮やかさ = 100
・明るさ = 100
・透明度 = 0（不透明）
pen_clean()
ペンで描画したものを全て消します。
pen_stamp()
スタンプします。
音楽
これについては私もよくわかっておりません。
つまり、謎です。
note(x)
xの音符を鳴らします。
読み取り専用
get_time()
2000年からの秒数を返します。
次のフレームまで返す値は変わりません。
get_delta()
１つ前のフレームからの秒数を返します。
get_answer()
答えを返します。
get_mouse_down()
マウスが押されたかどうかを返します。
get_mouse_x()
マウスのx座標を返します。
get_mouse_y()
マウスのy座標を返します。
get_loudness()
音量を返します。（廃止）
get_timer()
タイマーの値を返します。
get_days_since2000()
2000年からの秒数を返します。
同じフレーム内で値が変動します。
get_username()
ユーザー名を返します。（廃止予定）