FGX.Camera.TfgCustomCamera
Delphi
TfgCustomCamera = class (TComponent)
Прямые наследники: TfgCamera
Содержание
Описание
Компонент доступа к камере устройства. Позволяет выбрать камеру наилучшим образом согласно настройкам.
Ограничение: можно использовать только один компонент с Active.True в рамках всего приложения.
Камера автоматически отключается, когда приложение уходит в фон и заново восстанавливает свою работу, когда приложение выходит на передний план.
Конструкторы
constructor
|
Create(AOwner: TComponent)
Описание отсутствует. |
Методы
procedure
|
AttachPreview(const APreview: IFGXCameraPreview)
Прикрепляет к текущей камере контрол для вывода превью. К одной камере можно прикреплять несколько потребителей кадров.
|
procedure
|
DetachPreview(const APreview: IFGXCameraPreview)
Отвязывает прикрепленный для превью контрол. |
procedure
|
DetachPreviews()
Отвязывает все прикрепленные для превью контролы. |
function
|
GetTheBestSize(const AFrameType: TfgFrameType; const AWishesSize: TSize): TSize
Возвращает наилучший размер кадра камеры (из списка доступных конфигураций камеры) на основании желаемого размера AWishesSize . |
function
|
GetTheBestSize(const ASizes: [[TArray<System.Types.TSize>]]; const AWishesSize: TSize): TSize
Описание отсутствует. |
procedure
|
CapturePhotoAsync(const AFileName: string)
Асинхронно выполняет запрос на получение фотографии с камеры с максимально допустимым размером MaxFrameSize и сохраняет фотографию в файл AFileName . Если фотография успешно снята, то вызывается событие OnCaptureReady , в противном случае - OnCaptureError . Обязательно убедитесь, что ваше приложение имеет доступ к месторасположению вашего будущего файла фотографии AFileName .
|
procedure
|
CapturePhotoAsync(const ABtmap: TfgBitmap)
Асинхронно выполняет запрос на получение фотографии с камеры с максимально допустимым размером MaxFrameSize и сохраняет фотографию в битмап ABtmap . Если фотография успешно снята, то вызывается событие OnCaptureReady , в противном случае - OnCaptureError . Битмап имеет ограничение на максимально допустимый размер, поэтому перед вызовом метода убедитесь, что ARequiredSize согласован с TfgBitmap.MaxSize .
|
Свойства
property
|
NativeCamera: IFGXCamera
Доступ к выбранной камере. Может вернуть nil , если ни одна камера не подходит под заданные настройки. Возвращает null, если камера не запущена.
|
property
|
Active: Boolean
True - камера запускается/запущена. False - камера остановлена. |
property
|
CameraType: TfgCameraType
Необходимый тип камеры. |
property
|
MaxFrameSize: TfgIntegerSize
Необходимый максимально допустимый размер кадров, которые генерирует камера. Если указано значени 0 для щирины и/или высоты, то это означает, что соответствующий размер не имеет ограничения.
|
События
event
|
OnCameraSelect: TOnCameraSelectEvent
Срабатывает, когда камеры уже выбраны согласно указанным настройкам. Согласно указанным настройкам компонент может выбрать более, чем одну камеру. В этом случае, компонент по умолчанию выбирает первую из списка. При помощи этого события вы можете скорректировать выбор камеры.
|
event
|
OnError: TOnCameraErrorEvent
Вызвается, когда в камере возникает ошибка. |
event
|
OnStateChanged: TOnCameraStateChangedEvent
Вызывается, когда камера меняет свое состояние. |
event
|
OnCapturePhotoError: TOnCameraCapturePhotoErrorEvent
Вызывается, если в процессе получения фотографии с камеры возникла ошибка. |
event
|
OnCapturePhotoReady: TOnCameraCapturePhotoReadyEvent
Вызывается, когда фотография получена с камеры. |
Константы
const
|
UndefinedFrameSize: Integer
Описание отсутствует. |
const
|
DefaultActive: Boolean
Описание отсутствует. |
const
|
DefaultCameraType: TfgCameraType
Описание отсутствует. |