vrLightService

# add a group node
groupNode = vrLightService.createLightGroup("group node")

# create a point light below the group pointLight = vrLightService.createLight("point light", vrLightTypes.LightType.Point, groupNode)
# find a light node in the main scene graph pointLight = vrNodeService.findNode("point light")
# find a light node in the light graph pointLight = vrLightService.findLight("point light")
# copy lens flares from pointLightNode1 to pointLightNode2 # this creates an actual copy of the vrdLensFlareEffect and stores it vrLightService.copyLensFlare(pointLightNode1.getLensFlareEffect()) vrLightService.pasteLensFlare([pointLightNode2])
# delete the pointlight and the group vrNodeService.removeNode([pointLight, groupNode])

概要

関数:

• convertLight(lightNode, lightType)
• convertLights(nodes, lightType)
• copyLensFlare(effect)
• copyLensFlareElements(elements)
• copyLensFlareGhosts(ghosts)
• copyLights(nodes)
• createLight(name, type, parent) → vrdNode
• createLightGroup(name, parent) → vrdNode
• createLightGroup(name, nodes) → vrdNode
• createLightLinkSet(name) → vrdLightLinkSetNode
• duplicateLensFlareElements(light, elements)
• duplicateLensFlareGhosts(ghostLine, ghosts)
• duplicateLights(nodes)
• findLight(name) → vrdNode
• findLights(name) → List[vrdNode]
• getAllLights(sceneGraph) → List[vrdNode]
• getHeadlight() → vrdBaseLightNode
• getLightLinksRoot() → vrdNode
• getLightRoot() → vrdNode
• getLightsClipboard() → List[vrdNode]
• getSelectedLensFlareElements() → List[vrdLensFlareElement]
• getSelectedLensFlareGhosts() → List[vrdLensFlareGhost]
• getSelectedNodes() → List[vrdNode]
• hasCopiedGhosts() → bool
• hasCopiedLensFlareEffect() → bool
• hasCopiedLensFlareElements() → bool
• isHeadLight(light) → bool
• isLightsClipboardEmpty() → bool
• loadLights(paths) → List[vrdNode]
• pasteLensFlare(lights)
• pasteLensFlareElements(light)
• pasteLensFlareGhosts(ghostLine)
• pasteLights(targetNodes)
• removeLightLinkSets(nodes)
• removeLights(nodes)
• saveLights(nodes, path) → bool
• setSelectedLensFlareElements(elements)
• setSelectedLensFlareGhosts(ghosts)
• setSelectedNodes(nodes)
• validateLights()

信号:

• lensFlareElementSelectionChanged(elements)
• lensFlareGhostSelectionChanged(ghosts)
• lightLinkSetsChanged()
• lightsConverted(lightIds)
• lightsStateChanged()
• lightsValidated()
• nodesAdded(nodes)
• nodesChanged(nodes)
• nodeSelectionChanged(nodes)
• nodesRemoved(nodes)

関数

vrLightService.convertLight(lightNode, lightType)

ライト ノードを別のタイプのライトに変換します。注意: この操作を行うと、このノード オブジェクトは無効になります。

パラメータ:	lightNode (vrdNode): 変換されるライト ノード。 lightType (vrLightTypes.LightType): ノードの変換先のタイプ。

vrLightService.convertLights(nodes, lightType)

ライト ノードを別のタイプのライトに変換します。注意: この操作を行うと、これらのノード オブジェクトは無効になります。

パラメータ:	nodes (List[vrdNode]): 変換するライト ノード。 lightType (vrLightTypes.LightType): ノードの変換先のタイプ。

vrLightService.copyLensFlare(effect)

コピー バッファにレンズ フレアの効果を追加します。

パラメータ:	effect (vrdLensFlareEffect): コピーするためにクリップボードに追加されたレンズ フレアの効果。

vrLightService.copyLensFlareElements(elements)

コピー バッファにレンズ フレアを追加します。

パラメータ:	elements (List[vrdLensFlareElement]): コピーするすべてのレンズ フレア

vrLightService.copyLensFlareGhosts(ghosts)

すべてのゴーストをコピー バッファにコピーします。

パラメータ:	ghosts (List[vrdLensFlareGhost]): コピーするすべてのゴーストのリスト

vrLightService.copyLights(nodes)

ライト グラフ内の指定したすべてのライト ノードをクリップボードにコピーします。クリップボードは、新しいコピーの前に毎回クリアされます。

パラメータ:	nodes (List[vrdNode]): コピーするすべてのライト ノードのリスト

vrLightService.createLight(name, type, parent=vrdNode())

ライト グラフ内に新しいライト ノードを作成します。

Directional: 指向性ライト タイプ

Point: ポイント ライト タイプ

Spot: スポット ライト タイプ

Rectangular: 長方形ライト タイプ

Disk: ディスク ライト タイプ

Spherical: 球状ライト タイプ

Ray: レイライト タイプ

パラメータ:	name (string): 新しいライト ノードの名前 type (vrLightTypes.LightType): ライト タイプ parent (vrdNode): このノードには、新しく作成されたライト ノードが子として含まれています。親ノードは、ライト グラフ内のグループ ノードである必要があります。したがって、ライト グラフのルート、または 1 レベル下の子グループを指定する必要があります。パラメータを省略すると、ライトのルートが使用されます。
戻り値:	ライト グラフ内の、新しく作成および追加されたライト ノード。
戻り値の型:	vrdNode

vrLightService.createLightGroup(name, parent=vrdNode())

新しいライト グループを作成します。

パラメータ:	name (string): 新しいライト グループ ノードの名前 parent (vrdNode): 新しいグループ ノードがこのノードにアタッチされます。親ノードは、ライト グラフ内のノードである必要があります。したがって、ライト グラフのルート、またはその子グループのいずれかを指定する必要があります。このパラメータを省略すると、ライト グラフのルートが使用されます。
戻り値:	新しく作成されたグループ ノード
戻り値の型:	vrdNode

vrLightService.createLightGroup(name, nodes)

いくつかのライトから新しいライト グループを作成します。

パラメータ:	name (string): ライト グループ ノードの名前 nodes (List[vrdNode]): 新しいグループの一部となるライト ノード。このグループは、ライト グラフ内のノードの共通の親の子になります。ノードに共通の親がない場合、グループはライト グラフのルート ノードの子になります。
戻り値:	新しく作成および追加されたライト グループ ノード
戻り値の型:	vrdNode

vrLightService.createLightLinkSet(name='')

新しいライト リンク セットを作成します。

パラメータ:	name (string): ライト リンク セットの名前。名前を省略すると、新しい一意の名前が自動的に生成されます。
戻り値:	新しく作成されたライト リンク セット。vrLightService.lightLinkSetsChanged() 信号が送信されます。
戻り値の型:	vrdLightLinkSetNode

vrLightService.duplicateLensFlareElements(light, elements)

ライトのレンズ フレア要素を複製して、同じライトに追加します。

パラメータ:	light (vrdPointLightNode) 一部のレンズ フレア要素が複製されるライト elements (List[vrdLensFlareElement]): 複製する必要がある要素。これらの要素には、指定したライトの要素を指定する必要があります。そうしないと、これらの要素は無視されます。

vrLightService.duplicateLensFlareGhosts(ghostLine, ghosts)

ゴースト ラインのレンズ フレア ゴーストを複製し、同じゴースト ラインに追加します。

パラメータ:	ghostLine (vrdLensFlareGhostLine): 一部のゴーストが複製されるゴースト ライン ghosts (List[vrdLensFlareGhost]): 複製する必要があるゴースト。これらのゴーストには、指定したゴースト ラインのゴーストを指定する必要があります。そうしないと、ゴーストは無視されます。

vrLightService.duplicateLights(nodes)

ライト グラフ内の指定したすべてのライト ノードを複製します。複製されたノードは、元のノードと同じ親の下に追加されます。

パラメータ:	nodes (List[vrdNode]): 複製するすべてのライト ノードのリスト。

vrLightService.findLight(name)

ライト グラフ内で指定された名前を持つライト ノードを検索します。

パラメータ:	name (string): 検索されたライト ノードの名前
戻り値:	ライト ノード。この名前のライト ノードが見つからない場合は、null になる可能性があります。
戻り値の型:	vrdNode

vrLightService.findLights(name)

指定した名前を持つすべてのライト ノードを検索します。

パラメータ:	name (string): 検索されたライト ノードの名前。ライトは、ライト グラフ内で検索されます。
戻り値:	ライト ノードのリスト。この名前のライト ノードが見つからない場合は、空になる可能性があります。
戻り値の型:	List[vrdNode]

vrLightService.getAllLights(sceneGraph)

すべてのライト ノードを返します。

パラメータ:	sceneGraph (bool): true の場合は、シーングラフからノードを収集します。ｆalse の場合は、ライト グラフを使用します。
戻り値:	すべてのライト ノード
戻り値の型:	List[vrdNode]

vrLightService.getHeadlight()

ヘッド ライト ノードを返します。

戻り値:	ヘッド ライト ノード
戻り値の型:	vrdBaseLightNode

vrLightService.getLightLinksRoot()

すべてのライト セットを含む、ライト セットのルート ノードを返します。

戻り値:	ライト セット ツリーのルート ノード
戻り値の型:	vrdNode

vrLightService.getLightRoot()

すべてのライトとレンズ フレアを含む、ライトのルート ノードを返します。

戻り値:	ライト グラフのルート ノード
戻り値の型:	vrdNode

vrLightService.getLightsClipboard()

戻り値:	クリップボードから取得したライト ノードのリスト。
戻り値の型:	List[vrdNode]

vrLightService.getSelectedLensFlareElements()

選択したレンズ フレア要素を取得します。

戻り値:	選択したレンズ フレア要素
戻り値の型:	List[vrdLensFlareElement]

vrLightService.getSelectedLensFlareGhosts()

現在選択されているゴーストを取得します。

戻り値:	現在選択されているゴースト。
戻り値の型:	List[vrdLensFlareGhost]

vrLightService.getSelectedNodes()

内部バッファから、現在選択されているすべてのライト ノードを返します。

戻り値:	現在選択されているすべてのライト ノードのリスト
戻り値の型:	List[vrdNode]

vrLightService.hasCopiedGhosts()

ゴースト要素がクリップボードで使用可能かどうかを確認します。

戻り値:	ゴースト要素がクリップボードで使用可能な場合は True
戻り値の型:	bool

vrLightService.hasCopiedLensFlareEffect()

レンズ フレア効果がクリップボードで使用可能であることを確認します。

戻り値:	レンズ フレア効果がクリップボードで使用可能な場合は True
戻り値の型:	bool

vrLightService.hasCopiedLensFlareElements()

レンズ フレア要素がクリップボードで使用可能かどうかを確認します。

戻り値:	レンズ フレア要素がクリップボードで使用可能な場合は True
戻り値の型:	bool

vrLightService.isHeadLight(light)

指定したノードがヘッド ライト ノードであるかどうかを確認します。

パラメータ:	light (vrdBaseLightNode) –
戻り値:	指定したノードがヘッド ライト ノードである場合は True
戻り値の型:	bool

vrLightService.isLightsClipboardEmpty()

ライト ノードがクリップボードで使用可能かどうかを確認します。

戻り値:	クリップボードが空の場合は true
戻り値の型:	bool

vrLightService.loadLights(paths)

OpenSG バイナリ ジオメトリまたは VRED プロジェクト バイナリ ファイルからライトをロードします

パラメータ:	paths (List[string]): バイナリ ファイルの完全なファイル パス
戻り値:	新しく追加されたすべてのライト ノード
戻り値の型:	List[vrdNode]

vrLightService.pasteLensFlare(lights)

コピー バッファから 1 つまたは複数のライトにレンズ フレアの効果を貼り付けます。

パラメータ:	lights (List[vrdPointLightNode]): レンズ フレア効果のコピー先となるライト。

vrLightService.pasteLensFlareElements(light)

クリップボードからライトにレンズ フレア要素を貼り付けます。

パラメータ:	light (vrdPointLightNode): レンズ フレア要素のコピー先となるライト。

vrLightService.pasteLensFlareGhosts(ghostLine)

コピー バッファ内のすべてのゴーストをゴースト ラインに貼り付けます。

パラメータ:	ghostLine (vrdLensFlareGhostLine): ゴーストを貼り付けるゴースト ライン。

vrLightService.pasteLights(targetNodes)

指定したすべてのライト ノードをクリップボードからグラフに貼り付けます。クリップボードの内容は変更されません。

パラメータ:	targetNodes (List[vrdNode]): ノードを貼り付けるターゲット ノード。

vrLightService.removeLightLinkSets(nodes)

ライト リンク セットを削除します。

パラメータ:	nodes (List[vrdLightLinkSetNode]): 削除するすべてのライト リンク セットのリスト。vrLightService.lightLinkSetsChanged() 信号が送信されます。

vrLightService.removeLights(nodes)

ライト グラフ内の指定したすべてのライト ノードを削除します。

パラメータ:	nodes (List[vrdNode]): 削除するすべてのライト ノードのリスト

vrLightService.saveLights(nodes, path)

指定したノード内のすべてのライトを再帰的に収集し、OpenSG バイナリ ジオメトリ ファイルとして保存します。

パラメータ:	nodes (List[vrdNode]): 保存するライト ノードのリスト path (string): osg ファイルの完全なファイル パス。osg サフィックスが含まれている必要があります。
戻り値:	ファイルが正常に保存されている場合は True
戻り値の型:	bool

vrLightService.setSelectedLensFlareElements(elements)

選択したすべてのレンズ フレア要素を設定します。

パラメータ:	elements (List[vrdLensFlareElement]): 選択する必要があるすべてのレンズ フレア要素のリスト。

vrLightService.setSelectedLensFlareGhosts(ghosts)

選択したゴーストを設定します。現在選択されているすべてのゴーストを、選択されていない状態にリセットします。vrLightService.lensFlareGhostSelectionChanged(ghosts) 信号が送信されます。

パラメータ:	ghosts (List[vrdLensFlareGhost]): 選択されるゴーストのリスト。

vrLightService.setSelectedNodes(nodes)

選択したすべてのライト ノードを設定します。現在選択されているすべてのノードが、選択されていない状態にリセットされます。ライト サービスのほぼすべてのコマンドが、選択したノードで機能します。vrLightService.nodeSelectionChanged(nodes) 信号が送信されます。

パラメータ:	nodes (List[vrdNode]): 現在選択されているすべてのライト ノードのリスト。

vrLightService.validateLights()

シーン グラフ内のすべてのライトがライト グラフ内のライトに相互に対応しているかどうかを検証します。有効な親を持たないライトは削除されます。vrLightService.lightsValidated() 信号が送信されます。

信号

vrLightService.lensFlareElementSelectionChanged(elements)

レンズ フレア要素の選択バッファが変更されている場合は、信号が送信されます。

パラメータ:	elements (List[vrdLensFlareElement]): 現在選択されているすべてのレンズ フレア要素

vrLightService.lensFlareGhostSelectionChanged(ghosts)

選択したゴーストのリストが変更されている場合は、信号が送信されます。

パラメータ:	ghosts (List[vrdLensFlareGhost]): 選択されてるすべてのゴーストの新しいリスト

vrLightService.lightLinkSetsChanged()

ライト リンク セットが追加または削除されている場合、信号が送信されます。

vrLightService.lightsConverted(lightIds)

ライトがさまざまなライト タイプに変換されるときに送信される信号。

パラメータ:	lightIds (List[integer]): 変換されたライトのオブジェクト ID。

vrLightService.lightsStateChanged()

ライト グラフまたはシーン グラフ内でいずれかのライトのオン/オフ状態が変更されると、信号が送信されます。

vrLightService.lightsValidated()

ライトの検証後に送信される信号。

vrLightService.nodesAdded(nodes)

ライト ノードが追加されている場合は、信号が送信されます。

パラメータ:	nodes (List[vrdNode]): 新しく作成されたライト ノード

vrLightService.nodesChanged(nodes)

ライト ノードが変更されている場合は、信号が送信されます。

パラメータ:	nodes (List[vrdNode]): 変更されたすべてのライト ノード

vrLightService.nodeSelectionChanged(nodes)

ライト ノードの選択バッファが変更されている場合は、信号が送信されます。

パラメータ:	nodes (List[vrdNode]): 現在選択されているすべてのライト ノード

vrLightService.nodesRemoved(nodes)

ライト ノードが削除されている場合は、信号が送信されます。

パラメータ:	nodes (List[vrdNode]): 削除されているすべてのライト ノード