get_display_scene_3d_infoT_get_display_scene_3d_infoGetDisplayScene3dInfoGetDisplayScene3dInfoget_display_scene_3d_info (Operator)
Name
get_display_scene_3d_infoT_get_display_scene_3d_infoGetDisplayScene3dInfoGetDisplayScene3dInfoget_display_scene_3d_info — Zurückgeben der Tiefe oder des Indexes eines dargestellten 3D-Objektmodells.
Signatur
void GetDisplayScene3dInfo(const HTuple& WindowHandle, const HTuple& Scene3D, const HTuple& Row, const HTuple& Column, const HTuple& Information, HTuple* Value)
HTuple HScene3D::GetDisplayScene3dInfo(const HWindow& WindowHandle, const HTuple& Row, const HTuple& Column, const HTuple& Information) const
Hlong HScene3D::GetDisplayScene3dInfo(const HWindow& WindowHandle, double Row, double Column, const HString& Information) const
Hlong HScene3D::GetDisplayScene3dInfo(const HWindow& WindowHandle, double Row, double Column, const char* Information) const
Hlong HScene3D::GetDisplayScene3dInfo(const HWindow& WindowHandle, double Row, double Column, const wchar_t* Information) const
(Nur Windows)
static void HOperatorSet.GetDisplayScene3dInfo(HTuple windowHandle, HTuple scene3D, HTuple row, HTuple column, HTuple information, out HTuple value)
HTuple HScene3D.GetDisplayScene3dInfo(HWindow windowHandle, HTuple row, HTuple column, HTuple information)
int HScene3D.GetDisplayScene3dInfo(HWindow windowHandle, double row, double column, string information)
def get_display_scene_3d_info(window_handle: HHandle, scene_3d: HHandle, row: MaybeSequence[Union[float, int]], column: MaybeSequence[Union[float, int]], information: MaybeSequence[str]) -> Sequence[Union[int, float]]
def get_display_scene_3d_info_s(window_handle: HHandle, scene_3d: HHandle, row: MaybeSequence[Union[float, int]], column: MaybeSequence[Union[float, int]], information: MaybeSequence[str]) -> Union[int, float]
Beschreibung
get_display_scene_3d_infoget_display_scene_3d_infoGetDisplayScene3dInfoGetDisplayScene3dInfoGetDisplayScene3dInfoget_display_scene_3d_info gibt Informationen über die
3D-Objektmodelle in der 3D-Szene Scene3DScene3DScene3DScene3Dscene3Dscene_3d, die im Fenster
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle an den Positionen (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn)
mit display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3ddisplay_scene_3d angezeigt wurden in ValueValueValueValuevaluevalue zurück.
Mit dem Parameter InformationInformationInformationInformationinformationinformation wird ausgewählt, welche
Werte zurückgegeben werden:
- 'object_index'"object_index""object_index""object_index""object_index""object_index"
-
Die Indices der 3D-Objektmodelle, die an den Positionen (RowRowRowRowrowrow,
ColumnColumnColumnColumncolumncolumn) dargestellt wurden. Befindet sich kein 3D-Objektmodell an
einer dieser Stellen, wird -1 zurückgegeben.
Um diese Information ermitteln zu können, muss der Parameter
'object_index_persistence'"object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence""object_index_persistence" mit set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParamSetScene3dParamset_scene_3d_param
auf 'true'"true""true""true""true""true" gesetzt worden sein.
- 'depth'"depth""depth""depth""depth""depth"
Die Tiefe (d.h. die Z-Koordinate im Kamerakoordinatensystem) an den
Positionen (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn). Befindet sich
kein 3D-Objektmodell an einer dieser Stellen, wird -1.0
zurückgegeben.
Um diese Information ermitteln zu können, muss der Parameter
'depth_persistence'"depth_persistence""depth_persistence""depth_persistence""depth_persistence""depth_persistence" mit set_scene_3d_paramset_scene_3d_paramSetScene3dParamSetScene3dParamSetScene3dParamset_scene_3d_param
auf 'true'"true""true""true""true""true" gesetzt worden sein.
Die Fensterkoordinaten RowRowRowRowrowrow und ColumnColumnColumnColumncolumncolumn müssen so angegeben
werden, dass sie dem gesetzten Bildausschnitt entsprechen. Sie können daher
auch subpixelgenau sein. Ist der Bildausschnitt durch (Zeile1,Spalte1,Zeile2,
Spalte2) gegeben, entspricht die linke obere Ecke den
Koordinaten (Zeile1 - 0.5, Spalte1 - 0.5), die rechte untere Ecke den
Koordinaten (Zeile2 - 0.5, Spalte2 - 0.5).
Die Operatoren get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPixget_mposition_sub_pix oder
get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix können verwendet werden, um diese Koordinaten
direkt zu erhalten.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Automatisch parallelisiert auf interner Datenebene.
Parameter
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Fensteridentifikator.
Scene3DScene3DScene3DScene3Dscene3Dscene_3d (input_control) scene_3d → HScene3D, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle der 3D-Szene.
RowRowRowRowrowrow (input_control) integer(-array) → HTupleMaybeSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Zeilenkoordinaten.
ColumnColumnColumnColumncolumncolumn (input_control) integer(-array) → HTupleMaybeSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Spaltenkoordinaten.
InformationInformationInformationInformationinformationinformation (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Abzufragende Information.
Defaultwert:
'depth'
"depth"
"depth"
"depth"
"depth"
"depth"
Werteliste: 'depth'"depth""depth""depth""depth""depth", 'object_index'"object_index""object_index""object_index""object_index""object_index"
ValueValueValueValuevaluevalue (output_control) integer(-array) → HTupleSequence[Union[int, float]]HTupleHtuple (integer / real) (int / long / double) (Hlong / double) (Hlong / double)
Werte an (Row,Column).
Ergebnis
get_display_scene_3d_infoget_display_scene_3d_infoGetDisplayScene3dInfoGetDisplayScene3dInfoGetDisplayScene3dInfoget_display_scene_3d_info liefert den Wert 2 (H_MSG_TRUE), falls die
Parameter korrekt sind. Gegebenenfalls wird eine Fehlerbehandlung
durchgeführt.
Vorgänger
display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3ddisplay_scene_3d,
get_mbuttonget_mbuttonGetMbuttonGetMbuttonGetMbuttonget_mbutton,
get_mbutton_sub_pixget_mbutton_sub_pixGetMbuttonSubPixGetMbuttonSubPixGetMbuttonSubPixget_mbutton_sub_pix,
get_mpositionget_mpositionGetMpositionGetMpositionGetMpositionget_mposition,
get_mposition_sub_pixget_mposition_sub_pixGetMpositionSubPixGetMpositionSubPixGetMpositionSubPixget_mposition_sub_pix
Siehe auch
display_scene_3ddisplay_scene_3dDisplayScene3dDisplayScene3dDisplayScene3ddisplay_scene_3d
Modul
3D Metrology