FGX.Camera.TfgCustomCamera: различия между версиями
Admin (обсуждение | вклад) (summary) |
Admin (обсуждение | вклад) (summary) |
||
Строка 47: | Строка 47: | ||
<p>Асинхронно выполняет запрос на получение фотографии с камеры с максимально допустимым размером <i>MaxFrameSize</i> и сохраняет фотографию в битмап <i>ABtmap</i> . Если фотография успешно снята, то вызывается событие <i>OnCaptureReady</i> , в противном случае - <i>OnCaptureError</i> .</p><div class="info">Битмап имеет ограничение на максимально допустимый размер, поэтому перед вызовом метода убедитесь, что <i>ARequiredSize</i> согласован с <i>TfgBitmap.MaxSize</i> .</div> | <p>Асинхронно выполняет запрос на получение фотографии с камеры с максимально допустимым размером <i>MaxFrameSize</i> и сохраняет фотографию в битмап <i>ABtmap</i> . Если фотография успешно снята, то вызывается событие <i>OnCaptureReady</i> , в противном случае - <i>OnCaptureError</i> .</p><div class="info">Битмап имеет ограничение на максимально допустимый размер, поэтому перед вызовом метода убедитесь, что <i>ARequiredSize</i> согласован с <i>TfgBitmap.MaxSize</i> .</div> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">procedure</syntaxhighlight> || <code lang="Delphi">RequestPermission()</code> | ||
+ | |||
+ | <p>Запрос авторизации для доступа к камере.</p><div class="info">Запрос асинхронный. Результат возвращается в событии <i>OnPermissionRequestCompleted</i> .</div> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">AuthorizationStatus(): [[FGX.Permissions.TfgPermissionCheckResult|TfgPermissionCheckResult]]</code> | ||
+ | <p>Возвращает статус авторизации доступа к камере.</p> | ||
|} | |} | ||
Строка 79: | Строка 86: | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCameraSelect: [[TOnCameraSelectEvent]]</code> | + | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCameraSelect: [[TOnCameraSelectEvent|TOnCameraSelectEvent]]</code> |
<p>Срабатывает, когда камеры уже выбраны согласно указанным настройкам.</p><div class="info">Согласно указанным настройкам компонент может выбрать более, чем одну камеру. В этом случае, компонент по умолчанию выбирает первую из списка. При помощи этого события вы можете скорректировать выбор камеры.</div> | <p>Срабатывает, когда камеры уже выбраны согласно указанным настройкам.</p><div class="info">Согласно указанным настройкам компонент может выбрать более, чем одну камеру. В этом случае, компонент по умолчанию выбирает первую из списка. При помощи этого события вы можете скорректировать выбор камеры.</div> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnError: [[TOnCameraErrorEvent]]</code> | + | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnError: [[TOnCameraErrorEvent|TOnCameraErrorEvent]]</code> |
<p>Вызвается, когда в камере возникает ошибка.</p> | <p>Вызвается, когда в камере возникает ошибка.</p> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnStateChanged: [[TOnCameraStateChangedEvent]]</code> | + | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnStateChanged: [[TOnCameraStateChangedEvent|TOnCameraStateChangedEvent]]</code> |
<p>Вызывается, когда камера меняет свое состояние.</p> | <p>Вызывается, когда камера меняет свое состояние.</p> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCapturePhotoError: [[TOnCameraCapturePhotoErrorEvent]]</code> | + | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCapturePhotoError: [[TOnCameraCapturePhotoErrorEvent|TOnCameraCapturePhotoErrorEvent]]</code> |
<p>Вызывается, если в процессе получения фотографии с камеры возникла ошибка.</p> | <p>Вызывается, если в процессе получения фотографии с камеры возникла ошибка.</p> | ||
|- | |- | ||
− | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCapturePhotoReady: [[TOnCameraCapturePhotoReadyEvent]]</code> | + | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnCapturePhotoReady: [[TOnCameraCapturePhotoReadyEvent|TOnCameraCapturePhotoReadyEvent]]</code> |
<p>Вызывается, когда фотография получена с камеры.</p> | <p>Вызывается, когда фотография получена с камеры.</p> | ||
+ | |- | ||
+ | | <syntaxhighlight lang="Delphi">event</syntaxhighlight> || <code>OnPermissionRequestCompleted: [[TfgPermissionResultEvent|TfgPermissionResultEvent]]</code> | ||
+ | <p>Вызывается, когда получен ответ на запрос об авторизации на использование камеры.</p> | ||
|} | |} | ||
Текущая версия на 17:14, 23 декабря 2022
Delphi
TfgCustomCamera = class (TComponent)
Прямые наследники: TfgCamera
Содержание
Описание
Компонент доступа к камере устройства. Позволяет выбрать камеру наилучшим образом согласно настройкам.
Ограничение: можно использовать только один компонент с Active.True в рамках всего приложения.
Камера автоматически отключается, когда приложение уходит в фон и заново восстанавливает свою работу, когда приложение выходит на передний план.
Конструкторы
constructor
|
Create(AOwner: TComponent)
Описание отсутствует. |
Методы
procedure
|
AttachClient(const APreview: IFGXCameraClient)
Прикрепляет к текущей камере контрол для вывода превью. К одной камере можно прикреплять несколько потребителей кадров.
|
procedure
|
DetachClient(const APreview: IFGXCameraClient)
Отвязывает прикрепленный для превью контрол. |
procedure
|
DetachClients()
Отвязывает все прикрепленные клиенты. |
function
|
GetTheBestSize(const AFrameType: TfgFrameType; const AWishesSize: TSize): TSize
Возвращает наилучший размер кадра камеры (из списка доступных конфигураций камеры) на основании желаемого размера AWishesSize . |
procedure
|
CapturePhotoAsync(const AFileName: string)
Асинхронно выполняет запрос на получение фотографии с камеры с максимально допустимым размером MaxFrameSize и сохраняет фотографию в файл AFileName . Если фотография успешно снята, то вызывается событие OnCaptureReady , в противном случае - OnCaptureError . Обязательно убедитесь, что ваше приложение имеет доступ к месторасположению вашего будущего файла фотографии AFileName .
|
procedure
|
CapturePhotoAsync(const ABtmap: TfgBitmap)
Асинхронно выполняет запрос на получение фотографии с камеры с максимально допустимым размером MaxFrameSize и сохраняет фотографию в битмап ABtmap . Если фотография успешно снята, то вызывается событие OnCaptureReady , в противном случае - OnCaptureError . Битмап имеет ограничение на максимально допустимый размер, поэтому перед вызовом метода убедитесь, что ARequiredSize согласован с TfgBitmap.MaxSize .
|
procedure
|
RequestPermission()
Запрос авторизации для доступа к камере. Запрос асинхронный. Результат возвращается в событии OnPermissionRequestCompleted .
|
function
|
AuthorizationStatus(): TfgPermissionCheckResult
Возвращает статус авторизации доступа к камере. |
Свойства
property
|
NativeCamera: IFGXCamera
Доступ к выбранной камере. Может вернуть nil , если ни одна камера не подходит под заданные настройки. Возвращает null, если камера не запущена.
|
property
|
Active: Boolean
True - камера запускается/запущена. False - камера остановлена. |
property
|
CameraType: TfgCameraType
Необходимый тип камеры. |
property
|
FlashMode: TfgCameraFlashMode
Режим работы вспышки камеры в момент съемки изображения. |
property
|
TorchMode: TfgCameraTorchMode
Режим работы вспышки камеры в режиме работы предпросмотра. Данное свойство не работает в процессе съемки фотографии.
|
property
|
MaxFrameSize: TfgIntegerSize
Необходимый максимально допустимый размер кадров, которые генерирует камера. Если указано значени 0 для щирины и/или высоты, то это означает, что соответствующий размер не имеет ограничения.
|
События
event
|
OnCameraSelect: TOnCameraSelectEvent
Срабатывает, когда камеры уже выбраны согласно указанным настройкам. Согласно указанным настройкам компонент может выбрать более, чем одну камеру. В этом случае, компонент по умолчанию выбирает первую из списка. При помощи этого события вы можете скорректировать выбор камеры.
|
event
|
OnError: TOnCameraErrorEvent
Вызвается, когда в камере возникает ошибка. |
event
|
OnStateChanged: TOnCameraStateChangedEvent
Вызывается, когда камера меняет свое состояние. |
event
|
OnCapturePhotoError: TOnCameraCapturePhotoErrorEvent
Вызывается, если в процессе получения фотографии с камеры возникла ошибка. |
event
|
OnCapturePhotoReady: TOnCameraCapturePhotoReadyEvent
Вызывается, когда фотография получена с камеры. |
event
|
OnPermissionRequestCompleted: TfgPermissionResultEvent
Вызывается, когда получен ответ на запрос об авторизации на использование камеры. |
Константы
const
|
UndefinedFrameSize: Integer
Описание отсутствует. |
const
|
DefaultActive: Boolean
Описание отсутствует. |
const
|
DefaultCameraType: TfgCameraType
Описание отсутствует. |
const
|
DefaultFlashMode: TfgCameraFlashMode
Описание отсутствует. |
const
|
DefaultTorchMode: TfgCameraTorchMode
Описание отсутствует. |