Open Core Interface - MLPI
MLPI-MotionLogicProgrammingInterface(mlpi4COM)  1.26.2
IGroupInfo.idl
Go to the documentation of this file.
1 // -----------------------------------------------------------------------
2 // MLPI - <IGroupInfo.idl>
3 // -----------------------------------------------------------------------
4 // Copyright (c) 2012 Bosch Rexroth. All rights reserved.
5 // Redistribution and use in source and binary forms of this MLPI software
6 // (SW) provided to you, with or without modification, are permitted
7 // without prior approval provided that the following conditions are met:
8 //
9 // 1. Redistributions of source code of SW must retain the above copyright
10 // notice, this list of conditions and the following disclaimer.
11 //
12 // 2. Redistributions in binary form of SW must reproduce the above copyright
13 // notice, this list of conditions and the following disclaimer in the
14 // documentation and/or other materials provided with the distribution.
15 //
16 // 3. User recognizes and acknowledges that it acquires no right,
17 // title or interest in or to any of the names or trademarks used in
18 // connection with the SW ("names") by virtue of this License and waives
19 // any right to or interest in the names. User recognizes and acknowledges
20 // that names of companies or names or products of companies displayed
21 // in the documentation of SW to indicate the interoperability of products
22 // with the SW are the names of their respective owners. The use of such
23 // names in the documentation of SW does not imply any sponsorship,
24 // approval, or endorsement by such companies of this product.
25 //
26 // 4. Modified code versions, i.e. any addition to or deletion from
27 // the substance or structure of the original code of the SW running
28 // the MLPI must be plainly marked as such and must not bemisrepresented
29 // as being original SW.
30 //
31 // 5. The SW may only be used in connection with a Bosch Rexroth product.
32 //
33 // THIS INFORMATION IS PROVIDED BY BOSCH REXROTH CORPORATION "AS IS"
34 // AND WITHOUT WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING
35 // (BUT NOTLIMITED TO) ANY IMPLIED WARRANTIES OF MERCHANTABILITY,
36 // FITNESS FOR ANY PARTICULAR PURPOSE, OR NON-INFRINGEMENT. WHILE THE
37 // INFORMATION PROVIDED IS BELIEVED TO BE ACCURATE, IT MAY INCLUDE
38 // ERRORS OR INACCURACIES.
39 // SUBJECT TO COMPULSORY STATUTORY PROVISIONS OF THE GERMAN LAW AS
40 // THE APPLICABLE LAW FOR THIS LICENSE BOSCH REXROTH CORPORATION WILL
41 // NOT BE LIABLE FOR ANY DAMAGES OF ANY KIND ARISING FROM THE USE OF
42 // THE SOFTWARE DISTRIBUTED HEREUNDER, INCLUDING BUT NOT LIMITED TO
43 // DIRECT, INDIRECT, INCIDENTAL, PUNITIVE, AND CONSEQUENTIAL DAMAGES.
44 // -----------------------------------------------------------------------
45 //
55 //
56 // -----------------------------------------------------------------------
57 
58 
62 [
63  object,
64  uuid(37DC9FCA-AE18-4705-B948-3AE7E63DB8D0),
65  dual,
66  nonextensible,
67  helpstring("IGroupInfo Interface"),
68  pointer_default(unique)
69 ]
70 interface IGroupInfo : IDispatch{
71 #if defined(WIN32) || defined(WIN64)
72  [id(1), helpstring("Method MovePoint")] HRESULT MovePoint([in, out] IRobotPoint* point);
87 
106  [id(2), helpstring("Method SetPerformanceEnable")] HRESULT SetPerformanceEnable([in] enum RobotPerformance type);
107 
124  [id(3), helpstring("Method GetPerformanceResult")] HRESULT GetPerformanceResult([out, retval] SAFEARRAY(struct RobotPerformanceResult) *performanceResult);
125 
143  [id(4), helpstring("Method GetMechanicData")] HRESULT GetMechanicData([in] BOOL updateOnly, [out, retval] SAFEARRAY(struct RobotMechanicData) *mechanicData);
144 
164  [id(5), helpstring("Method GetActualPosition")] HRESULT GetActualPosition([in] enum RobotCoordinateSystem cs, [out, retval] IRobotPoint** position);
165 
178  [id(6), helpstring("Method GetName")] HRESULT GetName([out, retval] BSTR* name);
179 
193  [id(7), helpstring("Method GetType")] HRESULT GetType([out, retval] enum RobotTypes* type);
194 
210  [id(8), helpstring("Method GetTransform")] HRESULT GetTransform([in] enum RobotCoordinateSystem coordSys, [out] struct RobotTrafoParameter *trafoParam);
211 
228  [id(9), helpstring("Method GetBeltConfiguration")] HRESULT GetBeltConfiguration([in] struct AxisRef belt, [out] struct RobotBeltConfigValues *beltValues);
229 
246  [id(10), helpstring("Method GetBeltErrorReaction")] HRESULT GetBeltErrorReaction([in] struct AxisRef belt, [out] struct RobotBeltErrorReactionValues *beltErrorReactParam);
247 
248 
265  [id(11), helpstring("Method GetKinematicValues")] HRESULT GetKinematicValues([out, retval] struct KinematicsValues *kinematicsValues);
266 
281  [id(12), helpstring("Method GetKinematicUnits")] HRESULT GetKinematicUnits([out, retval] struct KinematicsUnits *kinematicsUnits);
282 
297  [id(13), helpstring("Method GetDiagnosisText")] HRESULT GetDiagnosisText([out, retval] BSTR *diagnosisText);
298 
314  [id(14), helpstring("Method TransformPoint")] HRESULT TransformPoint( [in] enum RobotCoordinateSystem csOut, [in, out] IRobotPoint* point);
315 
329  //[id(15), helpstring("Method GetCoordinateSystemInfo")] HRESULT GetCoordinateSystemInfo([out, retval] SAFEARRAY(struct CoordinateSystemInfo) *csInfo);
330 #endif
331 };
332 
333 
334 
335 // -----------------------------------------------------------------------
336 // HISTORY
337 // -----------------------------------------------------------------------
338 // 01-Jan-2012
339 // - first release
340 // 07-Aug-2012 DOS Subject: getTransform implementation for commlpi
341 // - added GetTransform(), GetBeltConfiguration()
342 // 24-Okt-2012 JUR Subject: WP-00028141 MLPI4RCF
343 // - GetBeltErrorReaction added
344 // 10-Dez-2012 JUR Subject: WP-00028141 MLPI4RCF
345 // - interface adaption and docu update due to MLPI release
346 // 04-Jan-2013 STR Subject: docu update
347 // - updated docu
348 // 09-Dec-2013 DED Subject: MLPI Robot Information functions
349 // - getCoordinateSystemInfo implementation
350 
351 
HRESULT GetBeltConfiguration([in] struct AxisRef belt, [out] struct RobotBeltConfigValues *beltValues)
This function returns the values of a belt configuration.
HRESULT GetMechanicData([in] BOOL updateOnly, [out, retval] SAFEARRAY(struct RobotMechanicData)*mechanicData)
This function returns an array of IRobot::RobotMechanicData of the Group.
HRESULT GetActualPosition([in] enum RobotCoordinateSystem cs, [out, retval] IRobotPoint **position)
This function returns the current position of the group in the given coordinate system.
HRESULT GetKinematicValues([out, retval] struct KinematicsValues *kinematicsValues)
This function fills an array of KinematicValues.
HRESULT GetKinematicUnits([out, retval] struct KinematicsUnits *kinematicsUnits)
This function fills an array of KinematicUnits with information about the units of the kinematic...
HRESULT SetPerformanceEnable([in] enum RobotPerformance type)
This function sets the IRobot::RobotPerformance of the Group. You can enable the performance measurem...
Definition of the IGroupInfo interface used to access information of a group.
Definition: IGroupInfo.idl:70
Definition of the IRobotPoint interface.
Definition: IRobotPoint.idl:71
HRESULT MovePoint([in, out] IRobotPoint *point)
This function returns the current position of the given point. You can use this function to track a p...
HRESULT TransformPoint([in] enum RobotCoordinateSystem csOut, [in, out] IRobotPoint *point)
This function transforms the current position of the given point into the given coordinate system...
HRESULT GetName([out, retval] BSTR *name)
This function returns the name of the Group.
HRESULT GetTransform([in] enum RobotCoordinateSystem coordSys, [out] struct RobotTrafoParameter *trafoParam)
This function returns the transformation values of a selected coordinate system.
HRESULT GetPerformanceResult([out, retval] SAFEARRAY(struct RobotPerformanceResult)*performanceResult)
This function returns an array of IRobot::RobotPerformanceResult of the Group.
HRESULT GetType([out, retval] enum RobotTypes *type)
This function returns the IRobot::RobotTypes of the Group.
HRESULT GetDiagnosisText([out, retval] BSTR *diagnosisText)
This function reads the current diagnosis text of the kinematic.
HRESULT GetBeltErrorReaction([in] struct AxisRef belt, [out] struct RobotBeltErrorReactionValues *beltErrorReactParam)
This function returns the values of a configured belt error reaction.