使用ImageSharp加载纹理后在OpenTK中仅显示白色四边形问题

Hey there! Let's dig into why you're only seeing a white quad after loading your image with ImageSharp and pushing it to VRAM in OpenTK—this is a super common gotcha when moving away from BitmapData, so let's break it down step by step.

1. Pixel Format Mismatch Between ImageSharp and OpenGL #

ImageSharp uses its own pixel formats (like Rgba32 or Bgr32) that don't always map directly to OpenGL's expectations. If you're passing the wrong format flags when uploading data, OpenGL can't interpret the pixels correctly, resulting in a white quad.

• Fix: Ensure you're using Rgba32 for your ImageSharp image (it's the most compatible with OpenGL), then use matching parameters in GL.TexImage2D:

  // First convert your image to Rgba32 if it isn't already
  var rgbaImage = image.CloneAs<Rgba32>();
  // Then when uploading:
  GL.TexImage2D(TextureTarget.Texture2D, 0, 
                PixelInternalFormat.Rgba, 
                Width, Height, 0, 
                PixelFormat.Rgba, 
                PixelType.UnsignedByte, 
                data);
  

  If you're using a different ImageSharp format (like Bgr32), swap PixelFormat.Rgba to PixelFormat.Bgr instead.

2. Unhandled Pixel Row Alignment #

OpenGL expects pixel rows to be 4-byte aligned by default, but ImageSharp outputs unpadded, contiguous pixel data. If your image's width × pixel byte count isn't a multiple of 4, OpenGL will misread the pixel data.

• Fix: Disable the alignment restriction before uploading your texture:

  // Add this right before binding your texture
  GL.PixelStore(PixelStoreParameter.UnpackAlignment, 1);
  

3. Incomplete Texture Setup #

Your provided Texture2D constructor only mentions GL.Enable(EnableCap.Texture2D)—you're probably missing critical steps to generate, bind, and configure the texture. Here's a complete, corrected example:

public struct Texture2D 
{ 
    public readonly int Handle; 
    public readonly int Width; 
    public readonly int Height; 

    public Texture2D(Image<Rgba32> image) 
    { 
        Width = image.Width; 
        Height = image.Height; 

        // Disable alignment restriction
        GL.PixelStore(PixelStoreParameter.UnpackAlignment, 1);

        // Generate and bind the texture
        Handle = GL.GenTexture();
        GL.BindTexture(TextureTarget.Texture2D, Handle);

        // Copy ImageSharp pixel data to an array
        var pixelData = new byte[Width * Height * 4];
        image.CopyPixelDataTo(pixelData);

        // Upload data to VRAM
        GL.TexImage2D(TextureTarget.Texture2D, 0, 
                      PixelInternalFormat.Rgba, 
                      Width, Height, 0, 
                      PixelFormat.Rgba, 
                      PixelType.UnsignedByte, 
                      pixelData);

        // Set basic texture filtering (prevents white artifacts from missing mipmaps)
        GL.TexParameter(TextureTarget.Texture2D, TextureParameterName.TextureMinFilter, (int)TextureMinFilter.Linear);
        GL.TexParameter(TextureTarget.Texture2D, TextureParameterName.TextureMagFilter, (int)TextureMagFilter.Linear);

        // Optional: Generate mipmaps if you need them
        GL.GenerateMipmap(GenerateMipmapTarget.Texture2D);
    }
}

4. Shader or Texture Binding Mistakes #

Even if your texture is loaded correctly, a misconfigured shader or missing binding will result in white:

• Bind the texture before rendering:

  GL.ActiveTexture(TextureUnit.Texture0);
  GL.BindTexture(TextureTarget.Texture2D, yourTexture.Handle);
  

• Verify your fragment shader samples the texture correctly:

  #version 330 core
  in vec2 texUV;
  out vec4 fragColor;
  uniform sampler2D u_Texture;
  
  void main() {
      fragColor = texture(u_Texture, texUV);
  }
  

• Make sure the sampler uniform is linked to the correct texture unit:

  int texLocation = GL.GetUniformLocation(yourShaderProgram, "u_Texture");
  GL.Uniform1(texLocation, 0); // Matches TextureUnit.Texture0
  

5. Forgotten UV Coordinates #

If your vertex data doesn't include valid UV coordinates (ranging from 0 to 1 for the full texture), the shader can't sample the texture properly and will default to white. Double-check that you're passing UVs to your vertex shader and that they map correctly to your quad.

内容的提问来源于stack exchange，提问作者2gJava