HALCON Website / HALCON Operator-Referenz / Graphik / 3D-Szene
KlassenKlassenKlassenKlassen | | | | Operatoren

add_scene_3d_labelT_add_scene_3d_labelAddScene3dLabeladd_scene_3d_labelAddScene3dLabelAddScene3dLabel (Operator)

Name

add_scene_3d_labelT_add_scene_3d_labelAddScene3dLabeladd_scene_3d_labelAddScene3dLabelAddScene3dLabel — Hinzufügen eines Labels zu einer 3D-Szene.

Signatur

add_scene_3d_label( : : Scene3D, Text, ReferencePoint, Position, RelatesTo : LabelIndex)

Herror T_add_scene_3d_label(const Htuple Scene3D, const Htuple Text, const Htuple ReferencePoint, const Htuple Position, const Htuple RelatesTo, Htuple* LabelIndex)

Herror add_scene_3d_label(const HTuple& Scene3D, const HTuple& Text, const HTuple& ReferencePoint, const HTuple& Position, const HTuple& RelatesTo, Hlong* LabelIndex)

Hlong HScene3D::AddScene3dLabel(const HTuple& Text, const HTuple& ReferencePoint, const HTuple& Position, const HTuple& RelatesTo) const

void AddScene3dLabel(const HTuple& Scene3D, const HTuple& Text, const HTuple& ReferencePoint, const HTuple& Position, const HTuple& RelatesTo, HTuple* LabelIndex)

Hlong HScene3D::AddScene3dLabel(const HTuple& Text, const HTuple& ReferencePoint, const HTuple& Position, const HTuple& RelatesTo) const

Hlong HScene3D::AddScene3dLabel(const HString& Text, const HTuple& ReferencePoint, const HTuple& Position, const HTuple& RelatesTo) const

Hlong HScene3D::AddScene3dLabel(const char* Text, const HTuple& ReferencePoint, const HTuple& Position, const HTuple& RelatesTo) const

void HOperatorSetX.AddScene3dLabel(
[in] VARIANT Scene3D, [in] VARIANT Text, [in] VARIANT ReferencePoint, [in] VARIANT Position, [in] VARIANT RelatesTo, [out] VARIANT* LabelIndex)

Hlong HScene3DX.AddScene3dLabel(
[in] VARIANT Text, [in] VARIANT ReferencePoint, [in] VARIANT Position, [in] VARIANT RelatesTo)

static void HOperatorSet.AddScene3dLabel(HTuple scene3D, HTuple text, HTuple referencePoint, HTuple position, HTuple relatesTo, out HTuple labelIndex)

int HScene3D.AddScene3dLabel(HTuple text, HTuple referencePoint, HTuple position, HTuple relatesTo)

int HScene3D.AddScene3dLabel(string text, HTuple referencePoint, HTuple position, HTuple relatesTo)

Beschreibung

add_scene_3d_labeladd_scene_3d_labelAddScene3dLabeladd_scene_3d_labelAddScene3dLabelAddScene3dLabel fügt ein Label mit dem Inhalt TextTextTextTextTexttext zur 3D-Szene Scene3DScene3DScene3DScene3DScene3Dscene3D hinzu und gibt den Index des Labels in LabelIndexLabelIndexLabelIndexLabelIndexLabelIndexlabelIndex zurück.

Der Bezugspunkt des Labels wird als [X,Y,Z]-Punkt im Koordinatensystem der 3D-Szene in ReferencePointReferencePointReferencePointReferencePointReferencePointreferencePoint festgelegt. Es ist möglich, ein Label ohne Bezugspunkt zu erzeugen, indem ein leeres Tupel übergeben wird. Dies ist allerdings nur möglich, wenn RelatesToRelatesToRelatesToRelatesToRelatesTorelatesTo auf 'point'"point""point""point""point""point" gesetzt wird (siehe die Beschreibung von RelatesToRelatesToRelatesToRelatesToRelatesTorelatesTo weiter unten).

Werden mehrere Texte in TextTextTextTextTexttext als Tupel übergeben, werden mehrere Labels erzeugt. Es ist möglich einen Bezugspunkt für alle Labels oder spezifische Bezugspunkte für jedes Label festzulegen. Das gilt auch für PositionPositionPositionPositionPositionposition und RelatesToRelatesToRelatesToRelatesToRelatesTorelatesTo.

Labels können fest in Fensterkoordinaten oder relativ zur Projektion des Bezugspunktes positioniert werden. Dafür werden die beiden Parameter PositionPositionPositionPositionPositionposition und RelatesToRelatesToRelatesToRelatesToRelatesTorelatesTo verwendet:

Feste Positionierung

Wird RelatesToRelatesToRelatesToRelatesToRelatesTorelatesTo auf 'window'"window""window""window""window""window" gesetzt, wird das Label an einer festen Position im Fenster (bzw. gerenderten Bild) dargestellt, auch wenn sich die Pose der 3D-Szene ändert. Es gibt zwei Möglichkeiten, die Position festzulegen. Es können entweder die [Zeile,Spalte]-Koordinaten der linken oberen Ecke des Labels in PositionPositionPositionPositionPositionposition übergeben werden oder eine der folgenden vordefinierten Positionen:

'top_left'"top_left""top_left""top_left""top_left""top_left" 'top'"top""top""top""top""top" 'top_right'"top_right""top_right""top_right""top_right""top_right"
'left'"left""left""left""left""left" 'center'"center""center""center""center""center" 'right'"right""right""right""right""right"
'bottom_left'"bottom_left""bottom_left""bottom_left""bottom_left""bottom_left" 'bottom'"bottom""bottom""bottom""bottom""bottom" 'bottom_right'"bottom_right""bottom_right""bottom_right""bottom_right""bottom_right"

Relative Positionierung

Wird RelatesToRelatesToRelatesToRelatesToRelatesTorelatesTo auf 'point'"point""point""point""point""point" gesetzt, wird das Label an einer Position relativ zur Projektion des Bezugspunkts dargestellt. Auf diese Weise bewegt sich das Label mit dem Bezugspunkt, wenn die Pose der 3D-Szene geändert wird. Es gibt wiederum zwei Möglichkeiten die Position festzulegen. Es kann entweder der Offset (in [Zeile,Spalte]-Koordinaten) der linken oberen Ecke des Labels oder eine der folgenden vordefinierten Positionen in PositionPositionPositionPositionPositionposition übergeben werden:

'top_left'"top_left""top_left""top_left""top_left""top_left" 'top'"top""top""top""top""top" 'top_right'"top_right""top_right""top_right""top_right""top_right"
'left'"left""left""left""left""left" 'center'"center""center""center""center""center" 'right'"right""right""right""right""right"
'bottom_left'"bottom_left""bottom_left""bottom_left""bottom_left""bottom_left" 'bottom'"bottom""bottom""bottom""bottom""bottom" 'bottom_right'"bottom_right""bottom_right""bottom_right""bottom_right""bottom_right"

Mit set_scene_3d_label_paramset_scene_3d_label_paramSetScene3dLabelParamset_scene_3d_label_paramSetScene3dLabelParamSetScene3dLabelParam können diese und andere Parameter wie z.B. Farbe und Schriftart des Labels verändert werden.

Parallelisierung

Parameter

Scene3DScene3DScene3DScene3DScene3Dscene3D (input_control)  scene_3d → HScene3D, HTupleHTupleHScene3D, HTupleHScene3DX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle der 3D-Szene.

TextTextTextTextTexttext (input_control)  string(-array) → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Text des Labels.

Defaultwert: 'label' "label" "label" "label" "label" "label"

ReferencePointReferencePointReferencePointReferencePointReferencePointreferencePoint (input_control)  point-array → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Bezugspunkt des Labels.

Parameteranzahl: 3

PositionPositionPositionPositionPositionposition (input_control)  point-array → HTupleHTupleHTupleVARIANTHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong) (BSTR / double / Hlong) (char* / double / Hlong)

Position im Fenster

Defaultwert: 'top' "top" "top" "top" "top" "top"

Werteliste: 'bottom'"bottom""bottom""bottom""bottom""bottom", 'bottom_left'"bottom_left""bottom_left""bottom_left""bottom_left""bottom_left", 'bottom_right'"bottom_right""bottom_right""bottom_right""bottom_right""bottom_right", 'center'"center""center""center""center""center", 'left'"left""left""left""left""left", 'right'"right""right""right""right""right", 'top'"top""top""top""top""top", 'top_left'"top_left""top_left""top_left""top_left""top_left", 'top_right'"top_right""top_right""top_right""top_right""top_right"

RelatesToRelatesToRelatesToRelatesToRelatesTorelatesTo (input_control)  string-array → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Feste oder relative Positionierung

Parameteranzahl: 1

Defaultwert: 'point' "point" "point" "point" "point" "point"

Werteliste: 'point'"point""point""point""point""point", 'window'"window""window""window""window""window"

LabelIndexLabelIndexLabelIndexLabelIndexLabelIndexlabelIndex (output_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Index des neuen Labels in der 3D-Szene.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert add_scene_3d_labeladd_scene_3d_labelAddScene3dLabeladd_scene_3d_labelAddScene3dLabelAddScene3dLabel den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_scene_3dcreate_scene_3dCreateScene3dcreate_scene_3dCreateScene3dCreateScene3d

Nachfolger

set_scene_3d_label_paramset_scene_3d_label_paramSetScene3dLabelParamset_scene_3d_label_paramSetScene3dLabelParamSetScene3dLabelParam

Siehe auch

remove_scene_3d_instanceremove_scene_3d_instanceRemoveScene3dInstanceremove_scene_3d_instanceRemoveScene3dInstanceRemoveScene3dInstance

Modul

3D Metrology

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 13.0.4 Copyright © 1996-2019 MVTec Software GmbH