aulut.dll.md

aulut.dllの仕様

ロード

require"aulut" などでロードします

ユーザーデータ

aulut_data

キャッシュしたLUTデータ

キー	型	説明
size	number	DOMAIN_SIZE
title	string	TITLE
type	number	テーブルの次元 1か3
(整数)	{number,number,number}	r,g,bの順でdomain dataが入る DOMAIN_MINとDOMAIN_MAXはそれぞれ0と255に正規化されている キーは1Dなら[0,size),3Dなら[0,size*size*size) 範囲チェックは行わない
convert	function	LUTによる変換の計算を行うメンバ関数 r,g,bの3引数をとり、変換後のr,g,bの3つの値を返す 4番目に[0,1]のnumberを入れると元の値とのブレンドを行える

関数

main(lut[,af=1],udata,w,h)

LUTの効果を適用する

引数	型	説明
lut	string or aulut_data	stringはテーブルファイルのパス
af	number	適用度 [0,1]
udata	userdata	画像データへのポインタ
w	integer	画像の横サイズ
h	integer	画像の縦サイズ

戻り値	型	説明
[1]	userdata	udata

std(type,udata)

LUT用のテーブル画像データを生成する

引数	型	説明
type	integer	テーブルの次元 1か3
udata	userdata	画像データへのポインタ typeを1にしているなら256x240,3なら512x512のものを渡してください

戻り値	型	説明
[1]	userdata	udata

save(path,udata,type[,title=nil[,domain_minmax={0,255}]])

渡された画像データが表すLUTをcubeファイルに保存する

引数	型	説明
path	nil, string	保存するパス nilにした場合は保存ダイアログを開く
udata	userdata	画像データへのポインタ 同上
type	integer	テーブルの次元 1か3
title	nil, string	cubeファイルのTITLE nilにした場合はオリジナルファイルのものを使用(cubeファイルでなければ無い)
domain_minmax	table	cubeファイルのDOMAIN_MINとDOMAIN_MAXを設定

戻り値	型	説明
[1]	none

image(lut,udata)

LUTを画像化したものを画像データに書き込む

引数	型	説明
lut	string or aulut_data	stringはテーブルファイルのパス
udata	userdata	画像データへのポインタ 同上

戻り値	型	説明
[1]	userdata	udata

preload(path)

LUTをキャッシュに読み込む

引数	型	説明
path	string	LUTファイルのパス

戻り値	型	説明
[1]	aulut_data	読み込んだLUTのaulut_data
[2]	boolean	新たに読み込みを行った(キャッシュを使用しなかった)らtrue

exist(path)

キャッシュの存在を問い合わせる

引数	型	説明
path	string	LUTファイルのパス

戻り値	型	説明
[1]	boolean	このパスのキャッシュが存在すればtrue

reset(path)

キャッシュの削除を行う

引数	型	説明
path	string	LUTファイルのパス

戻り値	型	説明
[1]	boolean	削除を行ったらtrue

キャッシュが存在しないパスを指定しても関数は成功する

reset()

全キャッシュの削除を行う

戻り値	型	説明
-	none

cached_list()

キャッシュの内容を巡回するイテレータ関数を返す

戻り値	型	説明
[1]	function	イテレータ関数

イテレータ関数はクロージャでループ用のデータを持っていて、呼び出すごとに結果が変わる(string.gmatchのような挙動) イテレータ関数は string,aulut_data でキャッシュされたLUTのファイルパスとデータを返す

備考

読み込んだLUTデータは、ファイルパスをキーにキャッシュされます ファイルに変更があった場合、reset(path)などでキャッシュを破棄しなければ変更は適用されません