QwtMatrixRasterData.3 6.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280
  1. .TH "QwtMatrixRasterData" 3 "Mon Dec 28 2020" "Version 6.1.6" "Qwt User's Guide" \" -*- nroff -*-
  2. .ad l
  3. .nh
  4. .SH NAME
  5. QwtMatrixRasterData \- A class representing a matrix of values as raster data\&.
  6. .SH SYNOPSIS
  7. .br
  8. .PP
  9. .PP
  10. \fC#include <qwt_matrix_raster_data\&.h>\fP
  11. .PP
  12. Inherits \fBQwtRasterData\fP\&.
  13. .SS "Public Types"
  14. .in +1c
  15. .ti -1c
  16. .RI "enum \fBResampleMode\fP { \fBNearestNeighbour\fP, \fBBilinearInterpolation\fP }"
  17. .br
  18. .RI "Resampling algorithm The default setting is NearestNeighbour;\&. "
  19. .in -1c
  20. .SS "Public Member Functions"
  21. .in +1c
  22. .ti -1c
  23. .RI "\fBQwtMatrixRasterData\fP ()"
  24. .br
  25. .RI "Constructor\&. "
  26. .ti -1c
  27. .RI "virtual \fB~QwtMatrixRasterData\fP ()"
  28. .br
  29. .RI "Destructor\&. "
  30. .ti -1c
  31. .RI "void \fBsetResampleMode\fP (\fBResampleMode\fP mode)"
  32. .br
  33. .RI "Set the resampling algorithm\&. "
  34. .ti -1c
  35. .RI "\fBResampleMode\fP \fBresampleMode\fP () const"
  36. .br
  37. .ti -1c
  38. .RI "virtual void \fBsetInterval\fP (Qt::Axis, const \fBQwtInterval\fP &)"
  39. .br
  40. .RI "Assign the bounding interval for an axis\&. "
  41. .ti -1c
  42. .RI "void \fBsetValueMatrix\fP (const QVector< double > &values, int \fBnumColumns\fP)"
  43. .br
  44. .RI "Assign a value matrix\&. "
  45. .ti -1c
  46. .RI "const QVector< double > \fBvalueMatrix\fP () const"
  47. .br
  48. .ti -1c
  49. .RI "void \fBsetValue\fP (int row, int col, double \fBvalue\fP)"
  50. .br
  51. .RI "Change a single value in the matrix\&. "
  52. .ti -1c
  53. .RI "int \fBnumColumns\fP () const"
  54. .br
  55. .ti -1c
  56. .RI "int \fBnumRows\fP () const"
  57. .br
  58. .ti -1c
  59. .RI "virtual QRectF \fBpixelHint\fP (const QRectF &) const"
  60. .br
  61. .RI "Calculate the pixel hint\&. "
  62. .ti -1c
  63. .RI "virtual double \fBvalue\fP (double x, double y) const"
  64. .br
  65. .in -1c
  66. .SH "Detailed Description"
  67. .PP
  68. A class representing a matrix of values as raster data\&.
  69. \fBQwtMatrixRasterData\fP implements an interface for a matrix of equidistant values, that can be used by a \fBQwtPlotRasterItem\fP\&. It implements a couple of resampling algorithms, to provide values for positions, that or not on the value matrix\&.
  70. .SH "Member Enumeration Documentation"
  71. .PP
  72. .SS "enum \fBQwtMatrixRasterData::ResampleMode\fP"
  73. .PP
  74. Resampling algorithm The default setting is NearestNeighbour;\&.
  75. .PP
  76. \fBEnumerator\fP
  77. .in +1c
  78. .TP
  79. \fB\fINearestNeighbour \fP\fP
  80. Return the value from the matrix, that is nearest to the the requested position\&.
  81. .TP
  82. \fB\fIBilinearInterpolation \fP\fP
  83. Interpolate the value from the distances and values of the 4 surrounding values in the matrix,
  84. .SH "Member Function Documentation"
  85. .PP
  86. .SS "int QwtMatrixRasterData::numColumns () const"
  87. .PP
  88. \fBReturns\fP
  89. .RS 4
  90. Number of columns of the value matrix
  91. .RE
  92. .PP
  93. \fBSee also\fP
  94. .RS 4
  95. \fBvalueMatrix()\fP, \fBnumRows()\fP, \fBsetValueMatrix()\fP
  96. .RE
  97. .PP
  98. .SS "int QwtMatrixRasterData::numRows () const"
  99. .PP
  100. \fBReturns\fP
  101. .RS 4
  102. Number of rows of the value matrix
  103. .RE
  104. .PP
  105. \fBSee also\fP
  106. .RS 4
  107. \fBvalueMatrix()\fP, \fBnumColumns()\fP, \fBsetValueMatrix()\fP
  108. .RE
  109. .PP
  110. .SS "QRectF QwtMatrixRasterData::pixelHint (const QRectF & area) const\fC [virtual]\fP"
  111. .PP
  112. Calculate the pixel hint\&. \fBpixelHint()\fP returns the geometry of a pixel, that can be used to calculate the resolution and alignment of the plot item, that is representing the data\&.
  113. .PP
  114. .IP "\(bu" 2
  115. NearestNeighbour
  116. .br
  117. \fBpixelHint()\fP returns the surrounding pixel of the top left value in the matrix\&.
  118. .IP "\(bu" 2
  119. BilinearInterpolation
  120. .br
  121. Returns an empty rectangle recommending to render in target device ( f\&.e\&. screen ) resolution\&.
  122. .PP
  123. .PP
  124. \fBParameters\fP
  125. .RS 4
  126. \fIarea\fP Requested area, ignored
  127. .RE
  128. .PP
  129. \fBReturns\fP
  130. .RS 4
  131. Calculated hint
  132. .RE
  133. .PP
  134. \fBSee also\fP
  135. .RS 4
  136. \fBResampleMode\fP, setMatrix(), \fBsetInterval()\fP
  137. .RE
  138. .PP
  139. .PP
  140. Reimplemented from \fBQwtRasterData\fP\&.
  141. .SS "\fBQwtMatrixRasterData::ResampleMode\fP QwtMatrixRasterData::resampleMode () const"
  142. .PP
  143. \fBReturns\fP
  144. .RS 4
  145. resampling algorithm
  146. .RE
  147. .PP
  148. \fBSee also\fP
  149. .RS 4
  150. \fBsetResampleMode()\fP, \fBvalue()\fP
  151. .RE
  152. .PP
  153. .SS "void QwtMatrixRasterData::setInterval (Qt::Axis axis, const \fBQwtInterval\fP & interval)\fC [virtual]\fP"
  154. .PP
  155. Assign the bounding interval for an axis\&. Setting the bounding intervals for the X/Y axis is mandatory to define the positions for the values of the value matrix\&. The interval in Z direction defines the possible range for the values in the matrix, what is f\&.e used by \fBQwtPlotSpectrogram\fP to map values to colors\&. The Z-interval might be the bounding interval of the values in the matrix, but usually it isn't\&. ( f\&.e a interval of 0\&.0-100\&.0 for values in percentage )
  156. .PP
  157. \fBParameters\fP
  158. .RS 4
  159. \fIaxis\fP X, Y or Z axis
  160. .br
  161. \fIinterval\fP Interval
  162. .RE
  163. .PP
  164. \fBSee also\fP
  165. .RS 4
  166. \fBQwtRasterData::interval()\fP, \fBsetValueMatrix()\fP
  167. .RE
  168. .PP
  169. .PP
  170. Reimplemented from \fBQwtRasterData\fP\&.
  171. .SS "void QwtMatrixRasterData::setResampleMode (\fBResampleMode\fP mode)"
  172. .PP
  173. Set the resampling algorithm\&.
  174. .PP
  175. \fBParameters\fP
  176. .RS 4
  177. \fImode\fP Resampling mode
  178. .RE
  179. .PP
  180. \fBSee also\fP
  181. .RS 4
  182. \fBresampleMode()\fP, \fBvalue()\fP
  183. .RE
  184. .PP
  185. .SS "void QwtMatrixRasterData::setValue (int row, int col, double value)"
  186. .PP
  187. Change a single value in the matrix\&.
  188. .PP
  189. \fBParameters\fP
  190. .RS 4
  191. \fIrow\fP Row index
  192. .br
  193. \fIcol\fP Column index
  194. .br
  195. \fIvalue\fP New value
  196. .RE
  197. .PP
  198. \fBSee also\fP
  199. .RS 4
  200. \fBvalue()\fP, \fBsetValueMatrix()\fP
  201. .RE
  202. .PP
  203. .SS "void QwtMatrixRasterData::setValueMatrix (const QVector< double > & values, int numColumns)"
  204. .PP
  205. Assign a value matrix\&. The positions of the values are calculated by dividing the bounding rectangle of the X/Y intervals into equidistant rectangles ( pixels )\&. Each value corresponds to the center of a pixel\&.
  206. .PP
  207. \fBParameters\fP
  208. .RS 4
  209. \fIvalues\fP Vector of values
  210. .br
  211. \fInumColumns\fP Number of columns
  212. .RE
  213. .PP
  214. \fBSee also\fP
  215. .RS 4
  216. \fBvalueMatrix()\fP, \fBnumColumns()\fP, \fBnumRows()\fP, \fBsetInterval()\fP()
  217. .RE
  218. .PP
  219. .SS "double QwtMatrixRasterData::value (double x, double y) const\fC [virtual]\fP"
  220. .PP
  221. \fBReturns\fP
  222. .RS 4
  223. the value at a raster position
  224. .RE
  225. .PP
  226. \fBParameters\fP
  227. .RS 4
  228. \fIx\fP X value in plot coordinates
  229. .br
  230. \fIy\fP Y value in plot coordinates
  231. .RE
  232. .PP
  233. \fBSee also\fP
  234. .RS 4
  235. \fBResampleMode\fP
  236. .RE
  237. .PP
  238. .PP
  239. Implements \fBQwtRasterData\fP\&.
  240. .SS "const QVector< double > QwtMatrixRasterData::valueMatrix () const"
  241. .PP
  242. \fBReturns\fP
  243. .RS 4
  244. Value matrix
  245. .RE
  246. .PP
  247. \fBSee also\fP
  248. .RS 4
  249. \fBsetValueMatrix()\fP, \fBnumColumns()\fP, \fBnumRows()\fP, \fBsetInterval()\fP
  250. .RE
  251. .PP
  252. .SH "Author"
  253. .PP
  254. Generated automatically by Doxygen for Qwt User's Guide from the source code\&.