Difference between revisions of "ImageData:getPixel (日本語)"

(Created page with "画像において指定された座標にあるピクセルの色を取得します。 有効な x および y の値は 0 を始点として画像の幅および高さの -...")
 
m (Have API docs describe what the API does (instead of what it doesn't do, or what the author thinks the user ought to do).)
Line 1: Line 1:
 
画像において指定された座標にあるピクセルの色を取得します。
 
画像において指定された座標にあるピクセルの色を取得します。
  
有効な x および y の値は 0 を始点として画像の幅および高さの -1 以下までです。
+
有効な x および y の値は 0 を始点として画像の幅および高さの -1 以下までです。非整数値は切り捨てられます。
 +
{{notice|[[0.10.2 (日本語)|0.10.2]] 以前において、この関数では非整数座標を扱えないため、非整数値が渡された場合は無効な結果を生成します。}}
 
== 関数 ==
 
== 関数 ==
 
=== 概要 ===
 
=== 概要 ===
Line 15: Line 16:
 
{{param|number|b|青色の成分 (0-255)}}
 
{{param|number|b|青色の成分 (0-255)}}
 
{{param|number|a|透過の成分 (0-255)}}
 
{{param|number|a|透過の成分 (0-255)}}
 +
 
== 用例 ==
 
== 用例 ==
 
画像にあるピクセルに対して反復を行い [[sequence (日本語)|sequence]] へ記憶します。
 
画像にあるピクセルに対して反復を行い [[sequence (日本語)|sequence]] へ記憶します。

Revision as of 13:31, 26 March 2017

画像において指定された座標にあるピクセルの色を取得します。

有効な x および y の値は 0 を始点として画像の幅および高さの -1 以下までです。非整数値は切り捨てられます。

O.png 0.10.2 以前において、この関数では非整数座標を扱えないため、非整数値が渡された場合は無効な結果を生成します。  


関数

概要

r, g, b, a = ImageData:getPixel( x, y )

引数

number x
X 軸上のピクセル位置。
number y
Y 軸上のピクセル位置。

返値

number r
赤色の成分 (0-255)
number g
緑色の成分 (0-255)
number b
青色の成分 (0-255)
number a
透過の成分 (0-255)

用例

画像にあるピクセルに対して反復を行い sequence へ記憶します。

local image = love.image.newImageData( 'path/to/Image.png' )
local pixels = {}
for x = 1, image:getWidth() do
    for y = 1, image:getHeight() do
        -- ピクセルの座標範囲は 0 から画像の 幅 - 1 / 高さ - 1 までです。
        local pixel = image:getPixel( x - 1, y - 1 )
        pixels[#pixels + 1] = pixel
    end
end
return pixels

関連


そのほかの言語