FGX.Canvas.TfgBitmap: различия между версиями
Admin (обсуждение | вклад) (summary) |
Admin (обсуждение | вклад) (summary) |
||
Строка 10: | Строка 10: | ||
== Описание == | == Описание == | ||
− | <p> | + | <p>Представление платформозависимого битмапа в памяти.</p> |
== Конструкторы == | == Конструкторы == | ||
Строка 37: | Строка 37: | ||
| <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">LoadFromFile(const AFileName: [[string]]): [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">LoadFromFile(const AFileName: [[string]]): [[Boolean]]</code> | ||
− | <p> | + | <p>Загружает нативный битмап из файла в существующий нативный битмап. Возвращает размер загруженного файла.</p><div class="info">Для Андроида: Если в качестве имени файла будет передано имя файла с изображением из ресурсов (папка assets), то сервис загрузит изображение из ресурсов. Например, если файл изображения развертывается по пути <i>assets\folder\filename.png</i> , то в качестве AFileName нужно указывать <i>folder\filename.png</i> .</div> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">LoadFromStream(const AStream: [[TStream]]): [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">LoadFromStream(const AStream: [[TStream]]): [[Boolean]]</code> | ||
− | <p> | + | <p>Загружает нативный битмап из переданного потока в существующий нативный битмап.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">SaveToFile(const AFileName: [[string]]): [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">SaveToFile(const AFileName: [[string]]): [[Boolean]]</code> | ||
− | <p> | + | <p>Сохраняет изображение в файл.</p><div class="info">Выбор используемого кодека зависит от разрешения файла. Поддерживаемые кодеки (jpg и png)</div> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">SaveToStream(const AStream: [[TStream]]): [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">SaveToStream(const AStream: [[TStream]]): [[Boolean]]</code> | ||
− | <p> | + | <p>Сохраняет изображение в поток.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">IsHandleCreated(): [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">IsHandleCreated(): [[Boolean]]</code> | ||
− | <p> | + | <p>Нативный хендл может создаваться отложенно. Он может создаваться в момент первой необходимости работать с нативным битмапом.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">procedure</syntaxhighlight> || <code lang="Delphi">Changed()</code> | | <syntaxhighlight lang="Delphi">procedure</syntaxhighlight> || <code lang="Delphi">Changed()</code> | ||
− | <p> | + | <p>Вызывает срабатывание обработчика OnChanged.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">procedure</syntaxhighlight> || <code lang="Delphi">ApplyTintColor(const ATintColor: [[TAlphaColor]])</code> | | <syntaxhighlight lang="Delphi">procedure</syntaxhighlight> || <code lang="Delphi">ApplyTintColor(const ATintColor: [[TAlphaColor]])</code> | ||
− | <p> | + | <p>Задает оттенок изображения. Операция не отменяемая.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">IsEmpty(): [[Boolean]]</code> | | <syntaxhighlight lang="Delphi">function</syntaxhighlight> || <code lang="Delphi">IsEmpty(): [[Boolean]]</code> | ||
− | <p> | + | <p>Определеяет, пустое изображение или нет? Пустое - это изображение, которое имеет нулевые размеры.</p> |
|} | |} | ||
Строка 67: | Строка 67: | ||
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>MaxSize: [[TSize]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>MaxSize: [[TSize]]</code> | ||
− | <p> | + | <p>Возвращает максимально допустимый размер нативного битмапа.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Bounds: [[TRect]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Bounds: [[TRect]]</code> | ||
− | <p> | + | <p>Вспомогательный метод возвращающий фрейм.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Handle: [[FGX.Canvas.TfgBitmapHandle|TfgBitmapHandle]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Handle: [[FGX.Canvas.TfgBitmapHandle|TfgBitmapHandle]]</code> | ||
− | <p> | + | <p>Хендл нативного битмапа.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Canvas: [[FGX.Canvas.TfgCanvas|TfgCanvas]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Canvas: [[FGX.Canvas.TfgCanvas|TfgCanvas]]</code> | ||
− | <p> | + | <p>Канва для доступа к возможностям выполнять отрисовки по битмапу. По умолчанию битмап не имеет канвы, однако, по первому запросу канва создается.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Size: [[TSize]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Size: [[TSize]]</code> | ||
− | <p> | + | <p>Физический размер битмапа. Сколько точек экрана реально занимает битмап, если его выводить на экран в масштабе 1 : 1.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Width: [[Integer]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Width: [[Integer]]</code> | ||
− | <p> | + | <p>Ширина в терминах физического размера.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Height: [[Integer]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Height: [[Integer]]</code> | ||
− | <p> | + | <p>Высота в терминах физического размера.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LogicalWidth: [[Single]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LogicalWidth: [[Single]]</code> | ||
− | <p> | + | <p>Ширина в терминах логического размера с учетом скейла экрана.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LogicalHeight: [[Single]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LogicalHeight: [[Single]]</code> | ||
− | <p> | + | <p>Высота в терминах логического размера с учетом скейла экрана.</p> |
|- | |- | ||
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Scale: [[Single]]</code> | | <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Scale: [[Single]]</code> | ||
− | <p> | + | <p>Скейл, используемый при выводе изображения на экран. Именно это свойство отвечает, какие окончательные физические размеры будут у изображения.</p> |
|} | |} | ||
Версия 16:13, 18 июля 2019
Delphi
TfgBitmap = class (TPersistent)
Содержание
Описание
Представление платформозависимого битмапа в памяти.
Конструкторы
constructor
|
Create()
Описание отсутствует. |
constructor
|
Create(const AWidth: Integer; const AHeight: Integer)
Описание отсутствует. |
constructor
|
CreateFromStream(const AStream: TStream)
Описание отсутствует. |
constructor
|
CreateFromFile(const AFileName: string)
Описание отсутствует. |
constructor
|
CreateFromBitmap(const ABitmap: TfgBitmap)
Описание отсутствует. |
Методы
function
|
LoadFromFile(const AFileName: string): Boolean
Загружает нативный битмап из файла в существующий нативный битмап. Возвращает размер загруженного файла. Для Андроида: Если в качестве имени файла будет передано имя файла с изображением из ресурсов (папка assets), то сервис загрузит изображение из ресурсов. Например, если файл изображения развертывается по пути assets\folder\filename.png , то в качестве AFileName нужно указывать folder\filename.png .
|
function
|
LoadFromStream(const AStream: TStream): Boolean
Загружает нативный битмап из переданного потока в существующий нативный битмап. |
function
|
SaveToFile(const AFileName: string): Boolean
Сохраняет изображение в файл. Выбор используемого кодека зависит от разрешения файла. Поддерживаемые кодеки (jpg и png)
|
function
|
SaveToStream(const AStream: TStream): Boolean
Сохраняет изображение в поток. |
function
|
IsHandleCreated(): Boolean
Нативный хендл может создаваться отложенно. Он может создаваться в момент первой необходимости работать с нативным битмапом. |
procedure
|
Changed()
Вызывает срабатывание обработчика OnChanged. |
procedure
|
ApplyTintColor(const ATintColor: TAlphaColor)
Задает оттенок изображения. Операция не отменяемая. |
function
|
IsEmpty(): Boolean
Определеяет, пустое изображение или нет? Пустое - это изображение, которое имеет нулевые размеры. |
Свойства
property
|
MaxSize: TSize
Возвращает максимально допустимый размер нативного битмапа. |
property
|
Bounds: TRect
Вспомогательный метод возвращающий фрейм. |
property
|
Handle: TfgBitmapHandle
Хендл нативного битмапа. |
property
|
Canvas: TfgCanvas
Канва для доступа к возможностям выполнять отрисовки по битмапу. По умолчанию битмап не имеет канвы, однако, по первому запросу канва создается. |
property
|
Size: TSize
Физический размер битмапа. Сколько точек экрана реально занимает битмап, если его выводить на экран в масштабе 1 : 1. |
property
|
Width: Integer
Ширина в терминах физического размера. |
property
|
Height: Integer
Высота в терминах физического размера. |
property
|
LogicalWidth: Single
Ширина в терминах логического размера с учетом скейла экрана. |
property
|
LogicalHeight: Single
Высота в терминах логического размера с учетом скейла экрана. |
property
|
Scale: Single
Скейл, используемый при выводе изображения на экран. Именно это свойство отвечает, какие окончательные физические размеры будут у изображения. |
События
event
|
OnChanged: TNotifyEvent
Описание отсутствует. |
Константы
const
|
DefaultScale: Integer
Описание отсутствует. |