Skip to content

api_math.md

Latest commit

 

History

History
488 lines (371 loc) · 11.2 KB

api_math.md

File metadata and controls

488 lines (371 loc) · 11.2 KB

Pyxel API sample

数学
バージョン：Pyxel 1.9版

contents

分類 項目
システム 変数 init() run() show() flip() quit()
リソース load() save()
入力 変数 btn() btnp() btnr() mouse() キー記述例
グラフィックス 変数 image() tilemap() clip() camera() pal() cls() pget() pset()
line() rect() rectb() circ() circb() elli() ellib() tri() trib()
fill() blt() bltm() text() 表示色
イメージクラス 変数 set() load() save() pget() pset()
タイルマップクラス 変数 set() pget() pset()
オーディオ sound() music() play_pos() play() playm() stop()
サウンドクラス 変数 set() set_notes() set_tones() set_volumes() set_effects()
ミュージッククラス 変数 set()
数学 ceil() floor() sgn() sqrt() sin() cos() atan2() rseed() rndi() rndf() nseed() noise()


数学


ceil()

x以上の最小の整数を返します。
ceil(x)

引数 型 説明
x f64 小数値

戻り値 型 説明
整数 i32 x以上の最小の整数 

n = pyxel.ceil( 4.125 )
print(n)    # 5

floor()

x以下の最大の整数を返します。
floor(x)

引数 型 説明
x f64 小数値

戻り値 型 説明
整数 i32 x以下の最大の整数 

n = pyxel.floor( 9.99 )
print(n)    # 9

sgn()

xが正の時に 1、0 の時に 0、負の時に-1 を返します。
sgn(x)

引数 型 説明
x f64 正負を調べたい値

戻り値 型 説明
正負 f64 xが正 1.0 , xが0 0.0 , xが負 -1.0 

print( pyxel.sgn( 20 ) )  # 1.0
print( pyxel.sgn(  0 ) )  # 0.0
print( pyxel.sgn( -3 ) )  # -1.0

sqrt()

xの平方根を返します。
sqrt(x)

引数 型 説明
x f64 平方根を求めたい数

戻り値 型 説明
平方根 f64 xの平方根（正の値） 

a = 3
b = 4
c = pyxel.sqrt(a**2 + b**2)
print(c)    # 5.0

・2点間の距離を計算する例

import pyxel
pyxel.init(128, 128)

x1 = 16
y1 = 16
distance = 0

def update():
    global distance
    dx = pyxel.mouse_x - x1
    dy = pyxel.mouse_y - y1
    distance = pyxel.sqrt(dx**2 + dy**2)
    return

def draw():
    pyxel.cls(0)
    pyxel.line(x1,y1, pyxel.mouse_x,pyxel.mouse_y, 7)
    pyxel.text(1,1, "distance="+str(distance),7)
    return

pyxel.run(update, draw)

sin()

deg度(Degree)の正弦を返します。
sin(deg)

引数 型 説明
deg f64 角度（Degree）

戻り値 型 説明
正弦 f64 deg度の正弦 (-1 から 1 の間の値) 

import pyxel
pyxel.init(128, 128)

x = 0
y = 0
deg = 0

def update():
    global x,y,deg
    x += 1
    if pyxel.width < x:
        x = 0
    y = pyxel.sin(deg) * 40
    deg += 10
    return

def draw():
    pyxel.cls(0)
    pyxel.camera(0,-64)
    pyxel.circ(x,y, 2, 7)
    return

pyxel.run(update, draw)

image sin

cos()

deg度(Degree)の余弦を返します。
cos(deg)

引数 型 説明
deg f64 角度（Degree）

戻り値 型 説明
余弦 f64 deg度の余弦 (-1 から 1 の間の値) 

import pyxel
pyxel.init(128,128)

x = 0
y = 0
deg = 0
r = 60
def update():
    global x,y,deg
    x = pyxel.cos(deg)*r
    y = pyxel.sin(deg)*r
    deg += 2
    return

def draw():
    pyxel.cls(0)
    pyxel.camera(-64,-64)
    pyxel.circ( x, y, 3, 7)
    return

pyxel.run(update,draw)

image cos

atan2()

y/xの逆正接を度(Degree)で返します。※引数の順番注意
atan2(y, x)

引数 型 説明
y f64 直角三角形では高さ
x f64 直角三角形では底辺の長さ

戻り値 型 説明
度 f64 x軸との角度（角度は画面下方向が正，上方向が負）

image atanC xとyから角度θを求められる


import pyxel
pyxel.init(128,128)

x = 50
y = x * pyxel.sqrt(3)
deg = pyxel.atan2(y,x)

pyxel.cls(0)
pyxel.trib(0,0, x,0, x,y, 7)
pyxel.text(10,4, str(deg), 10)
pyxel.show()

image atanA

import pyxel
pyxel.init(128,128)

x = 0
y = 0
deg = 0

def update():
    global x,y,deg
    x = pyxel.mouse_x
    y = pyxel.mouse_y
    deg = pyxel.atan2(y,x)
    return

def draw():
    pyxel.cls(0)
    pyxel.camera(-64,-64)
    pyxel.line(-64,0, 64,0, 7)
    pyxel.line(0,-64, 0,64, 7)
    pyxel.line(0,0, x,y, 10)
    pyxel.text(-63,-63, str(deg), 7)
    return

pyxel.run(update,draw)

image atanB


image atandeg 戻り値の角度は上方向が負


rseed()

乱数生成器のシードを設定します。
rseed(seed)

引数 型 説明
seed u32 シード値（この値により乱数が決まる） 

import pyxel
pyxel.init(128,128)

for i in range(2):
    print( i,end=": ")
    pyxel.rseed(42)
    for j in range(10):
        print(pyxel.rndi(0, 100),end=",")
    print("\n")

pyxel.cls(0)
pyxel.show()

print結果

0: 8,38,68,93,100,77,72,29,32,88,
1: 8,38,68,93,100,77,72,29,32,88,

　※シードを同じ値で指定すると同じ結果になる。（プログラムを再実行しても同じ）

rndi()

a以上b以下のランダムな整数を返します。
rndi(a, b)

引数 型 説明
a i32 最小値
b i32 最大値

戻り値 型 説明
整数 i32 a以上b以下のランダムな整数 

import pyxel
pyxel.init(128,128)

for i in range(2):
    print( i,end=": ")
    #pyxel.rseed(42)
    for j in range(10):
        print(pyxel.rndi(0, 100),end=",")
    print("\n")

pyxel.cls(0)
pyxel.show()
0: 69,1,74,9,54,72,36,51,89,58,
1: 9,4,66,10,94,8,35,32,37,4,

　※Pyxel初期化時に自動的に設定されたシードが使われる

rndf()

a以上b以下のランダムな小数を返します。
rndf(a, b)

引数 型 説明
a f64 最小値
b f64 最大値

戻り値 型 説明
小数 f64 a以上b以下のランダムな小数 

import pyxel
pyxel.init(128,128)

for i in range(10):
    print(pyxel.rndf(0.5, 3.5))

pyxel.cls(0)
pyxel.show()
3.116554467221664
2.724697657335488
2.607186647179384
1.604990052259575
3.389089969281373
1.036421173813125
1.9161581923250663
2.6261067074533324
0.6363005612566948
3.080457828333305

nseed()

Perlin ノイズのシードを設定します。
　（パーリンノイズは座標ごとの乱数でなだらかな変化の値を得られるもの。ゲームで地形生成やテクスチャに利用される）
nseed(seed)

引数 型 説明
seed u32 シード値 

import pyxel
SIZE = 128
pyxel.init(SIZE,SIZE)

pyxel.cls(0)
pyxel.nseed(1)
scale = 0.03
for y in range(SIZE):
    for x in range(SIZE):
        col = pyxel.floor(abs(pyxel.noise(x*scale, y*scale) * 16))
        pyxel.pset(x,y,col)

pyxel.show()

image nseed
　（pyxel.nseed(1)の設定値を100や123456に変更しても結果が変わらないため，使い方の調査が必要）

noise()

指定された座標の Perlin ノイズ値を返します。
noise(x, [y], [z])

引数 型 説明
x f64 x座標
y f64 y座標
z f64 z座標

戻り値 型 説明
ノイズ値 f64 指定された座標の Perlin ノイズ値（-1.0 と 1.0 の間の値※詳細は未確認） 

import pyxel
SIZE = 128
pyxel.init(SIZE,SIZE)
# パレットをグレースケールに書き換え
for i in range(16):
    pyxel.colors[i] = i * 0x101010
    
pyxel.cls(0)

# Perlinノイズ scaleが大きいほど変化が多くなる
scale = 0.04
z = 1
for y in range(SIZE):
    for x in range(SIZE):
        col = pyxel.floor(abs(pyxel.noise(x*scale, y*scale, z*scale) * 16))
        pyxel.pset(x,y,col)

pyxel.show()

z = 1 image
z = 2 image
z = 5 image

ページの先頭に戻る　　TOPに戻る