From 1e9fa8e06de5da7fcc268e9cccb2d6b21c5f53a3 Mon Sep 17 00:00:00 2001 From: Michele Calgaro Date: Sat, 20 Jul 2024 20:15:52 +0900 Subject: Rename graphics class nt* related files to equivalent tq* (part 2) Signed-off-by: Michele Calgaro --- doc/html/ntqpointarray.html | 285 -------------------------------------------- 1 file changed, 285 deletions(-) delete mode 100644 doc/html/ntqpointarray.html (limited to 'doc/html/ntqpointarray.html') diff --git a/doc/html/ntqpointarray.html b/doc/html/ntqpointarray.html deleted file mode 100644 index 322c73f5e..000000000 --- a/doc/html/ntqpointarray.html +++ /dev/null @@ -1,285 +0,0 @@ - - - - - -TQPointArray Class - - - - - - - -

TQPointArray Class Reference

- -

The TQPointArray class provides an array of points. -More... -

#include <ntqpointarray.h> -

Inherits TQMemArray<TQPoint>. -

List of all member functions. -

Public Members

TQPointArray ()
~TQPointArray ()
TQPointArray ( int size )
TQPointArray ( const TQPointArray & a )
TQPointArray ( const TQRect & r, bool closed = FALSE )
TQPointArray & operator= ( const TQPointArray & a )
TQPointArray copy () const
void translate ( int dx, int dy )
TQRect boundingRect () const
void point ( uint index, int * x, int * y ) const
TQPoint point ( uint index ) const
void setPoint ( uint index, int x, int y )
void setPoint ( uint i, const TQPoint & p )
bool putPoints ( int index, int nPoints, int firstx, int firsty, ... )
bool putPoints ( int index, int nPoints, const TQPointArray & from, int fromIndex = 0 )
void makeArc ( int x, int y, int w, int h, int a1, int a2 )
void makeEllipse ( int x, int y, int w, int h )
void makeArc ( int x, int y, int w, int h, int a1, int a2, const TQWMatrix & xf )
TQPointArray cubicBezier () const

Related Functions

TQDataStream & operator<< ( TQDataStream & s, const TQPointArray & a )
TQDataStream & operator>> ( TQDataStream & s, TQPointArray & a )

Detailed Description

- - -The TQPointArray class provides an array of points. -

- - -

A TQPointArray is an array of TQPoint objects. In addition to the -functions provided by TQMemArray, TQPointArray provides some -point-specific functions. -

For convenient reading and writing of the point data use -setPoints(), putPoints(), point(), and setPoint(). -

For geometry operations use boundingRect() and translate(). There -is also the TQWMatrix::map() function for more general -transformations of TQPointArrays. You can also create arcs and -ellipses with makeArc() and makeEllipse(). -

Among others, TQPointArray is used by TQPainter::drawLineSegments(), -TQPainter::drawPolyline(), TQPainter::drawPolygon() and -TQPainter::drawCubicBezier(). -

Note that because this class is a TQMemArray, copying an array and -modifying the copy modifies the original as well, i.e. a shallow copy. If you need a deep copy use copy() or detach(), for example: -

-        void drawGiraffe( const TQPointArray & r, TQPainter * p )
-        {
-            TQPointArray tmp = r;
-            tmp.detach();
-            // some code that modifies tmp
-            p->drawPoints( tmp );
-        }
-

- -

If you forget the tmp.detach(), the const array will be modified. -

Member Function Documentation

TQPointArray::TQPointArray () -

- -

Constructs a null point array. -

TQPointArray::TQPointArray ( int size ) -

- -

Constructs a point array with room for size points. Makes a -null array if size == 0. -

TQPointArray::TQPointArray ( const TQPointArray & a ) -

- -

Constructs a shallow copy of the point array a. -

TQPointArray::TQPointArray ( const TQRect & r, bool closed = FALSE ) -

-Constructs a point array from the rectangle r. -

If closed is FALSE, then the point array just contains the -following four points in the listed order: r.topLeft(), -r.topRight(), r.bottomRight() and r.bottomLeft(). -

If closed is TRUE, then a fifth point is set to r.topLeft(). - -

TQPointArray::~TQPointArray () -

- -

Destroys the point array. - -

TQRect TQPointArray::boundingRect () const -

-Returns the bounding rectangle of the points in the array, or -TQRect(0,0,0,0) if the array is empty. - -

TQPointArray TQPointArray::copy () const -

- -

Creates a deep copy of the array. -

TQPointArray TQPointArray::cubicBezier () const -

-Returns the Bezier points for the four control points in this -array. - -

void TQPointArray::makeArc ( int x, int y, int w, int h, int a1, int a2 ) -

-Sets the points of the array to those describing an arc of an -ellipse with size, width w by height h, and position (x, -y), starting from angle a1 and spanning by angle a2. The -resulting array has sufficient resolution for pixel accuracy (see -the overloaded function which takes an additional TQWMatrix -parameter). -

Angles are specified in 16ths of a degree, i.e. a full circle -equals 5760 (16*360). Positive values mean counter-clockwise, -whereas negative values mean the clockwise direction. Zero degrees -is at the 3 o'clock position. -

See the angle diagram. - -

void TQPointArray::makeArc ( int x, int y, int w, int h, int a1, int a2, const TQWMatrix & xf ) -

-This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -

Sets the points of the array to those describing an arc of an -ellipse with width w and height h and position (x, y), -starting from angle a1, and spanning angle by a2, and -transformed by the matrix xf. The resulting array has -sufficient resolution for pixel accuracy. -

See the angle diagram. - -

void TQPointArray::makeEllipse ( int x, int y, int w, int h ) -

-Sets the points of the array to those describing an ellipse with -size, width w by height h, and position (x, y). -

The returned array has sufficient resolution for use as pixels. - -

TQPointArray & TQPointArray::operator= ( const TQPointArray & a ) -

- -

Assigns a shallow copy of a to this point array and returns a -reference to this point array. -

Equivalent to assign(a). -

void TQPointArray::point ( uint index, int * x, int * y ) const -

-Reads the coordinates of the point at position index within the -array and writes them into *x and *y. - -

TQPoint TQPointArray::point ( uint index ) const -

-This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -

Returns the point at position index within the array. - -

bool TQPointArray::putPoints ( int index, int nPoints, int firstx, int firsty, ... ) -

-Copies nPoints points from the variable argument list into this -point array from position index, and resizes the point array if -index+nPoints exceeds the size of the array. -

Returns TRUE if successful, or FALSE if the array could not be -resized (typically due to lack of memory). -

The example code creates an array with three points (4,5), (6,7) -and (8,9), by expanding the array from 1 to 3 points: -

-        TQPointArray a( 1 );
-        a[0] = TQPoint( 4, 5 );
-        a.putPoints( 1, 2, 6,7, 8,9 ); // index == 1, points == 2
-

- -

This has the same result, but here putPoints overwrites rather -than extends: -

-        TQPointArray a( 3 );
-        a.putPoints( 0, 3, 4,5, 0,0, 8,9 );
-        a.putPoints( 1, 1, 6,7 );
-

- -

The points are given as a sequence of integers, starting with firstx then firsty, and so on. -

bool TQPointArray::putPoints ( int index, int nPoints, const TQPointArray & from, int fromIndex = 0 ) -

-This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -

This version of the function copies nPoints from from into -this array, starting at index in this array and fromIndex in -from. fromIndex is 0 by default. -

-        TQPointArray a;
-        a.putPoints( 0, 3, 1,2, 0,0, 5,6 );
-        // a is now the three-point array ( 1,2, 0,0, 5,6 );
-        TQPointArray b;
-        b.putPoints( 0, 3, 4,4, 5,5, 6,6 );
-        // b is now ( 4,4, 5,5, 6,6 );
-        a.putPoints( 2, 3, b );
-        // a is now ( 1,2, 0,0, 4,4, 5,5, 6,6 );
-

- - -