06．モデルデータファイル読み込みを作る

（開発環境として「Eclipse」を使用した、古い情報です。
　開発環境として「Android Studio」を使用した、新しい情報は、
　「ホーム > プログラミング > モデルビューアを作る ( Android + OpenGL ES 1.0/1.1 ) ( Android Studio 2.3.3 版 )」）

05．で作成したモデルビューアは、表示するモデルデータをアプリケーション内で定義していました。
モデルデータファイル読み込み処理を作成し、05．で作成したモデルビューアを、ファイルからモデルデータを読み込んで描画するようにします。（アスキー形式STLファイル読み込み処理を作成します。）

使用開発環境は、Eclipse 3.7.2 ベースの Pleiades です。

解説

Android APIには、標準では、ファイル選択に関する関数、クラスは用意されていないので、自作します。
ファイル選択アクティビティ（ Activity + ListView + 拡張子フィルタ ) のページのファイルを流用します。

アスキー形式STLファイル読み込み処理を作成します。

ファイル選択アクティビティを呼び出す項目を、オプションメニュー項目として追加します。

実装

プロジェクトを開く

05．で作成したモデルビューアプロジェクトを開きます。

STLファイル読み込みクラスの作成

STLファイルの読み込み処理を担うクラスを作成します。

パッケージエクスプローラで、作成したプロジェクトの下の「src」の下の作成したパッケージを右クリックし、右クリックメニューの「新規 > クラス」を選択します。

名前にクラス名「StlFileLoader」、
を入力し、「完了」ボタンを押します。

StlFileLoaderクラスの中身を以下のようにします。

public class StlFileLoader { public static Model load( String strPath ) { File file = new File( strPath ); long lFileSize = file.length(); if( 0 == lFileSize ) { return null; } try { BufferedReader br = new BufferedReader( new FileReader( strPath ) ); br.mark( (int)lFileSize ); // ファーストパース（要素数カウント） int[] aiCountTriangle = new int[1]; if( !parse_first( br, aiCountTriangle ) ) { return null; } // 領域確保 if( 0 == aiCountTriangle[0] ) { return null; } float[] af3Vertex = new float[aiCountTriangle[0] * 3 * 3]; br.reset(); // セカンドパース（値詰め） if( !parse_second( br, af3Vertex ) ) { return null; } br.close(); return new Model( af3Vertex ); } catch( Exception e ) { Log.e( "StlFileLoader", "load error : " + e ); return null; } } private static boolean parse_first( BufferedReader br, int[] aiCountTriangle ) { // インプットのチェック if( null == aiCountTriangle ) { return false; } // アウトプットの初期化 aiCountTriangle[0] = 0; int iIndexTriangle = 0; while( true ) { try { String strReadString = br.readLine(); if( null == strReadString ) { break; } StringTokenizer stReadString = new StringTokenizer( strReadString, ", \t\r\n" ); if( !stReadString.hasMoreTokens() ) { continue; } String token = stReadString.nextToken(); if( token.equalsIgnoreCase( "endfacet" ) ) { ++iIndexTriangle; continue; } } catch( Exception e ) { Log.e( "StlFileLoader", "parse_first error : " + e ); return false; } } aiCountTriangle[0] = iIndexTriangle; return true; } private static boolean parse_second( BufferedReader br, float[] af3Vertex ) { // インプットのチェック if( null == af3Vertex ) { return false; } int iIndexTriangle = 0; int iIndex3 = 0; while( true ) { try { String strReadString = br.readLine(); if( null == strReadString ) { break; } StringTokenizer stReadString = new StringTokenizer( strReadString, ", \t\r\n" ); if( !stReadString.hasMoreTokens() ) { continue; } String token = stReadString.nextToken(); if( token.equalsIgnoreCase( "vertex" ) ) { if( 3 <= iIndex3 ) { continue; } af3Vertex[iIndexTriangle * 9 + iIndex3 * 3 + 0] = Float.valueOf( stReadString.nextToken() ); af3Vertex[iIndexTriangle * 9 + iIndex3 * 3 + 1] = Float.valueOf( stReadString.nextToken() ); af3Vertex[iIndexTriangle * 9 + iIndex3 * 3 + 2] = Float.valueOf( stReadString.nextToken() ); ++iIndex3; continue; } else if( token.equalsIgnoreCase( "facet" ) ) { // 面法線ベクトル iIndex3 = 0; continue; } else if( token.equalsIgnoreCase( "endfacet" ) ) { ++iIndexTriangle; continue; } else if( token.equalsIgnoreCase( "solid" ) ) { // ソリッド名 continue; } } catch( Exception e ) { Log.e( "StlFileLoader", "parse_second error : " + e ); return false; } } return true; } }

モデルビューアビュークラスにモデルファイル読み込み関数の追加

モデルビューアビュークラスにモデルファイル読み込み関数を追加します。
処理内容は、
・StlFileLoaderクラスのload関数の呼び出し
・StlFileLoaderクラスのload関数の結果のモデルデータを、RendererオブジェクトのsetModel関数で、セット。
・再描画要求の呼び出し

public class ModelViewerView extends GLSurfaceView implements GestureDetector.OnGestureListener { （・・・省略・・・） public void loadModelFile( String strPath ) { Model model = StlFileLoader.load( strPath ); if( null == model ) { Toast.makeText( getContext(), "Failed to load file : " + strPath, Toast.LENGTH_SHORT ).show(); return; } m_renderer.setModel( model ); requestRender(); // 再描画 } }

ファイル選択アクティビティ関連ファイルの追加

Android APIには、標準では、ファイル選択に関する関数、クラスは用意されていないので、自作します。
ファイル選択アクティビティ（ Activity + ListView + 拡張子フィルタ ) のページのファイルを流用します。
ファイル選択アクティビティ（ Activity + ListView + 拡張子フィルタ ) のページのサンプルプロジェクト (FileSelectionActivityExtFilterSample.zip)の中の

FileInfo.java
FileInfoArrayAdapter.java
FileSelectionActivity.java

を下記手続きでプロジェクトに配置します。

FileSelectionActivityExtFilterSample.zip をダウンロードし、適当なフォルダに解凍します。
Windowsのエクスプローラで、モデルビューアプロジェクトのフォルダを探します。
プロジェクトのフォルダの下の「src」フォルダを掘り下げ、「modelvieweretude」フォルダを探します。
「FileInfo.java」「FileInfoArrayAdapter.java」「FileSelectionActivity.java」ファイルを、「modelvieweretude」フォルダにコピーします。
Eclipseのメニュー「ファイル > リフレッシュ」を選択します。
「FileInfo.java」「FileInfoArrayAdapter.java」「FileSelectionActivity.java」ファイルの、package宣言を修正します。

メインアクティビティのオプションメニューにファイル選択に関する項目の追加

メインアクティビティのオプションメニューにファイル選択に関する項目を追加します。メニューのファイル選択を選択したときの処理も追加します。

メニューのファイル選択を選択したときの処理として、インテントを介してファイル選択アクティビティを起動する処理を記述します。

ファイル選択アクティビティの初期フォルダに関するメンバ変数も追加します。

public class ModelViewerEtudeActivity extends Activity { // リクエストコード private static final int REQUEST_FILESELECT = 0; // オプションメニューID private static final int MENUID_FILE = 1; （・・・省略・・・） private String m_strInitialDir = "/"; // 初期フォルダ（・・・省略・・・） // オプションメニュー生成時 @Override public boolean onCreateOptionsMenu( Menu menu ) { super.onCreateOptionsMenu( menu ); MenuItem menuitem; SubMenu submenu; menu.add( 0, MENUID_FILE, 0, "Select File..." ); （・・・省略・・・） } // オプションメニュー選択時 @Override public boolean onOptionsItemSelected( MenuItem item ) { switch( item.getItemId() ) { case MENUID_FILE: // ファイル選択アクティビティ Intent intent = new Intent( this, FileSelectionActivity.class ); intent.putExtra( "initialdir", m_strInitialDir ); intent.putExtra( "ext", "stl" ); startActivityForResult( intent, REQUEST_FILESELECT ); return true; （・・・省略・・・） } }

メインアクティビティクラスにファイル選択アクティビティの結果に関する処理の追加

メインアクティビティクラスにファイル選択アクティビティの結果に関する処理の追加します。

処理として、選択したファイル名を引数として、モデルビューアビューのloadModelFile関数を呼び出す処理を記述します。

public class ModelViewerEtudeActivity extends Activity { （・・・省略・・・） // アクティビティ呼び出し結果の取得 @Override protected void onActivityResult( int requestCode, int resultCode, Intent intent ) { if( REQUEST_FILESELECT == requestCode && RESULT_OK == resultCode ) { Bundle extras = intent.getExtras(); if( null != extras ) { File file = (File)extras.getSerializable( "file" ); m_modelviewerview.loadModelFile( file.getPath() ); m_strInitialDir = file.getParent(); } } } }

モデルビューアビュークラスのモデル作成処理の削除

3. で作成した、モデルビューアクラスのモデルデータ作成処理は不要なので削除します。

public class ModelViewerView extends GLSurfaceView implements GestureDetector.OnGestureListener { （・・・省略・・・） public ModelViewerView( Context context ) { （・・・省略・・・） // モデルの作成および登録 //m_renderer.setModel( makeModel() ); （・・・省略・・・） } （・・・省略・・・） // モデルの作成 /*private Model makeModel() { （・・・省略・・・） }*/ （・・・省略・・・） }

AndroidManifest.xml へのファイル選択アクティビティの追加

「FileSelectionActivity」を使用するためには、AndroidManifest.xml に、「FileSelectionActivity」に関する記述を追加する必要があります。

AndroidManifest.xml に
<activity android:name="FileSelectionActivity"></activity>
という記述を、直接追記、もしくは、GUI操作で追記します。

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.hiramine.modelvieweretude" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="7" android:targetSdkVersion="7" /> <application android:icon="@drawable/ic_launcher" android:label="@string/app_name" > <activity android:name=".ModelViewerEtudeActivity" android:label="@string/app_name" android:configChanges="keyboardHidden|orientation"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <activity android:name="FileSelectionActivity"></activity> </application> </manifest>

実行

Android Virtual Device にて、動作確認。

※ ターゲット：「Android 4.0.3 - API Level 15」、ハードウェア：「GPU emulation」をyes、として作成したAndroid Virtual Device にて動作確認。

実行し、アスキー形式STLファイルからモデルデータを読み込んで描画できるようになっていることを確認します。

起動直後

ModelData01.stlファイルの読み込み

ModelData02.stlファイルの読み込み

ダウンロード

サンプルプロジェクト

 サンプルモデル（ModelData01.stl）

サンプルモデル（ModelData02.stl）