Roboception rc visard Montage- Und Betriebsanleitung Seite 188

7.5. Gemeinsame Funktionalitäten
Parameter
Die ROI-Komponente hat keine Laufzeitparameter.
Services
Die angebotenen Services der ROI-Funktionalität können mithilfe der
8.3) oder der rc_visard Web GUI
bietet, ausprobiert und getestet werden.
Zusätzlich zur eigentlichen Serviceantwort gibt jeder Service einen sogenannten
hend aus einem Integer-Wert und einer optionalen Textnachricht zurück. Erfolgreiche Service-Anfragen
werden mit einem Wert von
reich bearbeitet wurde, aber zusätzliche Informationen zur Verfügung stehen. Negative Werte bedeu-
ten, dass Fehler aufgetreten sind. Für den Fall, dass mehrere Rückgabewerte zutreffend wären, wird
der kleinste zurückgegeben, und die entsprechenden Textnachrichten werden in
akkumuliert.
Die folgende Tabelle führt die möglichen Rückgabe-Codes an:
Tab. 7.18: Rückgabe-Codes der Region of Interest Funktionalität
Code Beschreibung
0 Erfolgreich
-1 Ungültige(s) Argument(e)
-10 Das neue Element konnte nicht hinzugefügt werden, da die maximal speicherbare Anzahl
an ROIs überschritten wurde.
10 Die maximal speicherbare Anzahl an ROIs wurde erreicht.
11 Mit dem Aufruf von
derselben überschrieben.
id
Alle Softwaremodule, die die ROI-Funktionalität anbieten, stellen folgende Services zur Verfügung.
set_region_of_interest
speichert eine ROI auf dem rc_visard. Alle ROIs sind dauerhaft gespeichert, auch über
Firmware-Updates und -Wiederherstellungen hinweg.
Die De nition der Request-Argumente mit jeweiligen Datentypen ist:
{
"args": {
"region _ of _
interest": {
"box": {
"x": "float64",
"y": "float64",
"z": "float64"
},
"id": "string",
"pose": {
"orientation": {
"w": "float64",
"x": "float64",
"y": "float64",
"z": "float64"
},
"position": {
"x": "float64",
"y": "float64",
Roboception GmbH
Handbuch: rc_visard
(Abschnitt 8.1) auf der Seite des Moduls, das die ROI-Funktionalität an-
quittiert. Positive Werte bedeuten, dass die Service-Anfrage zwar erfolg-
0
set _ region _ of _ interest
187
REST-API-Schnittstelle
wurde ein bereits existierendes Objekt mit
(Fortsetzung auf der nächsten Seite)
(Abschnitt
return _ code
beste-
return _ code.message
Rev: 21.01.1
Status: 30.01.2021