GenerateWebGLRenderingContext.cpp 51 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274
  1. /*
  2. * Copyright (c) 2024, Aliaksandr Kalenik <kalenik.aliaksandr@gmail.com>
  3. * Copyright (c) 2024, Luke Wilde <luke@ladybird.org>
  4. *
  5. * SPDX-License-Identifier: BSD-2-Clause
  6. */
  7. #include "BindingsGenerator/IDLGenerators.h"
  8. #include <AK/LexicalPath.h>
  9. #include <AK/SourceGenerator.h>
  10. #include <AK/StringBuilder.h>
  11. #include <LibCore/ArgsParser.h>
  12. #include <LibCore/File.h>
  13. #include <LibIDL/IDLParser.h>
  14. #include <LibMain/Main.h>
  15. static bool is_webgl_object_type(StringView type_name)
  16. {
  17. return type_name == "WebGLBuffer"sv
  18. || type_name == "WebGLFramebuffer"sv
  19. || type_name == "WebGLProgram"sv
  20. || type_name == "WebGLRenderbuffer"sv
  21. || type_name == "WebGLSampler"sv
  22. || type_name == "WebGLShader"sv
  23. || type_name == "WebGLTexture"sv
  24. || type_name == "WebGLVertexArrayObject"sv;
  25. }
  26. static bool gl_function_modifies_framebuffer(StringView function_name)
  27. {
  28. return function_name == "clear"sv
  29. || function_name == "drawArrays"sv
  30. || function_name == "drawElements"sv
  31. || function_name == "blitFramebuffer"sv
  32. || function_name == "invalidateFramebuffer"sv;
  33. }
  34. static ByteString to_cpp_type(const IDL::Type& type, const IDL::Interface& interface)
  35. {
  36. if (type.name() == "undefined"sv)
  37. return "void"sv;
  38. if (type.name() == "object"sv) {
  39. if (type.is_nullable())
  40. return "JS::Object*"sv;
  41. return "JS::Object&"sv;
  42. }
  43. if (type.name() == "DOMString"sv) {
  44. if (type.is_nullable())
  45. return "Optional<String>"sv;
  46. return "String"sv;
  47. }
  48. auto cpp_type = idl_type_name_to_cpp_type(type, interface);
  49. return cpp_type.name;
  50. }
  51. static ByteString idl_to_gl_function_name(StringView function_name)
  52. {
  53. StringBuilder gl_function_name_builder;
  54. gl_function_name_builder.append("gl"sv);
  55. for (size_t i = 0; i < function_name.length(); ++i) {
  56. if (i == 0) {
  57. gl_function_name_builder.append(to_ascii_uppercase(function_name[i]));
  58. } else {
  59. gl_function_name_builder.append(function_name[i]);
  60. }
  61. }
  62. if (function_name == "clearDepth"sv || function_name == "depthRange"sv) {
  63. gl_function_name_builder.append("f"sv);
  64. }
  65. return gl_function_name_builder.to_byte_string();
  66. }
  67. struct NameAndType {
  68. StringView name;
  69. struct {
  70. StringView type;
  71. int element_count { 0 };
  72. } return_type;
  73. Optional<int> webgl_version { OptionalNone {} };
  74. };
  75. static void generate_get_parameter(SourceGenerator& generator, int webgl_version)
  76. {
  77. Vector<NameAndType> const name_to_type = {
  78. { "ACTIVE_TEXTURE"sv, { "GLenum"sv } },
  79. { "ALIASED_LINE_WIDTH_RANGE"sv, { "Float32Array"sv, 2 } },
  80. { "ALIASED_POINT_SIZE_RANGE"sv, { "Float32Array"sv, 2 } },
  81. { "ALPHA_BITS"sv, { "GLint"sv } },
  82. { "ARRAY_BUFFER_BINDING"sv, { "WebGLBuffer"sv } },
  83. { "BLEND"sv, { "GLboolean"sv } },
  84. { "BLEND_COLOR"sv, { "Float32Array"sv, 4 } },
  85. { "BLEND_DST_ALPHA"sv, { "GLenum"sv } },
  86. { "BLEND_DST_RGB"sv, { "GLenum"sv } },
  87. { "BLEND_EQUATION_ALPHA"sv, { "GLenum"sv } },
  88. { "BLEND_EQUATION_RGB"sv, { "GLenum"sv } },
  89. { "BLEND_SRC_ALPHA"sv, { "GLenum"sv } },
  90. { "BLEND_SRC_RGB"sv, { "GLenum"sv } },
  91. { "BLUE_BITS"sv, { "GLint"sv } },
  92. { "COLOR_CLEAR_VALUE"sv, { "Float32Array"sv, 4 } },
  93. // FIXME: { "COLOR_WRITEMASK"sv, { "sequence<GLboolean>"sv, 4 } },
  94. // FIXME: { "COMPRESSED_TEXTURE_FORMATS"sv, { "Uint32Array"sv } },
  95. { "CULL_FACE"sv, { "GLboolean"sv } },
  96. { "CULL_FACE_MODE"sv, { "GLenum"sv } },
  97. { "CURRENT_PROGRAM"sv, { "WebGLProgram"sv } },
  98. { "DEPTH_BITS"sv, { "GLint"sv } },
  99. { "DEPTH_CLEAR_VALUE"sv, { "GLfloat"sv } },
  100. { "DEPTH_FUNC"sv, { "GLenum"sv } },
  101. { "DEPTH_RANGE"sv, { "Float32Array"sv, 2 } },
  102. { "DEPTH_TEST"sv, { "GLboolean"sv } },
  103. { "DEPTH_WRITEMASK"sv, { "GLboolean"sv } },
  104. { "DITHER"sv, { "GLboolean"sv } },
  105. { "ELEMENT_ARRAY_BUFFER_BINDING"sv, { "WebGLBuffer"sv } },
  106. { "FRAMEBUFFER_BINDING"sv, { "WebGLFramebuffer"sv } },
  107. { "FRONT_FACE"sv, { "GLenum"sv } },
  108. { "GENERATE_MIPMAP_HINT"sv, { "GLenum"sv } },
  109. { "GREEN_BITS"sv, { "GLint"sv } },
  110. { "IMPLEMENTATION_COLOR_READ_FORMAT"sv, { "GLenum"sv } },
  111. { "IMPLEMENTATION_COLOR_READ_TYPE"sv, { "GLenum"sv } },
  112. { "LINE_WIDTH"sv, { "GLfloat"sv } },
  113. { "MAX_COMBINED_TEXTURE_IMAGE_UNITS"sv, { "GLint"sv } },
  114. { "MAX_CUBE_MAP_TEXTURE_SIZE"sv, { "GLint"sv } },
  115. { "MAX_FRAGMENT_UNIFORM_VECTORS"sv, { "GLint"sv } },
  116. { "MAX_RENDERBUFFER_SIZE"sv, { "GLint"sv } },
  117. { "MAX_TEXTURE_IMAGE_UNITS"sv, { "GLint"sv } },
  118. { "MAX_TEXTURE_SIZE"sv, { "GLint"sv } },
  119. { "MAX_VARYING_VECTORS"sv, { "GLint"sv } },
  120. { "MAX_VERTEX_ATTRIBS"sv, { "GLint"sv } },
  121. { "MAX_VERTEX_TEXTURE_IMAGE_UNITS"sv, { "GLint"sv } },
  122. { "MAX_VERTEX_UNIFORM_VECTORS"sv, { "GLint"sv } },
  123. { "MAX_VIEWPORT_DIMS"sv, { "Int32Array"sv, 2 } },
  124. { "PACK_ALIGNMENT"sv, { "GLint"sv } },
  125. { "POLYGON_OFFSET_FACTOR"sv, { "GLfloat"sv } },
  126. { "POLYGON_OFFSET_FILL"sv, { "GLboolean"sv } },
  127. { "POLYGON_OFFSET_UNITS"sv, { "GLfloat"sv } },
  128. { "RED_BITS"sv, { "GLint"sv } },
  129. { "RENDERBUFFER_BINDING"sv, { "WebGLRenderbuffer"sv } },
  130. { "RENDERER"sv, { "DOMString"sv } },
  131. { "SAMPLE_ALPHA_TO_COVERAGE"sv, { "GLboolean"sv } },
  132. { "SAMPLE_BUFFERS"sv, { "GLint"sv } },
  133. { "SAMPLE_COVERAGE"sv, { "GLboolean"sv } },
  134. { "SAMPLE_COVERAGE_INVERT"sv, { "GLboolean"sv } },
  135. { "SAMPLE_COVERAGE_VALUE"sv, { "GLfloat"sv } },
  136. { "SAMPLES"sv, { "GLint"sv } },
  137. { "SCISSOR_BOX"sv, { "Int32Array"sv, 4 } },
  138. { "SCISSOR_TEST"sv, { "GLboolean"sv } },
  139. { "SHADING_LANGUAGE_VERSION"sv, { "DOMString"sv } },
  140. { "STENCIL_BACK_FAIL"sv, { "GLenum"sv } },
  141. { "STENCIL_BACK_FUNC"sv, { "GLenum"sv } },
  142. { "STENCIL_BACK_PASS_DEPTH_FAIL"sv, { "GLenum"sv } },
  143. { "STENCIL_BACK_PASS_DEPTH_PASS"sv, { "GLenum"sv } },
  144. { "STENCIL_BACK_REF"sv, { "GLint"sv } },
  145. { "STENCIL_BACK_VALUE_MASK"sv, { "GLuint"sv } },
  146. { "STENCIL_BACK_WRITEMASK"sv, { "GLuint"sv } },
  147. { "STENCIL_BITS"sv, { "GLint"sv } },
  148. { "STENCIL_CLEAR_VALUE"sv, { "GLint"sv } },
  149. { "STENCIL_FAIL"sv, { "GLenum"sv } },
  150. { "STENCIL_FUNC"sv, { "GLenum"sv } },
  151. { "STENCIL_PASS_DEPTH_FAIL"sv, { "GLenum"sv } },
  152. { "STENCIL_PASS_DEPTH_PASS"sv, { "GLenum"sv } },
  153. { "STENCIL_REF"sv, { "GLint"sv } },
  154. { "STENCIL_TEST"sv, { "GLboolean"sv } },
  155. { "STENCIL_VALUE_MASK"sv, { "GLuint"sv } },
  156. { "STENCIL_WRITEMASK"sv, { "GLuint"sv } },
  157. { "SUBPIXEL_BITS"sv, { "GLint"sv } },
  158. { "TEXTURE_BINDING_2D"sv, { "WebGLTexture"sv } },
  159. { "TEXTURE_BINDING_CUBE_MAP"sv, { "WebGLTexture"sv } },
  160. { "UNPACK_ALIGNMENT"sv, { "GLint"sv } },
  161. // FIXME: { "UNPACK_COLORSPACE_CONVERSION_WEBGL"sv, { "GLenum"sv } },
  162. // FIXME: { "UNPACK_FLIP_Y_WEBGL"sv, { "GLboolean"sv } },
  163. // FIXME: { "UNPACK_PREMULTIPLY_ALPHA_WEBGL"sv, { "GLboolean"sv } },
  164. { "VENDOR"sv, { "DOMString"sv } },
  165. { "VERSION"sv, { "DOMString"sv } },
  166. { "VIEWPORT"sv, { "Int32Array"sv, 4 } },
  167. { "MAX_SAMPLES"sv, { "GLint"sv }, 2 },
  168. { "MAX_3D_TEXTURE_SIZE"sv, { "GLint"sv }, 2 },
  169. { "MAX_ARRAY_TEXTURE_LAYERS"sv, { "GLint"sv }, 2 },
  170. { "MAX_COLOR_ATTACHMENTS"sv, { "GLint"sv }, 2 },
  171. { "MAX_VERTEX_UNIFORM_COMPONENTS"sv, { "GLint"sv }, 2 },
  172. { "MAX_UNIFORM_BLOCK_SIZE"sv, { "GLint64"sv }, 2 },
  173. { "MAX_UNIFORM_BUFFER_BINDINGS"sv, { "GLint"sv }, 2 },
  174. { "UNIFORM_BUFFER_OFFSET_ALIGNMENT"sv, { "GLint"sv }, 2 },
  175. { "MAX_DRAW_BUFFERS"sv, { "GLint"sv }, 2 },
  176. { "MAX_VERTEX_UNIFORM_BLOCKS"sv, { "GLint"sv }, 2 },
  177. { "MAX_FRAGMENT_INPUT_COMPONENTS"sv, { "GLint"sv }, 2 },
  178. { "MAX_COMBINED_UNIFORM_BLOCKS"sv, { "GLint"sv }, 2 },
  179. };
  180. auto is_primitive_type = [](StringView type) {
  181. return type == "GLboolean"sv || type == "GLint"sv || type == "GLfloat"sv || type == "GLenum"sv || type == "GLuint"sv;
  182. };
  183. generator.append(" switch (pname) {");
  184. for (auto const& name_and_type : name_to_type) {
  185. if (name_and_type.webgl_version.has_value() && name_and_type.webgl_version.value() != webgl_version)
  186. continue;
  187. auto const& parameter_name = name_and_type.name;
  188. auto const& type_name = name_and_type.return_type.type;
  189. StringBuilder string_builder;
  190. SourceGenerator impl_generator { string_builder };
  191. impl_generator.set("parameter_name", parameter_name);
  192. impl_generator.set("type_name", type_name);
  193. impl_generator.append(R"~~~(
  194. case GL_@parameter_name@: {)~~~");
  195. if (is_primitive_type(type_name)) {
  196. impl_generator.append(R"~~~(
  197. GLint result;
  198. glGetIntegerv(GL_@parameter_name@, &result);
  199. return JS::Value(result);
  200. )~~~");
  201. } else if (type_name == "GLint64"sv) {
  202. impl_generator.append(R"~~~(
  203. GLint64 result;
  204. glGetInteger64v(GL_@parameter_name@, &result);
  205. return JS::Value(static_cast<double>(result));
  206. )~~~");
  207. } else if (type_name == "DOMString"sv) {
  208. impl_generator.append(R"~~~(
  209. auto result = reinterpret_cast<const char*>(glGetString(GL_@parameter_name@));
  210. return JS::PrimitiveString::create(m_realm->vm(), ByteString { result });)~~~");
  211. } else if (type_name == "Float32Array"sv || type_name == "Int32Array"sv) {
  212. auto element_count = name_and_type.return_type.element_count;
  213. impl_generator.set("element_count", MUST(String::formatted("{}", element_count)));
  214. if (type_name == "Int32Array"sv) {
  215. impl_generator.set("gl_function_name", "glGetIntegerv"sv);
  216. impl_generator.set("element_type", "GLint"sv);
  217. } else if (type_name == "Float32Array"sv) {
  218. impl_generator.set("gl_function_name", "glGetFloatv"sv);
  219. impl_generator.set("element_type", "GLfloat"sv);
  220. } else {
  221. VERIFY_NOT_REACHED();
  222. }
  223. impl_generator.append(R"~~~(
  224. Array<@element_type@, @element_count@> result;
  225. @gl_function_name@(GL_@parameter_name@, result.data());
  226. auto byte_buffer = MUST(ByteBuffer::copy(result.data(), @element_count@ * sizeof(@element_type@)));
  227. auto array_buffer = JS::ArrayBuffer::create(m_realm, move(byte_buffer));
  228. return JS::@type_name@::create(m_realm, @element_count@, array_buffer);
  229. )~~~");
  230. } else if (type_name == "WebGLProgram"sv || type_name == "WebGLBuffer"sv || type_name == "WebGLTexture"sv || type_name == "WebGLFramebuffer"sv || type_name == "WebGLRenderbuffer"sv) {
  231. impl_generator.append(R"~~~(
  232. GLint result;
  233. glGetIntegerv(GL_@parameter_name@, &result);
  234. if (!result)
  235. return JS::js_null();
  236. return @type_name@::create(m_realm, *this, result);
  237. )~~~");
  238. } else {
  239. VERIFY_NOT_REACHED();
  240. }
  241. impl_generator.append(" }");
  242. generator.append(string_builder.string_view());
  243. }
  244. generator.appendln(R"~~~(
  245. default:
  246. dbgln("Unknown WebGL parameter name: {:x}", pname);
  247. set_error(GL_INVALID_ENUM);
  248. return JS::js_null();
  249. })~~~");
  250. }
  251. static void generate_get_buffer_parameter(SourceGenerator& generator)
  252. {
  253. Vector<NameAndType> const name_to_type = {
  254. { "BUFFER_SIZE"sv, { "GLint"sv } },
  255. { "BUFFER_USAGE"sv, { "GLenum"sv } },
  256. };
  257. generator.append(" switch (pname) {");
  258. for (auto const& name_and_type : name_to_type) {
  259. auto const& parameter_name = name_and_type.name;
  260. auto const& type_name = name_and_type.return_type.type;
  261. StringBuilder string_builder;
  262. SourceGenerator impl_generator { string_builder };
  263. impl_generator.set("parameter_name", parameter_name);
  264. impl_generator.set("type_name", type_name);
  265. impl_generator.append(R"~~~(
  266. case GL_@parameter_name@: {
  267. GLint result;
  268. glGetBufferParameteriv(target, GL_@parameter_name@, &result);
  269. return JS::Value(result);
  270. }
  271. )~~~");
  272. generator.append(string_builder.string_view());
  273. }
  274. generator.appendln(R"~~~(
  275. default:
  276. dbgln("Unknown WebGL buffer parameter name: {:x}", pname);
  277. set_error(GL_INVALID_ENUM);
  278. return JS::js_null();
  279. })~~~");
  280. }
  281. static void generate_get_internal_format_parameter(SourceGenerator& generator)
  282. {
  283. generator.append(R"~~~(
  284. switch (pname) {
  285. case GL_SAMPLES: {
  286. GLint num_sample_counts { 0 };
  287. glGetInternalformativ(target, internalformat, GL_NUM_SAMPLE_COUNTS, 1, &num_sample_counts);
  288. auto samples_buffer = MUST(ByteBuffer::create_zeroed(num_sample_counts * sizeof(GLint)));
  289. glGetInternalformativ(target, internalformat, GL_SAMPLES, num_sample_counts, reinterpret_cast<GLint*>(samples_buffer.data()));
  290. auto array_buffer = JS::ArrayBuffer::create(m_realm, move(samples_buffer));
  291. return JS::Int32Array::create(m_realm, num_sample_counts, array_buffer);
  292. }
  293. default:
  294. dbgln("Unknown WebGL internal format parameter name: {:x}", pname);
  295. set_error(GL_INVALID_ENUM);
  296. return JS::js_null();
  297. }
  298. )~~~");
  299. }
  300. static void generate_webgl_object_handle_unwrap(SourceGenerator& generator, StringView object_name, StringView early_return_value)
  301. {
  302. StringBuilder string_builder;
  303. SourceGenerator unwrap_generator { string_builder };
  304. unwrap_generator.set("object_name", object_name);
  305. unwrap_generator.set("early_return_value", early_return_value);
  306. unwrap_generator.append(R"~~~(
  307. GLuint @object_name@_handle = 0;
  308. if (@object_name@) {
  309. auto handle_or_error = @object_name@->handle(this);
  310. if (handle_or_error.is_error()) {
  311. set_error(GL_INVALID_OPERATION);
  312. return @early_return_value@;
  313. }
  314. @object_name@_handle = handle_or_error.release_value();
  315. }
  316. )~~~");
  317. generator.append(unwrap_generator.as_string_view());
  318. }
  319. ErrorOr<int> serenity_main(Main::Arguments arguments)
  320. {
  321. StringView generated_header_path;
  322. StringView generated_implementation_path;
  323. Vector<ByteString> base_paths;
  324. StringView webgl_context_idl_path;
  325. Core::ArgsParser args_parser;
  326. args_parser.add_option(webgl_context_idl_path, "Path to the WebGLRenderingContext idl file", "webgl-idl-path", 'i', "webgl-idl-path");
  327. args_parser.add_option(Core::ArgsParser::Option {
  328. .argument_mode = Core::ArgsParser::OptionArgumentMode::Required,
  329. .help_string = "Path to root of IDL file tree(s)",
  330. .long_name = "base-path",
  331. .short_name = 'b',
  332. .value_name = "base-path",
  333. .accept_value = [&](StringView s) {
  334. base_paths.append(s);
  335. return true;
  336. },
  337. });
  338. args_parser.add_option(generated_header_path, "Path to the header file to generate", "generated-header-path", 'h', "generated-header-path");
  339. args_parser.add_option(generated_implementation_path, "Path to the implementation file to generate", "generated-implementation-path", 'c', "generated-implementation-path");
  340. args_parser.parse(arguments);
  341. auto generated_header_file = TRY(Core::File::open(generated_header_path, Core::File::OpenMode::Write));
  342. auto generated_implementation_file = TRY(Core::File::open(generated_implementation_path, Core::File::OpenMode::Write));
  343. auto idl_file = MUST(Core::File::open(webgl_context_idl_path, Core::File::OpenMode::Read));
  344. auto webgl_context_idl_file_content = MUST(idl_file->read_until_eof());
  345. Vector<ByteString> import_base_paths;
  346. for (auto const& base_path : base_paths) {
  347. VERIFY(!base_path.is_empty());
  348. import_base_paths.append(base_path);
  349. }
  350. IDL::Parser parser(webgl_context_idl_path, StringView(webgl_context_idl_file_content), import_base_paths);
  351. auto const& interface = parser.parse();
  352. auto path = LexicalPath(generated_header_path);
  353. auto title = path.title();
  354. auto first_dot = title.find('.');
  355. ByteString class_name = title;
  356. if (first_dot.has_value())
  357. class_name = title.substring_view(0, *first_dot);
  358. StringBuilder header_file_string_builder;
  359. SourceGenerator header_file_generator { header_file_string_builder };
  360. header_file_generator.set("class_name", class_name);
  361. StringBuilder implementation_file_string_builder;
  362. SourceGenerator implementation_file_generator { implementation_file_string_builder };
  363. implementation_file_generator.set("class_name", class_name);
  364. auto webgl_version = class_name == "WebGLRenderingContextImpl" ? 1 : 2;
  365. if (webgl_version == 1) {
  366. implementation_file_generator.append(R"~~~(
  367. #include <GLES2/gl2.h>
  368. #include <GLES2/gl2ext.h>
  369. )~~~");
  370. } else {
  371. implementation_file_generator.append(R"~~~(
  372. #include <GLES3/gl3.h>
  373. )~~~");
  374. }
  375. implementation_file_generator.append(R"~~~(
  376. #include <LibJS/Runtime/ArrayBuffer.h>
  377. #include <LibJS/Runtime/DataView.h>
  378. #include <LibJS/Runtime/TypedArray.h>
  379. #include <LibWeb/HTML/HTMLCanvasElement.h>
  380. #include <LibWeb/HTML/HTMLImageElement.h>
  381. #include <LibWeb/HTML/HTMLVideoElement.h>
  382. #include <LibWeb/HTML/ImageBitmap.h>
  383. #include <LibWeb/HTML/ImageData.h>
  384. #include <LibWeb/WebGL/OpenGLContext.h>
  385. #include <LibWeb/WebGL/WebGLActiveInfo.h>
  386. #include <LibWeb/WebGL/WebGLBuffer.h>
  387. #include <LibWeb/WebGL/WebGLFramebuffer.h>
  388. #include <LibWeb/WebGL/WebGLProgram.h>
  389. #include <LibWeb/WebGL/WebGLRenderbuffer.h>
  390. #include <LibWeb/WebGL/@class_name@.h>
  391. #include <LibWeb/WebGL/WebGLSampler.h>
  392. #include <LibWeb/WebGL/WebGLShader.h>
  393. #include <LibWeb/WebGL/WebGLSync.h>
  394. #include <LibWeb/WebGL/WebGLShaderPrecisionFormat.h>
  395. #include <LibWeb/WebGL/WebGLTexture.h>
  396. #include <LibWeb/WebGL/WebGLUniformLocation.h>
  397. #include <LibWeb/WebGL/WebGLVertexArrayObject.h>
  398. #include <LibWeb/WebIDL/Buffers.h>
  399. namespace Web::WebGL {
  400. static Vector<GLchar> null_terminated_string(StringView string)
  401. {
  402. Vector<GLchar> result;
  403. for (auto c : string.bytes())
  404. result.append(c);
  405. result.append('\\0');
  406. return result;
  407. }
  408. @class_name@::@class_name@(JS::Realm& realm, NonnullOwnPtr<OpenGLContext> context)
  409. : m_realm(realm)
  410. , m_context(move(context))
  411. {
  412. }
  413. )~~~");
  414. header_file_generator.append(R"~~~(
  415. #pragma once
  416. #include <AK/NonnullOwnPtr.h>
  417. #include <LibGC/Ptr.h>
  418. #include <LibGfx/Bitmap.h>
  419. #include <LibWeb/Bindings/PlatformObject.h>
  420. #include <LibWeb/Forward.h>
  421. #include <LibWeb/WebGL/WebGLRenderingContextBase.h>
  422. #include <LibWeb/WebIDL/Types.h>
  423. namespace Web::WebGL {
  424. using namespace Web::HTML;
  425. class @class_name@ : public WebGLRenderingContextBase {
  426. public:
  427. @class_name@(JS::Realm&, NonnullOwnPtr<OpenGLContext>);
  428. OpenGLContext& context() { return *m_context; }
  429. virtual void present() = 0;
  430. virtual void needs_to_present() = 0;
  431. virtual void set_error(GLenum) = 0;
  432. )~~~");
  433. for (auto const& function : interface.functions) {
  434. if (function.extended_attributes.contains("FIXME")) {
  435. continue;
  436. }
  437. if (function.name == "getSupportedExtensions"sv || function.name == "getExtension"sv || function.name == "getContextAttributes"sv || function.name == "isContextLost"sv) {
  438. // Implemented in WebGLRenderingContext
  439. continue;
  440. }
  441. StringBuilder function_declaration;
  442. StringBuilder function_parameters;
  443. for (size_t i = 0; i < function.parameters.size(); ++i) {
  444. auto const& parameter = function.parameters[i];
  445. function_parameters.append(to_cpp_type(*parameter.type, interface));
  446. function_parameters.append(" "sv);
  447. function_parameters.append(parameter.name.to_snakecase());
  448. if (i != function.parameters.size() - 1) {
  449. function_parameters.append(", "sv);
  450. }
  451. }
  452. auto function_name = function.name.to_snakecase();
  453. function_declaration.append(to_cpp_type(*function.return_type, interface));
  454. function_declaration.append(" "sv);
  455. function_declaration.append(function_name);
  456. function_declaration.append("("sv);
  457. function_declaration.append(function_parameters.string_view());
  458. function_declaration.append(");"sv);
  459. header_file_generator.append(" "sv);
  460. header_file_generator.append(function_declaration.string_view());
  461. header_file_generator.append("\n"sv);
  462. StringBuilder function_impl;
  463. SourceGenerator function_impl_generator { function_impl };
  464. function_impl_generator.set("class_name", class_name);
  465. ScopeGuard function_guard { [&] {
  466. function_impl_generator.append("}\n"sv);
  467. implementation_file_generator.append(function_impl_generator.as_string_view().bytes());
  468. } };
  469. function_impl_generator.set("function_name", function_name);
  470. function_impl_generator.set("function_parameters", function_parameters.string_view());
  471. function_impl_generator.set("function_return_type", to_cpp_type(*function.return_type, interface));
  472. function_impl_generator.append(R"~~~(
  473. @function_return_type@ @class_name@::@function_name@(@function_parameters@)
  474. {
  475. m_context->make_current();
  476. )~~~");
  477. if (gl_function_modifies_framebuffer(function.name)) {
  478. function_impl_generator.append(" m_context->notify_content_will_change();\n"sv);
  479. }
  480. if (function.name == "getUniformLocation"sv) {
  481. generate_webgl_object_handle_unwrap(function_impl_generator, "program"sv, "{}"sv);
  482. function_impl_generator.append(R"~~~(
  483. auto name_null_terminated = null_terminated_string(name);
  484. return WebGLUniformLocation::create(m_realm, glGetUniformLocation(program_handle, name_null_terminated.data()));
  485. )~~~");
  486. continue;
  487. }
  488. if (function.name == "createBuffer"sv) {
  489. function_impl_generator.append(R"~~~(
  490. GLuint handle = 0;
  491. glGenBuffers(1, &handle);
  492. return WebGLBuffer::create(m_realm, *this, handle);
  493. )~~~");
  494. continue;
  495. }
  496. if (function.name == "createTexture"sv) {
  497. function_impl_generator.append(R"~~~(
  498. GLuint handle = 0;
  499. glGenTextures(1, &handle);
  500. return WebGLTexture::create(m_realm, *this, handle);
  501. )~~~");
  502. continue;
  503. }
  504. if (function.name == "createFramebuffer"sv) {
  505. function_impl_generator.append(R"~~~(
  506. GLuint handle = 0;
  507. glGenFramebuffers(1, &handle);
  508. return WebGLFramebuffer::create(m_realm, *this, handle);
  509. )~~~");
  510. continue;
  511. }
  512. if (function.name == "createRenderbuffer"sv) {
  513. function_impl_generator.append(R"~~~(
  514. GLuint handle = 0;
  515. glGenRenderbuffers(1, &handle);
  516. return WebGLRenderbuffer::create(m_realm, *this, handle);
  517. )~~~");
  518. continue;
  519. }
  520. if (function.name == "invalidateFramebuffer"sv) {
  521. function_impl_generator.append(R"~~~(
  522. glInvalidateFramebuffer(target, attachments.size(), attachments.data());
  523. needs_to_present();
  524. )~~~");
  525. continue;
  526. }
  527. if (function.name == "createVertexArray"sv) {
  528. function_impl_generator.append(R"~~~(
  529. GLuint handle = 0;
  530. glGenVertexArrays(1, &handle);
  531. return WebGLVertexArrayObject::create(m_realm, *this, handle);
  532. )~~~");
  533. continue;
  534. }
  535. if (function.name == "createSampler"sv) {
  536. function_impl_generator.append(R"~~~(
  537. GLuint handle = 0;
  538. glGenSamplers(1, &handle);
  539. return WebGLSampler::create(m_realm, *this, handle);
  540. )~~~");
  541. continue;
  542. }
  543. if (function.name == "fenceSync"sv) {
  544. function_impl_generator.append(R"~~~(
  545. GLsync handle = glFenceSync(condition, flags);
  546. return WebGLSync::create(m_realm, *this, handle);
  547. )~~~");
  548. continue;
  549. }
  550. if (function.name == "shaderSource"sv) {
  551. generate_webgl_object_handle_unwrap(function_impl_generator, "shader"sv, ""sv);
  552. function_impl_generator.append(R"~~~(
  553. Vector<GLchar*> strings;
  554. auto string = null_terminated_string(source);
  555. strings.append(string.data());
  556. Vector<GLint> length;
  557. length.append(source.bytes().size());
  558. glShaderSource(shader_handle, 1, strings.data(), length.data());
  559. )~~~");
  560. continue;
  561. }
  562. if (function.name == "vertexAttribPointer"sv) {
  563. function_impl_generator.append(R"~~~(
  564. glVertexAttribPointer(index, size, type, normalized, stride, reinterpret_cast<void*>(offset));
  565. )~~~");
  566. continue;
  567. }
  568. if (function.name == "texStorage2D") {
  569. function_impl_generator.append(R"~~~(
  570. glTexStorage2D(target, levels, internalformat, width, height);
  571. )~~~");
  572. continue;
  573. }
  574. if (function.name == "texImage2D"sv && function.overload_index == 0) {
  575. function_impl_generator.append(R"~~~(
  576. void const* pixels_ptr = nullptr;
  577. if (pixels) {
  578. auto const& viewed_array_buffer = pixels->viewed_array_buffer();
  579. auto const& byte_buffer = viewed_array_buffer->buffer();
  580. pixels_ptr = byte_buffer.data();
  581. }
  582. glTexImage2D(target, level, internalformat, width, height, border, format, type, pixels_ptr);
  583. )~~~");
  584. continue;
  585. }
  586. if (function.name == "texImage3D"sv && function.overload_index == 0) {
  587. // FIXME: If a WebGLBuffer is bound to the PIXEL_UNPACK_BUFFER target, generates an INVALID_OPERATION error.
  588. // FIXME: If srcData is null, a buffer of sufficient size initialized to 0 is passed.
  589. // FIXME: If type is specified as FLOAT_32_UNSIGNED_INT_24_8_REV, srcData must be null; otherwise, generates an INVALID_OPERATION error.
  590. // FIXME: If srcData is non-null, the type of srcData must match the type according to the above table; otherwise, generate an INVALID_OPERATION error.
  591. // FIXME: If an attempt is made to call this function with no WebGLTexture bound (see above), generates an INVALID_OPERATION error.
  592. // FIXME: If there's not enough data in srcData starting at srcOffset, generate INVALID_OPERATION.
  593. function_impl_generator.append(R"~~~(
  594. void const* src_data_ptr = nullptr;
  595. if (src_data) {
  596. auto const& viewed_array_buffer = src_data->viewed_array_buffer();
  597. auto const& byte_buffer = viewed_array_buffer->buffer();
  598. src_data_ptr = byte_buffer.data();
  599. }
  600. glTexImage3D(target, level, internalformat, width, height, depth, border, format, type, src_data_ptr);
  601. )~~~");
  602. continue;
  603. }
  604. if (function.name == "texImage3D"sv && function.overload_index == 1) {
  605. // FIXME: If a WebGLBuffer is bound to the PIXEL_UNPACK_BUFFER target, generates an INVALID_OPERATION error.
  606. // FIXME: If srcData is null, a buffer of sufficient size initialized to 0 is passed.
  607. // FIXME: If type is specified as FLOAT_32_UNSIGNED_INT_24_8_REV, srcData must be null; otherwise, generates an INVALID_OPERATION error.
  608. // FIXME: If srcData is non-null, the type of srcData must match the type according to the above table; otherwise, generate an INVALID_OPERATION error.
  609. // FIXME: If an attempt is made to call this function with no WebGLTexture bound (see above), generates an INVALID_OPERATION error.
  610. // FIXME: If there's not enough data in srcData starting at srcOffset, generate INVALID_OPERATION.
  611. function_impl_generator.append(R"~~~(
  612. void const* src_data_ptr = nullptr;
  613. if (src_data) {
  614. auto const& viewed_array_buffer = src_data->viewed_array_buffer();
  615. auto const& byte_buffer = viewed_array_buffer->buffer();
  616. src_data_ptr = byte_buffer.data() + src_offset;
  617. }
  618. glTexImage3D(target, level, internalformat, width, height, depth, border, format, type, src_data_ptr);
  619. )~~~");
  620. continue;
  621. }
  622. if (function.name == "texImage2D"sv && function.overload_index == 1) {
  623. // FIXME: If this function is called with an ImageData whose data attribute has been neutered,
  624. // an INVALID_VALUE error is generated.
  625. // FIXME: If this function is called with an ImageBitmap that has been neutered, an INVALID_VALUE
  626. // error is generated.
  627. // FIXME: If this function is called with an HTMLImageElement or HTMLVideoElement whose origin
  628. // differs from the origin of the containing Document, or with an HTMLCanvasElement,
  629. // ImageBitmap or OffscreenCanvas whose bitmap's origin-clean flag is set to false,
  630. // a SECURITY_ERR exception must be thrown. See Origin Restrictions.
  631. // FIXME: If source is null then an INVALID_VALUE error is generated.
  632. function_impl_generator.append(R"~~~(
  633. auto bitmap = source.visit(
  634. [](GC::Root<HTMLImageElement> const& source) -> RefPtr<Gfx::ImmutableBitmap> {
  635. return source->immutable_bitmap();
  636. },
  637. [](GC::Root<HTMLCanvasElement> const& source) -> RefPtr<Gfx::ImmutableBitmap> {
  638. auto surface = source->surface();
  639. if (!surface)
  640. return {};
  641. auto bitmap = MUST(Gfx::Bitmap::create(Gfx::BitmapFormat::RGBA8888, Gfx::AlphaType::Premultiplied, surface->size()));
  642. surface->read_into_bitmap(*bitmap);
  643. return Gfx::ImmutableBitmap::create(*bitmap);
  644. },
  645. [](GC::Root<HTMLVideoElement> const& source) -> RefPtr<Gfx::ImmutableBitmap> {
  646. return Gfx::ImmutableBitmap::create(*source->bitmap());
  647. },
  648. [](GC::Root<ImageBitmap> const& source) -> RefPtr<Gfx::ImmutableBitmap> {
  649. return Gfx::ImmutableBitmap::create(*source->bitmap());
  650. },
  651. [](GC::Root<ImageData> const& source) -> RefPtr<Gfx::ImmutableBitmap> {
  652. return Gfx::ImmutableBitmap::create(source->bitmap());
  653. });
  654. if (!bitmap)
  655. return;
  656. void const* pixels_ptr = bitmap->bitmap()->begin();
  657. int width = bitmap->width();
  658. int height = bitmap->height();
  659. glTexImage2D(target, level, internalformat, width, height, 0, format, type, pixels_ptr);
  660. )~~~");
  661. continue;
  662. }
  663. if (webgl_version == 2 && function.name == "texImage2D"sv && function.overload_index == 2) {
  664. function_impl_generator.append(R"~~~(
  665. void const* pixels_ptr = nullptr;
  666. if (src_data) {
  667. auto const& viewed_array_buffer = src_data->viewed_array_buffer();
  668. auto const& byte_buffer = viewed_array_buffer->buffer();
  669. pixels_ptr = byte_buffer.data() + src_offset;
  670. }
  671. glTexImage2D(target, level, internalformat, width, height, border, format, type, pixels_ptr);
  672. )~~~");
  673. continue;
  674. }
  675. if (function.name == "texSubImage2D"sv && function.overload_index == 0) {
  676. function_impl_generator.append(R"~~~(
  677. void const* pixels_ptr = nullptr;
  678. if (pixels) {
  679. auto const& viewed_array_buffer = pixels->viewed_array_buffer();
  680. auto const& byte_buffer = viewed_array_buffer->buffer();
  681. pixels_ptr = byte_buffer.data();
  682. }
  683. glTexSubImage2D(target, level, xoffset, yoffset, width, height, format, type, pixels_ptr);
  684. )~~~");
  685. continue;
  686. }
  687. if (webgl_version == 2 && function.name == "texSubImage2D"sv && function.overload_index == 1) {
  688. function_impl_generator.append(R"~~~(
  689. void const* pixels_ptr = nullptr;
  690. if (src_data) {
  691. auto const& viewed_array_buffer = src_data->viewed_array_buffer();
  692. auto const& byte_buffer = viewed_array_buffer->buffer();
  693. pixels_ptr = byte_buffer.data() + src_offset;
  694. }
  695. glTexSubImage2D(target, level, xoffset, yoffset, width, height, format, type, pixels_ptr);
  696. )~~~");
  697. continue;
  698. }
  699. if (function.name == "texSubImage3D"sv && function.overload_index == 0) {
  700. function_impl_generator.append(R"~~~(
  701. void const* pixels_ptr = nullptr;
  702. if (src_data) {
  703. auto const& viewed_array_buffer = src_data->viewed_array_buffer();
  704. auto const& byte_buffer = viewed_array_buffer->buffer();
  705. pixels_ptr = byte_buffer.data() + src_offset;
  706. }
  707. glTexSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, pixels_ptr);
  708. )~~~");
  709. continue;
  710. }
  711. if (function.name == "getShaderParameter"sv) {
  712. generate_webgl_object_handle_unwrap(function_impl_generator, "shader"sv, "JS::js_null()"sv);
  713. function_impl_generator.append(R"~~~(
  714. GLint result = 0;
  715. glGetShaderiv(shader_handle, pname, &result);
  716. return JS::Value(result);
  717. )~~~");
  718. continue;
  719. }
  720. if (function.name == "getProgramParameter"sv) {
  721. generate_webgl_object_handle_unwrap(function_impl_generator, "program"sv, "JS::js_null()"sv);
  722. function_impl_generator.append(R"~~~(
  723. GLint result = 0;
  724. glGetProgramiv(program_handle, pname, &result);
  725. return JS::Value(result);
  726. )~~~");
  727. continue;
  728. }
  729. if (function.name == "bufferData"sv && function.overload_index == 0) {
  730. function_impl_generator.append(R"~~~(
  731. glBufferData(target, size, 0, usage);
  732. )~~~");
  733. continue;
  734. }
  735. if (webgl_version == 2 && function.name == "bufferData"sv && function.overload_index == 2) {
  736. function_impl_generator.append(R"~~~(
  737. VERIFY(src_data);
  738. auto const& viewed_array_buffer = src_data->viewed_array_buffer();
  739. auto const& byte_buffer = viewed_array_buffer->buffer();
  740. auto src_data_length = src_data->byte_length();
  741. auto src_data_element_size = src_data->element_size();
  742. u8 const* buffer_ptr = byte_buffer.data();
  743. u64 copy_length = length == 0 ? src_data_length - src_offset : length;
  744. copy_length *= src_data_element_size;
  745. if (src_offset > src_data_length) {
  746. set_error(GL_INVALID_VALUE);
  747. return;
  748. }
  749. if (src_offset + copy_length > src_data_length) {
  750. set_error(GL_INVALID_VALUE);
  751. return;
  752. }
  753. buffer_ptr += src_offset * src_data_element_size;
  754. glBufferData(target, copy_length, buffer_ptr, usage);
  755. )~~~");
  756. continue;
  757. }
  758. if (webgl_version == 2 && function.name == "bufferSubData"sv && function.overload_index == 1) {
  759. function_impl_generator.append(R"~~~(
  760. VERIFY(src_data);
  761. auto const& viewed_array_buffer = src_data->viewed_array_buffer();
  762. auto const& byte_buffer = viewed_array_buffer->buffer();
  763. auto src_data_length = src_data->byte_length();
  764. auto src_data_element_size = src_data->element_size();
  765. u8 const* buffer_ptr = byte_buffer.data();
  766. u64 copy_length = length == 0 ? src_data_length - src_offset : length;
  767. copy_length *= src_data_element_size;
  768. if (src_offset > src_data_length) {
  769. set_error(GL_INVALID_VALUE);
  770. return;
  771. }
  772. if (src_offset + copy_length > src_data_length) {
  773. set_error(GL_INVALID_VALUE);
  774. return;
  775. }
  776. buffer_ptr += src_offset * src_data_element_size;
  777. glBufferSubData(target, dst_byte_offset, copy_length, buffer_ptr);
  778. )~~~");
  779. continue;
  780. }
  781. if (function.name == "readPixels"sv) {
  782. function_impl_generator.append(R"~~~(
  783. if (!pixels) {
  784. return;
  785. }
  786. void *ptr = nullptr;
  787. if (pixels->is_data_view()) {
  788. auto& data_view = static_cast<JS::DataView&>(*pixels->raw_object());
  789. ptr = data_view.viewed_array_buffer()->buffer().data();
  790. } else if (pixels->is_typed_array_base()) {
  791. auto& typed_array_base = static_cast<JS::TypedArrayBase&>(*pixels->raw_object());
  792. ptr = typed_array_base.viewed_array_buffer()->buffer().data();
  793. } else {
  794. VERIFY_NOT_REACHED();
  795. }
  796. glReadPixels(x, y, width, height, format, type, ptr);
  797. )~~~");
  798. continue;
  799. }
  800. if (function.name == "drawElements"sv) {
  801. function_impl_generator.append(R"~~~(
  802. glDrawElements(mode, count, type, reinterpret_cast<void*>(offset));
  803. needs_to_present();
  804. )~~~");
  805. continue;
  806. }
  807. if (function.name == "drawBuffers"sv) {
  808. function_impl_generator.append(R"~~~(
  809. glDrawBuffers(buffers.size(), buffers.data());
  810. )~~~");
  811. continue;
  812. }
  813. if (function.name.starts_with("uniformMatrix"sv)) {
  814. auto number_of_matrix_elements = function.name.substring_view(13, 1);
  815. function_impl_generator.set("number_of_matrix_elements", number_of_matrix_elements);
  816. if (webgl_version == 1) {
  817. function_impl_generator.set("array_argument_name", "value");
  818. } else {
  819. function_impl_generator.set("array_argument_name", "data");
  820. }
  821. function_impl_generator.append(R"~~~(
  822. auto matrix_size = @number_of_matrix_elements@ * @number_of_matrix_elements@;
  823. float const* raw_data = nullptr;
  824. u64 count = 0;
  825. if (@array_argument_name@.has<Vector<float>>()) {
  826. auto& vector_data = @array_argument_name@.get<Vector<float>>();
  827. raw_data = vector_data.data();
  828. count = vector_data.size() / matrix_size;
  829. } else {
  830. auto& typed_array_base = static_cast<JS::TypedArrayBase&>(*@array_argument_name@.get<GC::Root<WebIDL::BufferSource>>()->raw_object());
  831. auto& float32_array = verify_cast<JS::Float32Array>(typed_array_base);
  832. raw_data = float32_array.data().data();
  833. count = float32_array.array_length().length() / matrix_size;
  834. }
  835. )~~~");
  836. if (webgl_version == 2) {
  837. function_impl_generator.append(R"~~~(
  838. if (src_offset + src_length > (count * matrix_size)) {
  839. set_error(GL_INVALID_VALUE);
  840. return;
  841. }
  842. raw_data += src_offset;
  843. if (src_length == 0) {
  844. count -= src_offset;
  845. } else {
  846. count = src_length;
  847. }
  848. )~~~");
  849. }
  850. function_impl_generator.append(R"~~~(
  851. glUniformMatrix@number_of_matrix_elements@fv(location->handle(), count, transpose, raw_data);
  852. )~~~");
  853. continue;
  854. }
  855. if (function.name == "uniform1fv"sv || function.name == "uniform2fv"sv || function.name == "uniform3fv"sv || function.name == "uniform4fv"sv || function.name == "uniform1iv"sv || function.name == "uniform2iv"sv || function.name == "uniform3iv"sv || function.name == "uniform4iv"sv) {
  856. auto number_of_vector_elements = function.name.substring_view(7, 1);
  857. auto element_type = function.name.substring_view(8, 1);
  858. if (element_type == "f"sv) {
  859. function_impl_generator.set("cpp_element_type", "float"sv);
  860. function_impl_generator.set("typed_array_type", "Float32Array"sv);
  861. function_impl_generator.set("gl_postfix", "f"sv);
  862. } else if (element_type == "i"sv) {
  863. function_impl_generator.set("cpp_element_type", "int"sv);
  864. function_impl_generator.set("typed_array_type", "Int32Array"sv);
  865. function_impl_generator.set("gl_postfix", "i"sv);
  866. } else {
  867. VERIFY_NOT_REACHED();
  868. }
  869. function_impl_generator.set("number_of_vector_elements", number_of_vector_elements);
  870. function_impl_generator.append(R"~~~(
  871. @cpp_element_type@ const* data = nullptr;
  872. size_t count = 0;
  873. if (v.has<Vector<@cpp_element_type@>>()) {
  874. auto& vector = v.get<Vector<@cpp_element_type@>>();
  875. data = vector.data();
  876. count = vector.size();
  877. } else if (v.has<GC::Root<WebIDL::BufferSource>>()) {
  878. auto& typed_array_base = static_cast<JS::TypedArrayBase&>(*v.get<GC::Root<WebIDL::BufferSource>>()->raw_object());
  879. auto& typed_array = verify_cast<JS::@typed_array_type@>(typed_array_base);
  880. data = typed_array.data().data();
  881. count = typed_array.array_length().length();
  882. } else {
  883. VERIFY_NOT_REACHED();
  884. }
  885. )~~~");
  886. if (webgl_version == 2) {
  887. function_impl_generator.append(R"~~~(
  888. if (src_offset + src_length > count) {
  889. set_error(GL_INVALID_VALUE);
  890. return;
  891. }
  892. data += src_offset;
  893. if (src_length == 0) {
  894. count -= src_offset;
  895. } else {
  896. count = src_length;
  897. }
  898. )~~~");
  899. }
  900. function_impl_generator.append(R"~~~(
  901. glUniform@number_of_vector_elements@@gl_postfix@v(location->handle(), count / @number_of_vector_elements@, data);
  902. )~~~");
  903. continue;
  904. }
  905. if (function.name == "vertexAttrib1fv"sv || function.name == "vertexAttrib2fv"sv || function.name == "vertexAttrib3fv"sv || function.name == "vertexAttrib4fv"sv) {
  906. auto number_of_vector_elements = function.name.substring_view(12, 1);
  907. function_impl_generator.set("number_of_vector_elements", number_of_vector_elements);
  908. function_impl_generator.append(R"~~~(
  909. if (values.has<Vector<float>>()) {
  910. auto& data = values.get<Vector<float>>();
  911. glVertexAttrib@number_of_vector_elements@fv(index, data.data());
  912. return;
  913. }
  914. auto& typed_array_base = static_cast<JS::TypedArrayBase&>(*values.get<GC::Root<WebIDL::BufferSource>>()->raw_object());
  915. auto& float32_array = verify_cast<JS::Float32Array>(typed_array_base);
  916. float const* data = float32_array.data().data();
  917. glVertexAttrib@number_of_vector_elements@fv(index, data);
  918. )~~~");
  919. continue;
  920. }
  921. if (function.name == "getParameter"sv) {
  922. generate_get_parameter(function_impl_generator, webgl_version);
  923. continue;
  924. }
  925. if (function.name == "getBufferParameter"sv) {
  926. generate_get_buffer_parameter(function_impl_generator);
  927. continue;
  928. }
  929. if (function.name == "getInternalformatParameter") {
  930. generate_get_internal_format_parameter(function_impl_generator);
  931. continue;
  932. }
  933. if (function.name == "getActiveUniform"sv) {
  934. generate_webgl_object_handle_unwrap(function_impl_generator, "program"sv, "{}"sv);
  935. function_impl_generator.append(R"~~~(
  936. GLint size = 0;
  937. GLenum type = 0;
  938. GLsizei buf_size = 256;
  939. GLsizei length = 0;
  940. GLchar name[256];
  941. glGetActiveUniform(program_handle, index, buf_size, &length, &size, &type, name);
  942. auto readonly_bytes = ReadonlyBytes { name, static_cast<size_t>(length) };
  943. return WebGLActiveInfo::create(m_realm, String::from_utf8_without_validation(readonly_bytes), type, size);
  944. )~~~");
  945. continue;
  946. }
  947. if (function.name == "getActiveAttrib"sv) {
  948. generate_webgl_object_handle_unwrap(function_impl_generator, "program"sv, "{}"sv);
  949. function_impl_generator.append(R"~~~(
  950. GLint size = 0;
  951. GLenum type = 0;
  952. GLsizei buf_size = 256;
  953. GLsizei length = 0;
  954. GLchar name[256];
  955. glGetActiveAttrib(program_handle, index, buf_size, &length, &size, &type, name);
  956. auto readonly_bytes = ReadonlyBytes { name, static_cast<size_t>(length) };
  957. return WebGLActiveInfo::create(m_realm, String::from_utf8_without_validation(readonly_bytes), type, size);
  958. )~~~");
  959. continue;
  960. }
  961. if (function.name == "getShaderInfoLog"sv) {
  962. generate_webgl_object_handle_unwrap(function_impl_generator, "shader"sv, "{}"sv);
  963. function_impl_generator.append(R"~~~(
  964. GLint info_log_length = 0;
  965. glGetShaderiv(shader_handle, GL_INFO_LOG_LENGTH, &info_log_length);
  966. Vector<GLchar> info_log;
  967. info_log.resize(info_log_length);
  968. if (!info_log_length)
  969. return String {};
  970. glGetShaderInfoLog(shader_handle, info_log_length, nullptr, info_log.data());
  971. return String::from_utf8_without_validation(ReadonlyBytes { info_log.data(), static_cast<size_t>(info_log_length - 1) });
  972. )~~~");
  973. continue;
  974. }
  975. if (function.name == "getProgramInfoLog"sv) {
  976. generate_webgl_object_handle_unwrap(function_impl_generator, "program"sv, "{}"sv);
  977. function_impl_generator.append(R"~~~(
  978. GLint info_log_length = 0;
  979. glGetProgramiv(program_handle, GL_INFO_LOG_LENGTH, &info_log_length);
  980. Vector<GLchar> info_log;
  981. info_log.resize(info_log_length);
  982. if (!info_log_length)
  983. return String {};
  984. glGetProgramInfoLog(program_handle, info_log_length, nullptr, info_log.data());
  985. return String::from_utf8_without_validation(ReadonlyBytes { info_log.data(), static_cast<size_t>(info_log_length - 1) });
  986. )~~~");
  987. continue;
  988. }
  989. if (function.name == "getShaderPrecisionFormat"sv) {
  990. function_impl_generator.append(R"~~~(
  991. GLint range[2];
  992. GLint precision;
  993. glGetShaderPrecisionFormat(shadertype, precisiontype, range, &precision);
  994. return WebGLShaderPrecisionFormat::create(m_realm, range[0], range[1], precision);
  995. )~~~");
  996. continue;
  997. }
  998. if (function.name == "deleteBuffer"sv) {
  999. generate_webgl_object_handle_unwrap(function_impl_generator, "buffer"sv, ""sv);
  1000. function_impl_generator.append(R"~~~(
  1001. glDeleteBuffers(1, &buffer_handle);
  1002. )~~~");
  1003. continue;
  1004. }
  1005. if (function.name == "deleteFramebuffer"sv) {
  1006. generate_webgl_object_handle_unwrap(function_impl_generator, "framebuffer"sv, ""sv);
  1007. function_impl_generator.append(R"~~~(
  1008. glDeleteFramebuffers(1, &framebuffer_handle);
  1009. )~~~");
  1010. continue;
  1011. }
  1012. if (function.name == "deleteRenderbuffer"sv) {
  1013. generate_webgl_object_handle_unwrap(function_impl_generator, "renderbuffer"sv, ""sv);
  1014. function_impl_generator.append(R"~~~(
  1015. glDeleteRenderbuffers(1, &renderbuffer_handle);
  1016. )~~~");
  1017. continue;
  1018. }
  1019. if (function.name == "deleteTexture"sv) {
  1020. generate_webgl_object_handle_unwrap(function_impl_generator, "texture"sv, ""sv);
  1021. function_impl_generator.append(R"~~~(
  1022. glDeleteTextures(1, &texture_handle);
  1023. )~~~");
  1024. continue;
  1025. }
  1026. if (function.name == "deleteVertexArray"sv) {
  1027. generate_webgl_object_handle_unwrap(function_impl_generator, "vertex_array"sv, ""sv);
  1028. function_impl_generator.append(R"~~~(
  1029. glDeleteVertexArrays(1, &vertex_array_handle);
  1030. )~~~");
  1031. continue;
  1032. }
  1033. Vector<ByteString> gl_call_arguments;
  1034. for (size_t i = 0; i < function.parameters.size(); ++i) {
  1035. auto const& parameter = function.parameters[i];
  1036. auto parameter_name = parameter.name.to_snakecase();
  1037. if (parameter.type->is_numeric() || parameter.type->is_boolean()) {
  1038. gl_call_arguments.append(parameter_name);
  1039. continue;
  1040. }
  1041. if (parameter.type->is_string()) {
  1042. function_impl_generator.set("parameter_name", parameter_name);
  1043. function_impl_generator.append(R"~~~(
  1044. auto @parameter_name@_null_terminated = null_terminated_string(@parameter_name@);
  1045. )~~~");
  1046. gl_call_arguments.append(ByteString::formatted("{}_null_terminated.data()", parameter_name));
  1047. continue;
  1048. }
  1049. if (is_webgl_object_type(parameter.type->name())) {
  1050. if (function.return_type->name() == "undefined"sv) {
  1051. function_impl_generator.set("early_return_value", "");
  1052. } else if (function.return_type->is_integer()) {
  1053. function_impl_generator.set("early_return_value", "-1");
  1054. } else if (function.return_type->is_boolean()) {
  1055. function_impl_generator.set("early_return_value", "false");
  1056. } else {
  1057. VERIFY_NOT_REACHED();
  1058. }
  1059. function_impl_generator.set("handle_parameter_name", parameter_name);
  1060. function_impl_generator.append(R"~~~(
  1061. auto @handle_parameter_name@_handle = 0;
  1062. if (@handle_parameter_name@) {
  1063. auto handle_or_error = @handle_parameter_name@->handle(this);
  1064. if (handle_or_error.is_error()) {
  1065. set_error(GL_INVALID_OPERATION);
  1066. return @early_return_value@;
  1067. }
  1068. @handle_parameter_name@_handle = handle_or_error.release_value();
  1069. }
  1070. )~~~");
  1071. gl_call_arguments.append(ByteString::formatted("{}_handle", parameter_name));
  1072. continue;
  1073. }
  1074. if (parameter.type->name() == "WebGLUniformLocation"sv) {
  1075. gl_call_arguments.append(ByteString::formatted("{} ? {}->handle() : 0", parameter_name, parameter_name));
  1076. continue;
  1077. }
  1078. if (parameter.type->name() == "WebGLSync"sv) {
  1079. // FIXME: Remove the GLsync cast once sync_handle actually returns the proper GLsync type.
  1080. gl_call_arguments.append(ByteString::formatted("(GLsync)({} ? {}->sync_handle() : nullptr)", parameter_name, parameter_name));
  1081. continue;
  1082. }
  1083. if (parameter.type->name() == "BufferSource"sv) {
  1084. function_impl_generator.set("buffer_source_name", parameter_name);
  1085. function_impl_generator.append(R"~~~(
  1086. void const* ptr = nullptr;
  1087. size_t byte_size = 0;
  1088. if (@buffer_source_name@->is_typed_array_base()) {
  1089. auto& typed_array_base = static_cast<JS::TypedArrayBase&>(*@buffer_source_name@->raw_object());
  1090. ptr = typed_array_base.viewed_array_buffer()->buffer().data();
  1091. byte_size = typed_array_base.viewed_array_buffer()->byte_length();
  1092. } else if (@buffer_source_name@->is_data_view()) {
  1093. auto& data_view = static_cast<JS::DataView&>(*@buffer_source_name@->raw_object());
  1094. ptr = data_view.viewed_array_buffer()->buffer().data();
  1095. byte_size = data_view.viewed_array_buffer()->byte_length();
  1096. } else if (@buffer_source_name@->is_array_buffer()) {
  1097. auto& array_buffer = static_cast<JS::ArrayBuffer&>(*@buffer_source_name@->raw_object());
  1098. ptr = array_buffer.buffer().data();
  1099. byte_size = array_buffer.byte_length();
  1100. } else {
  1101. VERIFY_NOT_REACHED();
  1102. }
  1103. )~~~");
  1104. gl_call_arguments.append(ByteString::formatted("byte_size"));
  1105. gl_call_arguments.append(ByteString::formatted("ptr"));
  1106. continue;
  1107. }
  1108. VERIFY_NOT_REACHED();
  1109. }
  1110. StringBuilder gl_call_arguments_string_builder;
  1111. gl_call_arguments_string_builder.join(", "sv, gl_call_arguments);
  1112. auto gl_call_string = ByteString::formatted("{}({})", idl_to_gl_function_name(function.name), gl_call_arguments_string_builder.string_view());
  1113. function_impl_generator.set("call_string", gl_call_string);
  1114. if (gl_function_modifies_framebuffer(function.name)) {
  1115. function_impl_generator.append(" needs_to_present();\n"sv);
  1116. }
  1117. if (function.return_type->name() == "undefined"sv) {
  1118. function_impl_generator.append(" @call_string@;"sv);
  1119. } else if (function.return_type->is_integer() || function.return_type->is_boolean()) {
  1120. function_impl_generator.append(" return @call_string@;"sv);
  1121. } else if (is_webgl_object_type(function.return_type->name())) {
  1122. function_impl_generator.set("return_type_name", function.return_type->name());
  1123. function_impl_generator.append(" return @return_type_name@::create(m_realm, *this, @call_string@);"sv);
  1124. } else {
  1125. VERIFY_NOT_REACHED();
  1126. }
  1127. function_impl_generator.append("\n"sv);
  1128. }
  1129. header_file_generator.append(R"~~~(
  1130. private:
  1131. GC::Ref<JS::Realm> m_realm;
  1132. NonnullOwnPtr<OpenGLContext> m_context;
  1133. };
  1134. }
  1135. )~~~");
  1136. implementation_file_generator.append(R"~~~(
  1137. }
  1138. )~~~");
  1139. MUST(generated_header_file->write_until_depleted(header_file_generator.as_string_view().bytes()));
  1140. MUST(generated_implementation_file->write_until_depleted(implementation_file_generator.as_string_view().bytes()));
  1141. return 0;
  1142. }