Differences

This shows you the differences between two versions of the page.

--- migration [2020/06/17 14:41] – maxime
+++ migration [2021/06/10 10:57] – polymorphgames
@@ Line 1: / Line 1: @@
 ====== Migration Notes ======
+===== Foundation Preview 1.7.1.0610 =====
+  * [[changelog:1.7|Full Preview Changelog]]
+  * [[preview:api|Preview Scripting API]]
+  * [[preview:assets|Preview Assets]]
+==== Texture loading ====
+Some ''[[api:texture|TEXTURE]]'' properties have been changed, depending on their use, to a new type: ''[[preview:api:atlas_cell|ATLAS_CELL]]''.
+Therefore, we added a way to explicitly choose the type of an asset to load, when calling ''[[mod-management-functions#registerassetid|registerAssetId]]''. Specifying the type is optional, ''TEXTURE'' will be inferred for texture assets if absent.
+This third parameter is currently only used for image assets.
+<file lua>
+mod:registerAssetId("test_img1.png", "TEST_IMAGE_1") -- without type specified, loads as a TEXTURE asset
+mod:registerAssetId("test_img2.png", "TEST_IMAGE_2", "TEXTURE") -- loads as a TEXTURE asset
+mod:registerAssetId("test_img3.png", "TEST_IMAGE_3", "ATLAS_CELL") -- loads as an ATLAS_CELL asset
+</file>
+**Technical Info:**  Atlas Cells are images packed in a large unique texture (commonly called atlas). This is especially useful for the GUI engine, allowing to draw most of the interface without having to switch the active binded texture.
 ===== Foundation Preview 1.6.0.0522 =====
@@ Line 5: / Line 27: @@
 ==== BUILDING and MONUMENT asset types ====
-Monuments have been reworked, and the ''MONUMENT'' type has been merged into ''[[preview:api:building|BUILDING]]''. This means there are a few changes to the way buildings and monuments are created.
+Monuments have been reworked, and the ''MONUMENT'' type has been merged into ''[[api:building|BUILDING]]''. This means there are a few changes to the way buildings and monuments are created.
 === Buildings ===
-A building's only building part should be specified with the property ''[[preview:api:building#assetcorebuildingpart|AssetCoreBuildingPart]]'' instead of ''BuildingPartSetList''. For the game to not mistake a building for a monument, the property ''[[preview:api:building#buildingpartsetlist|BuildingPartSetList]]'' shoud be left empty.
+A building's only building part should be specified with the property ''[[api:building#assetcorebuildingpart|AssetCoreBuildingPart]]'' instead of ''BuildingPartSetList''. For the game to not mistake a building for a monument, the property ''[[api:building#buildingpartsetlist|BuildingPartSetList]]'' shoud be left empty.
 <file lua>
@@ Line 34: / Line 56: @@
 === Monuments ===
-Monuments are now created around a single building part, placed before all the others. This part is the one selected just after selecting the monument in the building selection menu. This part has to be specified in the property ''[[preview:api:building#assetcorebuildingpart|AssetCoreBuildingPart]]''. All other parts still are in ''[[preview:api:building#buildingpartsetlist|BuildingPartSetList]]''.
+Monuments are now created around a single building part, placed before all the others. This part is the one selected just after selecting the monument in the building selection menu. This part has to be specified in the property ''[[api:building#assetcorebuildingpart|AssetCoreBuildingPart]]''. All other parts still are in ''[[api:building#buildingpartsetlist|BuildingPartSetList]]''.
-The core building part, if removed, will remove the whole monument. Like for the market, the core building part can be used for preview only, and be invisible once built by setting ''[[preview:api:building_part#isvisiblewhenbuild|BUILDING_PART.IsVisibleWhenBuilt]]'' to ''false''.
+The core building part, if removed, will remove the whole monument. Like for the market, the core building part can be used for preview only, and be invisible once built by setting ''[[api:building_part#isvisiblewhenbuild|BUILDING_PART.IsVisibleWhenBuilt]]'' to ''false''.
 <file lua>
@@ Line 70: / Line 92: @@
 Before:
-  * CorePart - ''[[preview:api:building_part_mover_bridge|BUILDING_PART_MOVER_BRIDGE]]''
+  * CorePart - ''[[api:building_part_mover_bridge|BUILDING_PART_MOVER_BRIDGE]]''
-    * StartPart - ''[[preview:api:building_part_mover|BUILDING_PART_MOVER]]''
+    * StartPart - ''[[api:building_part_mover|BUILDING_PART_MOVER]]''
-    * EndPart - ''[[preview:api:building_part_mover_bridge|BUILDING_PART_MOVER_BRIDGE]]''
+    * EndPart - ''[[api:building_part_mover_bridge|BUILDING_PART_MOVER_BRIDGE]]''
 Now:
-  * CorePart - ''[[preview:api:building_part_mover|BUILDING_PART_MOVER]]''
+  * CorePart - ''[[api:building_part_mover|BUILDING_PART_MOVER]]''
-    * StartPart - ''[[preview:api:building_part_mover_bridge|BUILDING_PART_MOVER_BRIDGE]]''
+    * StartPart - ''[[api:building_part_mover_bridge|BUILDING_PART_MOVER_BRIDGE]]''
-    * EndPart - ''[[preview:api:building_part_mover_bridge|BUILDING_PART_MOVER_BRIDGE]]''
+    * EndPart - ''[[api:building_part_mover_bridge|BUILDING_PART_MOVER_BRIDGE]]''
 ==== Slope constructor ====
-Improvements have been made to the bridge, and you now have to setup bridge end parts (''StartPart'' and ''EndPart'') with a ''[[preview:api:building_constructor_slope|BUILDING_CONSTRUCTOR_SLOPE]]''.
+Improvements have been made to the bridge, and you now have to setup bridge end parts (''StartPart'' and ''EndPart'') with a ''[[api:building_constructor_slope|BUILDING_CONSTRUCTOR_SLOPE]]''.
 ==== Building zone and basement ====
-To improve the number of basement spawned, scalable building parts (with constructor ''[[preview:api:building_constructor_scaler|BUILDING_CONSTRUCTOR_SCALER]]'' or ''[[preview:api:building_constructor_basement|BUILDING_CONSTRUCTOR_BASEMENT]]'') now need a non-empty building zone that fits the size of your basement filler. If no building zone is set, basements will not be placed.
+To improve the number of basement spawned, scalable building parts (with constructor ''[[api:building_constructor_scaler|BUILDING_CONSTRUCTOR_SCALER]]'' or ''[[api:building_constructor_basement|BUILDING_CONSTRUCTOR_BASEMENT]]'') now need a non-empty building zone that fits the size of your basement filler. If no building zone is set, basements will not be placed.
+The [[api:building_zone|BUILDING_ZONE]] type has also been reworked to allow zone polygons per building part.
 ===== Foundation 1.4.5.1009 =====