# Image Shader
\nOnly use a shader to display an image on your screen~
\n**Note: compiling the shader may take some time!**<\/p>\n
<\/p>\n
### How to prepare a custom image~
\nFirst, use ffmpeg (or any tool) to resize your image to **160\u00d7160 pixels**.<\/p>\n
“`bash
\nUsing ffmpeg:
\nffmpeg -i Input.png -vf scale=160:160 image.png
\n“`<\/p>\n
Then place the resized image in the same directory as the Python script below. “`python def generate_glsl_chunks(image_path, output_dir=”image_chunks”): width, height = img.size os.makedirs(output_dir, exist_ok=True) for chunk_y in range(num_chunks_y): array_name = f”image_data_{chunk_y}_{chunk_x}” glsl_array = f”vec4 {array_name}[{chunk_size * chunk_size}] = vec4[{chunk_size * chunk_size}](n”<\/p>\n for i, pixel in enumerate(pixel_data): Only use a shader to display an image on your screen~<\/p>\n","protected":false},"featured_media":83887,"template":"","meta":{"_minecraft_slug":"image-shader","_minecraft_project_id":"uYBHIcV9","_minecraft_author":"lanzhan5656","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":4439,"_minecraft_follows":3,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"image-shader.zip","_minecraft_size_bytes":4887669,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:13:59.183725Z","_minecraft_date_created":"2025-09-12T17:51:50.209928Z","_minecraft_date_modified":"2025-09-12T14:59:33.521071Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/image-shader","_minecraft_icon_attachment_id":83887,"_minecraft_imported_at":"2026-06-04T19:14:25+00:00","_minecraft_import_hash":"0851c9971db8fce3b47bee245042b028","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[991,43,1000,883,887,169,1011,888,8],"mod_loader":[890],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-83886","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-cartoon","mod_category-cursed","mod_category-fantasy","mod_category-iris","mod_category-potato","mod_category-realistic","mod_category-screenshot","mod_category-semi-realistic","mod_category-vanilla-like","mod_loader-iris","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\nRun the script to produce an `image_chunks` folder, then copy the 16 **.glsl files** inside into `shaders\/data\/image_chunks` (you need to unpack the shader pack first).
\nEnter the game, enable the custom image option in the shader settings, and wait for the shader to finish compiling \u2014 Then it’s ok~<\/p>\nA Python Script<\/summary>\n
\nfrom PIL import Image
\nimport os<\/p>\n
\n try:
\n img = Image.open(image_path).convert(‘RGBA’)
\n except FileNotFoundError:
\n print(f”Error: Image file not found at {image_path}”)
\n return<\/p>\n
\n if width != 160 or height != 160:
\n print(f”Error: Image must be 160×160 pixels, but it is {width}x{height}.”)
\n print(f”You can use:”)
\n print(f”ffmpeg -i image.png -vf scale=160:160 output.png”)
\n print(f”to adjust the image resolution.”)
\n return<\/p>\n
\n chunk_size = 40
\n num_chunks_x = width \/\/ chunk_size
\n num_chunks_y = height \/\/ chunk_size<\/p>\n
\n for chunk_x in range(num_chunks_x):
\n left = chunk_x * chunk_size
\n upper = chunk_y * chunk_size
\n right = left + chunk_size
\n lower = upper + chunk_size
\n sub_img = img.crop((left, upper, right, lower))
\n pixel_data = list(sub_img.getdata())<\/p>\n
\n output_file_path = os.path.join(output_dir, f”{array_name}.glsl”)<\/p>\n
\n r, g, b, a = pixel
\n glsl_array += f” vec4({r\/255.0}, {g\/255.0}, {b\/255.0}, {a\/255.0})”
\n if i < len(pixel_data) - 1:\n glsl_array += \",\"\n if (i + 1) % 4 == 0:\n glsl_array += \"n\"\n \n glsl_array += \");n\"\n\n with open(output_file_path, 'w') as f:\n f.write(glsl_array)\n \n print(f\"Generated file: {output_file_path}\")\n\n# --- Config ---\nimage_file = \"image.png\"\noutput_directory = \"image_chunks\"\n\ngenerate_glsl_chunks(image_file, output_directory)\n\n```\n\n<\/p>\n","protected":false},"excerpt":{"rendered":"