diff options
Diffstat (limited to 'doc/html/tqpainter.html')
| -rw-r--r-- | doc/html/tqpainter.html | 82 |
1 files changed, 41 insertions, 41 deletions
diff --git a/doc/html/tqpainter.html b/doc/html/tqpainter.html index bf08f62b4..5c09278f4 100644 --- a/doc/html/tqpainter.html +++ b/doc/html/tqpainter.html @@ -39,11 +39,11 @@ body { background: #ffffff; color: black; } <ul> <li class=fn>enum <a href="#CoordinateMode-enum"><b>CoordinateMode</b></a> { CoordDevice, CoordPainter }</li> <li class=fn><a href="#TQPainter"><b>TQPainter</b></a> ()</li> -<li class=fn><a href="#TQPainter-2"><b>TQPainter</b></a> ( const TQPaintDevice * pd, bool unclipped = FALSE )</li> -<li class=fn><a href="#TQPainter-3"><b>TQPainter</b></a> ( const TQPaintDevice * pd, const TQWidget * copyAttributes, bool unclipped = FALSE )</li> +<li class=fn><a href="#TQPainter-2"><b>TQPainter</b></a> ( const TQPaintDevice * pd, bool unclipped = false )</li> +<li class=fn><a href="#TQPainter-3"><b>TQPainter</b></a> ( const TQPaintDevice * pd, const TQWidget * copyAttributes, bool unclipped = false )</li> <li class=fn><a href="#~TQPainter"><b>~TQPainter</b></a> ()</li> -<li class=fn>bool <a href="#begin"><b>begin</b></a> ( const TQPaintDevice * pd, bool unclipped = FALSE )</li> -<li class=fn>bool <a href="#begin-2"><b>begin</b></a> ( const TQPaintDevice * pd, const TQWidget * copyAttributes, bool unclipped = FALSE )</li> +<li class=fn>bool <a href="#begin"><b>begin</b></a> ( const TQPaintDevice * pd, bool unclipped = false )</li> +<li class=fn>bool <a href="#begin-2"><b>begin</b></a> ( const TQPaintDevice * pd, const TQWidget * copyAttributes, bool unclipped = false )</li> <li class=fn>bool <a href="#end"><b>end</b></a> ()</li> <li class=fn>TQPaintDevice * <a href="#device"><b>device</b></a> () const</li> <li class=fn>bool <a href="#isActive"><b>isActive</b></a> () const</li> @@ -84,7 +84,7 @@ body { background: #ffffff; color: black; } <li class=fn>void <a href="#setViewport"><b>setViewport</b></a> ( int x, int y, int w, int h )</li> <li class=fn>void <a href="#setWorldXForm"><b>setWorldXForm</b></a> ( bool enable )</li> <li class=fn>const TQWMatrix & <a href="#worldMatrix"><b>worldMatrix</b></a> () const</li> -<li class=fn>void <a href="#setWorldMatrix"><b>setWorldMatrix</b></a> ( const TQWMatrix & m, bool combine = FALSE )</li> +<li class=fn>void <a href="#setWorldMatrix"><b>setWorldMatrix</b></a> ( const TQWMatrix & m, bool combine = false )</li> <li class=fn>void saveWorldMatrix () <em>(obsolete)</em></li> <li class=fn>void restoreWorldMatrix () <em>(obsolete)</em></li> <li class=fn>void <a href="#scale"><b>scale</b></a> ( double sx, double sy )</li> @@ -133,7 +133,7 @@ body { background: #ffffff; color: black; } <li class=fn>void <a href="#drawChord-2"><b>drawChord</b></a> ( const TQRect & r, int a, int alen )</li> <li class=fn>void <a href="#drawLineSegments"><b>drawLineSegments</b></a> ( const TQPointArray & a, int index = 0, int nlines = -1 )</li> <li class=fn>void <a href="#drawPolyline"><b>drawPolyline</b></a> ( const TQPointArray & a, int index = 0, int npoints = -1 )</li> -<li class=fn>void <a href="#drawPolygon"><b>drawPolygon</b></a> ( const TQPointArray & a, bool winding = FALSE, int index = 0, int npoints = -1 )</li> +<li class=fn>void <a href="#drawPolygon"><b>drawPolygon</b></a> ( const TQPointArray & a, bool winding = false, int index = 0, int npoints = -1 )</li> <li class=fn>void <a href="#drawConvexPolygon"><b>drawConvexPolygon</b></a> ( const TQPointArray & pa, int index = 0, int npoints = -1 )</li> <li class=fn>void <a href="#drawCubicBezier"><b>drawCubicBezier</b></a> ( const TQPointArray & a, int index = 0 )</li> <li class=fn>void <a href="#drawPixmap"><b>drawPixmap</b></a> ( int x, int y, const TQPixmap & pixmap, int sx = 0, int sy = 0, int sw = -1, int sh = -1 )</li> @@ -287,7 +287,7 @@ transformations, they are optimized away, gaining another little bit of speed. <p> After all the coordinate transformation is done, TQPainter can clip the drawing to an arbitrary rectangle or region. <a href="#hasClipping">hasClipping</a>() is -TRUE if TQPainter clips, and <a href="#clipRegion">clipRegion</a>() returns the clip region. +true if TQPainter clips, and <a href="#clipRegion">clipRegion</a>() returns the clip region. You can set it using either <a href="#setClipRegion">setClipRegion</a>() or <a href="#setClipRect">setClipRect</a>(). Note that the clipping can be slow. It's all system-dependent, but as a rule of thumb, you can assume that drawing speed is @@ -341,11 +341,11 @@ Constructs a painter. to default values when <a href="#begin">begin</a>() is called. <p> <p>See also <a href="#begin">begin</a>() and <a href="#end">end</a>(). -<h3 class=fn><a name="TQPainter-2"></a>TQPainter::TQPainter ( const <a href="tqpaintdevice.html">TQPaintDevice</a> * pd, bool unclipped = FALSE ) +<h3 class=fn><a name="TQPainter-2"></a>TQPainter::TQPainter ( const <a href="tqpaintdevice.html">TQPaintDevice</a> * pd, bool unclipped = false ) </h3> Constructs a painter that begins painting the paint device <em>pd</em> immediately. Depending on the underlying graphic system the -painter will paint over children of the paintdevice if <em>unclipped</em> is TRUE. +painter will paint over children of the paintdevice if <em>unclipped</em> is true. <p> This constructor is convenient for short-lived painters, e.g. in a <a href="tqwidget.html#paintEvent">paint event</a> and should be used only once. The constructor calls <a href="#begin">begin</a>() for you and the TQPainter @@ -375,11 +375,11 @@ of the painter failed you should rather use begin() and end() to paint on external devices, e.g. printers. <p> <p>See also <a href="#begin">begin</a>() and <a href="#end">end</a>(). -<h3 class=fn><a name="TQPainter-3"></a>TQPainter::TQPainter ( const <a href="tqpaintdevice.html">TQPaintDevice</a> * pd, const <a href="tqwidget.html">TQWidget</a> * copyAttributes, bool unclipped = FALSE ) +<h3 class=fn><a name="TQPainter-3"></a>TQPainter::TQPainter ( const <a href="tqpaintdevice.html">TQPaintDevice</a> * pd, const <a href="tqwidget.html">TQWidget</a> * copyAttributes, bool unclipped = false ) </h3> Constructs a painter that begins painting the paint device <em>pd</em> immediately, with the default arguments taken from <em>copyAttributes</em>. The painter will paint over children of the paint -device if <em>unclipped</em> is TRUE (although this is not supported on +device if <em>unclipped</em> is true (although this is not supported on all platforms). <p> <p>See also <a href="#begin">begin</a>(). @@ -399,10 +399,10 @@ Destroys the painter. <p> Returns the current background mode. <p> <p>See also <a href="#setBackgroundMode">setBackgroundMode</a>() and <a href="tqt.html#BGMode-enum">BGMode</a>. -<h3 class=fn>bool <a name="begin"></a>TQPainter::begin ( const <a href="tqpaintdevice.html">TQPaintDevice</a> * pd, bool unclipped = FALSE ) +<h3 class=fn>bool <a name="begin"></a>TQPainter::begin ( const <a href="tqpaintdevice.html">TQPaintDevice</a> * pd, bool unclipped = false ) </h3> -Begins painting the paint device <em>pd</em> and returns TRUE if -successful; otherwise returns FALSE. If <em>unclipped</em> is TRUE, the +Begins painting the paint device <em>pd</em> and returns true if +successful; otherwise returns false. If <em>unclipped</em> is true, the painting will not be clipped at the paint device's boundaries, (although this is not supported by all platforms). <p> The errors that can occur are serious problems, such as these: @@ -424,13 +424,13 @@ time. <p> <p>See also <a href="#end">end</a>() and <a href="#flush">flush</a>(). <p>Examples: <a href="aclock-example.html#x1183">aclock/aclock.cpp</a>, <a href="desktop-example.html#x1733">desktop/desktop.cpp</a>, <a href="drawdemo-example.html#x1067">drawdemo/drawdemo.cpp</a>, <a href="hello-example.html#x1633">hello/hello.cpp</a>, <a href="picture-example.html#x111">picture/picture.cpp</a>, <a href="tutorial1-10.html#x2348">t10/cannon.cpp</a>, and <a href="xform-example.html#x1233">xform/xform.cpp</a>. -<h3 class=fn>bool <a name="begin-2"></a>TQPainter::begin ( const <a href="tqpaintdevice.html">TQPaintDevice</a> * pd, const <a href="tqwidget.html">TQWidget</a> * copyAttributes, bool unclipped = FALSE ) +<h3 class=fn>bool <a name="begin-2"></a>TQPainter::begin ( const <a href="tqpaintdevice.html">TQPaintDevice</a> * pd, const <a href="tqwidget.html">TQWidget</a> * copyAttributes, bool unclipped = false ) </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> This version opens the painter on a paint device <em>pd</em> and sets the initial pen, background color and font from <em>copyAttributes</em>, painting over the paint device's children when <em>unclipped</em> is -TRUE. This is equivalent to: +true. This is equivalent to: <p> <pre> TQPainter p; p.<a href="#begin">begin</a>( pd ); @@ -749,7 +749,7 @@ greater, <em>npoints</em> points are drawn. values are truncated. This limitation is expected to go away in TQt 4. -<h3 class=fn>void <a name="drawPolygon"></a>TQPainter::drawPolygon ( const <a href="tqpointarray.html">TQPointArray</a> & a, bool winding = FALSE, int index = 0, int npoints = -1 ) +<h3 class=fn>void <a name="drawPolygon"></a>TQPainter::drawPolygon ( const <a href="tqpointarray.html">TQPointArray</a> & a, bool winding = false, int index = 0, int npoints = -1 ) </h3> Draws the polygon defined by the <em>npoints</em> points in <em>a</em> starting at <em>a[index]</em>. (<em>index</em> defaults to 0.) @@ -758,8 +758,8 @@ array are used (i.e. a.size()-index line segments define the polygon). <p> The first point is always connected to the last point. <p> The polygon is filled with the current <a href="#brush">brush</a>(). If <em>winding</em> is -TRUE, the polygon is filled using the winding fill algorithm. If -<em>winding</em> is FALSE, the polygon is filled using the even-odd +true, the polygon is filled using the winding fill algorithm. If +<em>winding</em> is false, the polygon is filled using the even-odd (alternative) fill algorithm. <p> <b>Warning:</b> On X11, coordinates that do not fit into 16-bit signed values are truncated. This limitation is expected to go away in @@ -1018,30 +1018,30 @@ function is not portable. <h3 class=fn>bool <a name="hasClipping"></a>TQPainter::hasClipping () const </h3> -<p> Returns TRUE if clipping has been set; otherwise returns FALSE. +<p> Returns true if clipping has been set; otherwise returns false. <p> <p>See also <a href="#setClipping">setClipping</a>(). <p>Example: <a href="themes-example.html#x217">themes/wood.cpp</a>. <h3 class=fn>bool <a name="hasViewXForm"></a>TQPainter::hasViewXForm () const </h3> -<p> Returns TRUE if view transformation is enabled; otherwise returns -FALSE. +<p> Returns true if view transformation is enabled; otherwise returns +false. <p> <p>See also <a href="#setViewXForm">setViewXForm</a>() and <a href="#xForm">xForm</a>(). <h3 class=fn>bool <a name="hasWorldXForm"></a>TQPainter::hasWorldXForm () const </h3> -<p> Returns TRUE if world transformation is enabled; otherwise returns -FALSE. +<p> Returns true if world transformation is enabled; otherwise returns +false. <p> <p>See also <a href="#setWorldXForm">setWorldXForm</a>(). <h3 class=fn>bool <a name="isActive"></a>TQPainter::isActive () const </h3> -<p> Returns TRUE if the painter is active painting, i.e. <a href="#begin">begin</a>() has +<p> Returns true if the painter is active painting, i.e. <a href="#begin">begin</a>() has been called and <a href="#end">end</a>() has not yet been called; otherwise returns -FALSE. +false. <p> <p>See also <a href="tqpaintdevice.html#paintingActive">TQPaintDevice::paintingActive</a>(). <p>Examples: <a href="desktop-example.html#x1739">desktop/desktop.cpp</a> and <a href="helpviewer-example.html#x1002">helpviewer/helpwindow.cpp</a>. @@ -1222,7 +1222,7 @@ and <em>not</em> subject to any <a href="coordsys.html">coordinate <p>Examples: <a href="qfd-example.html#x1999">qfd/fontdisplayer.cpp</a> and <a href="themes-example.html#x220">themes/wood.cpp</a>. <h3 class=fn>void <a name="setClipping"></a>TQPainter::setClipping ( bool enable ) </h3> -Enables clipping if <em>enable</em> is TRUE, or disables clipping if <em>enable</em> is FALSE. +Enables clipping if <em>enable</em> is true, or disables clipping if <em>enable</em> is false. <p> <p>See also <a href="#hasClipping">hasClipping</a>(), <a href="#setClipRect">setClipRect</a>(), and <a href="#setClipRegion">setClipRegion</a>(). <p>Example: <a href="themes-example.html#x221">themes/wood.cpp</a>. @@ -1282,8 +1282,8 @@ character 'x' in the font currently set on the painter. <h3 class=fn>void <a name="setViewXForm"></a>TQPainter::setViewXForm ( bool enable ) </h3> -Enables view transformations if <em>enable</em> is TRUE, or disables -view transformations if <em>enable</em> is FALSE. +Enables view transformations if <em>enable</em> is true, or disables +view transformations if <em>enable</em> is false. <p> <p>See also <a href="#hasViewXForm">hasViewXForm</a>(), <a href="#setWindow">setWindow</a>(), <a href="#setViewport">setViewport</a>(), <a href="#setWorldMatrix">setWorldMatrix</a>(), <a href="#setWorldXForm">setWorldXForm</a>(), and <a href="#xForm">xForm</a>(). <h3 class=fn>void <a name="setViewport"></a>TQPainter::setViewport ( int x, int y, int w, int h ) @@ -1322,15 +1322,15 @@ rectangle. See the <a href="coordsys.html">Coordinate System Overview</a> for an This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Sets the painter's window to rectangle <em>r</em>. -<h3 class=fn>void <a name="setWorldMatrix"></a>TQPainter::setWorldMatrix ( const <a href="tqwmatrix.html">TQWMatrix</a> & m, bool combine = FALSE ) +<h3 class=fn>void <a name="setWorldMatrix"></a>TQPainter::setWorldMatrix ( const <a href="tqwmatrix.html">TQWMatrix</a> & m, bool combine = false ) </h3> Sets the world <a href="tqwmatrix.html#TransformationMode">transformation matrix</a> to <em>m</em> and enables world transformation. -<p> If <em>combine</em> is TRUE, then <em>m</em> is combined with the current +<p> If <em>combine</em> is true, then <em>m</em> is combined with the current transformation matrix, otherwise <em>m</em> replaces the current transformation matrix. -<p> If <em>m</em> is the identity matrix and <em>combine</em> is FALSE, this -function calls <a href="#setWorldXForm">setWorldXForm</a>(FALSE). (The identity matrix is the +<p> If <em>m</em> is the identity matrix and <em>combine</em> is false, this +function calls <a href="#setWorldXForm">setWorldXForm</a>(false). (The identity matrix is the matrix where <a href="tqwmatrix.html#m11">TQWMatrix::m11</a>() and <a href="tqwmatrix.html#m22">TQWMatrix::m22</a>() are 1.0 and the rest are 0.0.) <p> World transformations are applied after the view transformations @@ -1349,7 +1349,7 @@ a TQWMatrix: { <a href="tqwmatrix.html">TQWMatrix</a> m; m.<a href="tqwmatrix.html#rotate">rotate</a>( a ); - <a href="#setWorldMatrix">setWorldMatrix</a>( m, TRUE ); + <a href="#setWorldMatrix">setWorldMatrix</a>( m, true ); } </pre> @@ -1363,8 +1363,8 @@ scale(), etc., is safe. <p>Examples: <a href="drawdemo-example.html#x1078">drawdemo/drawdemo.cpp</a> and <a href="xform-example.html#x1242">xform/xform.cpp</a>. <h3 class=fn>void <a name="setWorldXForm"></a>TQPainter::setWorldXForm ( bool enable ) </h3> -Enables world transformations if <em>enable</em> is TRUE, or disables -world transformations if <em>enable</em> is FALSE. The world +Enables world transformations if <em>enable</em> is true, or disables +world transformations if <em>enable</em> is false. The world <a href="tqwmatrix.html#TransformationMode">transformation matrix</a> is not changed. <p> <p>See also <a href="#setWorldMatrix">setWorldMatrix</a>(), <a href="#setWindow">setWindow</a>(), <a href="#setViewport">setViewport</a>(), <a href="#setViewXForm">setViewXForm</a>(), and <a href="#xForm">xForm</a>(). @@ -1531,7 +1531,7 @@ shaded line using the painter <em>p</em>. <p> Nothing is drawn if <em>y1</em> != <em>y2</em> and <em>x1</em> != <em>x2</em> (i.e. the line is neither horizontal nor vertical). <p> The color group argument <em>g</em> specifies the shading colors (<a href="tqcolorgroup.html#light">light</a>, <a href="tqcolorgroup.html#dark">dark</a> and <a href="tqcolorgroup.html#mid">middle</a> colors). -<p> The line appears sunken if <em>sunken</em> is TRUE, or raised if <em>sunken</em> is FALSE. +<p> The line appears sunken if <em>sunken</em> is true, or raised if <em>sunken</em> is false. <p> The <em>lineWidth</em> argument specifies the line width for each of the lines. It is not the total line width. <p> The <em>midLineWidth</em> argument specifies the width of a middle line @@ -1550,7 +1550,7 @@ widgets that follow the current GUI style. <p> Draws the shaded panel specified by (<em>x</em>, <em>y</em>, <em>w</em>, <em>h</em>) using the painter <em>p</em>. <p> The color group argument <em>g</em> specifies the shading colors (<a href="tqcolorgroup.html#light">light</a>, <a href="tqcolorgroup.html#dark">dark</a> and <a href="tqcolorgroup.html#mid">middle</a> colors). -<p> The panel appears sunken if <em>sunken</em> is TRUE, or raised if <em>sunken</em> is FALSE. +<p> The panel appears sunken if <em>sunken</em> is true, or raised if <em>sunken</em> is false. <p> The <em>lineWidth</em> argument specifies the line width. <p> The panel's interior is filled with the <em>fill</em> brush unless <em>fill</em> is 0. <p> If you want to use a <a href="tqframe.html">TQFrame</a> widget instead, you can make it @@ -1567,7 +1567,7 @@ widgets that follow the current GUI style. <p> Draws the shaded rectangle specified by (<em>x</em>, <em>y</em>, <em>w</em>, <em>h</em>) using the painter <em>p</em>. <p> The color group argument <em>g</em> specifies the shading colors (<a href="tqcolorgroup.html#light">light</a>, <a href="tqcolorgroup.html#dark">dark</a> and <a href="tqcolorgroup.html#mid">middle</a> colors). -<p> The rectangle appears sunken if <em>sunken</em> is TRUE, or raised if <em>sunken</em> is FALSE. +<p> The rectangle appears sunken if <em>sunken</em> is true, or raised if <em>sunken</em> is false. <p> The <em>lineWidth</em> argument specifies the line width for each of the lines. It is not the total line width. <p> The <em>midLineWidth</em> argument specifies the width of a middle line @@ -1587,7 +1587,7 @@ widgets that follow the current GUI style. <p> <tt>#include <tqdrawutil.h></tt> <p> Draws the Windows-style button specified by (<em>x</em>, <em>y</em>, <em>w</em>, <em>h</em>) using the painter <em>p</em>. <p> The color group argument <em>g</em> specifies the shading colors (<a href="tqcolorgroup.html#light">light</a>, <a href="tqcolorgroup.html#dark">dark</a> and <a href="tqcolorgroup.html#mid">middle</a> colors). -<p> The button appears sunken if <em>sunken</em> is TRUE, or raised if <em>sunken</em> is FALSE. +<p> The button appears sunken if <em>sunken</em> is true, or raised if <em>sunken</em> is false. <p> The line width is 2 pixels. <p> The button's interior is filled with the <em>*fill</em> brush unless <em>fill</em> is 0. <p> <b>Warning:</b> This function does not look at <a href="tqwidget.html#style">TQWidget::style</a>() or @@ -1601,7 +1601,7 @@ widgets that follow the current GUI style. <p> <tt>#include <tqdrawutil.h></tt> <p> Draws the Windows-style panel specified by (<em>x</em>, <em>y</em>, <em>w</em>, <em>h</em>) using the painter <em>p</em>. <p> The color group argument <em>g</em> specifies the shading colors. -<p> The panel appears sunken if <em>sunken</em> is TRUE, or raised if <em>sunken</em> is FALSE. +<p> The panel appears sunken if <em>sunken</em> is true, or raised if <em>sunken</em> is false. <p> The line width is 2 pixels. <p> The button's interior is filled with the <em>fill</em> brush unless <em>fill</em> is 0. <p> If you want to use a <a href="tqframe.html">TQFrame</a> widget instead, you can make it |