2025-12-17 10:33:08 +00:00
using AIStudio.Tools.PluginSystem ;
2025-02-18 10:24:43 +00:00
namespace AIStudio.Chat ;
public static class IImageSourceExtensions
{
2025-12-17 10:33:08 +00:00
private static string TB ( string fallbackEN ) = > I18N . I . T ( fallbackEN , typeof ( IImageSourceExtensions ) . Namespace , nameof ( IImageSourceExtensions ) ) ;
2025-12-30 17:30:32 +00:00
public static string DetermineMimeType ( this IImageSource image )
{
switch ( image . SourceType )
{
case ContentImageSource . BASE64 :
{
// Try to detect the mime type from the base64 string:
var base64Data = image . Source ;
if ( base64Data . StartsWith ( "data:" , StringComparison . OrdinalIgnoreCase ) )
{
var mimeEnd = base64Data . IndexOf ( ';' ) ;
if ( mimeEnd > 5 )
{
return base64Data [ 5. . mimeEnd ] ;
}
}
// Fallback:
return "application/octet-stream" ;
}
case ContentImageSource . URL :
{
// Try to detect the mime type from the URL extension:
var uri = new Uri ( image . Source ) ;
var extension = Path . GetExtension ( uri . AbsolutePath ) . ToLowerInvariant ( ) ;
return extension switch
{
".png" = > "image/png" ,
".jpg" or ".jpeg" = > "image/jpeg" ,
".gif" = > "image/gif" ,
".bmp" = > "image/bmp" ,
".webp" = > "image/webp" ,
_ = > "application/octet-stream"
} ;
}
case ContentImageSource . LOCAL_PATH :
{
var extension = Path . GetExtension ( image . Source ) . ToLowerInvariant ( ) ;
return extension switch
{
".png" = > "image/png" ,
".jpg" or ".jpeg" = > "image/jpeg" ,
".gif" = > "image/gif" ,
".bmp" = > "image/bmp" ,
".webp" = > "image/webp" ,
_ = > "application/octet-stream"
} ;
}
default :
return "application/octet-stream" ;
}
}
2025-02-18 10:24:43 +00:00
/// <summary>
/// Read the image content as a base64 string.
/// </summary>
/// <remarks>
/// The images are directly converted to base64 strings. The maximum
/// size of the image is around 10 MB. If the image is larger, the method
2025-12-30 17:30:32 +00:00
/// returns an empty string.<br/>
/// <br/>
2025-02-18 10:24:43 +00:00
/// As of now, this method does no sort of image processing. LLMs usually
/// do not work with arbitrary image sizes. In the future, we might have
2025-12-30 17:30:32 +00:00
/// to resize the images before sending them to the model.<br/>
/// <br/>
/// Note as well that this method returns just the base64 string without
/// any data URI prefix (like "data:image/png;base64,"). The caller has
/// to take care of that if needed.
2025-02-18 10:24:43 +00:00
/// </remarks>
/// <param name="image">The image source.</param>
/// <param name="token">The cancellation token.</param>
/// <returns>The image content as a base64 string; might be empty.</returns>
2025-12-30 17:30:32 +00:00
public static async Task < ( bool success , string base64Content ) > TryAsBase64 ( this IImageSource image , CancellationToken token = default )
2025-02-18 10:24:43 +00:00
{
switch ( image . SourceType )
{
case ContentImageSource . BASE64 :
2025-12-30 17:30:32 +00:00
return ( success : true , image . Source ) ;
2025-02-18 10:24:43 +00:00
case ContentImageSource . URL :
{
using var httpClient = new HttpClient ( ) ;
using var response = await httpClient . GetAsync ( image . Source , HttpCompletionOption . ResponseHeadersRead , token ) ;
if ( response . IsSuccessStatusCode )
{
// Read the length of the content:
var lengthBytes = response . Content . Headers . ContentLength ;
if ( lengthBytes > 10_000_000 )
2025-12-17 10:33:08 +00:00
{
await MessageBus . INSTANCE . SendError ( new ( Icons . Material . Filled . ImageNotSupported , TB ( "The image at the URL is too large (>10 MB). Skipping the image." ) ) ) ;
2025-12-30 17:30:32 +00:00
return ( success : false , string . Empty ) ;
2025-12-17 10:33:08 +00:00
}
2025-02-18 10:24:43 +00:00
var bytes = await response . Content . ReadAsByteArrayAsync ( token ) ;
2025-12-30 17:30:32 +00:00
return ( success : true , Convert . ToBase64String ( bytes ) ) ;
2025-02-18 10:24:43 +00:00
}
2025-12-30 17:30:32 +00:00
await MessageBus . INSTANCE . SendError ( new ( Icons . Material . Filled . ImageNotSupported , TB ( "Failed to download the image from the URL. Skipping the image." ) ) ) ;
return ( success : false , string . Empty ) ;
2025-02-18 10:24:43 +00:00
}
case ContentImageSource . LOCAL_PATH :
if ( File . Exists ( image . Source ) )
{
// Read the content length:
var length = new FileInfo ( image . Source ) . Length ;
if ( length > 10_000_000 )
2025-12-17 10:33:08 +00:00
{
await MessageBus . INSTANCE . SendError ( new ( Icons . Material . Filled . ImageNotSupported , TB ( "The local image file is too large (>10 MB). Skipping the image." ) ) ) ;
2025-12-30 17:30:32 +00:00
return ( success : false , string . Empty ) ;
2025-12-17 10:33:08 +00:00
}
2025-02-18 10:24:43 +00:00
var bytes = await File . ReadAllBytesAsync ( image . Source , token ) ;
2025-12-30 17:30:32 +00:00
return ( success : true , Convert . ToBase64String ( bytes ) ) ;
2025-02-18 10:24:43 +00:00
}
2025-12-30 17:30:32 +00:00
await MessageBus . INSTANCE . SendError ( new ( Icons . Material . Filled . ImageNotSupported , TB ( "The local image file does not exist. Skipping the image." ) ) ) ;
return ( success : false , string . Empty ) ;
2025-02-18 10:24:43 +00:00
default :
2025-12-30 17:30:32 +00:00
return ( success : false , string . Empty ) ;
2025-02-18 10:24:43 +00:00
}
}
}