OpenSiv3D  v0.6.5
C++20 framework for creative coding
Functions
s3d::Dialog Namespace Reference

Functions

Optional< FilePath > OpenFile (const Array< FileFilter > &filters={}, FilePathView defaultDirectory=U"", StringView title=U"")
 オープンファイルダイアログを表示し、選択されたファイルを返します。 More...
 
Array< FilePath > OpenFiles (const Array< FileFilter > &filters={}, FilePathView defaultDirectory=U"", StringView title=U"")
 オープンファイルダイアログを表示し、選択されたファイルを返します。複数選択することもできます。 More...
 
Optional< FilePath > SaveFile (const Array< FileFilter > &filters={}, FilePathView defaultDirectory=U"", StringView title=U"")
 セーブファイルダイアログを表示し、選択されたファイルパスを返します。 More...
 
Optional< FilePath > SelectFolder (FilePathView defaultDirectory=U"", StringView title=U"")
 フォルダ選択ダイアログを表示し、選択されたフォルダを返します。 More...
 
Image OpenImage (FilePathView defaultDirectory=U"", StringView title=U"")
 イアログから画像ファイルを選択し、Image を作成します。 More...
 
Texture OpenTexture (FilePathView defaultDirectory=U"", StringView title=U"")
 ダイアログから画像ファイルを選択し、Texture を作成します。 More...
 
Texture OpenTexture (TextureDesc desc, FilePathView defaultDirectory=U"", StringView title=U"")
 ダイアログから画像ファイルを選択し、Texture を作成します。 More...
 
Wave OpenWave (FilePathView defaultDirectory=U"", StringView title=U"")
 ダイアログから音声ファイルを選択し、Wave を作成します。 More...
 
Audio OpenAudio (FilePathView defaultDirectory=U"", StringView title=U"")
 ダイアログから音声ファイルを選択し、Audio を作成します。 More...
 
Audio OpenAudio (Audio::FileStreaming f, FilePathView defaultDirectory=U"", StringView title=U"")
 ダイアログから音声ファイルを選択し、ストリーミング再生する Audio を作成します。 More...
 
Optional< FilePath > SaveImage (FilePathView defaultDirectory=U"", StringView title=U"")
 セーブファイルダイアログから、画像を保存するパスを取得します。 More...
 
Optional< FilePath > SaveWave (FilePathView defaultDirectory=U"", StringView title=U"")
 セーブファイルダイアログから、音声を保存するパスを取得します。 More...
 

Function Documentation

◆ OpenAudio() [1/2]

Audio s3d::Dialog::OpenAudio ( Audio::FileStreaming  f,
FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

ダイアログから音声ファイルを選択し、ストリーミング再生する Audio を作成します。

Parameters
fAudio::Stream
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Returns
作成した音声。ファイルが選択されなかった場合は空の Audio

◆ OpenAudio() [2/2]

Audio s3d::Dialog::OpenAudio ( FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

ダイアログから音声ファイルを選択し、Audio を作成します。

Parameters
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Returns
作成した音声。ファイルが選択されなかった場合は空の Audio

◆ OpenFile()

Optional<FilePath> s3d::Dialog::OpenFile ( const Array< FileFilter > &  filters = {},
FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

オープンファイルダイアログを表示し、選択されたファイルを返します。

Parameters
filtersダイアログに表示するファイルの拡張子のフィルタ
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Returns
選択されたファイルのパス。選択されなかった場合は none

◆ OpenFiles()

Array<FilePath> s3d::Dialog::OpenFiles ( const Array< FileFilter > &  filters = {},
FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

オープンファイルダイアログを表示し、選択されたファイルを返します。複数選択することもできます。

Parameters
filtersダイアログに表示するファイルの拡張子のフィルタ
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Returns
選択されたファイルパスの一覧。選択されなかった場合は空の配列

◆ OpenImage()

Image s3d::Dialog::OpenImage ( FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

イアログから画像ファイルを選択し、Image を作成します。

Parameters
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Returns
作成した Image. ファイルが選択されなかった場合は空の Image

◆ OpenTexture() [1/2]

Texture s3d::Dialog::OpenTexture ( FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

ダイアログから画像ファイルを選択し、Texture を作成します。

Parameters
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Returns
作成したテクスチャ。ファイルが選択されなかった場合は空のテクスチャ

◆ OpenTexture() [2/2]

Texture s3d::Dialog::OpenTexture ( TextureDesc  desc,
FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

ダイアログから画像ファイルを選択し、Texture を作成します。

Parameters
descテクスチャの設定
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Returns
作成したテクスチャ。ファイルが選択されなかった場合は空のテクスチャ

◆ OpenWave()

Wave s3d::Dialog::OpenWave ( FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

ダイアログから音声ファイルを選択し、Wave を作成します。

Parameters
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Returns
作成した音声。ファイルが選択されなかった場合は空の Wave

◆ SaveFile()

Optional<FilePath> s3d::Dialog::SaveFile ( const Array< FileFilter > &  filters = {},
FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

セーブファイルダイアログを表示し、選択されたファイルパスを返します。

Parameters
filtersダイアログに表示するファイルの拡張子のフィルタ
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Remarks
この関数はファイルの保存は行いません。戻り値をファイル保存系の関数と組み合わせて使ってください。
Returns
選択されたファイルパス。選択されなかった場合は none

◆ SaveImage()

Optional<FilePath> s3d::Dialog::SaveImage ( FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

セーブファイルダイアログから、画像を保存するパスを取得します。

Parameters
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Remarks
この関数は画像ファイルの保存は行いません。Image::save() と組み合わせて使ってください。
Returns
画像ファイルを保存するパス。選択されなかった場合は none

◆ SaveWave()

Optional<FilePath> s3d::Dialog::SaveWave ( FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

セーブファイルダイアログから、音声を保存するパスを取得します。

Parameters
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Remarks
この関数は音声ファイルの保存は行いません。Wave::save() と組み合わせて使ってください。
Returns
音声ファイルを保存するパス。選択されなかった場合は none

◆ SelectFolder()

Optional<FilePath> s3d::Dialog::SelectFolder ( FilePathView  defaultDirectory = U"",
StringView  title = U"" 
)

フォルダ選択ダイアログを表示し、選択されたフォルダを返します。

Parameters
defaultDirectoryダイアログで表示するデフォルトディレクトリ。空の場合は OS のデフォルト
titleダイアログのタイトル。空の場合は OS のデフォルト
Returns
選択されたフォルダのパス。選択されなかった場合は none