File: star.h

package info (click to toggle)
spacechart 0.9.2-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 1,704 kB
  • ctags: 917
  • sloc: ansic: 7,718; sh: 330; makefile: 205; sed: 93
file content (122 lines) | stat: -rw-r--r-- 4,756 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
/***********************************************************************
 * star.h : Definition of operations on star_t
 ***********************************************************************/

/***********************************************************************
 *  This file is part of SpaceChart.
 *  Copyright (C) 1999 Miguel Coca <e970095@zipi.fi.upm.es>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 ***********************************************************************/

#ifndef _INCLUDE_STAR_H_
#define _INCLUDE_STAR_H_

#include <stdio.h>
#include "starmap.h"

/* Spectral classes for the stars. */
typedef enum
{
        SPECTRUM_O,
        SPECTRUM_B,
        SPECTRUM_A,
        SPECTRUM_F,
        SPECTRUM_G,
        SPECTRUM_K,
        SPECTRUM_M,
        SPECTRUM_WHITE_DWARF
} spectrum_t;

/* First the functions to access the star system. */

typedef struct st_star star_t;

/* Create a new star with default values. */
star_t* star_new( void );

/* Read a star from a file. */
int star_read( star_t* star, FILE* file );

/* Access to the unique internal id of the star. */
inline void star_set_id( star_t* star, star_id_t id );
inline star_id_t star_get_id( star_t* star );

/* Access to the Gliese catalog name of the star. */
inline void star_set_catalog_name( star_t* star, char* name );
inline void star_get_catalog_name( star_t* star, char* name );

/* Access to the short name of the star. */
inline void star_set_short_name( star_t* star, char* name );
inline void star_get_short_name( star_t* star, char* name );

/* Access to the heliocentric cartesian coordinates of the star. */
inline void star_set_coords( star_t* star, coords_3d_t* coords );
inline void star_get_coords( star_t* star, coords_3d_t* coords );

/* Returns the number of components of the star system. */
inline int star_components( star_t* star );

/* Destroy the star structure and free allocated memory. */
inline void star_destroy( star_t* star );

/**************************************************** 
 * Now the functions to access specific components. 
 ****************************************************/

typedef struct st_star_component star_component_t;

/* Create a new component. */
star_component_t *star_component_new( void );

/* Add a component to the star system. */
void star_add_component( star_t* star, star_component_t* comp );

/* Loop over the components of the star system. */
void star_foreach_component( star_t* star, 
                             void (*function)( star_component_t *component,
                                               void *data ),
                             void *data );

/* Returns the character that identifies the component. */
void star_component_set_component( star_component_t *comp, char name );
char star_component_get_component( star_component_t *comp );

/* Access to the proper name of the star. */
void star_component_set_proper_name( star_component_t* comp, char* name );
void star_component_get_proper_name( star_component_t* comp, char* name );

/* Access to the Bayer-Flamsteed name of the star. */
void star_component_set_bayer_name( star_component_t* comp, char* name );
void star_component_get_bayer_name( star_component_t* comp, char* name );

/* Access to the DM catalog number of the star. */
void star_component_set_dm_name( star_component_t* comp, char* name );
void star_component_get_dm_name( star_component_t* comp, char* name );

/* Access to the string that marks the spectral class of the star. */
void star_component_set_spectrum( star_component_t* comp, char* spectrum );
void star_component_get_spectrum( star_component_t* comp, char* spectrum );
/* Returns the spectral class of the star inferred from the class string. */
spectrum_t star_component_get_spectrum_type( star_component_t* comp );

/* Access to the luminosity of the star. */
void star_component_set_luminosity( star_component_t* comp, float lum );
float star_component_get_luminosity( star_component_t* comp );

/* Destroy the component structure. */
void star_component_destroy( star_component_t* comp );

#endif