DI-Guy SDK Documentation  13.8
diguyViewCameraSettings.h
Go to the documentation of this file.
1 
2 /*********************************************************************
3  ** Copyright (c) 1992-2022 MAK Technologies, Inc.
4  ** All rights reserved.
5  *********************************************************************/
6 
7 
8 
9 #ifndef __diguyViewCameraSettings_H
10 #define __diguyViewCameraSettings_H
11 
12 #ifdef SWIG
14 #else
15 #define CPLUSPLUS_ONLY
16 #endif
17 
18 #ifdef CPLUSPLUS_ONLY
19 class bdiCamera;
21 
22 #include <diguy_constants.h>
23 
24 #endif
25 
26 
27 #include <declspec_diguy.h>
28 
29 /*********************************************************************/
47 class BDI_DECLSPEC_diguy diguyViewCameraSettings
48 {
49 
50 public:
51 
52 /*****************************************************************************/
58  /*l
59  *b Description:
60  **
61  ** The diguyViewCameraSettings equivalent of
62  ** diguyViewCamera::get_name().
63  */
64  const char* get_name();
65 
66  /*l
67  *b Description:
68  **
69  ** The diguyViewCameraSettings equivalent of
70  ** diguyViewCamera::get_type_name().
71  */
72  const char* get_type_name();
73 
74  /*l
75  *b Description:
76  **
77  ** The diguyViewCameraSettings equivalent of
78  ** diguyViewCamera::set_near_plane().
79  */
80  void set_near_plane(float near_plane);
81 
82  /*l
83  *b Description:
84  **
85  ** The diguyViewCameraSettings equivalent of
86  ** diguyViewCamera::get_near_plane().
87  */
88  float get_near_plane();
89 
90  /*l
91  *b Description:
92  **
93  ** The diguyViewCameraSettings equivalent of
94  ** diguyViewCamera::set_far_plane().
95  */
96  void set_far_plane(float far_plane);
97 
98  /*l
99  *b Description:
100  **
101  ** The diguyViewCameraSettings equivalent of
102  ** diguyViewCamera::get_far_plane().
103  */
104  float get_far_plane();
105 
106  /*l
107  *b Description:
108  **
109  ** The diguyViewCameraSettings equivalent of
110  ** diguyViewCamera::set_fov().
111  */
112  void set_fov(float fov);
113 
114  /*l
115  *b Description:
116  **
117  ** The diguyViewCameraSettings equivalent of
118  ** diguyViewCamera::get_fov().
119  */
120  float get_fov();
121 
122  /*l
123  *b Description:
124  **
125  ** The diguyViewCameraSettings equivalent of
126  ** diguyViewCamera::set_min_fov().
127  */
128  void set_min_fov(float fov);
129 
130  /*l
131  *b Description:
132  **
133  ** The diguyViewCameraSettings equivalent of
134  ** diguyViewCamera::set_max_fov().
135  */
136  void set_max_fov(float fov);
137 
138  /*l
139  *b Description:
140  **
141  ** The diguyViewCameraSettings equivalent of
142  ** diguyViewCamera::get_min_fov().
143  */
144  float get_min_fov();
145 
146  /*l
147  *b Description:
148  **
149  ** The diguyViewCameraSettings equivalent of
150  ** diguyViewCamera::get_max_fov().
151  */
152  float get_max_fov();
153 
154  /*l
155  *b Description:
156  **
157  ** The diguyViewCameraSettings equivalent of
158  ** diguyViewCamera::set_aspect().
159  */
160  void set_aspect(float aspect);
161 
162  /*l
163  *b Description:
164  **
165  ** The diguyViewCameraSettings equivalent of
166  ** diguyViewCamera::get_aspect().
167  */
168  float get_aspect();
169 
170  /*l
171  *b Description:
172  **
173  ** The diguyViewCameraSettings equivalent of
174  ** diguyViewCamera::set_position().
175  */
176  void set_position(float x, float y, float z);
177 
178  /*l
179  *b Description:
180  **
181  ** The diguyViewCameraSettings equivalent of
182  ** diguyViewCamera::get_position_x().
183  */
184  float get_position_x();
185 
186  /*l
187  *b Description:
188  **
189  ** The diguyViewCameraSettings equivalent of
190  ** diguyViewCamera::get_position_y().
191  */
192  float get_position_y();
193 
194  /*l
195  *b Description:
196  **
197  ** The diguyViewCameraSettings equivalent of
198  ** diguyViewCamera::get_position_z().
199  */
200  float get_position_z();
201 
202  /*l
203  *b Description:
204  **
205  ** The diguyViewCameraSettings equivalent of
206  ** diguyViewCamera::set_orientation().
207  */
208  void set_orientation(float yaw, float roll, float pitch);
209 
210  /*l
211  *b Description:
212  **
213  ** The diguyViewCameraSettings equivalent of
214  ** diguyViewCamera::set_orientation_roll().
215  */
216  void set_orientation_roll(float r);
217 
218  /*l
219  *b Description:
220  **
221  ** The diguyViewCameraSettings equivalent of
222  ** diguyViewCamera::get_orientation_yaw().
223  */
224  float get_orientation_yaw();
225 
226  /*l
227  *b Description:
228  **
229  ** The diguyViewCameraSettings equivalent of
230  ** diguyViewCamera::get_orientation_roll().
231  */
232  float get_orientation_roll();
233 
234  /*l
235  *b Description:
236  **
237  ** The diguyViewCameraSettings equivalent of
238  ** diguyViewCamera::get_orientation_pitch().
239  */
240  float get_orientation_pitch();
241 
242  /*l
243  *b Description:
244  **
245  ** The diguyViewCameraSettings equivalent of
246  ** diguyViewCamera::set_pitch_lower_limit().
247  */
248  void set_pitch_lower_limit(float limit);
249 
250  /*l
251  *b Description:
252  **
253  ** The diguyViewCameraSettings equivalent of
254  ** diguyViewCamera::set_pitch_upper_limit().
255  */
256  void set_pitch_upper_limit(float limit);
257 
258  /*l
259  *b Description:
260  **
261  ** The diguyViewCameraSettings equivalent of
262  ** diguyViewCamera::get_pitch_lower_limit().
263  */
264  float get_pitch_lower_limit();
265 
266  /*l
267  *b Description:
268  **
269  ** The diguyViewCameraSettings equivalent of
270  ** diguyViewCamera::get_pitch_upper_limit().
271  */
272  float get_pitch_upper_limit();
273 
274  /*l
275  *b Description:
276  **
277  ** The diguyViewCameraSettings equivalent of
278  ** diguyViewCamera::get_pitch_has_limits().
279  */
280  int get_pitch_has_limits();
281 
282  /*l
283  *b Description:
284  **
285  ** The diguyViewCameraSettings equivalent of
286  ** diguyViewCamera::set_distance().
287  */
288  void set_distance(float distance);
289 
290  /*l
291  *b Description:
292  **
293  ** The diguyViewCameraSettings equivalent of
294  ** diguyViewCamera::get_distance().
295  */
296  float get_distance();
297 
298  /*l
299  *b Description:
300  **
301  ** The diguyViewCameraSettings equivalent of
302  ** diguyViewCamera::set_fix().
303  */
304  void set_fix(float x, float y, float z);
305 
306  /*l
307  *b Description:
308  **
309  ** The diguyViewCameraSettings equivalent of
310  ** diguyViewCamera::get_fix_x().
311  */
312  float get_fix_x();
313 
314  /*l
315  *b Description:
316  **
317  ** The diguyViewCameraSettings equivalent of
318  ** diguyViewCamera::get_fix_y().
319  */
320  float get_fix_y();
321 
322  /*l
323  *b Description:
324  **
325  ** The diguyViewCameraSettings equivalent of
326  ** diguyViewCamera::get_fix_z().
327  */
328  float get_fix_z();
329 
330  /*l
331  *b Description:
332  **
333  ** The diguyViewCameraSettings equivalent of
334  ** diguyViewCamera::set_move_mode().
335  */
336  int set_move_mode(diguyViewCameraMoveMode move_mode);
337 
338  /*l
339  *b Description:
340  **
341  ** The diguyViewCameraSettings equivalent of
342  ** diguyViewCamera::get_move_mode().
343  */
344  diguyViewCameraMoveMode get_move_mode();
345 
346  /*l
347  *b Description:
348  **
349  ** The diguyViewCameraSettings equivalent of
350  ** diguyViewCamera::set_projection_mode().
351  */
352  int set_projection_mode(diguyViewCameraProjectionMode projection_mode);
353 
354  /*l
355  *b Description:
356  **
357  ** The diguyViewCameraSettings equivalent of
358  ** diguyViewCamera::get_projection_mode().
359  */
360  diguyViewCameraProjectionMode get_projection_mode();
361 
362  /*l
363  *b Description:
364  **
365  ** The diguyViewCameraSettings equivalent of
366  ** diguyViewCamera::set_speed().
367  */
368  int set_speed(float speed);
369 
370  /*l
371  *b Description:
372  **
373  ** The diguyViewCameraSettings equivalent of
374  ** diguyViewCamera::get_speed().
375  */
376  float get_speed();
377 
378 
379 /*****************************************************************************/
385  /*l
386  *b Description:
387  **
388  ** The diguyViewCameraSettings equivalent of
389  ** diguyViewCamera::set_track_name().
390  */
391  void set_track_name(const char* track_name);
392 
393  /*l
394  *b Description:
395  **
396  ** The diguyViewCameraSettings equivalent of
397  ** diguyViewCamera::get_track_name().
398  */
399  const char* get_track_name();
400 
401  /*l
402  *b Description:
403  **
404  ** The diguyViewCameraSettings equivalent of
405  ** diguyViewCamera::set_track_link_name().
406  */
407  void set_track_link_name(const char* track_link_name);
408 
409  /*l
410  *b Description:
411  **
412  ** The diguyViewCameraSettings equivalent of
413  ** diguyViewCamera::get_track_link_name().
414  */
415  const char* get_track_link_name();
416 
417  /*l
418  *b Description:
419  **
420  ** The diguyViewCameraSettings equivalent of
421  ** diguyViewCamera::set_track_offset().
422  */
423  void set_track_offset(float x, float y, float z);
424 
425  /*l
426  *b Description:
427  **
428  ** The diguyViewCameraSettings equivalent of
429  ** diguyViewCamera::get_track_offset_x().
430  */
431  float get_track_offset_x();
432 
433  /*l
434  *b Description:
435  **
436  ** The diguyViewCameraSettings equivalent of
437  ** diguyViewCamera::get_track_offset_y().
438  */
439  float get_track_offset_y();
440 
441  /*l
442  *b Description:
443  **
444  ** The diguyViewCameraSettings equivalent of
445  ** diguyViewCamera::get_track_offset_z().
446  */
447  float get_track_offset_z();
448 
449  /*l
450  *b Description:
451  **
452  ** The diguyViewCameraSettings equivalent of
453  ** diguyViewCamera::set_track_offset_is_in_world_coordinates().
454  */
455  void set_track_offset_is_in_world_coordinates(int value);
456 
457  /*l
458  *b Description:
459  **
460  ** The diguyViewCameraSettings equivalent of
461  ** diguyViewCamera::get_track_offset_is_in_world_coordinates().
462  */
463  int get_track_offset_is_in_world_coordinates();
464 
465  /*l
466  *b Description:
467  **
468  ** The diguyViewCameraSettings equivalent of
469  ** diguyViewCamera::set_dolly_name().
470  */
471  void set_dolly_name(const char* dolly_name);
472 
473  /*l
474  *b Description:
475  **
476  ** The diguyViewCameraSettings equivalent of
477  ** diguyViewCamera::get_dolly_name().
478  */
479  const char* get_dolly_name();
480 
481  /*l
482  *b Description:
483  **
484  ** The diguyViewCameraSettings equivalent of
485  ** diguyViewCamera::set_dolly_link_name().
486  */
487  void set_dolly_link_name(const char* dolly_link_name);
488 
489  /*l
490  *b Description:
491  **
492  ** The diguyViewCameraSettings equivalent of
493  ** diguyViewCamera::get_dolly_link_name().
494  */
495  const char* get_dolly_link_name();
496 
497  /*l
498  *b Description:
499  **
500  ** The diguyViewCameraSettings equivalent of
501  ** diguyViewCamera::set_dolly_offset().
502  */
503  void set_dolly_offset(float x, float y, float z);
504 
505  /*l
506  *b Description:
507  **
508  ** The diguyViewCameraSettings equivalent of
509  ** diguyViewCamera::get_dolly_offset_x().
510  */
511  float get_dolly_offset_x();
512 
513  /*l
514  *b Description:
515  **
516  ** The diguyViewCameraSettings equivalent of
517  ** diguyViewCamera::get_dolly_offset_y().
518  */
519  float get_dolly_offset_y();
520 
521  /*l
522  *b Description:
523  **
524  ** The diguyViewCameraSettings equivalent of
525  ** diguyViewCamera::get_dolly_offset_z().
526  */
527  float get_dolly_offset_z();
528 
529  /*l
530  *b Description:
531  **
532  ** The diguyViewCameraSettings equivalent of
533  ** diguyViewCamera::set_dolly_offset_is_in_world_coordinates().
534  */
535  void set_dolly_offset_is_in_world_coordinates(int value);
536 
537  /*l
538  *b Description:
539  **
540  ** The diguyViewCameraSettings equivalent of
541  ** diguyViewCamera::get_dolly_offset_is_in_world_coordinates().
542  */
543  int get_dolly_offset_is_in_world_coordinates();
544 
545 
546 /****************************************************************************/
547 /****************************************************************************/
548 /****************************************************************************/
555 /****************************************************************************/
556 /****************************************************************************/
557 /****************************************************************************/
558 
559  /*l
560  ** The diguyViewCameraSettings equivalent of
561  ** the diguyViewCamera function with the same name.
562  */
563  void set_speed_fov_degrees_per_wheel_click(float fov_change);
564 
565  /*l
566  ** The diguyViewCameraSettings equivalent of
567  ** the diguyViewCamera function with the same name.
568  */
569  float get_speed_fov_degrees_per_wheel_click();
570 
571  /*l
572  ** The diguyViewCameraSettings equivalent of
573  ** the diguyViewCamera function with the same name.
574  */
575  void set_speed_meters_per_second(float speed);
576 
577  /*l
578  ** The diguyViewCameraSettings equivalent of
579  ** the diguyViewCamera function with the same name.
580  */
581  float get_speed_meters_per_second();
582 
583  /*l
584  ** The diguyViewCameraSettings equivalent of
585  ** the diguyViewCamera function with the same name.
586  */
587  void set_require_smooth_servo(diguyViewCameraServoTarget target, int require);
588 
589  /*l
590  ** The diguyViewCameraSettings equivalent of
591  ** the diguyViewCamera function with the same name.
592  */
593  int get_require_smooth_servo(diguyViewCameraServoTarget target);
594 
595  /*l
596  ** The diguyViewCameraSettings equivalent of
597  ** the diguyViewCamera function with the same name.
598  */
599  void set_track_camera_avoids_obstacles(int avoid);
600 
601  /*l
602  ** The diguyViewCameraSettings equivalent of
603  ** the diguyViewCamera function with the same name.
604  */
605  int get_track_camera_avoids_obstacles();
606 
607  /*l
608  ** The diguyViewCameraSettings equivalent of
609  ** the diguyViewCamera function with the same name.
610  */
611  void set_ignore_mouse_drags(int ignore);
612 
613  /*l
614  ** The diguyViewCameraSettings equivalent of
615  ** the diguyViewCamera function with the same name.
616  */
617  int get_ignore_mouse_drags();
618 
619 
624 #ifdef CPLUSPLUS_ONLY
625 
626  bdiCamera* get_scripted_object() {return m_camera;}
627 
628 private:
629 
630  /*l
631  ** A private constructor.
632  */
633  diguyViewCameraSettings(bdiCamera* camera);
634 
635  /*l
636  ** A pointer to internal data.
637  */
638  bdiCamera* m_camera;
639 
640  friend class bdiCamera;
641 
642 #endif
643 
644 };
645 
646 #endif /* __diguyViewCameraSettings_H */
647 
The diguyViewCameraSettings class holds camera settings data that can be loaded into a diguyViewCamer...
Definition: diguyViewCameraSettings.h:43
diguyViewCameraProjectionMode
DI-Guy camera projection modes.
Definition: diguy_constants.h:296
diguyViewCameraMoveMode
DI-Guy camera move modes.
Definition: diguy_constants.h:266
diguyViewCameraServoTarget
Aspects of the DI-Guy camera that can be servoed.
Definition: diguy_constants.h:283