FGX.Canvas.TfgBitmap: различия между версиями

Материал из FGX Native Докуметации
Перейти к навигации Перейти к поиску
(summary)
(summary)
Строка 10: Строка 10:
 
== Описание ==
 
== Описание ==
  
<p>Представление платформозависимого битмапа в памяти.</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><div class="info">Для Андроида: Если в качестве имени файла будет передано имя файла с изображением из ресурсов (папка assets), то сервис загрузит изображение из ресурсов. Например, если файл изображения развертывается по пути <i>assets\folder\filename.png</i> , то в качестве AFileName нужно указывать <i>folder\filename.png</i> .</div>
+
<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>Загружает нативный битмап из переданного потока в существующий нативный битмап.</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><div class="info">Выбор используемого кодека зависит от разрешения файла. Поддерживаемые кодеки (jpg и png)</div>
+
<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>Сохраняет изображение в поток.</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>Нативный хендл может создаваться отложенно. Он может создаваться в момент первой необходимости работать с нативным битмапом.</p>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">procedure</syntaxhighlight> || <code lang="Delphi">Changed()</code>
 
| <syntaxhighlight lang="Delphi">procedure</syntaxhighlight> || <code lang="Delphi">Changed()</code>
<p>Вызывает срабатывание обработчика OnChanged.</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>Задает оттенок изображения. Операция не отменяемая.</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>Определеяет, пустое изображение или нет? Пустое - это изображение, которое имеет нулевые размеры.</p>
 
|}
 
|}
  
Строка 67: Строка 67:
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>MaxSize: [[TSize]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>MaxSize: [[TSize]]</code>
<p>Возвращает максимально допустимый размер нативного битмапа.</p>
+
<p>Возвращает максимально допустимый размер нативного битмапа.</p>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Bounds: [[TRect]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Bounds: [[TRect]]</code>
<p>Вспомогательный метод возвращающий фрейм.</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>Хендл нативного битмапа.</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>Канва для доступа к возможностям выполнять отрисовки по битмапу. По умолчанию битмап не имеет канвы, однако, по первому запросу канва создается.</p>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Size: [[TSize]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Size: [[TSize]]</code>
<p>Физический размер битмапа. Сколько точек экрана реально занимает битмап, если его выводить на экран в масштабе 1 : 1.</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>Ширина в терминах физического размера.</p>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Height: [[Integer]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Height: [[Integer]]</code>
<p>Высота в терминах физического размера.</p>
+
<p>Высота в терминах физического размера.</p>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LogicalWidth: [[Single]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LogicalWidth: [[Single]]</code>
<p>Ширина в терминах логического размера с учетом скейла экрана.</p>
+
<p>Ширина в терминах логического размера с учетом скейла экрана.</p>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LogicalHeight: [[Single]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>LogicalHeight: [[Single]]</code>
<p>Высота в терминах логического размера с учетом скейла экрана.</p>
+
<p>Высота в терминах логического размера с учетом скейла экрана.</p>
 
|-
 
|-
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Scale: [[Single]]</code>
 
| <syntaxhighlight lang="Delphi">property</syntaxhighlight> || <code>Scale: [[Single]]</code>
<p>Скейл, используемый при выводе изображения на экран. Именно это свойство отвечает, какие окончательные физические размеры будут у изображения.</p>
+
<p>Скейл, используемый при выводе изображения на экран. Именно это свойство отвечает, какие окончательные физические размеры будут у изображения.</p>
 
|}
 
|}
  

Версия 14:53, 8 июля 2019

Delphi

TfgBitmap = class (TPersistent)

TPersistent -> TfgBitmap

Описание

Представление платформозависимого битмапа в памяти.

Конструкторы

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

Описание отсутствует.