BREW FAQ : ファイルシステム

BREW SDK3.1 付属のシミュレータで、リムーバブルディスク (miniSD や MMC) を使用したファイルアクセスをシミュレートできますか ?

リムーバブルディスクを使用したファイルアクセスは、以下の手順でシミュレートできます。

Windows の [スタート] メニューから、 BREW MIF エディタ ver 3.0 を起動します。
[依存ファイル] タブを選択し、外部クラスモジュールとして AEECLSID_CARD0_ACCESS を追加してください。外部クラスモジュールの追加方法は、『BREW SDK 3.0 ユーザードキュメンテーション』の「外部依存クラスの追加」を参照してください。
Windows の [スタート] メニューから、 BREW シミュレータ ver 3.0 を起動します。
[プロパティ] タブを選択し、[MMC1 ディレクトリ] を設定します。ここで設定したディレクトリがリムーバブルディスクのディレクトリになります。
リムーバブルディスクにアクセスするために、ファイル名の先頭に AEEFS_CARD0_DIR を設定します。詳細は、『BREW 3.0 API リファレンス』の「IFileMgrインタフェース」を参照してください。
IFILEMGR_OpenFile を使用し、リムーバブルディスク上のファイルをオープンします。

以下に、リムーバブルディスク上のテキストファイルから、データを読み込むサンプルコードを記載します。

IFileMgr*  fileMgr;
IFile*     file;
char       fileName[32] = {0};
char       buffer[128]  = {0};
int        size = 0;

if (SUCCESS == 
ISHELL_CreateInstance(pMe->m_pIShell, AEECLSID_FILEMGR, (void**)&fileMgr)) {

 // リムーバブルディスクにアクセスするため、
 // ファイル名の先頭に AEEFS_CARD0_DIR を設定します。
 STRCAT(fileName, AEEFS_CARD0_DIR);
 STRCAT(fileName, "test.txt");

 // リムーバブルディスク上のテキスト ファイルをオープンします。
 file = IFILEMGR_OpenFile(fileMgr, fileName, _OFM_READ);

 if (file != NULL) {
  // リムーバブルディスクからファイルを読み込みます。
  size = IFILE_Read(file, buffer, sizeof(buffer) - sizeof(char));

  if (size > 0) {
   // リムーバブルディスクから読み込んだテキスト ファイルの内容を
   // ログに表示します。
   DBGPRINTF("*** read from file : %s ***", buffer);
  }

  // IFile インターフェイスを解放します。
  IFILE_Release(file);
}

 // IFileMgr インターフェイスを解放します。
 IFILEMGR_Release(fileMgr);
}

2006 年 01 月 01 日│エミュレータファイルシステム

エミュレータで日本語を入力することはできますか？

デバイスファイルを切り替えることで、エミュレータで日本語の入力ができます。デバイスファイルは、BREW SDK 2.1.1 JP に含まれている「Sharp Z-800_Ja_SJIS.qsc」を使用します。
以下の手順で、デバイスファイルの切り替えができます。

エミュレータを起動します。
[ファイル] メニューの [デバイスの読み込み] をクリックします。
[デバイスの選択] ダイアログを表示します。
「Sharp Z-800_Ja_SJIS.qsc」を選択します。
[デバイスの選択] ダイアログの [開く] をクリックします。

また、デバイスコンフィギュレータを使用してデバイスファイルの内容を日本語に対応させることで、日本語を使用することも可能です。
エミュレータで日本語を使用するには、デバイス属性の言語とフォントにある以下の項目を変更してください。

言語　→ "日本語" に変更してください。
エンコード　→ "S-JIS" に変更してください
フォントの種類を変更してください。　→ 日本語表示に対応しているフォントに変更してください。例えば、"MS ゴシック"、"MS 明朝" など。

以下の手順で、デバイスファイルの内容を日本語に対応できます。

デバイスコンフィギュレータを起動します。
[ファイル] メニューの [開く] をクリックします。
[リソースファイルを開く] ダイアログを表示します。
[内容を変更するデバイスファイル] を選択し、[開く] をクリックします。
[デバイス属性] グループの [詳細] をクリックします。
[デバイス属性] ダイアログボックスを表示します。
[言語とフォント] タブを選択します。
[言語] ボックス一覧の [日本語] を選択します。
[エンコード]ボックス一覧の [S-JIS] を選択します。
[アクティブなフォントの種類] グループの [Windowsフォント] を選択します。
[Windowsフォント] グループの [標準] フォントの [設定] をクリックします。
[フォント] ダイアログボックスを表示します。
[フォント名] ボックスの一覧の [MS ゴシック] 選択します。
[フォント] ダイアログボックスの [OK] をクリックします。
[Windowsフォント] グループの [大きい文字] フォントの [設定] をクリックします。
[フォント] ダイアログボックスを表示します。
[フォント名] ボックスの一覧の [MS ゴシック] 選択します。
[フォント] ダイアログボックスの [OK] をクリックします。
[デバイス属性] ダイアログボックスの [OK] をクリックします。
[ファイル] メニューの [保存] をクリックし、変更内容を保存します。

2006 年 01 月 01 日│エミュレータファイルシステム

BREW のファイルシステムの特徴を教えてください。

BREW では、パソコンと同じようなファイルシステムが使われています。
BREW 2.x と BREW 3.x 以降で、異なるファイルシステムが用いられています。

BREW 2.x

ディレクトリを作成できます。
絶対ファイル名の最大長が 64 文字 (エミュレータでは 255 文字) までという制限があります。
アプリケーションのディレクトリ (アプリケーションのモジュールファイルが存在するディレクトリ) と共有ディレクトリにしかアクセスできません。

他のアプリケーションのディレクトリには、アクセスできません。

BREW でファイルの操作を行う場合は、.mif ファイルの特権レベルでファイルの操作を許可してください。また、共有ディレクトリに書き込みをする場合は、共有ディレクトリへの書き込みを許可してください。共有ディレクトリからデータを読み込む場合は、特権レベルを設定する必要はありません。

BREW 3.x 以降

BREW 3.x 以降では、BREW ファイルシステム全体にアクセスすることができます。各ファイルにはアクセス権を設定することができ、他のアプリからのファイルの読み書きを制限することが可能です。

2006 年 01 月 01 日│ファイルシステム

ディレクトリを作成するには ?

ディレクトリを作成するには、IFileMgr インターフェイスの IFILEMGR_MkDir 関数を使用します。 IFILEMGR_MkDir 関数は存在しない親ディレクトリを作成してはくれませんので、多階層のディレクトリを作成するには親になる階層を逐一作成する必要があります。

SophiaFramework では、 SFBFileMgr::MkDir 関数を使用します。

[ BREW API のみを使用したコード ]

IShell*    shell = app->a.m_pIShell;
IFileMgr*  filemgr;

// IFileMgr インターフェイスを作成します。
ISHELL_CreateInstance(shell, AEECLSID_FILEMGR, (void*)&filemgr);

// ディレクトリを作成します。
IFILEMGR_MkDir(filemgr, "new_dir");

// IFileMgr インターフェイスを破棄します。
IFILEMGR_Release(filemgr);

[ SophiaFramework を使用したコード ]

SFBFileMgrSmp  filemgr;

// SFBFileMgr インスタンスを作成します。
filemgr = SFBFileMgr::NewInstance();

// ディレクトリを作成します。
filemgr->MkDir("new_dir");

2006 年 01 月 01 日│ファイルシステム

ディレクトリ名を変更するには ?

ディレクトリ名を変更するには、IFileMgr インターフェイスの IFILEMGR_Rename 関数を使用します。

SophiaFramework では、 SFBFileMgr::Rename 関数を使用します。

[ BREW API のみを使用したコード ]

IShell*    shell = app->a.m_pIShell;
IFileMgr*  filemgr;

// IFileMgr インターフェイスを作成します。
ISHELL_CreateInstance(shell, AEECLSID_FILEMGR, (void*)&filemgr);

// ディレクトリを作成します。
IFILEMGR_MkDir(filemgr, "new_dir");

// ディレクトリ名を変更します。
IFILEMGR_Rename(filemgr,"new_dir", "temp_dir");

// IFileMgr インターフェイスを破棄します。
IFILEMGR_Release(filemgr);

[ SophiaFramework を使用したコード ]

SFBFileMgrSmp  filemgr;

// SFBFileMgr インスタンスを作成します。
filemgr = SFBFileMgr::NewInstance();

// ディレクトリを作成します。
filemgr->MkDir("new_dir");

// ディレクトリ名を変更します。
filemgr->Rename("new_dir", "temp_dir");

2006 年 01 月 01 日│ファイルシステム

ディレクトリを削除するには ?

ディレクトリを削除するには、IFileMgr インターフェイスの IFILEMGR_RmDir 関数を使用します。

SophiaFramework では、 SFBFileMgr::RmDir 関数を使用します。

[ BREW API のみを使用したコード ]

IShell*    shell = app->a.m_pIShell;
IFileMgr*  filemgr;

// IFileMgr インターフェイスを作成します。
ISHELL_CreateInstance(shell, AEECLSID_FILEMGR, (void*)&filemgr);

// ディレクトリを作成します。
IFILEMGR_MkDir(filemgr, "new_dir");

// ディレクトリを削除します。
IFILEMGR_RmDir(filemgr, "new_dir");

// IFileMgr インターフェイスを破棄します。
IFILEMGR_Release(filemgr);

[SophiaFramework を使用したコード]

SFBFileMgrSmp  filemgr;

// SFBFileMgr インスタンスを作成します。
filemgr = SFBFileMgr::NewInstance();

// ディレクトリを作成します。
filemgr->MkDir("new_dir");

// ディレクトリを削除します。
filemgr->RmDir("new_dir");

2006 年 01 月 01 日│ファイルシステム

ファイルを作成するには ?

ファイルを作成するには、IFileMgr インターフェイスの IFILEMGR_OpenFile 関数を使用します。

IFILEMGR_OpenFile 関数は以下のように定義されており、ファイルを作成する場合はオープンモードに _OFM_CREATE を指定します。

IFile* IFILEMGR_OpenFile(
 IFileMgr*    filemgr,   // IFileMgr インターフェイス
 const char*  filename,  // ファイル名
 OpenFile     mode       // オープン モード
);

オープンモード	意味
_OFM_READ	ファイルを読み込みモードでオープンします。ファイルが存在しない場合は、ファイルを作成しません。
_OFM_READWRITE	ファイルを読み込み / 書き込みモードでオープンします。ファイルが存在しない場合は、ファイルを作成しません。
_OFM_APPEND	ファイルを読み込み / 書き込みモードでオープンします。ファイルの末尾からファイルアクセスを行います。ファイルが存在しない場合は、ファイルを作成しません
_OFM_CREATE	ファイルを読み込み / 書き込みモードで作成します。既にファイルが存在する場合はファイルがオープンされることはなく、エラーとなります。

BREW API には、ファイルをクローズする関数がないため、ファイルをクローズするには IFile インターフェイスを解放する必要があります。

SophiaFramework では、 SFBFileMgr::OpenFile 関数を使用します。

[ BREW API のみを使用したコード ]

IShell*    shell = app->a.m_pIShell;
IFileMgr*  filemgr;
IFile*     file;

// IFileMgr インターフェイスを作成します。
ISHELL_CreateInstance(shell, AEECLSID_FILEMGR, (void*)&filemgr);

// ファイルを作成します。
file = IFILEMGR_OpenFile(filemgr, "sample.txt", _OFM_CREATE);

// IFile インターフェイスを破棄します。
IFILE_Release(file);

// IFileMgr インターフェイスを破棄します。
IFILEMGR_Release(filemgr);

[ SophiaFramework を使用したコード ]

SFBFileMgrSmp  filemgr;
SFBFileSmp     file;

// SFBFileMgr インスタンスを作成します。
filemgr = SFBFileMgr::NewInstance();

// ファイルを作成します。
file = filemgr->OpenFile("sample.txt", _OFM_CREATE);

// SophiaFramework を使用すると
// ファイルのクローズは自動で行われます。
// もし、手動でクローズしたい場合は、
//
// file.Release();
//
// と記述します。

2006 年 01 月 01 日│ファイルシステム

ファイルの情報を取得するには ?

ファイルの情報を取得するには、IFileMgr インターフェイスの IFILEMGR_GetInfo 関数を使用し、 FileInfo 構造体にファイルの情報を取得します。

FileInfo 構造体は、以下のように定義されています。

typedef struct _FileInfo
{
 char        attrib;                    // ファイルの属性
 uint32      dwCreationDate;            // ファイル作成日
 uint32      dwSize;                    // ファイルサイズ
 char        szName[AEE_MAX_FILE_NAME]; // ファイル名
} AEEFileInfo;

SophiaFramework では、 SFBFileMgr::GetInfo 関数を使用します。

[ BREW API のみを使用したコード ]

IShell*    shell = app->a.m_pIShell;
IFileMgr*  filemgr;
FileInfo   info;

// IFileMgr インターフェイスを作成します。
ISHELL_CreateInstance(shell, AEECLSID_FILEMGR, (void*)&filemgr);

// ファイル情報を取得します。
IFILEMGR_GetInfo(filemgr, "sample.txt", &info);

// IFileMgr インターフェイスを破棄します。
IFILEMGR_Release(filemgr);

[ SophiaFramework を使用したコード ]

SFBFileMgrSmp  filemgr;
FileInfo       info;

// SFBFileMgr インターフェイスを作成します。
filemgr = SFBFileMgr::NewInstance();

// ファイル情報を取得します。
filemgr->GetInfo("sample.txt",&info);

2006 年 01 月 01 日│ファイルシステム

ファイルからデータを読み込むには ?

ファイルからデータを読み込むには、IFile インターフェイスの IFILE_Read 関数を使用します。 IFILEMGR_OpenFile 関数のオープンモードに _OFM_READ や _OFM_READWRITE を指定してファイルをオープンし、 IFILE_Read 関数を使用してファイルを読み込みます。このとき、.mif ファイルでファイルアクセスを許可する必要があります。

SophiaFramework では、 SFBFile::Read 関数を使用します。

[ BREW API のみを使用したコード ]

//
// ファイルからデータを読み込みます。
//

IShell*    shell = app->a.m_pIShell;
IFileMgr*  filemgr;
IFile*     file;
char       buffer[128];
int        size;

// IFileMgr インターフェイスを作成します。
ISHELL_CreateInstance(shell, AEECLSID_FILEMGR, (void*)&filemgr);

// ファイルをオープンします。
file = IFILEMGR_OpenFile(filemgr, "sample.txt", _OFM_READ);

// ファイルからデータの読み込みます。
size = IFILE_Read(file, buffer, sizeof(buffer) - 1);

// ファイルをクローズします。
IFILE_Release(file);

// 読み込んだファイルのデータを利用する処理
           ・
           ・
           ・

// IFileMgr インターフェイスを破棄します。
IFILEMGR_Release(filemgr);

[ SophiaFramework を使用したコード ]

//
// ファイルからデータを読み込みます。
//

SFBFileMgrSmp  filemgr;
SFBFileSmp     file;
AChar          buffer[128];
SInt32         size;

// SFBFileMgr インスタンスを作成します。
filemgr = SFBFileMgr::NewInstance();

// ファイルをオープンします。
file = filemgr->OpenFile("sample.txt", _OFM_READ);

// ファイルからデータの読み込みます。
size = file->Read(buffer, sizeof(buffer) - 1);

// 読み込んだファイルのデータを利用する処理
           ・
           ・
           ・

2006 年 01 月 01 日│ファイルシステム

ファイルにデータを書き込むには ?

ファイルにデータを書き込むには、IFile インターフェイスの IFILE_Write 関数を使用します。 IFILEMGR_OpenFile 関数のオープンモードに _OFM_READWRITE や _OFM_CREATE を指定してファイルをオープンし、 IFILE_Write 関数を使用してファイルにデータを書き込みます。このとき、.mif ファイルでファイルアクセスを許可する必要があります。

SophiaFramework では、 SFBFile::Write 関数を使用します。

[ BREW API のみを使用したコード ]

//
// ファイルにデータを書き込みます。
//

IShell*    shell = app->a.m_pishell;
IFileMgr*  filemgr;
IFile*     file;
char       buffer[] = "If you didn't know about the FRAMEWORK for BREW,"
                      " the development of your products will be in the deadline.";

// IFileMgr インターフェイスを作成します。
ISHELL_CreateInstance(shell, AEECLSID_FILEMGR, (void*)&filemgr);

// ファイルをオープンします。
file = ifilemgr_openfile(filemgr, "sample.txt", _ofm_create);

// ファイルへデータを書き込みます。
IFILE_Write(file, buffer, sizeof(buffer) - 1);

// ファイルをクローズします。
IFILE_Release(file);

// IFileMgr インターフェイスを破棄します。
IFILEMGR_Release(filemgr);

[ SophiaFramework を使用したコード ]

//
// ファイルにデータを書き込みます。
//

SFBFileMgrSmp  filemgr;
SFBFileSmp     file;
AChar          buffer[] = "If you didn't know about the FRAMEWORK for BREW,"
                          " the development of your products will be in the deadline.";

// SFBFileMgr インスタンスを作成します。
filemgr = sfbfilemgr::newinstance();

// ファイルをオープンします。
file = filemgr->openfile("sample.txt", _ofm_create);

// ファイルへデータを書き込みます。
file->Write(buffer, sizeof(buffer) - 1);

2006 年 01 月 01 日│ファイルシステム

ファイルのアクセス位置を移動するには ?

ファイルのアクセス位置を移動するには、IFile インターフェイスの IFILE_Seek 関数を使用します。ファイルのオープン後に、IFILE_Seek 関数を使用してファイルのアクセス位置を変更します。

uint32 IFILE_Seek(
 IFile*        file,         // IFile インターフェイス
 FileSeekType  seekType,     // 移動の起点
 int32         moveDistance  // 移動量
);

ファイルのアクセス位置には、以下の値を指定します。

関数名 [BREW]	処理概要
_SEEK_CURRENT	現在のファイルのアクセス位置を起点とします。
_SEEK_START	ファイルの先頭を起点とします。
_SEEK_END	ファイルの末尾を起点とします。

SophiaFramework では、 SFBFile::Seek 関数を使用します。

[ BREW API のみを使用したコード ]

//
// ファイルのアクセス位置を移動します。
//

IShell*         shell = app->a.m_pishell;
IFileMgr*       filemgr;
IFile*          file;
char            buffer[128];
int             size;

// IFileMgr インターフェイスを作成します。
ISHELL_CreateInstance(shell, AEECLSID_FILEMGR, (void*)&filemgr);

// ファイルをオープンします。
file = ifilemgr_openfile(filemgr, "sample.txt", _ofm_read);

if (file != null) {
    // ファイルのアクセス位置を変更します。
    IFILE_Seek(file, _SEEK_START, 3);

    // ファイルからデータの読み込みます。
    size = ifile_read(file, buffer, sizeof(buffer) - 1);
    
    if (size > 0) {
        // 読み込んだファイルのデータを利用する処理
               ・
               ・
               ・
    }

    // ファイルをクローズします。
    IFILE_Release(file);
}

// IFileMgr インターフェイスを破棄します。
IFILEMGR_Release(filemgr);

[ SophiaFramework を使用したコード ]

//
// ファイルのアクセス位置を移動します。
//

SFBFileMgrSmp  filemgr;
SFBFileSmp     file;
AChar          buffer[128];
SInt32         size;

// SFBFileMgr インスタンスを作成します。
filemgr = sfbfilemgr::newinstance();

// ファイルをオープンします。
file = filemgr->openfile("sample.txt", _ofm_read);

if (file != null) {
    // ファイルのアクセス位置を変更します。
    file->Seek(_SEEK_START, 3);

    // ファイルからデータの読み込みます。
    size = file->read(buffer, sizeof(buffer) - 1);

    if (size > 0) {
        // 読み込んだファイルのデータを利用する処理
               ・
               ・
               ・
    }
}

2006 年 01 月 01 日│ファイルシステム

ファイルのデータを切り捨てるには ?

ファイルデータを切り捨てるには、IFile インターフェイスの IFILE_Truncate 関数を使用します。ファイルのオープン後に IFILE_Truncate 関数を使用してファイルのデータの切り捨て位置を設定します。

IFILE_Truncate 関数は、以下のように定義されています。

int IFILE_Truncate(
IFile* file,        // IFile インターフェイス
uint32 truncatePos  // 切り捨て位置
);

SophiaFramework では、 SFBFile::Truncate 関数を使用します。

[ BREW API のみを使用したコード ]

IShell*         shell       = app->a.m_pIShell;
IFileMgr*       filemgr;
IFile*          file;

// IFileMgr インターフェイスを作成します。
ISHELL_CreateInstance(shell, AEECLSID_FILEMGR, (void*)&filemgr);

// ファイルをオープンします。
file = IFILEMGR_OpenFile(filemgr, "sample.txt", _OFM_READWRITE);
if (file != NULL) {
 // ファイル データの切り捨て位置を設定します。
 IFILE_Truncate(file, 3);
 // ファイルをクローズします。
 IFILE_Release(file);
}

// IFileMgr インターフェイスを破棄します。
IFILEMGR_Release(filemgr);

[ SophiaFramework を使用したコード ]

SFBFileMgrSmp  filemgr;
SFBFileSmp     file;

// SFBFileMgr インターフェイスを作成します。
filemgr = SFBFileMgr::NewInstance();

// ファイルをオープンします。
file = filemgr->OpenFile("sample.txt", _OFM_READWRITE);

if (file != null) {
    // ファイル データの切り捨て位置を設定します。
    file->Truncate(3);
}

2006 年 01 月 01 日│ファイルシステム

EFS とは ?

EFS とは、Embedded File System (組込みファイルシステム) の略称で、BREW 端末上のファイルシステムのことです。

2006 年 01 月 01 日│ファイルシステム

遅延エンコードの場合も　ICAMERA_SetMediaData で画像の出力形式を設定しなければいけませんか？

はい。

遅延エンコードに設定されている場合も、ICAMERA_SetMediaData() を設定する必要があります。

これは、ICamera インターフェースがファイルへの出力を前提に設計されているためで、遅延エンコードに設定されている場合は、ICAMERA_RecordSnapshot() が完了した後でユーザーが ICAMERA_EncodeSnapshot() によってファイルへ出力することが期待されています。そのため、ICAMERA_SetMediaData() が設定されていない場合にはスナップショットモードへの移行を行わない機種すら存在します。

ファイルに出力する必要がない場合には、

pMe->_mediaData.clsData = MMD_FILE_NAME;
pMe->_mediaData.pData = "dummy.jpg";
ICAMERA_SetMediaData(pMe->_camera, &(pMe->_mediaData), "image/jpeg");

のように、適当な値を設定してください。

2006 年 01 月 01 日│ファイルシステムカメラ

BREW C++ ライブラリ & GUI フレームワーク & XML ミドルウェア / 携帯 Java アプリ圧縮ツール : 株式会社 ソフィア・クレイドル

BREW FAQ : ファイルシステム

BREW SDK3.1 付属のシミュレータで、リムーバブルディスク (miniSD や MMC) を使用したファイル アクセスをシミュレートできますか ?

エミュレータで日本語を入力することはできますか？

BREW のファイルシステムの特徴を教えてください。

BREW 2.x

BREW 3.x 以降

ディレクトリを作成するには ?

[ BREW API のみを使用したコード ]

[ SophiaFramework を使用したコード ]

ディレクトリ名を変更するには ?

[ BREW API のみを使用したコード ]

[ SophiaFramework を使用したコード ]

ディレクトリを削除するには ?

[ BREW API のみを使用したコード ]

[SophiaFramework を使用したコード]

ファイルを作成するには ?

[ BREW API のみを使用したコード ]

[ SophiaFramework を使用したコード ]

ファイルの情報を取得するには ?

[ BREW API のみを使用したコード ]

[ SophiaFramework を使用したコード ]

ファイルからデータを読み込むには ?

[ BREW API のみを使用したコード ]

[ SophiaFramework を使用したコード ]

ファイルにデータを書き込むには ?

[ BREW API のみを使用したコード ]

[ SophiaFramework を使用したコード ]

ファイルのアクセス位置を移動するには ?

[ BREW API のみを使用したコード ]

[ SophiaFramework を使用したコード ]

ファイルのデータを切り捨てるには ?

[ BREW API のみを使用したコード ]

[ SophiaFramework を使用したコード ]

EFS とは ?

遅延エンコードの場合も ICAMERA_SetMediaData で画像の出力形式を設定しなければいけませんか？

BREW C++ ライブラリ & GUI フレームワーク & XML ミドルウェア / 携帯 Java アプリ圧縮ツール : 株式会社ソフィア・クレイドル

BREW SDK3.1 付属のシミュレータで、リムーバブルディスク (miniSD や MMC) を使用したファイルアクセスをシミュレートできますか ?

遅延エンコードの場合も　ICAMERA_SetMediaData で画像の出力形式を設定しなければいけませんか？