Types/BlendMode - Revision history

BilkaBot: Removed old prototype docs

2024-10-25T14:32:16Z

Removed old prototype docs

← Older revision		Revision as of 14:32, 25 October 2024
Line 2:		Line 2:

	</p><p>This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].</p></div>		</p><p>This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].</p></div>



	~~A [[Types/string]] that determines how sprites/animations should blend with the background. The possible values are listed below.~~

	Note: In most of Factorio it is assumed colors are in alpha premultiplied format: [https://www.factorio.com/blog/post/fff-172 FFF #172 - Blending and Rendering]. Sprites get premultiplied when loaded, unless <code>premul_alpha</code> is set to false on the sprite/animation itself. But generating mipmaps doesn't respect <code>premul_alpha</code>, so lower mipmap levels will be in premultiplied format regardless.

	~~== Possible values ==~~
	~~=== normal ===~~
	~~The result color is determined with the following formula:~~
	~~<code>Result = Active_RGB + Background_RGB * ( 1 - Active_Alpha )</code>~~

	~~Note: This is alpha blending with an assumption that Active_RGB is already premultiplied with Active_Alpha.~~

	~~=== additive ===~~
	~~The result color is determined with the following formula:~~
	~~<code>Result = Active_RGB + Background_RGB</code>~~

	~~=== additive-soft ===~~
	~~The result color is determined with the following formula:~~
	~~<code>Result = Active_RGB * ( 1 - Background_RGB ) + Background_RGB</code>~~

	~~=== multiplicative ===~~
	~~The result color is determined with the following formula:~~
	~~<code>Result = Active_RGB * Background_RGB</code>~~

	~~=== overwrite ===~~
	~~The result color is determined with the following formula:~~
	~~<code>Result = Active_RGBA or Background_RGBA</code>~~

BilkaBot: Updated styling of prototype doc migration note

2023-09-21T10:42:21Z

Updated styling of prototype doc migration note

← Older revision		Revision as of 10:42, 21 September 2023
Line 1:		Line 1:
	'''The prototype docs have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/types/BlendMode.html https://lua-api.factorio.com/latest/types/BlendMode.html]		<div class="stub"><p>'''The prototype docs have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/types/BlendMode.html https://lua-api.factorio.com/latest/types/BlendMode.html]

	This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].		</p><p>This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].</p></div>

BilkaBot: Protected "Types/BlendMode": Migrated prototype doc to separate website ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2023-08-16T17:51:29Z

Protected "Types/BlendMode": Migrated prototype doc to separate website ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision		Revision as of 17:51, 16 August 2023
(No difference)

BilkaBot: Migrated prototype doc to separate website

2023-08-16T17:51:29Z

Migrated prototype doc to separate website

← Older revision		Revision as of 17:51, 16 August 2023
Line 1:		Line 1:
			'''The prototype docs have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/types/BlendMode.html https://lua-api.factorio.com/latest/types/BlendMode.html]

			This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].



	A [[Types/string]] that determines how sprites/animations should blend with the background. The possible values are listed below.		A [[Types/string]] that determines how sprites/animations should blend with the background. The possible values are listed below.

Bilka: typo

2023-01-30T14:08:26Z

typo

← Older revision		Revision as of 14:08, 30 January 2023
Line 1:		Line 1:
	A [[Types/string]] that determines how sprites/animations should blend with the background. The possible values are listed below.		A [[Types/string]] that determines how sprites/animations should blend with the background. The possible values are listed below.

	Note: In most of Factorio it is assumed colors are in alpha premultiplied format: [https://www.factorio.com/blog/post/fff-172 FFF #172 - Blending and Rendering]. Sprites get premultiplied when loaded, unless <code>premul_alpha</code> is set to false on the sprite/animation itself. But generating mipmaps doesn't respect <code>premul_alpha</code>, so ~~lowel~~ mipmap levels will be in premultiplied format regardless.		Note: In most of Factorio it is assumed colors are in alpha premultiplied format: [https://www.factorio.com/blog/post/fff-172 FFF #172 - Blending and Rendering]. Sprites get premultiplied when loaded, unless <code>premul_alpha</code> is set to false on the sprite/animation itself. But generating mipmaps doesn't respect <code>premul_alpha</code>, so lower mipmap levels will be in premultiplied format regardless.

	== Possible values ==		== Possible values ==

Posila: Clarify formula for normal blending.

2023-01-22T12:48:46Z

Clarify formula for normal blending.

← Older revision		Revision as of 12:48, 22 January 2023
Line 1:		Line 1:
	A [[Types/string]] that determines how sprites/animations should blend with the background. The possible values are listed below.		A [[Types/string]] that determines how sprites/animations should blend with the background. The possible values are listed below.

	Note: ~~Unless~~ <code>premul_alpha</code> is set to false on the sprite/animation itself, ~~Active_RGB is considered to~~ be premultiplied ~~with alpha~~.		Note: In most of Factorio it is assumed colors are in alpha premultiplied format: [https://www.factorio.com/blog/post/fff-172 FFF #172 - Blending and Rendering]. Sprites get premultiplied when loaded, unless <code>premul_alpha</code> is set to false on the sprite/animation itself. But generating mipmaps doesn't respect <code>premul_alpha</code>, so lowel mipmap levels will be in premultiplied format regardless.

	== Possible values ==		== Possible values ==
	=== normal ===		=== normal ===
	The result color is determined with the following formula:		The result color is determined with the following formula:
	<code>Result = Active_RGB * Active_Alpha + Background_RGB * ( 1 - Active_Alpha )</code>		<code>Result = Active_RGB + Background_RGB * ( 1 - Active_Alpha )</code>

			Note: This is alpha blending with an assumption that Active_RGB is already premultiplied with Active_Alpha.

	=== additive ===		=== additive ===

Bilka: Split into own page

2020-05-04T11:33:57Z

Split into own page

New page

A [[Types/string]] that determines how sprites/animations should blend with the background. The possible values are listed below.

Note: Unless <code>premul_alpha</code> is set to false on the sprite/animation itself, Active_RGB is considered to be premultiplied with alpha.

== Possible values ==
=== normal ===
The result color is determined with the following formula:
<code>Result = Active_RGB * Active_Alpha + Background_RGB * ( 1 - Active_Alpha )</code>

=== additive ===
The result color is determined with the following formula:
<code>Result = Active_RGB + Background_RGB</code>

=== additive-soft ===
The result color is determined with the following formula:
<code>Result = Active_RGB * ( 1 - Background_RGB ) + Background_RGB</code>

=== multiplicative ===
The result color is determined with the following formula:
<code>Result = Active_RGB * Background_RGB</code>

=== overwrite ===
The result color is determined with the following formula:
<code>Result = Active_RGBA or Background_RGBA</code>