PointLight クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
空間内で指定した位置にある光源を表し、その光源をすべての方向に投影します。
public ref class PointLight sealed : System::Windows::Media::Media3D::PointLightBasepublic sealed class PointLight : System.Windows.Media.Media3D.PointLightBasetype PointLight = class
inherit PointLightBasePublic NotInheritable Class PointLight
Inherits PointLightBase- 継承
例
次の例では、 PointLight オブジェクトを作成し、そのプロパティの一部を設定します。
// Point light values.
PointLight _ptLight = new PointLight();
' Point light values.
Private _ptLight As New PointLight()
public MyLights()
{
for (int i = 0; i < nbrDirLights; i++)
{
_dirLight[i] = new DirectionalLight();
_dirLight[i].Color = _dirLightColor[i];
_dirLight[i].Direction = _dirVector[i];
}
_ptLight.Position = new Point3D(-3, -7, 10);
_ptLight.Color = System.Windows.Media.Brushes.White.Color;
_ptLight.Range = 15.0;
_ptLight.ConstantAttenuation = 3.0;
}
Public Sub New()
For i As Integer = 0 To nbrDirLights - 1
_dirLight(i) = New DirectionalLight()
_dirLight(i).Color = _dirLightColor(i)
_dirLight(i).Direction = _dirVector(i)
Next i
_ptLight.Position = New Point3D(-3, -7, 10)
_ptLight.Color = System.Windows.Media.Brushes.White.Color
_ptLight.Range = 15.0
_ptLight.ConstantAttenuation = 3.0
End Sub
注釈
光の強度が距離を越えて減少する速度は減衰と呼ばれ、 ConstantAttenuation、 LinearAttenuation、または QuadraticAttenuation プロパティを設定することで制御できます。
コンストラクター
| 名前 | 説明 |
|---|---|
| PointLight() |
PointLight クラスの新しいインスタンスを元の位置で初期化します。 |
| PointLight(Color, Point3D) |
指定した色を使用して、指定した位置にある PointLight クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| Bounds |
このRect3Dの軸揃え境界ボックスを指定するModel3Dを取得します。 (継承元 Model3D) |
| CanFreeze |
オブジェクトを変更不可にできるかどうかを示す値を取得します。 (継承元 Freezable) |
| Color |
ライトの色を取得または設定します。 (継承元 Light) |
| ConstantAttenuation |
光の強度が距離を越えて減少する定数値を取得または設定します。 (継承元 PointLightBase) |
| DependencyObjectType |
このインスタンスの CLR 型をラップする DependencyObjectType を取得します。 (継承元 DependencyObject) |
| Dispatcher |
このDispatcherが関連付けられているDispatcherObjectを取得します。 (継承元 DispatcherObject) |
| HasAnimatedProperties |
1 つ以上の AnimationClock オブジェクトがこのオブジェクトの依存関係プロパティのいずれかに関連付けられているかどうかを示す値を取得します。 (継承元 Animatable) |
| IsFrozen |
オブジェクトが現在変更可能かどうかを示す値を取得します。 (継承元 Freezable) |
| IsSealed |
このインスタンスが現在シールされているかどうかを示す値を取得します (読み取り専用)。 (継承元 DependencyObject) |
| LinearAttenuation |
距離に対するライトの強度の線形ディミクションを指定する値を取得または設定します。 (継承元 PointLightBase) |
| Position |
ワールド空間におけるライトの位置を指定する Point3D を取得または設定します。 (継承元 PointLightBase) |
| QuadraticAttenuation |
2 次演算によって計算される、距離に対する光の効果のディミクションを指定する値を取得または設定します。 (継承元 PointLightBase) |
| Range |
ライトが効果を持たない距離を取得または設定します。 (継承元 PointLightBase) |
| Transform |
モデルに設定された Transform3D を取得または設定します。 (継承元 Model3D) |
メソッド
| 名前 | 説明 |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
指定したAnimationClockにDependencyPropertyを適用します。 プロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
指定したAnimationClockにDependencyPropertyを適用します。 プロパティが既にアニメーション化されている場合は、 SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
指定した DependencyPropertyにアニメーションを適用します。 アニメーションは、次のフレームがレンダリングされるときに開始されます。 指定したプロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
指定した DependencyPropertyにアニメーションを適用します。 アニメーションは、次のフレームがレンダリングされるときに開始されます。 指定したプロパティが既にアニメーション化されている場合は、 SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable) |
| CheckAccess() |
呼び出し元のスレッドがこの DispatcherObjectにアクセスできるかどうかを判断します。 (継承元 DispatcherObject) |
| ClearValue(DependencyProperty) |
プロパティのローカル値をクリアします。 クリアするプロパティは、 DependencyProperty 識別子によって指定されます。 (継承元 DependencyObject) |
| ClearValue(DependencyPropertyKey) |
読み取り専用プロパティのローカル値をクリアします。 クリアするプロパティは、 DependencyPropertyKeyによって指定されます。 (継承元 DependencyObject) |
| Clone() |
この PointLightの変更可能な複製を作成し、このオブジェクトの値の詳細コピーを作成します。 依存関係プロパティをコピーする場合、このメソッドはリソース参照とデータ バインディングをコピーします (ただし、解決されなくなる可能性があります)、アニメーションやその現在の値はコピーしません。 |
| CloneCore(Freezable) |
基本 (アニメーション化されていない) プロパティ値を使用して、インスタンスを指定した Freezable の複製 (ディープ コピー) にします。 (継承元 Freezable) |
| CloneCurrentValue() |
この PointLight オブジェクトの変更可能な複製を作成し、このオブジェクトの現在の値の詳細コピーを作成します。 リソース参照、データ バインディング、およびアニメーションはコピーされませんが、現在の値はコピーされます。 |
| CloneCurrentValueCore(Freezable) |
現在のプロパティ値を使用して、インスタンスを指定した Freezable の変更可能な複製 (ディープ コピー) にします。 (継承元 Freezable) |
| CoerceValue(DependencyProperty) |
指定した依存関係プロパティの値を強制します。 これは、呼び出し元のCoerceValueCallbackに存在する依存関係プロパティのプロパティ メタデータで指定されたDependencyObject関数を呼び出すことによって実現されます。 (継承元 DependencyObject) |
| CreateInstance() |
Freezable クラスの新しいインスタンスを初期化します。 (継承元 Freezable) |
| CreateInstanceCore() |
派生クラスで実装された場合は、 Freezable 派生クラスの新しいインスタンスを作成します。 (継承元 Freezable) |
| Equals(Object) |
指定された DependencyObject が現在の DependencyObjectと等しいかどうかを判断します。 (継承元 DependencyObject) |
| Freeze() |
現在のオブジェクトを変更不可にし、その IsFrozen プロパティを |
| FreezeCore(Boolean) |
この Animatable オブジェクトを変更不可にするか、変更不可にできるかどうかを判断します。 (継承元 Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
指定した DependencyPropertyのアニメーション化されていない値を返します。 (継承元 Animatable) |
| GetAsFrozen() |
基本 (アニメーション化されていない) プロパティ値を使用して、 Freezableの固定コピーを作成します。 コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。 (継承元 Freezable) |
| GetAsFrozenCore(Freezable) |
基本 (アニメーション化されていない) プロパティ値を使用して、インスタンスを指定した Freezable の固定複製にします。 (継承元 Freezable) |
| GetCurrentValueAsFrozen() |
現在のプロパティ値を使用して、 Freezable の固定コピーを作成します。 コピーは固定されているため、固定されたサブオブジェクトは参照によってコピーされます。 (継承元 Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
現在のインスタンスを、指定した Freezableの固定複製にします。 オブジェクトにアニメーション化された依存関係プロパティがある場合は、現在のアニメーション化された値がコピーされます。 (継承元 Freezable) |
| GetHashCode() |
この DependencyObjectのハッシュ コードを取得します。 (継承元 DependencyObject) |
| GetLocalValueEnumerator() |
この DependencyObjectでローカルに値が設定されている依存関係プロパティを決定するための特殊な列挙子を作成します。 (継承元 DependencyObject) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| GetValue(DependencyProperty) |
DependencyObjectのこのインスタンスの依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject) |
| InvalidateProperty(DependencyProperty) |
指定した依存関係プロパティの有効な値を再評価します。 (継承元 DependencyObject) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| OnChanged() |
現在の Freezable オブジェクトが変更されたときに呼び出されます。 (継承元 Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
設定したばかりの DependencyObjectType データ メンバーに対して適切なコンテキスト ポインターが確立されるようにします。 (継承元 Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
DependencyObjectのOnPropertyChanged(DependencyPropertyChangedEventArgs)実装をオーバーライドして、Changed型の依存関係プロパティの変化に応じてFreezable ハンドラーも呼び出します。 (継承元 Freezable) |
| ReadLocalValue(DependencyProperty) |
依存関係プロパティが存在する場合は、そのローカル値を返します。 (継承元 DependencyObject) |
| ReadPreamble() |
Freezableが有効なスレッドからアクセスされていることを確認します。 Freezableの継承子は、依存関係プロパティではないデータ メンバーを読み取る API の先頭でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
値ソースを変更せずに依存関係プロパティの値を設定します。 (継承元 DependencyObject) |
| SetValue(DependencyProperty, Object) |
依存関係プロパティ識別子で指定された依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
依存関係プロパティの DependencyPropertyKey 識別子で指定された、読み取り専用の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
シリアル化プロセスが指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 DependencyObject) |
| ToString() |
Model3D の文字列形式を作成します。 (継承元 Model3D) |
| ToString(IFormatProvider) |
Model3D の文字列形式を作成します。 (継承元 Model3D) |
| VerifyAccess() |
呼び出し元のスレッドがこの DispatcherObjectにアクセスできるように強制します。 (継承元 DispatcherObject) |
| WritePostscript() |
ChangedのFreezable イベントを発生させ、そのOnChanged() メソッドを呼び出します。 Freezableから派生するクラスは、依存関係プロパティとして格納されていないクラス メンバーを変更する API の末尾でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
| WritePreamble() |
Freezableが固定されていないこと、および有効なスレッド コンテキストからアクセスされていることを確認します。 Freezable 継承子は、依存関係プロパティではないデータ メンバーに書き込む API の先頭でこのメソッドを呼び出す必要があります。 (継承元 Freezable) |
イベント
| 名前 | 説明 |
|---|---|
| Changed |
Freezableまたはそれに含まれるオブジェクトが変更されたときに発生します。 (継承元 Freezable) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
指定した形式を使用して、現在のインスタンスの値を書式設定します。 (継承元 Model3D) |
