From b0980f91b199a1a407fede50fa0e0a4dbc9fee50 Mon Sep 17 00:00:00 2001 From: gurpreetsinghmatharoo Date: Thu, 26 Dec 2024 09:49:18 +0530 Subject: [PATCH] docs(general): Fixed code blocks on YUV Videos page https://github.com/YoYoGames/GameMaker-Bugs/issues/8832 --- .../Drawing/Videos/YUV_Videos.htm | 134 +++++++++--------- 1 file changed, 65 insertions(+), 69 deletions(-) diff --git a/Manual/contents/GameMaker_Language/GML_Reference/Drawing/Videos/YUV_Videos.htm b/Manual/contents/GameMaker_Language/GML_Reference/Drawing/Videos/YUV_Videos.htm index f8aa6a3ac..1c828429f 100644 --- a/Manual/contents/GameMaker_Language/GML_Reference/Drawing/Videos/YUV_Videos.htm +++ b/Manual/contents/GameMaker_Language/GML_Reference/Drawing/Videos/YUV_Videos.htm @@ -3,7 +3,7 @@ - + YUV Videos @@ -21,79 +21,75 @@

YUV Videos

Read the video_draw() reference page first for information on what data that function returns for YUV videos, and then continue reading below for instructions on using that data to draw the video.

YUV Shader

Create a shader asset in your project, and replace its Fragment Shader (.fsh) code with this:

- 
//
-// CUSTOM fragment shader for handling YUV content
-//
-varying vec2 v_vTexcoord;
-varying vec4 v_vColour;
-uniform sampler2D v_chroma;
-const float x = 1.164383;
-const float y = 1.138393;
-const float z = 1.138393;
-const vec3 src_bias = vec3(16.0 / 255.0, 128.0 / 255.0, 128.0 / 255.0);
-const mat3 src_xform = mat3(1.00000000 * x,  0.00000000 * y,  1.57480000 * z,
-                            1.00000000 * x, -0.18732427 * y, -0.46812427 * z,
-			    1.00000000 * x,  1.85560000 * y,  0.00000000 * z);
-void main()
-{
-    float yy = texture2D(gm_BaseTexture, vec2(v_vTexcoord.x, v_vTexcoord.y)).r;
-    vec2 cbcr = texture2D(v_chroma, vec2(v_vTexcoord.x, v_vTexcoord.y)).rg;
-    vec3 yuv = vec3(yy, cbcr);
-    yuv -= src_bias;
-    yuv *= src_xform;
-    gl_FragColor = vec4(yuv, 1.0);
-}
-  
-
+

//
+ // CUSTOM fragment shader for handling YUV content
+ //
+ varying vec2 v_vTexcoord;
+ varying vec4 v_vColour;
+ uniform sampler2D v_chroma;
+ const float x = 1.164383;
+ const float y = 1.138393;
+ const float z = 1.138393;
+ const vec3 src_bias = vec3(16.0 / 255.0, 128.0 / 255.0, 128.0 / 255.0);
+ const mat3 src_xform = mat3(1.00000000 * x,  0.00000000 * y,  1.57480000 * z,
+                             1.00000000 * x, -0.18732427 * y, -0.46812427 * z,
+                             1.00000000 * x,  1.85560000 * y,  0.00000000 * z);
+ void main()
+ {
+     float yy = texture2D(gm_BaseTexture, vec2(v_vTexcoord.x, v_vTexcoord.y)).r;
+     vec2 cbcr = texture2D(v_chroma, vec2(v_vTexcoord.x, v_vTexcoord.y)).rg;
+     vec3 yuv = vec3(yy, cbcr);
+     yuv -= src_bias;
+     yuv *= src_xform;
+     gl_FragColor = vec4(yuv, 1.0);
+ }

Get Sampler

In the Create event of your object, get the sampler ID of the v_chroma shader uniform, only if the video is YUV:

- 
var _format = video_get_format();
-if (_format == video_format_yuv)
-{
-    videochromasampler = shader_get_sampler_index(shader_YUV, "v_chroma");
-}
-
+

var _format = video_get_format();
+ if (_format == video_format_yuv)
+ {
+     videochromasampler = shader_get_sampler_index(shader_YUV, "v_chroma");
+ }

Draw Video

In the Draw event of your object, call video_draw(), and if its first array position is 0 (meaning the video is playing), draw the video.

In the code below, we're using a switch statement on the video_get_format() function. If the video is using the RGBA format, then it simply draws the surface in position [1] of the array.

If the video is using the YUV format, it uses the shader to draw the two surfaces (in positions [1] and [2]) onto a primitive quad.

- 
var _data = video_draw();
-if(_data[0] == 0)
-{
-	switch(video_get_format())
-	{
-		case video_format_rgba:
-			var _surf = _data[1];
-			draw_surface(_surf,0,0);
-		break;
-	
-		//  #### YUV PART HERE ####
-		case video_format_yuv:
-			var _surf = _data[1];
-			var _chromasurf = _data[2];
-			if(surface_exists(_surf) and surface_exists(_chromasurf))
-			{
-				shader_set(shader_YUV);
-			
-				var _tex_id = surface_get_texture(_surf);
-				var _chroma_tex_id = surface_get_texture(_chromasurf);
-				texture_set_stage(videochromasampler, _chroma_tex_id);
-				gpu_set_texfilter(false);
-			
-				draw_primitive_begin_texture(pr_trianglestrip, _tex_id);
-			        draw_vertex_texture(0, 0, 0, 0);
-				draw_vertex_texture(surface_get_width(_chromasurf), 0, 1, 0);
-				draw_vertex_texture(0, surface_get_height(_chromasurf), 0, 1);
-				draw_vertex_texture(surface_get_width(_chromasurf), surface_get_height(_chromasurf), 1, 1);
-				draw_primitive_end();
-			
-				gpu_set_texfilter(true);
-				shader_reset();
-			}
-		break;
-	}
-}
-
+

var _data = video_draw();
+ if(_data[0] == 0)
+ {
+     switch(video_get_format())
+     {
+         case video_format_rgba:
+             var _surf = _data[1];
+             draw_surface(_surf,0,0);
+         break;
+     
+         //  #### YUV PART HERE ####
+         case video_format_yuv:
+             var _surf = _data[1];
+             var _chromasurf = _data[2];
+             if(surface_exists(_surf) and surface_exists(_chromasurf))
+             {
+                 shader_set(shader_YUV);
+             
+                 var _tex_id = surface_get_texture(_surf);
+                 var _chroma_tex_id = surface_get_texture(_chromasurf);
+                 texture_set_stage(videochromasampler, _chroma_tex_id);
+                 gpu_set_texfilter(false);
+             
+                 draw_primitive_begin_texture(pr_trianglestrip, _tex_id);
+                 draw_vertex_texture(0, 0, 0, 0);
+                 draw_vertex_texture(surface_get_width(_chromasurf), 0, 1, 0);
+                 draw_vertex_texture(0, surface_get_height(_chromasurf), 0, 1);
+                 draw_vertex_texture(surface_get_width(_chromasurf), surface_get_height(_chromasurf), 1, 1);
+                 draw_primitive_end();
+             
+                 gpu_set_texfilter(true);
+                 shader_reset();
+             }
+         break;
+     }
+ }

The code under case video_format_yuv: does the following: