Types/IconData: Difference between revisions

From Official Factorio Wiki
Jump to navigation Jump to search
(Added some precisions about scale, shift and shadow, based on my tests.)
(Removed old prototype docs)
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Basics ==
<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/IconData.html https://lua-api.factorio.com/latest/types/IconData.html]
Data of one icon "layer" for the <code>icons</code> property of the [[Types/IconSpecification]].


== Mandatory properties ==
</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>
=== icon ===
'''Type''': [[Types/FileName]]
 
The path to the icon.
 
=== icon_size ===
'''Type''': [[Types/SpriteSizeType]]
 
Mandatory if <code>icon_size</code> is not specified outside of <code>icons</code>. The size of the square icon, in pixels, e.g. 32 for a 32px by 32px icon.
 
== Optional properties ==
=== tint ===
'''Type''': [[Types/Color]]
 
'''Default''': {r=1, g=1, b=1, a=1}
 
Tint of the icon. Default is when tint = nil. See Type for full details.
 
=== shift ===
'''Type''': [[Types/vector]]
 
'''Default''': {0, 0}
 
Used to offset the icon "layer" from the overall icon.
 
=== scale ===
'''Type''': [[Types/double]]
 
'''Default for items/recipes''': (32/icon_size)
 
'''Default for technologies''': (256/icon_size)
 
When set, specifies the scale of the icon on the GUI scale.
Scale 2 means that the icon will be 2 times bigger on screen (and more pixelated).
 
=== icon_mipmaps ===
'''Type''': [[Types/uint8]]
 
'''Default''': 0
 
== Notes ==
 
• Only the first icon layer will display a shadow.
 
• The final combination of icons will always be resized in GUI based on the first icon layer's size, but won't be resized when displayed on machines in alt-mode.
 
• Shift values are based on final size (icon_size * scale) of the first icon.
 
== Examples ==
 
<syntaxhighlight lang="lua">{
  icon = "__base__/graphics/icons/fluid/heavy-oil.png",
  icon_size = 64,
  scale = 0.5,
  shift = {4, -8}
}</syntaxhighlight>

Latest revision as of 14:32, 25 October 2024

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/IconData.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 on the forums.

Retrieved from "https://wiki.factorio.com/index.php?title=Types/IconData&oldid=202696"