[3D Shapes]

Icon	コントロール	ユニットスコープ	DocWiki (ja)	DocWiki (en)
	TCone	FMX.Objects3D	[DocWiki]	[DocWiki]
	TCube	FMX.Objects3D	[DocWiki]	[DocWiki]
	TCylinder	FMX.Objects3D	[DocWiki]	[DocWiki]
	TDisk	FMX.Objects3D	[DocWiki]	[DocWiki]
	TEllipse3D	FMX.Objects3D	[DocWiki]	[DocWiki]
	TGrid3D	FMX.Objects3D	[DocWiki]	[DocWiki]
	TMesh	FMX.Objects3D	[DocWiki]	[DocWiki]
	TModel3D	FMX.Objects3D	[DocWiki]	[DocWiki]
	TPath3D	FMX.Objects3D	[DocWiki]	[DocWiki]
	TPlane	FMX.Objects3D	[DocWiki]	[DocWiki]
	TRectangle3D	FMX.Objects3D	[DocWiki]	[DocWiki]
	TRoundCube	FMX.Objects3D	[DocWiki]	[DocWiki]
	TSelectionPoint3D (XE2 のみ)	FMX.Objects3D	[DocWiki]	[DocWiki]
	TSphere	FMX.Objects3D	[DocWiki]	[DocWiki]
	TStrokeCube	FMX.Objects3D	[DocWiki]	[DocWiki]
	TText3D	FMX.Objects3D	[DocWiki]	[DocWiki]

TMaterial の各メンバーについての詳細です。

• Ambient
  環境反射色です。環境反射を行わないようにするには NULL を指定します。
• Diffuse
  拡散反射色です。拡散反射を行わないようにするには NULL を指定します。透過色を使うと半透明のオブジェクトを表現できます。
• Specular
  鏡面反射色です。鏡面反射を行わないようにするには NULL を指定します。
• Shinness
  鏡面反射の強さ (光沢度) を 0～100 で指定します。Shinness が大きいほどハイライトは小さく、鏡面反射光は強くなります。
• Emissive
  発光色です。発光しないようにするには NULL を指定します。外部光の反射ではなくシェイプそのものを発光させるのに使います。
• Lighting
  照明を行うかどうかを指定します。
• FillMode
  塗りつぶしのモードを指定します。
  • fmSolid: 単色
  • fmWireframe: ワイヤーフレーム
• Modulation
  変調のモードを指定します。
  • tmModulate: 変調。シェイプの色とテクスチャの色をミックスします。
  • tmReplace: 置換。テクスチャの色のみが使われます。Ambient / Diffuse / Specular の反射光が無視されるという事なので、ライティングの影響を受けなくなります。
• ShadeMode
  シェーディングモードを指定します。
  • smFlat: フラットシェーディング
  • smGouraud: グーローシェーディング
• Texture
  シェイプに貼り付けるテクスチャを指定します。
• TextureFilterling
  テクスチャフィルタを指定します。貼られたテクスチャによって最適なテクスチャフィルタを選択する必要があります。
  • tfLinear: 線形補間。テクスチャが拡大される時、線形補完が行われます。テクスチャによってはボケて見える事があります。
  • tfNearest: 補間無し。テクスチャが拡大されても何も行われません。テクスチャがクッキリ見える反面、ジャギーが目立つ事があります。

XE3 では XE2 の TMaterial に相当するものを [Materials] にある "マテリアルコントロール" で指定します。

3D Shapes の MaterialSource プロパティにマテリアルコントロールを設定します。XE2 の TMaterial に最も近いのは TLightMaterialSource です。

See Also:

• 3D シェイプの色とか質感ってどうやって変えるの？ (FireMonkey Tips)
• FMX.Objects3D.TShape3D.Material (DocWiki - ja)
• FMX.Objects3D.TShape3D.Material (DocWiki - en)
• シェーディング (Wikipedia)
• フラットシェーディング (Wikipedia)
• グーローシェーディング (Wikipedia)
• フォンシェーディング (Wikipedia)
• ワイヤーフレーム (Wikipedia)
• テクスチャマッピング (Wikipedia)
• 地球はま～るい、ま～るいはママの顔、ボ～クの～顔♪ (副題: 多分、4 分以内でできると思う地球儀) (DEKO のざつだん)
• Dive into your body. Feel so good! (副題: 二匹目のドジョウでパノラマ写真ビューア) (DEKO のざつだん)
• FireMonkey で作る地球儀 ～ 多分、4 分以内に ～ (YouTube)
• FireMonkey [3D Shapes] Demo (YouTube)
• FireMonkey ～ Subdivisions とは何ぞや？ ～ (YouTube)
• FireMonkey ～ Subdivisions と鏡面反射 ～ (YouTube)

3D オブジェクトの投影については、"画面投影 (DocWiki)" を読んでも、どういう事か解りづらいと思いますので画像で説明します。

このページで投影を説明している時点で、既にお判り頂けているとは思いますが、"投影に関連するのは 3D オブジェクト" であり、カメラではありません。TCamera にも Projection プロパティはありますが、そちらは基本的に操作する必要はありません (あまり意味のないプロパティです)。

3D オブジェクトの Projection プロパティはデフォルトで pjCamera になっています。TSphere を 2 つ用意し、右側の TSphere の Projection プロパティを pjScreen にしてみました。何が違うのかは拡大 / 縮小してみれば判ります。

  

左側の Projection プロパティが pjCamera な TSphere は、フォーム (ビュー) のサイズを変更しても相対位置は変わらず、相対サイズも変わりません (拡大 / 縮小時の縦横比が変わらないのならば)。逆に、Projection プロパティに pjScreen を指定した右側の TSphere は、フォーム (ビュー) のサイズを変更しても絶対位置のままであり、絶対サイズのままです。

絶対位置/絶対サイズはカメラの視点を変更しても変わることはありません。例えば、FPS ゲームのターゲットスコープを 3D オブジェクトで作ったり、ストックしている所持アイテムを表示したりするのに使えるという事です。

See Also:

• "画面投影 - FireMonkey 3D (DocWiki)"
• "FMX.Types3D.TControl3D.Projection (DocWiki)"

基本的 (プリミティブ) な形状の 3D オブジェクトです。円錐です。SubDivisionsAxes プロパティを変更すると五角錐や六角錐も作れます。初期値は 12 なので、正確には十二角錐という事になります。

See Also:

• TDummy - FireMonkey Components [3D Scene] (FireMonkey Tips)
• FireMonkey 3D (DocWiki)

基本的 (プリミティブ) な形状の 3D オブジェクトです。立方体です (直方体にもできますが)。テクスチャはすべての面に貼られます。

See Also:

• TDummy - FireMonkey Components [3D Scene] (FireMonkey Tips)
• FireMonkey 3D (DocWiki)

基本的 (プリミティブ) な形状の 3D オブジェクトです。円柱です。SubDivisionsAxes プロパティを変更すると五角柱や六角柱も作れます。初期値は 12 なので、正確には十二角柱という事になります。

See Also:

• TDummy - FireMonkey Components [3D Scene] (FireMonkey Tips)
• FireMonkey 3D (DocWiki)
• Microsoft Research Image Composite Editor (ICE) (Microsoft Research)
• 変なジュース -とある科学の超電磁砲＜レールガン＞ 公式サイト-

基本的 (プリミティブ) な形状の 3D オブジェクトです。円盤です。SubDivisionsAxes プロパティを変更すると正五角形や正六角形も作れます。初期値は 16 なので、正確には正十六角形という事になります。

See Also:

• TDummy - FireMonkey Components [3D Scene] (FireMonkey Tips)
• FireMonkey 3D (DocWiki)

基本的 (プリミティブ) な形状の 3D オブジェクトです。円を押し出した形状 (円柱) の 3D オブジェクトです。

• XE2:
  テクスチャは 前面 (Material.Texture) / 背面 (MaterialBack.Texture) / 側面 (MaterialShaft.Texture) にそれぞれ貼る事ができます。
• XE3 以降:
  テクスチャは 前面 (MaterialSource) / 背面 (MaterialBackSource) / 側面 (MaterialShaftSource) に指定されたマテリアルコントロールにそれぞれ貼る事ができます。

前面 / 背面 / 側面 は、Sides プロパティで個別に表示 / 非表示を切り替える事ができます。

See Also:

• TDummy - FireMonkey Components [3D Scene] (FireMonkey Tips)
• FireMonkey 3D (DocWiki)
• Microsoft Research Image Composite Editor (ICE) (Microsoft Research)
• 変なジュース -とある科学の超電磁砲＜レールガン＞ 公式サイト-

グリッドを表す 3D オブジェクトです。位置関係を示すスケールとして使います。グリッドの色は LineColor で指定します。マス目の大きさは Frequency で指定します。Marks で指定したサイズの倍数の時にグリッドの線が細線になります。

See Also:

• FireMonkey 3D (DocWiki)

メッシュオブジェクトです。

See Also:

• FireMonkey でカスタムメッシュを生成することにより、数学関数を視覚化する (EDN)
• FireMonkey で、波の干渉を視覚化する (EDN)
• ポリゴンメッシュ (Wikipedia)
• FireMonkey 3D (DocWiki)

3D モデリングツールで作られた複雑な形状の 3D モデルデータを読み込める 3D オブジェクトです。TMeshCollection に読み込める形式は、

• *.ase (Ascii Scene Export)
• *.dae (COLLADA)
• *.obj (Wavefront)

LoadFromFile() でモデルデータを読み込む場合には、モデル形式に応じて以下を uses する必要があります。

• FMX.ASE.Importer
• FMX.DAE.Importer
• FMX.OBJ.Importer

XE8 以降では WrapMode プロパティが追加され、コントロールの境界ボックスと 3D モデルの関係を設定できるようになっています。デフォルトは Fit ですが、XE7 以前の動作は Original 相当なので注意が必要です。

See Also:

• FireMonkey Q&A (EDN)
• FMX.Objects3D.TModel3D.MeshCollection (DocWiki)
• TModel3D に読み込めるデータ形式は？ (FireMonkey Tips)
• FireMonkey 3D (DocWiki)

パスオブジェクトです。パスで描かれた図形を押し出した形状の 3D オブジェクトを作り出す事ができます。テクスチャは

• XE2:
  テクスチャは 前面 (Material.Texture) / 背面 (MaterialBack.Texture) にそれぞれ貼る事ができます。
• XE3 以降:
  テクスチャは 前面 (MaterialSource) / 背面 (MaterialBackSource) に指定されたマテリアルコントロールにそれぞれ貼る事ができます。

前面 / 背面 / 側面 は、Sides プロパティで個別に表示 / 非表示を切り替える事ができます。

例えば、Path.Data プロパティに、

M 5,20 L 35,20 L 10,40 L 20,10 L 30,40 Z

このようなデータを設定すると、星型を押し出したような 3D オブジェクトが表示されます。

データ中の M は "Move - 絶対位置 (X,Y)"、L は "Line - 絶対位置 (X,Y)"、Z で "パスを閉じる" コマンドです。コマンドの詳細は "パス マークアップ構文 (MSDN)" を参照して下さい。

...とはいえ、複雑なパスを手で記述するのはとても面倒です。GUI でパスデータを作成する方法もあります。

1. InkScape でパスデータを作り、SVG (プレーン) 形式で保存する。
   
2. SVG をテキストエディタで開き、パスデータ部分をコピーする。
   
3. RAD Studio のパスデザイナにパスデータを貼り付ける。
   

See Also:

• FireMonkey 3D (DocWiki)
• パス マークアップ構文 (MSDN)
• Extensible Application Markup Language (XAML) (Wikipedia)
• Scalable Vector Graphics (SVG) (Wikipedia)
• TPathLabel - FireMonkey Components [Standard] (FireMonkey Tips)
• InkScape
• InkScape Portable Edition

基本的 (プリミティブ) な形状の 3D オブジェクトです。板です。テクスチャを貼って背景等に使う事ができます。

• XE2:
  テクスチャは片面のみに貼られます (Material.Modulation が tmReplace かつ TwoSide が True の場合のみ両面に貼られます)。
• XE3 以降:
  テクスチャは MaterialSource に指定されたマテリアルコントロールにそれぞれ貼る事ができます。

テクスチャを貼った TPlane と、画像を指定した TImage3D はよく似ていますが、TPlane はライティングの影響を受けます。

See Also:

• TImage3D - FireMonkey Components [3D Layers] (FireMonkey Tips)
• FireMonkey 3D (DocWiki)

基本的 (プリミティブ) な形状の 3D オブジェクトです。長方形を押し出した形状 (四角柱) の 3D オブジェクトです。テクスチャは

• XE2:
  テクスチャは 前面 (Material.Texture) / 背面 (MaterialBack.Texture) / 側面 (MaterialShaft.Texture) にそれぞれ貼る事ができます。
• XE3 以降:
  テクスチャは 前面 (MaterialSource) / 背面 (MaterialBackSource) / 側面 (MaterialShaftSource) に指定されたマテリアルコントロールにそれぞれ貼る事ができます。

前面 / 背面 / 側面 は、Sides プロパティで個別に表示 / 非表示を切り替える事ができます。

また、XRadius / YRadius プロパティを設定すると角を丸くする事ができます (シャフト形状なので ZRadius プロパティはありません)。Radius と半径を同じにすると TEllipse3D のような円柱になります。

See Also:

• TDummy - FireMonkey Components [3D Scene] (FireMonkey Tips)
• FireMonkey 3D (DocWiki)

基本的 (プリミティブ) な形状の 3D オブジェクトです。角が丸い立方体です。テクスチャは前面と背面をメインに貼られます。

See Also:

• TDummy - FireMonkey Components [3D Scene] (FireMonkey Tips)
• FireMonkey 3D (DocWiki)

選択用のオブジェクトです。移動や回転の処理は自前で行わなくてはなりません。

• Kind
  選択ポイントの種類を指定します。
  • spMove
    ドラッグされると、選択ポイントはその方向に移動します。
  • spRotation
    ドラッグされると、選択対象は特定の角度で回転します。回転角は Angle プロパティで取得できます。
• WorkPlane
  選択ポイントが移動または回転できる面を指定するプロパティです。
  • X
    1 を設定すると、選択ポイントは Y/Z 平面上を移動、または X 軸を中心に回転します (Position.Y / Position.Z のみ変化する)。
  • Y
    1 を設定すると、選択ポイントは X/Z 平面上を移動、または Y 軸を中心に回転します (Position.X / Position.Z のみ変化する)。
  • Z
    1 を設定すると、選択ポイントは X/Y 平面上を移動、または Z 軸を中心に回転します (Position.X / Position.Y のみ変化する)。

See Also:

• FireMonkey 3D (DocWiki)

基本的 (プリミティブ) な形状の 3D オブジェクトです。球体です。テクスチャは球面に貼られます (縦横比 1:2 のテクスチャ画像が使えます)。

See Also:

• TDummy - FireMonkey Components [3D Scene] (FireMonkey Tips)
• FireMonkey 3D (DocWiki)

ワイヤーフレームの立方体です。

• XE2:
  テクスチャを貼れますが、テクスチャは無視されます。ワイヤーの色は Material.Diffuse で指定します。

See Also:

• FireMonkey 3D (DocWiki)

文字列を押し出した形状の 3D オブジェクトです。Text プロパティに文字列を指定します。テクスチャは

• XE2:
  テクスチャは 前面 (Material.Texture) / 背面 (MaterialBack.Texture) / 側面 (MaterialShaft.Texture) にそれぞれ貼る事ができます。
• XE3 以降:
  テクスチャは 前面 (MaterialSource) / 背面 (MaterialBackSource) / 側面 (MaterialShaftSource) に指定されたマテリアルコントロールにそれぞれ貼る事ができます。

前面 / 背面 / 側面 は、Sides プロパティで個別に表示 / 非表示を切り替える事ができます。

立体的な文字が必要ないのであれば、TTextLayer3D を使う事も出来ます。

See Also:

• TTextLayer3D - FireMonkey Components [3D Layers] (FireMonkey Tips)
• FireMonkey 3D (DocWiki)