Q3Picture Class Reference

#include <q3picture.h>

Inheritance diagram for Q3Picture:

[legend]Collaboration diagram for Q3Picture:

[legend]List of all members.

---

Detailed Description

The Q3Picture class is a paint device that records and replays Q3Painter commands.

Q3Picture can also read and write SVG (Scalable Vector Graphics) files; these files are in an XML format specified by { http://www.w3.org/Graphics/SVG/ W3C}. Note that when using the load() and save() functions to read and write SVG files, the format must be specified.

See also:

QPicture

Definition at line 33 of file q3picture.h.

Public Member Functions
	Q3Picture ()
	Q3Picture (const QPicture &pic)
bool	load (QIODevice *dev, const char *format=0)
bool	load (const QString &fileName, const char *format=0)
bool	save (QIODevice *dev, const char *format=0)
bool	save (const QString &fileName, const char *format=0)

---

Constructor & Destructor Documentation

Q3Picture::Q3Picture

(

)

[inline]

Constructs a Q3Picture.

Definition at line 36 of file q3picture.h.

: QPicture(-1) { }

Q3Picture::Q3Picture

(

const QPicture &

other

)

[inline]

Constructs a copy of other.

Definition at line 37 of file q3picture.h.

: QPicture(pic) { }

---

Member Function Documentation

bool Q3Picture::load	(	QIODevice *	device,
		const char *	format = 0
	)

Loads the picture in the specified format from the given device. Returns true if the file is loaded successfully; otherwise returns false.

Note that when using the load() function to read SVG files, the format must be specified. For example:

        Q3Picture picture;
        picture.load("drawing.svg", SVG);

See also:

save()

Reimplemented from QPicture.

Definition at line 141 of file q3picture.cpp.

References QPainter::Antialiasing, b, Q3SvgDevice::boundingRect(), Q3SvgDevice::load(), QPicture::load(), p, Q3SvgDevice::play(), and qstrcmp().

Referenced by load().

{
    if (qstrcmp(format, "svg" ) == 0) {
  Q3SvgDevice svg;
  if (!svg.load(dev))
      return false;
        QPainter p(this);
        p.setRenderHint(QPainter::Antialiasing);
  bool b = svg.play(&p);
  d_func()->brect = svg.boundingRect();
  return b;
    }
    return QPicture::load(dev, format);
}

Here is the call graph for this function:

bool Q3Picture::load	(	const QString &	fileName,
		const char *	format = 0
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Loads the picture in the specified format from a file with the given fileName. Returns true if the file is loaded successfully; otherwise returns false.

Reimplemented from QPicture.

Definition at line 117 of file q3picture.cpp.

References load(), QFile::open(), and QIODevice::ReadOnly.

{
    QFile f(fileName);
    if (!f.open(QIODevice::ReadOnly))
        return false;
    return load(&f, format);
}

Here is the call graph for this function:

bool Q3Picture::save	(	QIODevice *	device,
		const char *	format = 0
	)

Saves the picture in the specified format to the given device.

Note that when using the save() function to save SVG files, the format must be specified. For example:

         Q3Picture picture;
         QPainter painter;
         painter.begin(&picture);           // paint in picture
         ...
         painter.end();                     // painting done
         picture.save("drawing.svg", SVG);  // save picture

See also:

load()

Reimplemented from QPicture.

Definition at line 204 of file q3picture.cpp.

References QPicture::boundingRect(), p, QPaintDevice::paintingActive(), QPicture::play(), qstricmp(), qWarning(), QPicture::save(), Q3SvgDevice::save(), and Q3SvgDevice::setBoundingRect().

{
    if (paintingActive()) {
        qWarning("Q3Picture::save: still being painted on. "
                  "Call QPainter::end() first");
        return false;
    }

    if (qstricmp(format, "svg") == 0) {
  Q3SvgDevice svg;
  QPainter p(&svg);
  if (!play(&p))
      return false;
  svg.setBoundingRect(boundingRect());
  return svg.save(dev);
    }

    return QPicture::save(dev, format);
}

Here is the call graph for this function:

bool Q3Picture::save	(	const QString &	fileName,
		const char *	format = 0
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Saves the picture in the specified format to the file with the given fileName.

See also:

load()

Reimplemented from QPicture.

Definition at line 163 of file q3picture.cpp.

References QPicture::boundingRect(), p, QPaintDevice::paintingActive(), QPicture::play(), qstricmp(), qWarning(), QPicture::save(), Q3SvgDevice::save(), and Q3SvgDevice::setBoundingRect().

{
    if (paintingActive()) {
        qWarning("Q3Picture::save: still being painted on. "
                  "Call QPainter::end() first");
        return false;
    }

    // identical to QIODevice* code below but the file name
    // makes a difference when it comes to saving pixmaps
    if (qstricmp( format, "svg") == 0) {
  Q3SvgDevice svg;
  QPainter p(&svg);
  if (!play(&p))
      return false;
  svg.setBoundingRect(boundingRect());
  return svg.save(fileName);
    }

    return QPicture::save(fileName, format);
}

Here is the call graph for this function:

---

The documentation for this class was generated from the following files:

• src/qt3support/painting/q3picture.h
• src/qt3support/painting/q3picture.cpp

---