eric7/Documentation/Source/eric7.EricGraphics.EricGraphicsView.html

<!DOCTYPE html>
<html><head>
<title>eric7.EricGraphics.EricGraphicsView</title>
<meta charset="UTF-8">
<style>
body {
    background: #EDECE6;
    margin: 0em 1em 10em 1em;
    color: black;
}

h1 { color: white; background: #85774A; }
h2 { color: white; background: #85774A; }
h3 { color: white; background: #9D936E; }
h4 { color: white; background: #9D936E; }
    
a { color: #BA6D36; }

</style>
</head>
<body>
<a NAME="top" ID="top"></a>
<h1>eric7.EricGraphics.EricGraphicsView</h1>

<p>
Module implementing a canvas view class.
</p>
<h3>Global Attributes</h3>

<table>
<tr><td>None</td></tr>
</table>
<h3>Classes</h3>

<table>

<tr>
<td><a href="#EricGraphicsView">EricGraphicsView</a></td>
<td>Class implementing a graphics view.</td>
</tr>
</table>
<h3>Functions</h3>

<table>
<tr><td>None</td></tr>
</table>
<hr />
<hr />
<a NAME="EricGraphicsView" ID="EricGraphicsView"></a>
<h2>EricGraphicsView</h2>

<p>
    Class implementing a graphics view.
</p>
<h3>Signals</h3>
<dl>

<dt>zoomValueChanged(int)</dt>
<dd>
emitted to signal a change of the zoom value
</dd>
</dl>
<h3>Derived from</h3>
QGraphicsView
<h3>Class Attributes</h3>

<table>
<tr><td>ZoomLevelDefault</td></tr><tr><td>ZoomLevels</td></tr>
</table>
<h3>Class Methods</h3>

<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>

<table>

<tr>
<td><a href="#EricGraphicsView.__init__">EricGraphicsView</a></td>
<td>Constructor</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.__getDiagram">__getDiagram</a></td>
<td>Private method to retrieve the diagram from the scene fitting it in the minimum rectangle.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.__levelForZoom">__levelForZoom</a></td>
<td>Private method determining the zoom level index given a zoom factor.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView._getDiagramRect">_getDiagramRect</a></td>
<td>Protected method to calculate the minimum rectangle fitting the diagram.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView._getDiagramSize">_getDiagramSize</a></td>
<td>Protected method to calculate the minimum size fitting the diagram.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.autoAdjustSceneSize">autoAdjustSceneSize</a></td>
<td>Public method to adjust the scene size to the diagram size.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.filteredItems">filteredItems</a></td>
<td>Public method to filter a list of items.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.getBackgroundColor">getBackgroundColor</a></td>
<td>Public method to get the configured background color.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.getDrawingColors">getDrawingColors</a></td>
<td>Public method to get the configured drawing colors.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.getForegroundColor">getForegroundColor</a></td>
<td>Public method to get the configured foreground color.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.printDiagram">printDiagram</a></td>
<td>Public method to print the diagram.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.resizeScene">resizeScene</a></td>
<td>Public method to resize the scene.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.saveImage">saveImage</a></td>
<td>Public method to save the scene to a file.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.setSceneSize">setSceneSize</a></td>
<td>Public method to set the scene size.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.setZoom">setZoom</a></td>
<td>Public method to set the zoom value in percent.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.zoom">zoom</a></td>
<td>Public method to get the current zoom factor in percent.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.zoomIn">zoomIn</a></td>
<td>Public method to zoom in.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.zoomOut">zoomOut</a></td>
<td>Public method to zoom out.</td>
</tr>
<tr>
<td><a href="#EricGraphicsView.zoomReset">zoomReset</a></td>
<td>Public method to handle the reset the zoom value.</td>
</tr>
</table>
<h3>Static Methods</h3>

<table>
<tr><td>None</td></tr>
</table>

<a NAME="EricGraphicsView.__init__" ID="EricGraphicsView.__init__"></a>
<h4>EricGraphicsView (Constructor)</h4>
<b>EricGraphicsView</b>(<i>scene, parent=None</i>)

<p>
        Constructor
</p>
<dl>

<dt><i>scene</i></dt>
<dd>
reference to the scene object (QGraphicsScene)
</dd>
<dt><i>parent</i></dt>
<dd>
parent widget (QWidget)
</dd>
</dl>
<a NAME="EricGraphicsView.__getDiagram" ID="EricGraphicsView.__getDiagram"></a>
<h4>EricGraphicsView.__getDiagram</h4>
<b>__getDiagram</b>(<i>rect, imageFormat="PNG", filename=None</i>)

<p>
        Private method to retrieve the diagram from the scene fitting it
        in the minimum rectangle.
</p>
<dl>

<dt><i>rect</i> (QRectF)</dt>
<dd>
minimum rectangle fitting the diagram
</dd>
<dt><i>imageFormat</i> (str)</dt>
<dd>
format for the image file
</dd>
<dt><i>filename</i></dt>
<dd>
name of the file for non pixmaps
        str
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
paint device containing the diagram
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
QPixmap or QSvgGenerator
</dd>
</dl>
<a NAME="EricGraphicsView.__levelForZoom" ID="EricGraphicsView.__levelForZoom"></a>
<h4>EricGraphicsView.__levelForZoom</h4>
<b>__levelForZoom</b>(<i>zoom</i>)

<p>
        Private method determining the zoom level index given a zoom factor.
</p>
<dl>

<dt><i>zoom</i></dt>
<dd>
zoom factor (integer)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
index of zoom factor (integer)
</dd>
</dl>
<a NAME="EricGraphicsView._getDiagramRect" ID="EricGraphicsView._getDiagramRect"></a>
<h4>EricGraphicsView._getDiagramRect</h4>
<b>_getDiagramRect</b>(<i>border=0</i>)

<p>
        Protected method to calculate the minimum rectangle fitting the
        diagram.
</p>
<dl>

<dt><i>border</i></dt>
<dd>
border width to include in the calculation (integer)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
the minimum rectangle (QRectF)
</dd>
</dl>
<a NAME="EricGraphicsView._getDiagramSize" ID="EricGraphicsView._getDiagramSize"></a>
<h4>EricGraphicsView._getDiagramSize</h4>
<b>_getDiagramSize</b>(<i>border=0</i>)

<p>
        Protected method to calculate the minimum size fitting the diagram.
</p>
<dl>

<dt><i>border</i></dt>
<dd>
border width to include in the calculation (integer)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
the minimum size (QSizeF)
</dd>
</dl>
<a NAME="EricGraphicsView.autoAdjustSceneSize" ID="EricGraphicsView.autoAdjustSceneSize"></a>
<h4>EricGraphicsView.autoAdjustSceneSize</h4>
<b>autoAdjustSceneSize</b>(<i>limit=False</i>)

<p>
        Public method to adjust the scene size to the diagram size.
</p>
<dl>

<dt><i>limit</i></dt>
<dd>
flag indicating to limit the scene to the
            initial size (boolean)
</dd>
</dl>
<a NAME="EricGraphicsView.filteredItems" ID="EricGraphicsView.filteredItems"></a>
<h4>EricGraphicsView.filteredItems</h4>
<b>filteredItems</b>(<i>items</i>)

<p>
        Public method to filter a list of items.
</p>
<dl>

<dt><i>items</i></dt>
<dd>
list of items as returned by the scene object
            (QGraphicsItem)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
list of interesting collision items (QGraphicsItem)
</dd>
</dl>
<a NAME="EricGraphicsView.getBackgroundColor" ID="EricGraphicsView.getBackgroundColor"></a>
<h4>EricGraphicsView.getBackgroundColor</h4>
<b>getBackgroundColor</b>(<i></i>)

<p>
        Public method to get the configured background color.
</p>
<dl>
<dt>Return:</dt>
<dd>
background color
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
QColor
</dd>
</dl>
<a NAME="EricGraphicsView.getDrawingColors" ID="EricGraphicsView.getDrawingColors"></a>
<h4>EricGraphicsView.getDrawingColors</h4>
<b>getDrawingColors</b>(<i></i>)

<p>
        Public method to get the configured drawing colors.
</p>
<dl>
<dt>Return:</dt>
<dd>
tuple containing the foreground and background colors
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
tuple of (QColor, QColor)
</dd>
</dl>
<a NAME="EricGraphicsView.getForegroundColor" ID="EricGraphicsView.getForegroundColor"></a>
<h4>EricGraphicsView.getForegroundColor</h4>
<b>getForegroundColor</b>(<i></i>)

<p>
        Public method to get the configured foreground color.
</p>
<dl>
<dt>Return:</dt>
<dd>
foreground color
</dd>
</dl>
<dl>
<dt>Return Type:</dt>
<dd>
QColor
</dd>
</dl>
<a NAME="EricGraphicsView.printDiagram" ID="EricGraphicsView.printDiagram"></a>
<h4>EricGraphicsView.printDiagram</h4>
<b>printDiagram</b>(<i>printer, diagramName=""</i>)

<p>
        Public method to print the diagram.
</p>
<dl>

<dt><i>printer</i></dt>
<dd>
reference to a ready configured printer object
            (QPrinter)
</dd>
<dt><i>diagramName</i></dt>
<dd>
name of the diagram (string)
</dd>
</dl>
<a NAME="EricGraphicsView.resizeScene" ID="EricGraphicsView.resizeScene"></a>
<h4>EricGraphicsView.resizeScene</h4>
<b>resizeScene</b>(<i>amount, isWidth=True</i>)

<p>
        Public method to resize the scene.
</p>
<dl>

<dt><i>amount</i></dt>
<dd>
size increment (integer)
</dd>
<dt><i>isWidth</i></dt>
<dd>
flag indicating width is to be resized (boolean)
</dd>
</dl>
<a NAME="EricGraphicsView.saveImage" ID="EricGraphicsView.saveImage"></a>
<h4>EricGraphicsView.saveImage</h4>
<b>saveImage</b>(<i>filename, imageFormat="PNG"</i>)

<p>
        Public method to save the scene to a file.
</p>
<dl>

<dt><i>filename</i></dt>
<dd>
name of the file to write the image to (string)
</dd>
<dt><i>imageFormat</i></dt>
<dd>
format for the image file (string)
</dd>
</dl>
<dl>
<dt>Return:</dt>
<dd>
flag indicating success (boolean)
</dd>
</dl>
<a NAME="EricGraphicsView.setSceneSize" ID="EricGraphicsView.setSceneSize"></a>
<h4>EricGraphicsView.setSceneSize</h4>
<b>setSceneSize</b>(<i>width, height</i>)

<p>
        Public method to set the scene size.
</p>
<dl>

<dt><i>width</i></dt>
<dd>
width for the scene (real)
</dd>
<dt><i>height</i></dt>
<dd>
height for the scene (real)
</dd>
</dl>
<a NAME="EricGraphicsView.setZoom" ID="EricGraphicsView.setZoom"></a>
<h4>EricGraphicsView.setZoom</h4>
<b>setZoom</b>(<i>value</i>)

<p>
        Public method to set the zoom value in percent.
</p>
<dl>

<dt><i>value</i></dt>
<dd>
zoom value in percent (integer)
</dd>
</dl>
<a NAME="EricGraphicsView.zoom" ID="EricGraphicsView.zoom"></a>
<h4>EricGraphicsView.zoom</h4>
<b>zoom</b>(<i></i>)

<p>
        Public method to get the current zoom factor in percent.
</p>
<dl>
<dt>Return:</dt>
<dd>
current zoom factor in percent (integer)
</dd>
</dl>
<a NAME="EricGraphicsView.zoomIn" ID="EricGraphicsView.zoomIn"></a>
<h4>EricGraphicsView.zoomIn</h4>
<b>zoomIn</b>(<i></i>)

<p>
        Public method to zoom in.
</p>
<a NAME="EricGraphicsView.zoomOut" ID="EricGraphicsView.zoomOut"></a>
<h4>EricGraphicsView.zoomOut</h4>
<b>zoomOut</b>(<i></i>)

<p>
        Public method to zoom out.
</p>
<a NAME="EricGraphicsView.zoomReset" ID="EricGraphicsView.zoomReset"></a>
<h4>EricGraphicsView.zoomReset</h4>
<b>zoomReset</b>(<i></i>)

<p>
        Public method to handle the reset the zoom value.
</p>
<div align="right"><a href="#top">Up</a></div>
<hr />
</body></html>