OPL.3 6.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172
  1. .TH "OPL" 3 "Tue Aug 9 2022" "openPilotLog" \" -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. OPL \- A namespace to collect constants and enums used throughout the application\&.
  6. .SH SYNOPSIS
  7. .br
  8. .PP
  9. .SS "Namespaces"
  10. .in +1c
  11. .ti -1c
  12. .RI " \fBCalc\fP"
  13. .br
  14. .RI "The ACalc namespace provides various functions for calculations that are performed outside of the database\&. This includes tasks like converting different units and formats, or functions calculating block time or night time\&. "
  15. .ti -1c
  16. .RI " \fBDb\fP"
  17. .br
  18. .ti -1c
  19. .RI " \fBLog\fP"
  20. .br
  21. .RI "The \fBOPL::Log\fP namespace encapsulates constants and functions used to provide logging to files and logging to console (stdout) "
  22. .in -1c
  23. .SS "Classes"
  24. .in +1c
  25. .ti -1c
  26. .RI "class \fBPaths\fP"
  27. .br
  28. .ti -1c
  29. .RI "struct \fBStyleSheet\fP"
  30. .br
  31. .RI "The \fBStyleSheet\fP struct holds the Display Name and File Name (in the resource system) for the available stylesheets\&. "
  32. .ti -1c
  33. .RI "class \fBStyle\fP"
  34. .br
  35. .RI "The AStyle class encapsulates style and stylesheet logic\&. "
  36. .ti -1c
  37. .RI "class \fBDatabase\fP"
  38. .br
  39. .RI "The DB class encapsulates the SQL database by providing fast access to hot database data\&. "
  40. .ti -1c
  41. .RI "class \fBDbCompletionData\fP"
  42. .br
  43. .RI "Provides data for QCompleters and QHashs\&. "
  44. .ti -1c
  45. .RI "class \fBDbSummary\fP"
  46. .br
  47. .RI "The \fBDbSummary\fP class collects summaries of entries and relevant data from the database\&. "
  48. .ti -1c
  49. .RI "class \fBRow\fP"
  50. .br
  51. .RI "The \fBRow\fP class provides an interface for retreiving and submitting entries from the database\&. "
  52. .ti -1c
  53. .RI "class \fBAircraftEntry\fP"
  54. .br
  55. .RI "A \fBRow\fP representing an Aircraft entry\&. See \fBRow\fP class for details\&. "
  56. .ti -1c
  57. .RI "class \fBTailEntry\fP"
  58. .br
  59. .RI "A \fBRow\fP representing a Tail (Registration) entry\&. See \fBRow\fP class for details\&. "
  60. .ti -1c
  61. .RI "class \fBPilotEntry\fP"
  62. .br
  63. .RI "A \fBRow\fP representing a Pilot entry\&. See \fBRow\fP class for details\&. "
  64. .ti -1c
  65. .RI "class \fBSimulatorEntry\fP"
  66. .br
  67. .RI "A \fBRow\fP representing a Simulator entry\&. See \fBRow\fP class for details\&. "
  68. .ti -1c
  69. .RI "class \fBFlightEntry\fP"
  70. .br
  71. .RI "A \fBRow\fP representing a Flight entry\&. See \fBRow\fP class for details\&. "
  72. .ti -1c
  73. .RI "class \fBCurrencyEntry\fP"
  74. .br
  75. .RI "A \fBRow\fP representing a Currency entry\&. See \fBRow\fP class for details\&. "
  76. .ti -1c
  77. .RI "class \fBAirportEntry\fP"
  78. .br
  79. .RI "A \fBRow\fP representing an Airport entry\&. See \fBRow\fP class for details\&. "
  80. .ti -1c
  81. .RI "class \fBDateTime\fP"
  82. .br
  83. .ti -1c
  84. .RI "class \fBANotificationHandler\fP"
  85. .br
  86. .RI "The \fBANotificationHandler\fP class handles displaying of user-directed messages\&. It displays information to the user in a QMessageBox and forwards the displayed message to ALog so it is written to the console and log files\&. The INFO, WARN and CRIT makros provide convenient access\&. "
  87. .ti -1c
  88. .RI "class \fBOplGlobals\fP"
  89. .br
  90. .RI "The \fBOplGlobals\fP class encapsulates non-POD globals to avoid making them static\&. It is available as a global static object via the OPL::GLOBAL makro and may be used as if it were a pointer, guaranteed to be initialized exactly once\&. For more information, see (Q_GLOBAL_STATIC)[https://doc.qt.io/qt-5/qglobalstatic.html#details]\&. "
  91. .in -1c
  92. .SS "Typedefs"
  93. .in +1c
  94. .ti -1c
  95. .RI "using \fBRowData_T\fP = QHash< QString, QVariant >"
  96. .br
  97. .in -1c
  98. .SS "Enumerations"
  99. .in +1c
  100. .ti -1c
  101. .RI "enum class \fBCompleterTarget\fP { \fBAirportIdentifierICAO\fP, \fBAirportIdentifierIATA\fP, \fBAirportIdentifier\fP, \fBAirportNames\fP, \fBRegistrations\fP, \fBCompanies\fP, \fBPilotNames\fP, \fBAircraftTypes\fP }"
  102. .br
  103. .RI "The DatabaseTarget enum lists database items that are used by completers, for content matching or need to be accessed programatically\&. "
  104. .ti -1c
  105. .RI "enum class \fBDbSummaryKey\fP { \fBtotal_flights\fP, \fBtotal_tails\fP, \fBtotal_pilots\fP, \fBlast_flight\fP, \fBtotal_time\fP }"
  106. .br
  107. .RI "Enumerates the QHash keys used when summarising a database\&. "
  108. .ti -1c
  109. .RI "enum class \fBDateFormat\fP { \fBISODate\fP, \fBDE\fP, \fBEN\fP }"
  110. .br
  111. .RI "ADateFormats enumerates the accepted date formats for QDateEdits\&. "
  112. .ti -1c
  113. .RI "enum class \fBFlightTimeFormat\fP { \fBDefault\fP, \fBDecimal\fP }"
  114. .br
  115. .ti -1c
  116. .RI "enum class \fBDateTimeFormat\fP { \fBDefault\fP, \fBBackup\fP }"
  117. .br
  118. .ti -1c
  119. .RI "enum class \fBPilotFunction\fP { \fBPIC\fP = 0, \fBPICUS\fP = 1, \fBSIC\fP = 2, \fBDUAL\fP = 3, \fBFI\fP = 4 }"
  120. .br
  121. .RI "PilotFunction Pilot in Command, Pilot in Command under Supervision, Second in Command (Co-Pilot), Dual, Flight Instructor\&. "
  122. .ti -1c
  123. .RI "enum class \fBTranslation\fP { \fBEnglish\fP, \fBGerman\fP, \fBSpanish\fP }"
  124. .br
  125. .RI "Enumerates the available translations\&. "
  126. .ti -1c
  127. .RI "enum class \fBDbViewName\fP { \fBDefault\fP, \fBDefaultWithSim\fP, \fBEasa\fP, \fBEasaWithSim\fP, \fBSimulatorOnly\fP }"
  128. .br
  129. .RI "Enumerates the available SQL views in the database\&. "
  130. .ti -1c
  131. .RI "enum class \fBSimulatorType\fP { \fBFNPTI\fP = 0, \fBFNPTII\fP = 1, \fBFSTD\fP = 2 }"
  132. .br
  133. .RI "Enumerates the Simulator Types: Flight and Navigation Procedures Trainer 1/2, Flight Simulation Training Device\&. "
  134. .ti -1c
  135. .RI "enum class \fBDbTable\fP { \fBAny\fP, \fBFlights\fP, \fBSimulators\fP, \fBPilots\fP, \fBTails\fP, \fBAircraft\fP, \fBAirports\fP, \fBCurrencies\fP, \fBChangelog\fP }"
  136. .br
  137. .RI "Enumerates the tables in the database\&. "
  138. .ti -1c
  139. .RI "enum class \fBCurrencyName\fP { \fBLicence\fP = 1, \fBTypeRating\fP = 2, \fBLineCheck\fP = 3, \fBMedical\fP = 4, \fBCustom1\fP = 5, \fBCustom2\fP = 6 }"
  140. .br
  141. .RI "Enumerates the currency names\&. "
  142. .in -1c
  143. .SH "Detailed Description"
  144. .PP
  145. A namespace to collect constants and enums used throughout the application\&.
  146. The opl namespace collects enums and constants that are used throughout the application and provide uniform access\&.
  147. .PP
  148. The date, time and datetime namespaces include enums used to differentiate date and time formats for QDate, QTime and QDateTime that deviate from standard values included in the Qt Framework like Qt::ISODate and are to be used in conjunction with the \&.toString() members of these classes\&.
  149. .PP
  150. The db namespace contains constants for programatically accessing the database in a fast and uniform manner\&.
  151. .SH "Enumeration Type Documentation"
  152. .PP
  153. .SS "enum \fBOPL::DateFormat\fP\fC [strong]\fP"
  154. .PP
  155. ADateFormats enumerates the accepted date formats for QDateEdits\&.
  156. .PP
  157. \fBTodo\fP
  158. .RS 4
  159. At the moment, only ISODate is accepet as a valid date format\&.
  160. .RE
  161. .PP
  162. .SH "Author"
  163. .PP
  164. Generated automatically by Doxygen for openPilotLog from the source code\&.