SUPPORTEDIMAGEFORMATS(3clc)

🌸 SUPPORTED_IMAGE_FORMATS 🌸

okay so bestie, welcome to the OpenCL Manual — yes this whole thing lives in the 3clc section of the manual, and today we're doing the image formats page. it's short, it's iconic, it's giving reference-table realness 💅

---

✨ NAME ✨

Supported_Image_Formats — Supported Image Formats

🎀 DESCRIPTION 🎀

so for read-write or write-only 2D and 3D images, there's a whole minimum list of supported image formats, and it's given by the table below. the table has three columns: image_num_channels, image_channel_order, and image_channel_data_type. here's the whole thing, transcribed with love 🫶

• image_num_channels = 4, image_channel_order = CL_RGBA, and then image_channel_data_type can be any one of these:
  • CL_UNORM_INT8
  • CL_UNORM_INT16
  • CL_SIGNED_INT8
  • CL_SIGNED_INT16
  • CL_SIGNED_INT32
  • CL_UNSIGNED_INT8
  • CL_UNSIGNED_INT16
  • CL_UNSIGNED_INT32
  • CL_HALF_FLOAT
  • CL_FLOAT
• image_num_channels = 4, image_channel_order = CL_BGRA, and image_channel_data_type is:
  • CL_UNORM_INT8

and that's literally the whole minimum list, no cap. those blank lines in the original table were just vibes spacing, not extra formats 💀

📜 SPECIFICATION 📜

OpenCL Specification[1]

👀 SEE ALSO 👀

go read these next, bestie, they're all connected:

• EXTENSION(3clc)
• cl_image_format(3clc)
• cl_khr_3d_image_writes(3clc)
• clGetSupportedImageFormats(3clc)

👑 AUTHORS 👑

The Khronos Group

💖 COPYRIGHT 💖

Copyright © 2007-2011 The Khronos Group Inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and/or associated documentation files (the "Materials"), to deal in the Materials without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Materials, and to permit persons to whom the Materials are furnished to do so, subject to the condition that this copyright notice and permission notice shall be included in all copies or substantial portions of the Materials.

fr fr do not strip that notice out of your copies, that's the whole deal of the license 🙈

📝 NOTES 📝

1. OpenCL Specification — page 97, section 5.3.2.1 - Supported Image Formats

---

and that's the page, bestie!! 🌈 the source/version + date situation at the bottom says The Khronos Group, 01/14/2021, and it's the SUPPORTED IMAGE FORM(3clc) footer. slay, go read your image formats, periodt 💜🦋