Plot layer, abstract base class.
Any number of mpLayer implementations can be attached to mpWindow. Examples for mpLayer implementations are function graphs, or scale rulers.
For convenience mpLayer defines a name, a font (wxFont), a pen (wxPen), and a continuity property (bool) as class members. The default values at constructor are the default font, a black pen, and continuity set to false (draw separate points). These may or may not be used by implementations.
Definition at line 164 of file mathplot.h.
#include <mrpt/otherlibs/mathplot/mathplot.h>
Public Member Functions | |
mpLayer () | |
virtual | ~mpLayer () |
virtual bool | HasBBox () |
Check whether this layer has a bounding box. More... | |
virtual bool | IsInfo () |
Check whether the layer is an info box. More... | |
virtual double | GetMinX () |
Get inclusive left border of bounding box. More... | |
virtual double | GetMaxX () |
Get inclusive right border of bounding box. More... | |
virtual double | GetMinY () |
Get inclusive bottom border of bounding box. More... | |
virtual double | GetMaxY () |
Get inclusive top border of bounding box. More... | |
virtual void | Plot (wxDC &dc, mpWindow &w)=0 |
Plot given view of layer to the given device context. More... | |
wxString | GetName () const |
Get layer name. More... | |
const wxFont & | GetFont () const |
Get font set for this layer. More... | |
const wxPen & | GetPen () const |
Get pen set for this layer. More... | |
void | SetContinuity (bool continuity) |
Set the 'continuity' property of the layer (true:draws a continuous line, false:draws separate points). More... | |
bool | GetContinuity () const |
Gets the 'continuity' property of the layer. More... | |
void | ShowName (bool show) |
Shows or hides the text label with the name of the layer (default is visible). More... | |
void | SetName (wxString name) |
Set layer name. More... | |
void | SetFont (wxFont &font) |
Set layer font. More... | |
void | SetPen (wxPen pen) |
Set layer pen. More... | |
void | SetDrawOutsideMargins (bool drawModeOutside) |
Set Draw mode: inside or outside margins. More... | |
bool | GetDrawOutsideMargins () |
Get Draw mode: inside or outside margins. More... | |
wxBitmap | GetColourSquare (int side=16) |
Get a small square bitmap filled with the colour of the pen used in the layer. More... | |
mpLayerType | GetLayerType () |
Get layer type: a Layer can be of different types: plot lines, axis, info boxes, etc, this method returns the right value. More... | |
bool | IsVisible () |
Checks whether the layer is visible or not. More... | |
void | SetVisible (bool show) |
Sets layer visibility. More... | |
const wxBrush & | GetBrush () const |
Get brush set for this layer. More... | |
void | SetBrush (wxBrush brush) |
Set layer brush. More... | |
Protected Attributes | |
wxFont | m_font |
Layer's font. More... | |
wxPen | m_pen |
Layer's pen. More... | |
wxBrush | m_brush |
Layer's brush. More... | |
wxString | m_name |
Layer's name. More... | |
bool | m_continuous |
Specify if the layer will be plotted as a continuous line or a set of points. More... | |
bool | m_showName |
States whether the name of the layer must be shown (default is true). More... | |
bool | m_drawOutsideMargins |
select if the layer should draw only inside margins or over all DC More... | |
mpLayerType | m_type |
Define layer type, which is assigned by constructor. More... | |
bool | m_visible |
Toggles layer visibility. More... | |
mpLayer::mpLayer | ( | ) |
|
inlinevirtual |
Definition at line 169 of file mathplot.h.
|
inline |
wxBitmap mpLayer::GetColourSquare | ( | int | side = 16 | ) |
Get a small square bitmap filled with the colour of the pen used in the layer.
Useful to create legends or similar reference to the layers.
side | side length in pixels |
|
inline |
Gets the 'continuity' property of the layer.
Definition at line 274 of file mathplot.h.
|
inline |
Get Draw mode: inside or outside margins.
Definition at line 301 of file mathplot.h.
|
inline |
|
inline |
Get layer type: a Layer can be of different types: plot lines, axis, info boxes, etc, this method returns the right value.
Definition at line 310 of file mathplot.h.
|
inlinevirtual |
Get inclusive right border of bounding box.
Reimplemented in mpFXYVector, mpMovableObject, and mpBitmapLayer.
Definition at line 196 of file mathplot.h.
|
inlinevirtual |
Get inclusive top border of bounding box.
Reimplemented in mpFXYVector, mpMovableObject, and mpBitmapLayer.
Definition at line 206 of file mathplot.h.
|
inlinevirtual |
Get inclusive left border of bounding box.
Reimplemented in mpFXYVector, mpMovableObject, and mpBitmapLayer.
Definition at line 191 of file mathplot.h.
|
inlinevirtual |
Get inclusive bottom border of bounding box.
Reimplemented in mpFXYVector, mpMovableObject, and mpBitmapLayer.
Definition at line 201 of file mathplot.h.
|
inline |
|
inline |
|
inlinevirtual |
Check whether this layer has a bounding box.
The default implementation returns TRUE. Override and return FALSE if your mpLayer implementation should be ignored by the calculation of the global bounding box for all layers in a mpWindow.
TRUE | Has bounding box |
FALSE | Has not bounding box |
Reimplemented in mpInfoLayer, mpScaleX, mpScaleY, mpText, mpMovableObject, and mpBitmapLayer.
Definition at line 178 of file mathplot.h.
|
inlinevirtual |
Check whether the layer is an info box.
The default implementation returns FALSE. It is overrided to TRUE for mpInfoLayer class and its derivative. It is necessary to define mouse actions behaviour over info boxes.
Reimplemented in mpInfoLayer.
Definition at line 186 of file mathplot.h.
|
inline |
Checks whether the layer is visible or not.
Definition at line 314 of file mathplot.h.
|
pure virtual |
Plot given view of layer to the given device context.
An implementation of this function has to transform layer coordinates to wxDC coordinates based on the view parameters retrievable from the mpWindow passed in w. Note that the public methods of mpWindow: x2p,y2p and p2x,p2y are already provided which transform layer coordinates to DC pixel coordinates, and user code should rely on them for portability and future changes to be applied transparently, instead of implementing the following formulas manually.
The passed device context dc has its coordinate origin set to the top-left corner of the visible area (the default). The coordinate orientation is as shown in the following picture:
(wxDC origin 0,0) x-------------> ascending X ----------------+ | | | | V ascending Y | | | | | | | +-------------------------------------------+ <-- right-bottom corner of the mpWindow visible area.
Note that Y ascends in downward direction, whereas the usual vertical orientation for mathematical plots is vice versa. Thus Y-orientation will be swapped usually, when transforming between wxDC and mpLayer coordinates. This change of coordinates is taken into account in the methods p2x,p2y,x2p,y2p.
Rules for transformation between mpLayer and wxDC coordinates
dc | Device context to plot to. |
w | View to plot. The visible area can be retrieved from this object. |
Implemented in mpInfoLayer, mpInfoCoords, mpInfoLegend, mpFX, mpFY, mpFXY, mpProfile, mpScaleX, mpScaleY, mpText, mpMovableObject, and mpBitmapLayer.
|
inline |
Set layer brush.
brush | brush, will be copied to internal class member |
Definition at line 326 of file mathplot.h.
|
inline |
Set the 'continuity' property of the layer (true:draws a continuous line, false:draws separate points).
Definition at line 269 of file mathplot.h.
|
inline |
Set Draw mode: inside or outside margins.
Default is outside, which allows the layer to draw up to the mpWindow border.
drawModeOutside | The draw mode to be set |
Definition at line 297 of file mathplot.h.
|
inline |
Set layer font.
font | Font, will be copied to internal class member |
Definition at line 288 of file mathplot.h.
|
inline |
Set layer name.
name | Name, will be copied to internal class member |
Definition at line 283 of file mathplot.h.
|
inline |
Set layer pen.
pen | Pen, will be copied to internal class member |
Definition at line 293 of file mathplot.h.
|
inline |
|
inline |
Shows or hides the text label with the name of the layer (default is visible).
Definition at line 278 of file mathplot.h.
|
protected |
Layer's brush.
Definition at line 331 of file mathplot.h.
|
protected |
Specify if the layer will be plotted as a continuous line or a set of points.
Definition at line 333 of file mathplot.h.
|
protected |
select if the layer should draw only inside margins or over all DC
Definition at line 335 of file mathplot.h.
|
protected |
Layer's font.
Definition at line 329 of file mathplot.h.
|
protected |
Layer's name.
Definition at line 332 of file mathplot.h.
|
protected |
Layer's pen.
Definition at line 330 of file mathplot.h.
|
protected |
States whether the name of the layer must be shown (default is true).
Definition at line 334 of file mathplot.h.
|
protected |
Define layer type, which is assigned by constructor.
Definition at line 336 of file mathplot.h.
|
protected |
Toggles layer visibility.
Definition at line 337 of file mathplot.h.
Page generated by Doxygen 1.9.5 for MRPT 1.4.0 SVN: at Tue Dec 27 00:53:09 UTC 2022 |