QCamera Class
QCameraクラスは、システム・カメラ・デバイス用のインターフェースを提供します。詳細...
| Header: | #include <QCamera> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
| In QML: | Camera |
| Inherits: | QObject |
パブリック・タイプ
| enum | Error { NoError, CameraError } |
| enum | ExposureMode { ExposureAuto, ExposureManual, ExposurePortrait, ExposureNight, ExposureSports, …, ExposureBarcode } |
| enum class | Feature { ColorTemperature, ExposureCompensation, IsoSensitivity, ManualExposureTime, CustomFocusPoint, FocusDistance } |
| flags | Features |
| enum | FlashMode { FlashOff, FlashOn, FlashAuto } |
| enum | FocusMode { FocusModeAuto, FocusModeAutoNear, FocusModeAutoFar, FocusModeHyperfocal, FocusModeInfinity, FocusModeManual } |
| enum | TorchMode { TorchOff, TorchOn, TorchAuto } |
| enum | WhiteBalanceMode { WhiteBalanceAuto, WhiteBalanceManual, WhiteBalanceSunlight, WhiteBalanceCloudy, WhiteBalanceShade, …, WhiteBalanceSunset } |
プロパティ
|
|
パブリック関数
| QCamera(QObject *parent = nullptr) | |
| QCamera(QCameraDevice::Position position, QObject *parent = nullptr) | |
| QCamera(const QCameraDevice &cameraDevice, QObject *parent = nullptr) | |
| virtual | ~QCamera() |
| QCameraDevice | cameraDevice() const |
| QCameraFormat | cameraFormat() const |
| QMediaCaptureSession * | captureSession() const |
| int | colorTemperature() const |
| QPointF | customFocusPoint() const |
| QCamera::Error | error() const |
| QString | errorString() const |
| float | exposureCompensation() const |
| QCamera::ExposureMode | exposureMode() const |
| float | exposureTime() const |
| QCamera::FlashMode | flashMode() const |
| float | focusDistance() const |
| QCamera::FocusMode | focusMode() const |
| QPointF | focusPoint() const |
| bool | isActive() const |
| bool | isAvailable() const |
| bool | isExposureModeSupported(QCamera::ExposureMode mode) const |
| bool | isFlashModeSupported(QCamera::FlashMode mode) const |
| bool | isFlashReady() const |
| bool | isFocusModeSupported(QCamera::FocusMode mode) const |
| bool | isTorchModeSupported(QCamera::TorchMode mode) const |
| bool | isWhiteBalanceModeSupported(QCamera::WhiteBalanceMode mode) const |
| int | isoSensitivity() const |
| float | manualExposureTime() const |
| int | manualIsoSensitivity() const |
| float | maximumExposureTime() const |
| int | maximumIsoSensitivity() const |
| float | maximumZoomFactor() const |
| float | minimumExposureTime() const |
| int | minimumIsoSensitivity() const |
| float | minimumZoomFactor() const |
| void | setCameraDevice(const QCameraDevice &cameraDevice) |
| void | setCameraFormat(const QCameraFormat &format) |
| void | setCustomFocusPoint(const QPointF &point) |
| void | setFocusDistance(float d) |
| void | setFocusMode(QCamera::FocusMode mode) |
| void | setZoomFactor(float factor) |
| QCamera::Features | supportedFeatures() const |
| QCamera::TorchMode | torchMode() const |
| QCamera::WhiteBalanceMode | whiteBalanceMode() const |
| float | zoomFactor() const |
パブリックスロット
| void | setActive(bool active) |
| void | setAutoExposureTime() |
| void | setAutoIsoSensitivity() |
| void | setColorTemperature(int colorTemperature) |
| void | setExposureCompensation(float ev) |
| void | setExposureMode(QCamera::ExposureMode mode) |
| void | setFlashMode(QCamera::FlashMode mode) |
| void | setManualExposureTime(float seconds) |
| void | setManualIsoSensitivity(int iso) |
| void | setTorchMode(QCamera::TorchMode mode) |
| void | setWhiteBalanceMode(QCamera::WhiteBalanceMode mode) |
| void | start() |
| void | stop() |
| void | zoomTo(float factor, float rate) |
シグナル
| void | activeChanged(bool) |
| void | cameraDeviceChanged() |
| void | cameraFormatChanged() |
| void | colorTemperatureChanged() const |
| void | customFocusPointChanged() |
| void | errorChanged() |
| void | errorOccurred(QCamera::Error error, const QString &errorString) |
| void | exposureCompensationChanged(float value) |
| void | exposureModeChanged() |
| void | exposureTimeChanged(float speed) |
| void | flashModeChanged() |
| void | flashReady(bool ready) |
| void | focusDistanceChanged(float) |
| void | focusModeChanged() |
| void | focusPointChanged() |
| void | isoSensitivityChanged(int value) |
| void | manualExposureTimeChanged(float speed) |
| void | manualIsoSensitivityChanged(int) |
| void | maximumZoomFactorChanged(float) |
| void | minimumZoomFactorChanged(float) |
| void | supportedFeaturesChanged() |
| void | torchModeChanged() |
| void | whiteBalanceModeChanged() const |
| void | zoomFactorChanged(float) |
詳細説明
QCameraはQMediaCaptureSession 、ビデオ録画や画像撮影に使用できます。
QCameraDevice 、使用可能なカメラを一覧表示し、使用するカメラを選択できます。
const QList<QCameraDevice> cameras = QMediaDevices::videoInputs(); for (const QCameraDevice &cameraDevice : cameras) { if (cameraDevice.description() == "mycamera") camera = new QCamera(cameraDevice); }
QCameraをサポートしているハードウェアでは、フォーカスとズームを調整できます。また、近接作業（バーコードの読み取りや文字の認識など）用の「マクロ」モードや、「タッチでフォーカス」（ハードウェアがフォーカスを合わせようとする画像の興味深い部分を示す）などの機能もあります。
camera->setFocusPointMode(QCamera::FocusModeManual); camera->setCustomFocusPoint(QPointF(0.25f, 0.75f)); // A point near the bottom left, 25% away from the corner, near that shiny vase
minimumZoomFactor() およびmaximumZoomFactor() メソッドは、サポートされるズーム倍率の範囲を提供します。zoomTo() メソッドでは、ズーム倍率を変更することができる。
camera->setZoomFactor(3.0);
カメラフレームの生データをキャプチャした後、カメラのハードウェアとソフトウェアはさまざまな画像処理タスクを実行し、最終的な画像を生成します。この処理には、環境光の色の補正、ノイズの低減、画像の調整などが含まれます。
これらの処理手順の多くは、[カメラ] プロパティで制御できます。たとえば、画像の処理に使用するホワイトバランス（または色温度）を設定できます：
camera->setWhiteBalanceMode(QCamera::WhiteBalanceFluorescent);
カメラフレームの画像処理の詳細については、カメラの画像処理を参照してください。
詳細については、カメラの概要を参照してください。
メンバ型ドキュメント
enum QCamera::Error
この列挙型は、最後のエラーコードを保持します。
| 定数 | 値 | 説明 |
|---|---|---|
QCamera::NoError | 0 | エラーは発生していません。 |
QCamera::CameraError | 1 | エラーが発生しました。 |
enum QCamera::ExposureMode
| 定数 | 値 | 説明 |
|---|---|---|
QCamera::ExposureAuto | 0 | 自動モード |
QCamera::ExposureManual | 1 | マニュアルモード |
QCamera::ExposurePortrait | 2 | ポートレート露出モード。 |
QCamera::ExposureNight | 3 | ナイトモード。 |
QCamera::ExposureSports | 4 | スポット露光モード。 |
QCamera::ExposureSnow | 5 | 雪の露出モード |
QCamera::ExposureBeach | 6 | ビーチ露出モード |
QCamera::ExposureAction | 7 | アクションモード5.5以降 |
QCamera::ExposureLandscape | 8 | 風景モード。5.5以降 |
QCamera::ExposureNightPortrait | 9 | 夜景ポートレートモード。5.5から |
QCamera::ExposureTheatre | 10 | シアターモード。5.5から |
QCamera::ExposureSunset | 11 | サンセットモード。5.5以降 |
QCamera::ExposureSteadyPhoto | 12 | 静止画モード。5.5から |
QCamera::ExposureFireworks | 13 | 花火モード。5.5から |
QCamera::ExposureParty | 14 | パーティーモード。5.5から |
QCamera::ExposureCandlelight | 15 | キャンドルライトモード。5.5から |
QCamera::ExposureBarcode | 16 | バーコードモード。5.5から |
enum class QCamera::Feature
flags QCamera::Featuresカメラがサポートする機能のセット。
カメラがサポートする機能のセットを記述します。返される値は以下の組み合わせです：
| 定数 | 値 | 説明 |
|---|---|---|
QCamera::Feature::ColorTemperature | 0x1 | カメラはカスタムcolorTemperature の設定をサポートしています。 |
QCamera::Feature::ExposureCompensation | 0x2 | カメラはカスタムexposureCompensation の設定をサポートしています。 |
QCamera::Feature::IsoSensitivity | 0x4 | カメラはカスタムisoSensitivity の設定をサポートしています。 |
QCamera::Feature::ManualExposureTime | 0x8 | カメラはmanual exposure Time の設定をサポートしています。 |
QCamera::Feature::CustomFocusPoint | 0x10 | カメラがcustom focus point の設定をサポートします。 |
QCamera::Feature::FocusDistance | 0x20 | Camera はfocusDistance プロパティの設定に対応しています。 |
Features型はQFlags<Feature>のtypedefです。これは、Feature値のORの組み合わせを格納します。
enum QCamera::FlashMode
| 定数 | 値 | 説明 |
|---|---|---|
QCamera::FlashOff | 0 | フラッシュはオフ |
QCamera::FlashOn | 1 | フラッシュがオン |
QCamera::FlashAuto | 2 | 自動フラッシュ |
enum QCamera::FocusMode
| 一定 | 値 | 説明 |
|---|---|---|
QCamera::FocusModeAuto | 0 | 連続オートフォーカスモード。 |
QCamera::FocusModeAutoNear | 1 | 近くの被写体に対する連続オートフォーカスモード。 |
QCamera::FocusModeAutoFar | 2 | 遠くの物体に対する連続オートフォーカスモード。 |
QCamera::FocusModeHyperfocal | 3 | 被写界深度を最大にして、超焦点距離までピントを合わせます。被写界深度が最大になるように、超焦点距離までピントを合わせます。 |
QCamera::FocusModeInfinity | 4 | 厳密に無限遠にピントを合わせる。 |
QCamera::FocusModeManual | 5 | マニュアルまたは固定フォーカスモード。 |
enum QCamera::TorchMode
| 一定 | 値 | 説明 |
|---|---|---|
QCamera::TorchOff | 0 | トーチがオフ |
QCamera::TorchOn | 1 | トーチがオン |
QCamera::TorchAuto | 2 | 自動トーチ |
enum QCamera::WhiteBalanceMode
| 一定 | 値 | 説明 |
|---|---|---|
QCamera::WhiteBalanceAuto | 0 | オートホワイトバランスモード。 |
QCamera::WhiteBalanceManual | 1 | マニュアルホワイトバランス。このモードでは、ホワイトバランスはsetColorTemperature() で設定する必要があります。 |
QCamera::WhiteBalanceSunlight | 2 | 太陽光ホワイトバランスモード。 |
QCamera::WhiteBalanceCloudy | 3 | 曇天ホワイトバランスモード。 |
QCamera::WhiteBalanceShade | 4 | 日陰ホワイトバランスモード。 |
QCamera::WhiteBalanceTungsten | 5 | タングステン（白熱灯）ホワイトバランスモード。 |
QCamera::WhiteBalanceFluorescent | 6 | 蛍光灯ホワイトバランスモード |
QCamera::WhiteBalanceFlash | 7 | フラッシュホワイトバランスモード |
QCamera::WhiteBalanceSunset | 8 | 夕焼けホワイトバランスモード |
プロパティ記録
active : bool
カメラが現在アクティブであるかどうかを記述する。
アクセス機能
通知シグナル：
| void | activeChanged(bool) |
cameraDevice : QCameraDevice
このカメラに関連付けられているQCameraDevice オブジェクトを返します。
アクセス関数
| QCameraDevice | cameraDevice() const |
| void | setCameraDevice(const QCameraDevice &cameraDevice) |
ノーティファイアシグナル：
| void | cameraDeviceChanged() |
cameraFormat : QCameraFormat
このカメラが現在使用しているカメラフォーマットを返します。
注意： Android ターゲットデバイスで FFMPEG バックエンドを使用する場合、YUV420Pフォーマットを要求すると、フルプレーナ 4:2:0 YUV420P またはセミプレーナ NV12/NV21 のいずれかが返されます。これは、デバイスOEMによって実装されたコーデックに依存します。
アクセス機能
| QCameraFormat | cameraFormat() const |
| void | setCameraFormat(const QCameraFormat &format) |
通知信号：
| void | cameraFormatChanged() |
QCameraDevice::videoFormatsも参照 。
colorTemperature : int
現在のホワイトバランスモードがWhiteBalanceManual の場合、現在の色温度を返す。その他のモードの場合、戻り値は未定義である。
アクセス関数：
| int | colorTemperature() const |
| void | setColorTemperature(int colorTemperature) |
ノーティファイアシグナル：
| void | colorTemperatureChanged() const |
customFocusPoint : QPointF
このプロパティは、カスタムフォーカスポイントの位置を、相対フレーム座標で表す。QPointF(0,0) は左上フレームポイントを指し、QPointF(0.5,0.5) はフレームセンターを指す。
カスタムフォーカスポイントプロパティはFocusPointCustom フォーカスモードでのみ使用されます。
カスタム・フォーカス・ポイントがサポートされているかどうかは、supportedFeatures() に Feature.CustomFocusPoint フラグを付けて問い合わせることで確認できます。
アクセス関数：
| QPointF | customFocusPoint() const |
| void | setCustomFocusPoint(const QPointF &point) |
通知シグナル：
| void | customFocusPointChanged() |
[read-only] error : const Error
カメラのエラー状態を返します。
アクセス関数：
| QCamera::Error | error() const |
Notifierシグナル：カメラのエラー状態を返します：
| void | errorChanged() |
[read-only] errorString : const QString
カメラのエラー状態を説明する可読文字列を返します。
アクセス関数
| QString | errorString() const |
ノーティファイアシグナル
| void | errorChanged() |
exposureCompensation : float
EV単位の露出補正。
露出補正プロパティにより、自動計算された露出を調整することができる。
アクセス関数：
| float | exposureCompensation() const |
| void | setExposureCompensation(float ev) |
通知信号：露出補正値をEV単位で示す：
| void | exposureCompensationChanged(float value) |
exposureMode : QCamera::ExposureMode
使用中の露出モードを保持する。
アクセス機能
| QCamera::ExposureMode | exposureMode() const |
| void | setExposureMode(QCamera::ExposureMode mode) |
アクセス関数：ノーティファイア信号：
| void | exposureModeChanged() |
QCamera::isExposureModeSupportedも参照 。
[read-only] exposureTime : const float
カメラの露光時間（秒）。
アクセス関数：
| float | exposureTime() const |
ノーティファイア信号：
| void | exposureTimeChanged(float speed) |
minimumExposureTime （）、maximumExposureTime （）、setManualExposureTime （）も参照 。
flashMode : QCamera::FlashMode
このプロパティは、使用中のフラッシュモードを保持する。
カメラにフラッシュがある場合、特定のフラッシュモードを有効にする。
アクセス関数：
| QCamera::FlashMode | flashMode() const |
| void | setFlashMode(QCamera::FlashMode mode) |
通知シグナル：
| void | flashModeChanged() |
QCamera::FlashMode 、QCamera::isFlashModeSupported 、QCamera::isFlashReadyも参照 。
[read-only] flashReady : const bool
フラッシュが充電され、使用可能な状態であることを示す。
アクセス機能：
| bool | isFlashReady() const | [see note below] |
注意： この関数は、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
通知信号：
| void | flashReady(bool ready) |
focusDistance : float
このプロパティは、カメラのおおよそのフォーカス距離を返す。報告される値は 0 から 1 の間で、0 は可能な限り近いフォーカス距離、1 は可能な限り遠いフォーカス距離です。1 は無限遠であることが多いが、常に無限遠とは限らないことに注意。
フォーカスモードがFocusModeManual に設定されていない限り、フォーカス距離の設定は無視されます。
アクセス機能：
| float | focusDistance() const |
| void | setFocusDistance(float d) |
通知信号：
| void | focusDistanceChanged(float) |
focusMode : FocusMode
このプロパティは、現在のカメラのフォーカスモードを保持する。
カメラの異なるフォーカスモードを設定します。すべてのオートフォーカスモードは、連続的にフォーカスを合わせます。フォーカスモードをFocusModeManual に設定することで、フォーカスをロックすることが可能です。 これは現在のフォーカスを保持し、自動フォーカスを停止します。
アクセス機能：
| QCamera::FocusMode | focusMode() const |
| void | setFocusMode(QCamera::FocusMode mode) |
通知信号：
| void | focusModeChanged() |
isFocusModeSupportedも参照 。
[read-only] focusPoint : const QPointF
オートフォーカスシステムが現在フォーカスに使用しているポイントを返します。
アクセス関数：
| QPointF | focusPoint() const |
通知信号：
| void | focusPointChanged() |
[read-only] isoSensitivity : const int
このプロパティはセンサーの ISO 感度を保持する。
カメラが現在使用している ISO 感度を表す。
アクセス関数：
| int | isoSensitivity() const |
アクセス関数：Notifier signal: このプロパティはセンサーのISO感度を保持する：
| void | isoSensitivityChanged(int value) |
setAutoIsoSensitivity() およびsetManualIsoSensitivity()も参照 。
manualExposureTime : int
マニュアル露光時間を設定します。seconds
アクセス機能：
| float | manualExposureTime() const |
| void | setManualExposureTime(float seconds) |
通知信号：
| void | manualExposureTimeChanged(float speed) |
manualIsoSensitivity : int
手動で設定されたISO感度について説明します。
このプロパティを-1（デフォルト）に設定すると、カメラは自動的にISO感度を調整します。
アクセス機能
| int | manualIsoSensitivity() const |
| void | setManualIsoSensitivity(int iso) |
通知信号：
| void | manualIsoSensitivityChanged(int) |
[read-only] maximumZoomFactor : const float
最大ズーム倍率を返します。
ズームに対応していないカメラでは、1.0 。
アクセス関数：
| float | maximumZoomFactor() const |
通知シグナル：
| void | maximumZoomFactorChanged(float) |
[read-only] minimumZoomFactor : const float
最小ズーム倍率を返します。
ズームに対応していないカメラでは1.0 になります。
アクセス関数：
| float | minimumZoomFactor() const |
通知シグナル
| void | minimumZoomFactorChanged(float) |
[read-only] supportedFeatures : const Features
このカメラがサポートする機能を返します。
アクセス関数：
| QCamera::Features | supportedFeatures() const |
Notifier signal: このカメラでサポートされている機能を返します：
| void | supportedFeaturesChanged() |
QCamera::Featureも参照 。
torchMode : QCamera::TorchMode
このプロパティは、使用中のトーチモードを保持する。
トーチは連続光源です。暗い場所でのビデオ撮影時に使用できます。トーチモードを有効にすると、通常、現在設定されているフラッシュモードが上書きされます。
アクセス機能：
| QCamera::TorchMode | torchMode() const |
| void | setTorchMode(QCamera::TorchMode mode) |
通知信号：
| void | torchModeChanged() |
QCamera::TorchMode 、QCamera::isTorchModeSupported 、QCamera::flashModeも参照 。
whiteBalanceMode : WhiteBalanceMode
使用中のホワイトバランスモードを返します。
アクセス関数：
| QCamera::WhiteBalanceMode | whiteBalanceMode() const |
| void | setWhiteBalanceMode(QCamera::WhiteBalanceMode mode) |
アクセス関数：ノーティファイアシグナル：
| void | whiteBalanceModeChanged() const |
zoomFactor : float
このプロパティは現在のズーム倍率を保持する。
現在のズーム倍率を取得または設定する。値はminimumZoomFactor からmaximumZoomFactor の間でクランプされる。
アクセス関数：
| float | zoomFactor() const |
| void | setZoomFactor(float factor) |
通知シグナル：
| void | zoomFactorChanged(float) |
メンバ関数ドキュメント
[explicit] QCamera::QCamera(QObject *parent = nullptr)
QCamera をparent で構築します。
複数のカメラが利用可能な場合、システムのデフォルトカメラを選択します。
[explicit] QCamera::QCamera(QCameraDevice::Position position, QObject *parent = nullptr)
指定されたposition にあるハードウェアカメラを使用する QCamera を構築します。
例えば、携帯電話では、前面カメラと背面カメラを簡単に選択するために使用できます。
指定されたposition にカメラがない場合、またはposition がQCameraDevice::UnspecifiedPosition の場合、デフォルトのカメラが使用されます。
[explicit] QCamera::QCamera(const QCameraDevice &cameraDevice, QObject *parent = nullptr)
カメラ記述cameraDevice およびparent から QCamera を構築します。
[virtual noexcept] QCamera::~QCamera()
カメラオブジェクトを破棄します。
QMediaCaptureSession *QCamera::captureSession() const
このカメラが接続されているキャプチャセッションを返すか、カメラがキャプチャセッションに接続されていない場合はnullptrを返します。
カメラをセッションに接続するにはQMediaCaptureSession::setCamera() を使用します。
[signal] void QCamera::errorOccurred(QCamera::Error error, const QString &errorString)
このシグナルはエラー状態がerror に変化したときに発信されます。エラーの説明はerrorString として提供される。
[signal] void QCamera::exposureCompensationChanged(float value)
露出補正がvalue に変化したときに発せられる信号。
注： プロパティexposureCompensation のノーティファイアシグナル。
float QCamera::exposureTime() const
現在の露光時間を秒単位で返す。
注： プロパティ exposureTime のゲッター関数。
[signal] void QCamera::exposureTimeChanged(float speed)
カメラの露出speed が変更されたことを通知する。
注： プロパティexposureTime に対するノーティファイアシグナル。
[signal] void QCamera::flashReady(bool ready)
フラッシュready の状態が変化したことを示す。
注： プロパティ flashReady に対するノーティファイアシグナル。
[signal] void QCamera::focusModeChanged()
focusMode が変更されたことを示す。
注: プロパティfocusMode に対するノーティファイアシグナル。
bool QCamera::isActive() const
カメラが現在アクティブである場合、true を返す。
注： プロパティactive のゲッター関数。
bool QCamera::isAvailable() const
カメラが使用可能な場合、true を返す。
[invokable] bool QCamera::isExposureModeSupported(QCamera::ExposureMode mode) const
露出mode がサポートされている場合、true を返す。
注 ：この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QCamera::isFlashModeSupported(QCamera::FlashMode mode) const
フラッシュmode がサポートされている場合、true を返します。
注： この関数はメタオブジェクトシステム経由でも QML からも呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QCamera::isFlashReady() const
フラッシュが充電されている場合、true を返します。
注意： この関数は、メタ・オブジェクト・システム経由でも、QML からも呼び出すことができます。Q_INVOKABLE を参照してください。
注： プロパティflashReady のゲッター関数です。
[invokable] bool QCamera::isFocusModeSupported(QCamera::FocusMode mode) const
フォーカスmode がカメラによってサポートされている場合、true を返します。
注 ：この関数は、メタオブジェクトシステム経由および QML から呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QCamera::isTorchModeSupported(QCamera::TorchMode mode) const
トーチmode がサポートされている場合、true を返します。
注意 ：この関数はメタオブジェクトシステム経由でも QML からも呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] bool QCamera::isWhiteBalanceModeSupported(QCamera::WhiteBalanceMode mode) const
ホワイトバランスmode がサポートされている場合、true を返します。
注： この関数は、メタオブジェクトシステム経由および QML から呼び出すことができます。Q_INVOKABLE を参照。
[signal] void QCamera::isoSensitivityChanged(int value)
感度がvalue に変化したときに発せられるシグナル。
注： プロパティisoSensitivity のノーティファイアシグナル。
float QCamera::manualExposureTime() const
マニュアル露光時間を秒単位で返し、カメラが自動露光時間を使用している場合は -1 を返す。
注： プロパティ manualExposureTime のゲッター関数。
setManualExposureTime()も参照 。
float QCamera::maximumExposureTime() const
最大露光時間を秒単位で返す。
int QCamera::maximumIsoSensitivity() const
カメラがサポートする最高ISO感度を返します。
float QCamera::minimumExposureTime() const
最小露光時間（秒）。
int QCamera::minimumIsoSensitivity() const
カメラがサポートする最小 ISO 感度を秒単位で返します。
[slot] void QCamera::setActive(bool active)
active がtrue の場合はカメラをオンにし、false の場合はオフにする。
注： プロパティactive に対するセッター関数。
isActive()も参照 。
[slot] void QCamera::setAutoExposureTime()
自動的に計算された露光時間を使用する
[slot] void QCamera::setAutoIsoSensitivity()
自動感度をオンにする
void QCamera::setCameraDevice(const QCameraDevice &cameraDevice)
カメラオブジェクトをcameraDevice で記述された物理カメラデバイスに接続します。デフォルトで構築されたQCameraDevice オブジェクトをcameraDevice として使用すると、カメラはシステムデフォルトのカメラデバイスに接続されます。
注： cameraDevice プロパティのセッター関数。
cameraDevice()も参照 。
void QCamera::setCameraFormat(const QCameraFormat &format)
format で指定されたフォーマットを使用するようにカメラに指示します。これを使用して、録画と画像キャプチャに使用する特定の解像度とフレームレートを定義できます。
注： Androidターゲット・デバイスでFFMPEGバックエンドを使用する場合、YUV420Pフォーマットを要求すると、完全にプレーナな4:2:0 YUV420Pまたはセミ・プレーナなNV12/NV21のいずれかを受信します。これは、デバイス OEM が実装するコーデックに依存します。
注： cameraFormat プロパティのセッター関数。
cameraFormat()も参照 。
[slot] void QCamera::setColorTemperature(int colorTemperature)
マニュアルホワイトバランスをcolorTemperature に設定します。 これは、whiteBalanceMode() がWhiteBalanceManual に設定されている場合に使用されます。 単位はケルビンです。
色温度を設定すると、WhiteBalanceManual がサポートされている場合にのみ効果があります。この場合、温度を 0 より大きく設定すると、ホワイトバランスモードは自動的にWhiteBalanceManual に設定されます。温度を 0 に設定すると、ホワイトバランスモードはWhiteBalanceAuto にリセットされます。
注： プロパティcolorTemperature に対するセッター関数。
colorTemperature()も参照 。
[slot] void QCamera::setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)
ホワイトバランスをmode に設定する。
注： プロパティwhiteBalanceMode のセッター関数。
whiteBalanceMode()も参照 。
void QCamera::setZoomFactor(float factor)
ズーム倍率factor に、毎秒 1 倍の割合でズームする。
注： プロパティzoomFactor のセッター関数。
zoomFactor() も参照 。
[slot] void QCamera::start()
カメラを起動します。
setActive(true)と同じ。
何らかの理由でカメラを起動できない場合、errorOccurred() シグナルが出力されます。
[slot] void QCamera::stop()
カメラを停止します。setActive(false)と同じ。
[slot] void QCamera::zoomTo(float factor, float rate)
rate を使用して、ズーム倍率factor にズームします。
rate は秒あたりの2の累乗で指定します。レート1の場合、ズーム・ファクター1から4まで2秒かかる。
注： 特定のレートを使用することは、すべてのカメラでサポートされているわけではありません。サポートされていない場合、ズームは可能な限り速く行われます。
本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
