QwtPolarSpectrogram.3 7.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321
  1. .TH "QwtPolarSpectrogram" 3 "Fri Sep 19 2014" "Version 1.1.1" "Qwt Polar User's Guide" \" -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. QwtPolarSpectrogram \-
  6. .PP
  7. An item, which displays a spectrogram\&.
  8. .SH SYNOPSIS
  9. .br
  10. .PP
  11. .PP
  12. \fC#include <qwt_polar_spectrogram\&.h>\fP
  13. .PP
  14. Inherits \fBQwtPolarItem\fP\&.
  15. .SS "Public Types"
  16. .in +1c
  17. .ti -1c
  18. .RI "enum \fBPaintAttribute\fP { \fBApproximatedAtan\fP = 0x01 }"
  19. .br
  20. .ti -1c
  21. .RI "typedef QFlags< \fBPaintAttribute\fP > \fBPaintAttributes\fP"
  22. .br
  23. .RI "\fIPaint attributes\&. \fP"
  24. .in -1c
  25. .SS "Public Member Functions"
  26. .in +1c
  27. .ti -1c
  28. .RI "\fBQwtPolarSpectrogram\fP ()"
  29. .br
  30. .RI "\fIConstructor\&. \fP"
  31. .ti -1c
  32. .RI "virtual \fB~QwtPolarSpectrogram\fP ()"
  33. .br
  34. .RI "\fIDestructor\&. \fP"
  35. .ti -1c
  36. .RI "void \fBsetData\fP (QwtRasterData *\fBdata\fP)"
  37. .br
  38. .ti -1c
  39. .RI "const QwtRasterData * \fBdata\fP () const "
  40. .br
  41. .ti -1c
  42. .RI "void \fBsetColorMap\fP (QwtColorMap *)"
  43. .br
  44. .ti -1c
  45. .RI "const QwtColorMap * \fBcolorMap\fP () const "
  46. .br
  47. .ti -1c
  48. .RI "void \fBsetPaintAttribute\fP (\fBPaintAttribute\fP, bool on=true)"
  49. .br
  50. .ti -1c
  51. .RI "bool \fBtestPaintAttribute\fP (\fBPaintAttribute\fP) const "
  52. .br
  53. .ti -1c
  54. .RI "virtual int \fBrtti\fP () const "
  55. .br
  56. .ti -1c
  57. .RI "virtual void \fBdraw\fP (QPainter *painter, const QwtScaleMap &azimuthMap, const QwtScaleMap &radialMap, const QPointF &pole, double radius, const QRectF &canvasRect) const "
  58. .br
  59. .ti -1c
  60. .RI "virtual QwtInterval \fBboundingInterval\fP (int scaleId) const "
  61. .br
  62. .in -1c
  63. .SS "Protected Member Functions"
  64. .in +1c
  65. .ti -1c
  66. .RI "virtual QImage \fBrenderImage\fP (const QwtScaleMap &azimuthMap, const QwtScaleMap &radialMap, const QPointF &pole, const QRect &rect) const "
  67. .br
  68. .RI "\fIRender an image from the data and color map\&. \fP"
  69. .ti -1c
  70. .RI "virtual void \fBrenderTile\fP (const QwtScaleMap &azimuthMap, const QwtScaleMap &radialMap, const QPointF &pole, const QPoint &imagePos, const QRect &tile, QImage *image) const "
  71. .br
  72. .RI "\fIRender a sub-rectangle of an image\&. \fP"
  73. .in -1c
  74. .SH "Detailed Description"
  75. .PP
  76. An item, which displays a spectrogram\&.
  77. A spectrogram displays threedimenional data, where the 3rd dimension ( the intensity ) is displayed using colors\&. The colors are calculated from the values using a color map\&.
  78. .PP
  79. \fBSee Also:\fP
  80. .RS 4
  81. QwtRasterData, QwtColorMap
  82. .RE
  83. .PP
  84. .SH "Member Enumeration Documentation"
  85. .PP
  86. .SS "enum \fBQwtPolarSpectrogram::PaintAttribute\fP"
  87. Attributes to modify the drawing algorithm\&. The default setting disables ApproximatedAtan
  88. .PP
  89. \fBSee Also:\fP
  90. .RS 4
  91. \fBsetPaintAttribute()\fP, \fBtestPaintAttribute()\fP
  92. .RE
  93. .PP
  94. .PP
  95. \fBEnumerator\fP
  96. .in +1c
  97. .TP
  98. \fB\fIApproximatedAtan \fP\fP
  99. Use qwtFastAtan2 instead of atan2 for translating widget into polar coordinates\&.
  100. .SH "Member Function Documentation"
  101. .PP
  102. .SS "QwtInterval QwtPolarSpectrogram::boundingInterval (intscaleId) const\fC [virtual]\fP"
  103. Interval, that is necessary to display the item This interval can be useful for operations like clipping or autoscaling
  104. .PP
  105. \fBParameters:\fP
  106. .RS 4
  107. \fIscaleId\fP Scale index
  108. .RE
  109. .PP
  110. \fBReturns:\fP
  111. .RS 4
  112. bounding interval ( == position )
  113. .RE
  114. .PP
  115. \fBSee Also:\fP
  116. .RS 4
  117. position()
  118. .RE
  119. .PP
  120. .PP
  121. Reimplemented from \fBQwtPolarItem\fP\&.
  122. .SS "const QwtColorMap * QwtPolarSpectrogram::colorMap () const"
  123. .PP
  124. \fBReturns:\fP
  125. .RS 4
  126. Color Map used for mapping the intensity values to colors
  127. .RE
  128. .PP
  129. \fBSee Also:\fP
  130. .RS 4
  131. \fBsetColorMap()\fP
  132. .RE
  133. .PP
  134. .SS "const QwtRasterData * QwtPolarSpectrogram::data () const"
  135. .PP
  136. \fBReturns:\fP
  137. .RS 4
  138. Spectrogram data
  139. .RE
  140. .PP
  141. \fBSee Also:\fP
  142. .RS 4
  143. \fBsetData()\fP
  144. .RE
  145. .PP
  146. .SS "void QwtPolarSpectrogram::draw (QPainter *painter, const QwtScaleMap &azimuthMap, const QwtScaleMap &radialMap, const QPointF &pole, doubleradius, const QRectF &canvasRect) const\fC [virtual]\fP"
  147. Draw the spectrogram
  148. .PP
  149. \fBParameters:\fP
  150. .RS 4
  151. \fIpainter\fP Painter
  152. .br
  153. \fIazimuthMap\fP Maps azimuth values to values related to 0\&.0, M_2PI
  154. .br
  155. \fIradialMap\fP Maps radius values into painter coordinates\&.
  156. .br
  157. \fIpole\fP Position of the pole in painter coordinates
  158. .br
  159. \fIradius\fP Radius of the complete plot area in painter coordinates
  160. .br
  161. \fIcanvasRect\fP Contents rect of the canvas in painter coordinates
  162. .RE
  163. .PP
  164. .PP
  165. Implements \fBQwtPolarItem\fP\&.
  166. .SS "QImage QwtPolarSpectrogram::renderImage (const QwtScaleMap &azimuthMap, const QwtScaleMap &radialMap, const QPointF &pole, const QRect &rect) const\fC [protected]\fP, \fC [virtual]\fP"
  167. .PP
  168. Render an image from the data and color map\&. The area is translated into a rect of the paint device\&. For each pixel of this rect the intensity is mapped into a color\&.
  169. .PP
  170. \fBParameters:\fP
  171. .RS 4
  172. \fIazimuthMap\fP Maps azimuth values to values related to 0\&.0, M_2PI
  173. .br
  174. \fIradialMap\fP Maps radius values into painter coordinates\&.
  175. .br
  176. \fIpole\fP Position of the pole in painter coordinates
  177. .br
  178. \fIrect\fP Target rectangle of the image in painter coordinates
  179. .RE
  180. .PP
  181. \fBReturns:\fP
  182. .RS 4
  183. A QImage::Format_Indexed8 or QImage::Format_ARGB32 depending on the color map\&.
  184. .RE
  185. .PP
  186. \fBSee Also:\fP
  187. .RS 4
  188. QwtRasterData::intensity(), QwtColorMap::rgb(), QwtColorMap::colorIndex()
  189. .RE
  190. .PP
  191. .SS "void QwtPolarSpectrogram::renderTile (const QwtScaleMap &azimuthMap, const QwtScaleMap &radialMap, const QPointF &pole, const QPoint &imagePos, const QRect &tile, QImage *image) const\fC [protected]\fP, \fC [virtual]\fP"
  192. .PP
  193. Render a sub-rectangle of an image\&. \fBrenderTile()\fP is called by \fBrenderImage()\fP to render different parts of the image by concurrent threads\&.
  194. .PP
  195. \fBParameters:\fP
  196. .RS 4
  197. \fIazimuthMap\fP Maps azimuth values to values related to 0\&.0, M_2PI
  198. .br
  199. \fIradialMap\fP Maps radius values into painter coordinates\&.
  200. .br
  201. \fIpole\fP Position of the pole in painter coordinates
  202. .br
  203. \fIimagePos\fP Top/left position of the image in painter coordinates
  204. .br
  205. \fItile\fP Sub-rectangle of the tile in painter coordinates
  206. .br
  207. \fIimage\fP Image to be rendered
  208. .RE
  209. .PP
  210. \fBSee Also:\fP
  211. .RS 4
  212. \fBsetRenderThreadCount()\fP
  213. .RE
  214. .PP
  215. \fBNote:\fP
  216. .RS 4
  217. renderTile needs to be reentrant
  218. .RE
  219. .PP
  220. .SS "int QwtPolarSpectrogram::rtti () const\fC [virtual]\fP"
  221. .PP
  222. \fBReturns:\fP
  223. .RS 4
  224. \fBQwtPolarItem::Rtti_PolarSpectrogram\fP
  225. .RE
  226. .PP
  227. .PP
  228. Reimplemented from \fBQwtPolarItem\fP\&.
  229. .SS "void QwtPolarSpectrogram::setColorMap (QwtColorMap *colorMap)"
  230. Change the color map
  231. .PP
  232. Often it is useful to display the mapping between intensities and colors as an additional plot axis, showing a color bar\&.
  233. .PP
  234. \fBParameters:\fP
  235. .RS 4
  236. \fIcolorMap\fP Color Map
  237. .RE
  238. .PP
  239. \fBSee Also:\fP
  240. .RS 4
  241. \fBcolorMap()\fP, QwtScaleWidget::setColorBarEnabled(), QwtScaleWidget::setColorMap()
  242. .RE
  243. .PP
  244. .SS "void QwtPolarSpectrogram::setData (QwtRasterData *data)"
  245. Set the data to be displayed
  246. .PP
  247. \fBParameters:\fP
  248. .RS 4
  249. \fIdata\fP Spectrogram Data
  250. .RE
  251. .PP
  252. \fBSee Also:\fP
  253. .RS 4
  254. \fBdata()\fP
  255. .RE
  256. .PP
  257. \fBWarning:\fP
  258. .RS 4
  259. QwtRasterData::initRaster() is called each time before the image is rendered, but without any useful parameters\&. Also QwtRasterData::rasterHint() is not used\&.
  260. .RE
  261. .PP
  262. .SS "void QwtPolarSpectrogram::setPaintAttribute (\fBPaintAttribute\fPattribute, boolon = \fCtrue\fP)"
  263. Specify an attribute how to draw the curve
  264. .PP
  265. \fBParameters:\fP
  266. .RS 4
  267. \fIattribute\fP Paint attribute
  268. .br
  269. \fIon\fP On/Off
  270. .RE
  271. .PP
  272. \fBSee Also:\fP
  273. .RS 4
  274. \fBtestPaintAttribute()\fP
  275. .RE
  276. .PP
  277. .SS "bool QwtPolarSpectrogram::testPaintAttribute (\fBPaintAttribute\fPattribute) const"
  278. .PP
  279. \fBParameters:\fP
  280. .RS 4
  281. \fIattribute\fP Paint attribute
  282. .RE
  283. .PP
  284. \fBReturns:\fP
  285. .RS 4
  286. True, when attribute has been set
  287. .RE
  288. .PP
  289. \fBSee Also:\fP
  290. .RS 4
  291. \fBsetPaintAttribute()\fP
  292. .RE
  293. .PP
  294. .SH "Author"
  295. .PP
  296. Generated automatically by Doxygen for Qwt Polar User's Guide from the source code\&.