//------------------------------------------------------------------------------
// Lamp : Open source game middleware
// Copyright (C) 2004  Junpei Ohtani ( Email : junpee@users.sourceforge.jp )
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//------------------------------------------------------------------------------

/** @file
 * グラフィックスデバイスセレクタヘッダ
 * @author Junpee
 */

#ifndef GRAPHICS_DEVICE_SELECTOR_H_
#define GRAPHICS_DEVICE_SELECTOR_H_

namespace Lamp{

class GraphicsAdapterInformation;
class GraphicsDeviceInformation;
class GraphicsDeviceComboInformation;

//------------------------------------------------------------------------------
// 設定ファイルを読み込もうとするプロキシデバイスセレクタとかあるといいかも
// フルスクリーン設定もファイルに書き込んどく
// それかSettingsにReader、Writer対応させて、セレクタ通さずに設定もありかも
// 読み込み失敗したときに選択しなおす必要がある
// 失敗の判定はやっぱりセレクタ任せなのでプロキシかな
/**
 * グラフィックスデバイスセレクタ
 */
class GraphicsDeviceSelector{
public:
	/**
	 * コンストラクタ
	 */
	GraphicsDeviceSelector(){}

	/**
	 * デストラクタ
	 */
	virtual ~GraphicsDeviceSelector(){}

	/**
	 * デバイス設定の選択
	 * @param windowHandle ウィンドウハンドル
	 * @param startFullscreen フルスクリーンを優先して初期化するならtrue
	 * @return 使用できるデバイスが存在すればtrue
	 */
	virtual bool chooseDeviceSettings(
		HWND windowHandle, bool startFullscreen);

	/**
	 * ウィンドウモードの最適な設定を探す
	 * @param windowHandle ウィンドウハンドル
	 * @param requireHAL ハードウェアアクセラレーションを要求する場合はtrue
	 * @param requireREF リファレンスラスタライザを要求する場合はtrue
	 * @return 使用できるデバイスが存在すればtrue
	 */
	virtual bool findBestWindowedMode(
		HWND windowHandle, bool requireHAL, bool requireREF) = 0;

	/**
	 * フルスクリーンモードの最適な設定を探す
	 * @param windowHandle ウィンドウハンドル
	 * @param requireHAL ハードウェアアクセラレーションを要求する場合はtrue
	 * @param requireREF リファレンスラスタライザを要求する場合はtrue
	 * @return 使用できるデバイスが存在すればtrue
	 */
	virtual bool findBestFullscreenMode(
		HWND windowHandle, bool requireHAL, bool requireREF) = 0;

protected:
	/**
	 * ウインドウモード設定の構築
	 * @param windowHandle ウィンドウハンドル
	 * @param displayMode ディスプレイモード
	 * @param bestAdapter 最適なアダプタ
	 * @param bestDevice 最適なデバイス
	 * @param bestDeviceCombo 最適なデバイスコンボ
	 */
	virtual void buildWindowModeSettings(
		HWND windowHandle, const D3DDISPLAYMODE& displayMode,
		GraphicsAdapterInformation* bestAdapter,
		GraphicsDeviceInformation* bestDevice,
		GraphicsDeviceComboInformation* bestDeviceCombo);

	/**
	 * フルスクリーンモード設定の構築
	 * @param displayMode ディスプレイモード
	 * @param bestAdapter 最適なアダプタ
	 * @param bestDevice 最適なデバイス
	 * @param bestDeviceCombo 最適なデバイスコンボ
	 */
	virtual void buildFullscreenModeSettings(
		const D3DDISPLAYMODE& displayMode,
		GraphicsAdapterInformation* bestAdapter,
		GraphicsDeviceInformation* bestDevice,
		GraphicsDeviceComboInformation* bestDeviceCombo);

private:
	// コピーコンストラクタの隠蔽
	GraphicsDeviceSelector(const GraphicsDeviceSelector& copy);

	// 代入コピーの隠蔽
	void operator =(const GraphicsDeviceSelector& copy);

};

//------------------------------------------------------------------------------
} // End of namespace Lamp
#endif // End of GRAPHICS_DEVICE_SELECTOR_H_
//------------------------------------------------------------------------------

