QImageWriter Class Reference翻訳
5558 ワード
QImageWriter Class Reference
このクラスは、画像をファイルまたは他のデバイスに書き込むために、フォーマットされた独立したインタフェースを提供します.
#include
共通のタイプ:
enum
ImageWriterError { DeviceError, UnsupportedFormatError, UnknownError }
共通関数:
QImageWriter ()
QImageWriter ( QIODevice * device, const QByteArray & format )
QImageWriter ( const QString & fileName, const QByteArray & format = QByteArray() )
~QImageWriter ()
bool
canWrite () const
int
compression () const
QIODevice *
device () const
ImageWriterError
error () const
QString
errorString () const
QString
fileName () const
QByteArray
format () const
float
gamma () const
int
quality () const
void
setCompression ( int compression )
void
setDevice ( QIODevice * device )
void
setFileName ( const QString & fileName )
void
setFormat ( const QByteArray & format )
void
setGamma ( float gamma )
void
setQuality ( int quality )
void
setText ( const QString & key, const QString & text )
bool
supportsOption ( QImageIOHandler::ImageOptionoption ) const
bool
write ( const QImage & image )
静的共通関数:
QList
supportedImageFormats ()
詳細:
このクラスは、ピクチャを格納する前に、差分係数レベル、圧縮レベル、品質などのフォーマット特別オプションを設定することをサポートします.これらのオプションが必要でない場合は、QImage::save()またはQpixmap::save()を使用して置き換えることができます.
画像を格納するために、QImageWriterオブジェクトを構築し始めます.ファイル名またはデバイスポインタ、および画像フォーマットをQImageWriterのコンストラクタに渡します.ギャップ係数(setGamma()や質量(setQuality()など)のようなオプションを設定することができます.canWirte()関数は真を返し、QImageWriterがピクチャを書くことができれば(すなわち、ピクチャフォーマットはサポートされ、デバイスは開くことができて書き込むことができる).write()関数を呼び出してデバイスに画像を書きます.
エラーが発生した場合は、画像を書くときに.Write()はエラーを返します.次にerror()関数を呼び出して、発生したエラータイプを見つけるか、errorString()関数を呼び出して、読み取り可能なエラー記述を得ることができます.
supportedImageFormat()関数を呼び出して、QImageWriterが読めるフォーマットリストにします.QImageWriterは、すべての内蔵画像フォーマットをサポートし、書き込みをサポートする画像フォーマットプラグインもあります.
メンバー・タイプ・ファイル:
列挙記述エラーは、QImageWriterを使用して画像を書き込むときに発生するエラーです.
Constant
Value
Description
QImageWriter::DeviceError
1
QImageWriter encountered a device error when writing the image data. Consult your device for more details on what went wrong.
QImageWriter::UnsupportedFormatError
2
Qt does not support the requested image format.
QImageWriter::UnknownError
0
An unknown error occurred. If you get this value after callingwrite(), it is most likely caused by a bug in QImageWriter.
メンバー関数ファイル:
QImageWriterオブジェクトを作成します.書き込む前にsetFormat()関数を呼び出して画像フォーマットを設定し、setDevice()またはsetFileName()を設定する必要があります.
画像の圧縮方法を返します.
compressionは、異なるピクチャフォーマットによって、この値が異なります.たとえばフォーマットがtiffの場合、0と1を設定できます.
QImageWriter writer;
writer.setFormat("png");//same as writer.setFormat("PNG");
gammaは、異なるピクチャフォーマットによって、この値が異なります.たとえば、フォーマットがpngの場合、0.0と0.1を設定できます.
qualityは、異なるピクチャフォーマットによって、この値が異なります.たとえばjpeg形式の場合、0と100を設定できます.
これは、著作権情報やその他の情報を格納するのに役立ちます.
Format
Description
BMP
Windows Bitmap
JPG
Joint Photographic Experts Group
JPEG
Joint Photographic Experts Group
PNG
Portable Network Graphics
PPM
Portable Pixmap
TIFF
Tagged Image File Format
XBM
X11 Bitmap
XPM
X11 Pixmap
このクラスは、画像をファイルまたは他のデバイスに書き込むために、フォーマットされた独立したインタフェースを提供します.
#include
共通のタイプ:
enum
ImageWriterError { DeviceError, UnsupportedFormatError, UnknownError }
共通関数:
QImageWriter ()
QImageWriter ( QIODevice * device, const QByteArray & format )
QImageWriter ( const QString & fileName, const QByteArray & format = QByteArray() )
~QImageWriter ()
bool
canWrite () const
int
compression () const
QIODevice *
device () const
ImageWriterError
error () const
QString
errorString () const
QString
fileName () const
QByteArray
format () const
float
gamma () const
int
quality () const
void
setCompression ( int compression )
void
setDevice ( QIODevice * device )
void
setFileName ( const QString & fileName )
void
setFormat ( const QByteArray & format )
void
setGamma ( float gamma )
void
setQuality ( int quality )
void
setText ( const QString & key, const QString & text )
bool
supportsOption ( QImageIOHandler::ImageOptionoption ) const
bool
write ( const QImage & image )
静的共通関数:
QList
supportedImageFormats ()
詳細:
このクラスは、ピクチャを格納する前に、差分係数レベル、圧縮レベル、品質などのフォーマット特別オプションを設定することをサポートします.これらのオプションが必要でない場合は、QImage::save()またはQpixmap::save()を使用して置き換えることができます.
画像を格納するために、QImageWriterオブジェクトを構築し始めます.ファイル名またはデバイスポインタ、および画像フォーマットをQImageWriterのコンストラクタに渡します.ギャップ係数(setGamma()や質量(setQuality()など)のようなオプションを設定することができます.canWirte()関数は真を返し、QImageWriterがピクチャを書くことができれば(すなわち、ピクチャフォーマットはサポートされ、デバイスは開くことができて書き込むことができる).write()関数を呼び出してデバイスに画像を書きます.
エラーが発生した場合は、画像を書くときに.Write()はエラーを返します.次にerror()関数を呼び出して、発生したエラータイプを見つけるか、errorString()関数を呼び出して、読み取り可能なエラー記述を得ることができます.
supportedImageFormat()関数を呼び出して、QImageWriterが読めるフォーマットリストにします.QImageWriterは、すべての内蔵画像フォーマットをサポートし、書き込みをサポートする画像フォーマットプラグインもあります.
メンバー・タイプ・ファイル:
enum QImageWriter::ImageWriterError
列挙記述エラーは、QImageWriterを使用して画像を書き込むときに発生するエラーです.
Constant
Value
Description
QImageWriter::DeviceError
1
QImageWriter encountered a device error when writing the image data. Consult your device for more details on what went wrong.
QImageWriter::UnsupportedFormatError
2
Qt does not support the requested image format.
QImageWriter::UnknownError
0
An unknown error occurred. If you get this value after callingwrite(), it is most likely caused by a bug in QImageWriter.
メンバー関数ファイル:
QImageWriter::QImageWriter ()
QImageWriterオブジェクトを作成します.書き込む前にsetFormat()関数を呼び出して画像フォーマットを設定し、setDevice()またはsetFileName()を設定する必要があります.
QImageWriter::QImageWriter( QIODevice * device,const QByteArray &format )
QImageWriter::QImageWriter ( const QString & fileName, const QByteArray& format = QByteArray() )
QImageWriter::~QImageWriter ()
bool QImageWriter::canWrite () const
int QImageWriter::compression () const
画像の圧縮方法を返します.
QIODevice * QImageWriter::device () const
ImageWriterError QImageWriter::error () const
QString QImageWriter::errorString () const
QString QImageWriter::fileName () const
QByteArray QImageWriter::format () const
float QImageWriter::gamma () const
int QImageWriter::quality () const
void QImageWriter::setCompression ( int compression )
compressionは、異なるピクチャフォーマットによって、この値が異なります.たとえばフォーマットがtiffの場合、0と1を設定できます.
void QImageWriter::setDevice ( QIODevice * device )
void QImageWriter::setFileName ( const QString & fileName )
void QImageWriter::setFormat ( const QByteArray & format )
QImageWriter writer;
writer.setFormat("png");//same as writer.setFormat("PNG");
void QImageWriter::setGamma ( float gamma )
gammaは、異なるピクチャフォーマットによって、この値が異なります.たとえば、フォーマットがpngの場合、0.0と0.1を設定できます.
void QImageWriter::setQuality ( int quality )
qualityは、異なるピクチャフォーマットによって、この値が異なります.たとえばjpeg形式の場合、0と100を設定できます.
void QImageWriter::setText ( const QString & key, const QString & text )
これは、著作権情報やその他の情報を格納するのに役立ちます.
QImage image("some/image.jpeg");
QImageWriter writer("images/outimage.png", "png");
writer.setText("Author", "John Smith");
writer.write(image);
QList<QByteArray> QImageWriter::supportedImageFormats () [static]
Format
Description
BMP
Windows Bitmap
JPG
Joint Photographic Experts Group
JPEG
Joint Photographic Experts Group
PNG
Portable Network Graphics
PPM
Portable Pixmap
TIFF
Tagged Image File Format
XBM
X11 Bitmap
XPM
X11 Pixmap