gusimplewhiteboard
wb_location.h
Go to the documentation of this file.
1/*
2 * file wb_location.h
3 *
4 * This file was generated by classgenerator from location.gen.
5 * DO NOT CHANGE MANUALLY!
6 *
7 * Copyright © 2021 Callum McColl. All rights reserved.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 *
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 *
16 * 2. Redistributions in binary form must reproduce the above
17 * copyright notice, this list of conditions and the following
18 * disclaimer in the documentation and/or other materials
19 * provided with the distribution.
20 *
21 * 3. All advertising materials mentioning features or use of this
22 * software must display the following acknowledgement:
23 *
24 * This product includes software developed by Callum McColl.
25 *
26 * 4. Neither the name of the author nor the names of contributors
27 * may be used to endorse or promote products derived from this
28 * software without specific prior written permission.
29 *
30 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
31 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
32 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
33 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
34 * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
35 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
36 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
37 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
38 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
39 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
40 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
41 *
42 * -----------------------------------------------------------------------
43 * This program is free software; you can redistribute it and/or
44 * modify it under the above terms or under the terms of the GNU
45 * General Public License as published by the Free Software Foundation;
46 * either version 2 of the License, or (at your option) any later version.
47 *
48 * This program is distributed in the hope that it will be useful,
49 * but WITHOUT ANY WARRANTY; without even the implied warranty of
50 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
51 * GNU General Public License for more details.
52 *
53 * You should have received a copy of the GNU General Public License
54 * along with this program; if not, see http://www.gnu.org/licenses/
55 * or write to the Free Software Foundation, Inc., 51 Franklin Street,
56 * Fifth Floor, Boston, MA 02110-1301, USA.
57 *
58 */
59
60#ifndef wb_location_h
61#define wb_location_h
62
63#pragma clang diagnostic push
64#pragma clang diagnostic ignored "-Wreserved-id-macro"
65
66#ifdef __linux
67# ifndef _POSIX_SOURCE
68# define _POSIX_SOURCE 200112L
69# endif
70#endif
71#ifndef _XOPEN_SOURCE
72# define _XOPEN_SOURCE 700
73#endif
74#ifdef __APPLE__
75# ifndef _DARWIN_C_SOURCE
76# define _DARWIN_C_SOURCE 200112L
77# endif
78# ifndef __DARWIN_C_LEVEL
79# define __DARWIN_C_LEVEL 200112L
80# endif
81#endif
82
83#pragma clang diagnostic pop
84
85#include <gu_util.h>
86#include <stdint.h>
87
88#include <stdint.h>
89#include <guunits/guunits.h>
90#include <gucoordinates/gucoordinates.h>
91
92#define LOCATION_GENERATED
93#define LOCATION_C_STRUCT wb_location
94#define LOCATION_NUMBER_OF_VARIABLES 5
95
96#ifdef WHITEBOARD_POSTER_STRING_CONVERSION
97#define LOCATION_DESC_BUFFER_SIZE 108
98#define LOCATION_TO_STRING_BUFFER_SIZE 43
99#endif
100
101#ifdef __cplusplus
102extern "C" {
103#endif
104
109{
110
114 int16_t direction;
115
119 uint16_t distance;
120
124 uint8_t confidence;
125
130
135
136};
137
138#ifdef WHITEBOARD_POSTER_STRING_CONVERSION
139
143const char* wb_location_description(const struct wb_location* self, char* descString, size_t bufferSize);
144
148const char* wb_location_to_string(const struct wb_location* self, char* toString, size_t bufferSize);
149
153struct wb_location* wb_location_from_string(struct wb_location* self, const char* str);
154
155#endif
156
171struct wb_location rr_coord_to_wb_location(const gu_relative_coordinate coord, const uint8_t confidence, const uint32_t distanceVariance, const uint32_t directionVariance);
172
184struct gu_relative_coordinate wb_location_to_rr_coord(const struct wb_location location);
185
202struct gu_optional_relative_coordinate wb_location_to_opt_rr_coord(const struct wb_location location, const uint8_t confidence);
203
204/*#ifdef WHITEBOARD_SERIALISATION*/
205
209size_t wb_location_to_network_serialised(const struct wb_location *self, char *dst);
210
214size_t wb_location_from_network_serialised(const char *src, struct wb_location *dst);
215
216/*#endif /// WHITEBOARD_SERIALISATION*/
217
218#ifdef __cplusplus
219}
220#endif
221
222#endif
WHITEBOARD_POSTER_STRING_CONVERSION.
Definition: wb_location.h:109
uint32_t distanceVariance
The variance of the distance.
Definition: wb_location.h:129
uint32_t directionVariance
The variance of the direction.
Definition: wb_location.h:134
int16_t direction
degrees, relative to the center of the nao torso.
Definition: wb_location.h:114
uint8_t confidence
The type of sighting.
Definition: wb_location.h:124
uint16_t distance
CM distance to the center point of the sighting.
Definition: wb_location.h:119
size_t wb_location_to_network_serialised(const struct wb_location *self, char *dst)
Network stream serialisation.
Definition: wb_location.c:345
const char * wb_location_description(const struct wb_location *self, char *descString, size_t bufferSize)
Convert to a description string.
Definition: wb_location.c:125
const char * wb_location_to_string(const struct wb_location *self, char *toString, size_t bufferSize)
Convert to a string.
Definition: wb_location.c:173
struct wb_location rr_coord_to_wb_location(const gu_relative_coordinate coord, const uint8_t confidence, const uint32_t distanceVariance, const uint32_t directionVariance)
WHITEBOARD_POSTER_STRING_CONVERSION.
Definition: wb_location.c:511
struct gu_optional_relative_coordinate wb_location_to_opt_rr_coord(const struct wb_location location, const uint8_t confidence)
Converts a wb_location to a gu_optional_relative_coordinate.
Definition: wb_location.c:532
struct wb_location * wb_location_from_string(struct wb_location *self, const char *str)
Convert from a string.
Definition: wb_location.c:221
struct gu_relative_coordinate wb_location_to_rr_coord(const struct wb_location location)
Converts a wb_location to a gu_relative_coordinate.
Definition: wb_location.c:523
size_t wb_location_from_network_serialised(const char *src, struct wb_location *dst)
Network stream deserialisation.
Definition: wb_location.c:426