Create atlas example

examples/resource/create_atlas/create_atlas.collection

@@ -0,0 +1,130 @@
+name: "create_atlas"
+scale_along_z: 0
+embedded_instances {
+  id: "example"
+  data: "components {\n"
+  "  id: \"create_atlas\"\n"
+  "  component: \"/examples/resource/create_atlas/create_atlas.script\"\n"
+  "  position {\n"
+  "    x: 0.0\n"
+  "    y: 0.0\n"
+  "    z: 0.0\n"
+  "  }\n"
+  "  rotation {\n"
+  "    x: 0.0\n"
+  "    y: 0.0\n"
+  "    z: 0.0\n"
+  "    w: 1.0\n"
+  "  }\n"
+  "  property_decls {\n"
+  "  }\n"
+  "}\n"
+  "embedded_components {\n"
+  "  id: \"label\"\n"
+  "  type: \"label\"\n"
+  "  data: \"size {\\n"
+  "  x: 128.0\\n"
+  "  y: 32.0\\n"
+  "  z: 0.0\\n"
+  "  w: 0.0\\n"
+  "}\\n"
+  "color {\\n"
+  "  x: 0.0\\n"
+  "  y: 0.0\\n"
+  "  z: 0.0\\n"
+  "  w: 1.0\\n"
+  "}\\n"
+  "outline {\\n"
+  "  x: 0.0\\n"
+  "  y: 0.0\\n"
+  "  z: 0.0\\n"
+  "  w: 1.0\\n"
+  "}\\n"
+  "shadow {\\n"
+  "  x: 0.0\\n"
+  "  y: 0.0\\n"
+  "  z: 0.0\\n"
+  "  w: 1.0\\n"
+  "}\\n"
+  "leading: 1.0\\n"
+  "tracking: 0.0\\n"
+  "pivot: PIVOT_CENTER\\n"
+  "blend_mode: BLEND_MODE_ALPHA\\n"
+  "line_break: false\\n"
+  "text: \\\"CLICK TO REPLACE PINK WITH YELLOW\\\"\\n"
+  "font: \\\"/builtins/fonts/system_font.font\\\"\\n"
+  "material: \\\"/builtins/fonts/label.material\\\"\\n"
+  "\"\n"
+  "  position {\n"
+  "    x: 360.0\n"
+  "    y: 40.0\n"
+  "    z: 0.0\n"
+  "  }\n"
+  "  rotation {\n"
+  "    x: 0.0\n"
+  "    y: 0.0\n"
+  "    z: 0.0\n"
+  "    w: 1.0\n"
+  "  }\n"
+  "}\n"
+  ""
+  position {
+    x: 0.0
+    y: 0.0
+    z: 0.0
+  }
+  rotation {
+    x: 0.0
+    y: 0.0
+    z: 0.0
+    w: 1.0
+  }
+  scale3 {
+    x: 1.0
+    y: 1.0
+    z: 1.0
+  }
+}
+embedded_instances {
+  id: "go"
+  data: "embedded_components {\n"
+  "  id: \"sprite\"\n"
+  "  type: \"sprite\"\n"
+  "  data: \"default_animation: \\\"anim\\\"\\n"
+  "material: \\\"/builtins/materials/sprite.material\\\"\\n"
+  "blend_mode: BLEND_MODE_ALPHA\\n"
+  "textures {\\n"
+  "  sampler: \\\"texture_sampler\\\"\\n"
+  "  texture: \\\"/builtins/graphics/particle_blob.tilesource\\\"\\n"
+  "}\\n"
+  "\"\n"
+  "  position {\n"
+  "    x: 0.0\n"
+  "    y: 0.0\n"
+  "    z: 0.0\n"
+  "  }\n"
+  "  rotation {\n"
+  "    x: 0.0\n"
+  "    y: 0.0\n"
+  "    z: 0.0\n"
+  "    w: 1.0\n"
+  "  }\n"
+  "}\n"
+  ""
+  position {
+    x: 36.0
+    y: 31.0
+    z: 0.0
+  }
+  rotation {
+    x: 0.0
+    y: 0.0
+    z: 0.0
+    w: 1.0
+  }
+  scale3 {
+    x: 1.0
+    y: 1.0
+    z: 1.0
+  }
+}

examples/resource/create_atlas/create_atlas.script

@@ -0,0 +1,144 @@
+-- load image from custom resources
+-- read pixels and write them to a buffer
+local function create_buffer_from_image(filename)
+	local png = assert(sys.load_resource(filename))
+	local loaded_image = image.load(png)
+	local width = loaded_image.width
+	local height = loaded_image.height
+	local pixels = loaded_image.buffer
+
+	local buffer_declaration = {
+		{
+			name = hash("rgba"),
+			type = buffer.VALUE_TYPE_UINT8,
+			count = 4
+		}
+	}
+	local pixel_buffer = buffer.create(width * height, buffer_declaration)
+	local pixel_stream = buffer.get_stream(pixel_buffer, hash("rgba"))
+	for y = 1, height do
+		for x = 1, width do
+			-- flip image
+			local pixels_index = ((height - y) * width * 4) + ((x - 1) * 4) + 1
+			local r = pixels:byte(pixels_index + 0)
+			local g = pixels:byte(pixels_index + 1)
+			local b = pixels:byte(pixels_index + 2)
+			local a = pixels:byte(pixels_index + 3)
+
+			-- write to buffer stream
+			local stream_index = ((y - 1) * width * 4) + ((x - 1) * 4) + 1
+			pixel_stream[stream_index + 0] = r
+			pixel_stream[stream_index + 1] = g
+			pixel_stream[stream_index + 2] = b
+			pixel_stream[stream_index + 3] = a
+		end
+	end
+
+	return pixel_buffer, width, height
+end
+
+local function replace_atlas_image(atlas_path, image_buffer, image_width, image_height)
+	-- get table with information about an atlas
+	local atlas = resource.get_atlas(atlas_path)
+	-- get table with information about the textured used by the atlas
+	local texture = resource.get_texture_info(atlas.texture)
+	pprint(atlas)
+	pprint(texture)
+
+
+	-- get the UV coordinates of the first image in the atlas
+	local first_uvs = atlas.geometries[1].uvs
+
+	-- this offset should not be necessary but it seems like there is an issue with the
+	-- UVs in Defold 1.5.0
+	local x = first_uvs[1] - 0
+	local y = first_uvs[2] - 6
+	print(x, y)
+	print(image_width, image_height)
+
+	-- create a table with texture update information
+	-- we want to update only a sub region of the atlas starting at a
+	-- certain position and with a certain size
+	local texture_info = {
+		type = resource.TEXTURE_TYPE_2D,
+		width = image_width,
+		height = image_height,
+		format = resource.TEXTURE_FORMAT_RGBA,
+		x = x,
+		y = y,
+		compression_type = resource.COMPRESSION_TYPE_DEFAULT,
+		num_mip_maps = texture.mipmaps,
+	}
+	-- update the atlas texture with the pixels from the provided buffer
+	resource.set_texture(atlas.texture, texture_info, image_buffer)
+end
+
+
+local function create_texture_rgba(texture_path, texture_width, texture_height)
+	-- create an empty texture
+	local tparams = {
+		width          = texture_width,
+		height         = texture_height,
+		type           = resource.TEXTURE_TYPE_2D,
+		format         = resource.TEXTURE_FORMAT_RGBA,
+	}
+	local texture_id = resource.create_texture(texture_path, tparams)
+	return texture_id
+end
+
+function init(self)
+	msg.post(".", "acquire_input_focus")
+
+	local texture_path = "/my_texture.texturec"
+	local atlas_path = "/my_atlas.texturesetc"
+
+	-- create an empty texture
+	local texture_id = create_texture_rgba(texture_path, 512, 512)
+
+	-- load an image as a Defold buffer
+	local image_buffer, image_width, image_height = create_buffer_from_image("/examples/resource/create_atlas/resources/shipYellow_manned.png")
+
+	-- create an atlas with one animation and one square geometry
+	-- note that the function doesn't support hashes for the texture,
+	-- you need to use a string for the texture path here aswell
+	local aparams = {
+		texture = texture_path,
+		animations = {
+			{
+				id          = "my_animation",
+				width       = image_width,
+				height      = image_height,
+				frame_start = 1,
+				frame_end   = 2,
+			}
+		},
+		geometries = {
+			{
+				vertices  = {
+					0, 0,
+					0, image_height,
+					image_width, image_height,
+					image_width, 0
+				},
+				uvs = {
+					0, 0,
+					0, image_height,
+					image_width, image_height,
+					image_width, 0
+				},
+				indices = {0,1,2,0,2,3}
+			}
+		}
+	}
+	local my_atlas_id = resource.create_atlas(atlas_path, aparams)
+
+	replace_atlas_image(atlas_path, image_buffer, image_width, image_height)
+
+	go.set("go#sprite", "image", my_atlas_id)
+end
+
+function on_input(self, action_id, action)
+	if action.pressed then
+		replace_atlas_image()
+	end
+end

game.project

@@ -1,7 +1,7 @@
 [project]
 title = Defold-examples
 version = 0.1
-custom_resources = examples/resource/modify_atlas/resources
+custom_resources = examples/resource/modify_atlas/resources, examples/resource/create_atlas/resources
 dependencies#0 = https://github.com/defold/extension-spine/archive/refs/tags/2.13.0.zip
 
 [bootstrap]