Cleanup: use doxy comments
This commit is contained in:
parent
c7b9ae310b
commit
933725ab46
|
@ -64,7 +64,7 @@ typedef struct uiFont {
|
|||
char _pad0[2];
|
||||
} uiFont;
|
||||
|
||||
/* this state defines appearance of text */
|
||||
/** This state defines appearance of text. */
|
||||
typedef struct uiFontStyle {
|
||||
/** Saved in file, 0 is default. */
|
||||
short uifont_id;
|
||||
|
@ -430,15 +430,22 @@ typedef enum eWireColor_Flags {
|
|||
TH_WIRECOLOR_TEXTCOLS = (1 << 1),
|
||||
} eWireColor_Flags;
|
||||
|
||||
/* A theme */
|
||||
/**
|
||||
* A theme.
|
||||
*
|
||||
* \note Currently only a single theme is ever used at once.
|
||||
* Different theme presets are stored as external files now.
|
||||
*/
|
||||
typedef struct bTheme {
|
||||
struct bTheme *next, *prev;
|
||||
char name[32];
|
||||
|
||||
ThemeUI tui;
|
||||
|
||||
/* Individual Spacetypes */
|
||||
/* note: ensure UI_THEMESPACE_END is updated when adding */
|
||||
/**
|
||||
* Individual Spacetypes:
|
||||
* \note Ensure #UI_THEMESPACE_END is updated when adding.
|
||||
*/
|
||||
ThemeSpace space_properties;
|
||||
ThemeSpace space_view3d;
|
||||
ThemeSpace space_file;
|
||||
|
@ -494,7 +501,7 @@ typedef struct bUserMenu {
|
|||
ListBase items;
|
||||
} bUserMenu;
|
||||
|
||||
/* May be part of bUserMenu or other list. */
|
||||
/** May be part of #bUserMenu or other list. */
|
||||
typedef struct bUserMenuItem {
|
||||
struct bUserMenuItem *next, *prev;
|
||||
char ui_name[64];
|
||||
|
@ -556,7 +563,7 @@ typedef struct UserDef_Runtime {
|
|||
} UserDef_Runtime;
|
||||
|
||||
typedef struct UserDef {
|
||||
/* UserDef has separate do-version handling, and can be read from other files */
|
||||
/** UserDef has separate do-version handling, and can be read from other files. */
|
||||
int versionfile, subversionfile;
|
||||
|
||||
/** #eUserPref_Flag. */
|
||||
|
@ -640,7 +647,7 @@ typedef struct UserDef {
|
|||
short transopts;
|
||||
short menuthreshold1, menuthreshold2;
|
||||
|
||||
/* startup template */
|
||||
/** Startup application template. */
|
||||
char app_template[64];
|
||||
|
||||
struct ListBase themes;
|
||||
|
@ -835,7 +842,7 @@ typedef enum eUserPref_Section {
|
|||
USER_SECTION_FILE_PATHS = 15,
|
||||
} eUserPref_Section;
|
||||
|
||||
/* UserDef.userpref_flag (State of the user preferences UI). */
|
||||
/** UserDef.userpref_flag (State of the user preferences UI). */
|
||||
typedef enum eUserPref_SectionFlag {
|
||||
/* Hide/expand keymap preferences. */
|
||||
USER_SECTION_INPUT_HIDE_UI_KEYCONFIG = (1 << 0),
|
||||
|
@ -1091,26 +1098,23 @@ typedef enum eColorPicker_Types {
|
|||
/** Timecode display styles
|
||||
* #UserDef.timecode_style */
|
||||
typedef enum eTimecodeStyles {
|
||||
/* as little info as is necessary to show relevant info
|
||||
* with '+' to denote the frames
|
||||
* i.e. HH:MM:SS+FF, MM:SS+FF, SS+FF, or MM:SS
|
||||
/**
|
||||
* As little info as is necessary to show relevant info with '+' to denote the frames
|
||||
* i.e. HH:MM:SS+FF, MM:SS+FF, SS+FF, or MM:SS.
|
||||
*/
|
||||
USER_TIMECODE_MINIMAL = 0,
|
||||
|
||||
/* reduced SMPTE - (HH:)MM:SS:FF */
|
||||
/** Reduced SMPTE - (HH:)MM:SS:FF */
|
||||
USER_TIMECODE_SMPTE_MSF = 1,
|
||||
|
||||
/* full SMPTE - HH:MM:SS:FF */
|
||||
/** Full SMPTE - HH:MM:SS:FF */
|
||||
USER_TIMECODE_SMPTE_FULL = 2,
|
||||
|
||||
/* milliseconds for sub-frames - HH:MM:SS.sss */
|
||||
/** Milliseconds for sub-frames - HH:MM:SS.sss. */
|
||||
USER_TIMECODE_MILLISECONDS = 3,
|
||||
|
||||
/* seconds only */
|
||||
/** Seconds only. */
|
||||
USER_TIMECODE_SECONDS_ONLY = 4,
|
||||
|
||||
/* Private (not exposed as generic choices) options. */
|
||||
/* milliseconds for sub-frames , SubRip format- HH:MM:SS,sss */
|
||||
/**
|
||||
* Private (not exposed as generic choices) options.
|
||||
* milliseconds for sub-frames , SubRip format- HH:MM:SS,sss.
|
||||
*/
|
||||
USER_TIMECODE_SUBRIP = 100,
|
||||
} eTimecodeStyles;
|
||||
|
||||
|
@ -1120,15 +1124,14 @@ typedef enum eNdof_Flag {
|
|||
NDOF_FLY_HELICOPTER = (1 << 1),
|
||||
NDOF_LOCK_HORIZON = (1 << 2),
|
||||
|
||||
/* the following might not need to be saved between sessions,
|
||||
* but they do need to live somewhere accessible... */
|
||||
/* The following might not need to be saved between sessions,
|
||||
* but they do need to live somewhere accessible. */
|
||||
NDOF_SHOULD_PAN = (1 << 3),
|
||||
NDOF_SHOULD_ZOOM = (1 << 4),
|
||||
NDOF_SHOULD_ROTATE = (1 << 5),
|
||||
|
||||
/* orbit navigation modes */
|
||||
/* Orbit navigation modes. */
|
||||
|
||||
/* exposed as Orbit|Explore in the UI */
|
||||
NDOF_MODE_ORBIT = (1 << 6),
|
||||
|
||||
/* actually... users probably don't care about what the mode
|
||||
|
|
Loading…
Reference in New Issue