Manages slide rendering by coordinating between the SkiaStitchingPipeline and SlideGLArea Handles async updates, caching, and progressive rendering for large pyramidal images. More...

Inheritance diagram for BioGTK.SKSlideRenderer:

Classes
class	CacheStatistics

Public Member Functions
	SKSlideRenderer (SKDrawingArea sk)
	Initialize renderer for a specific GLArea widget.

void	SetSource (OpenSlideGTK.OpenSlideBase openSlideSource)
	Set OpenSlide source and initialize pipeline.

void	SetSource (SlideBase slideSource)
	Set BioLib slide source and initialize pipeline.

async Task	UpdateViewAsync (PointD origin, double resolution, ZCT coordinate, int width=600, int height=400)
	Update the rendered view asynchronously - main entry point for rendering.

SKImage	RenderRegion (RectangleD region, int level, ZCT coordinate, double resolution, int pxwidth, int pxheight)
	Render a specific region synchronously (for exports, small areas)

SKImage	RenderCurrentViewSync ()
	Render current viewport synchronously (blocking)

SKImage	GetCurrentImage ()
	Get the current image for rendering - called by GLArea during draw Returns the best available image (full quality or preview)

void	DrawToCanvas (SKCanvas canvas, int canvasWidth, int canvasHeight)
	Draw the current image to a canvas with proper scaling Called during the Skia render callback from SlideGLArea.

void	ClearCache ()
	Clear the tile cache.

CacheStatistics	GetCacheStatistics ()
	Get cache statistics for monitoring.

void	UpdateConfiguration (int? maxCacheSizeMB=null, int? tileSize=null, SKSamplingOptions? sampling=null, bool? enablePrefetch=null, bool? enableProgressiveRendering=null)
	Update renderer configuration and reinitialize if needed.

void	Dispose ()

Properties
int	MaxCacheSizeMB = 512 `[get, set]`

int	TileSize = 256 `[get, set]`

SKSamplingOptions	Sampling = SKSamplingOptions.Default `[get, set]`

bool	EnablePrefetch = true `[get, set]`

bool	IsRendering `[get]`

bool	HasValidImage `[get]`

Detailed Description

Manages slide rendering by coordinating between the SkiaStitchingPipeline and SlideGLArea Handles async updates, caching, and progressive rendering for large pyramidal images.

Definition at line 15 of file SKSlideRenderer.cs.

Constructor & Destructor Documentation

◆ SKSlideRenderer()

BioGTK.SKSlideRenderer.SKSlideRenderer ( SKDrawingArea sk )

Initialize renderer for a specific GLArea widget.

Definition at line 50 of file SKSlideRenderer.cs.

        {
            InitializeDefaults();
        }

Member Function Documentation

◆ ClearCache()

void BioGTK.SKSlideRenderer.ClearCache ( )

Clear the tile cache.

Definition at line 410 of file SKSlideRenderer.cs.

        {
            _stitchingPipeline?.ClearCache();
        }

◆ Dispose()

void BioGTK.SKSlideRenderer.Dispose ( )

Definition at line 475 of file SKSlideRenderer.cs.

        {
            _currentRenderedImage?.Dispose();       
            _stitchingPipeline?.Dispose();
            _currentRenderedImage = null;
            _stitchingPipeline = null;
        }

◆ DrawToCanvas()

void BioGTK.SKSlideRenderer.DrawToCanvas	(	SKCanvas	canvas,
		int	canvasWidth,
		int	canvasHeight )

Draw the current image to a canvas with proper scaling Called during the Skia render callback from SlideGLArea.

Definition at line 330 of file SKSlideRenderer.cs.

        {
            if (canvas == null)
                return;
 
            var image = GetCurrentImage();
            if (image == null)
                return;
            try
            {
                using (var paint = new SKPaint
                {
                    IsAntialias = true,
                    BlendMode = SKBlendMode.SrcOver
                })
                {
                    // Draw image to fill canvas
                    var destRect = new SKRect(0, 0, canvasWidth, canvasHeight);
                    canvas.DrawImage(image, destRect, paint);
                }
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error drawing to canvas: {ex.Message}");
            }
        }

◆ GetCacheStatistics()

CacheStatistics BioGTK.SKSlideRenderer.GetCacheStatistics ( )

Get cache statistics for monitoring.

Definition at line 418 of file SKSlideRenderer.cs.

        {
            // Could be extended to expose actual stats from pipeline
            return new CacheStatistics
            {
                IsEnabled = _stitchingPipeline != null,
                MaxSizeMB = MaxCacheSizeMB,
                TileSize = TileSize
            };
        }

◆ GetCurrentImage()

SKImage BioGTK.SKSlideRenderer.GetCurrentImage ( )

Get the current image for rendering - called by GLArea during draw Returns the best available image (full quality or preview)

Definition at line 320 of file SKSlideRenderer.cs.

        {
            // Return full quality if available, otherwise preview
            return _currentRenderedImage;
        }

◆ RenderCurrentViewSync()

SKImage BioGTK.SKSlideRenderer.RenderCurrentViewSync ( )

Render current viewport synchronously (blocking)

Definition at line 298 of file SKSlideRenderer.cs.

        {
            if (!_hasSource || _stitchingPipeline == null)
                return null;
 
            return _stitchingPipeline.StitchViewportAsync(
                _lastOrigin,
                _lastResolution,
                _lastCoordinate,
                _lastWidth,
                _lastHeight
            ).Result;
        }

◆ RenderRegion()

SKImage BioGTK.SKSlideRenderer.RenderRegion	(	RectangleD	region,
		int	level,
		ZCT	coordinate,
		double	resolution,
		int	pxwidth,
		int	pxheight )

Render a specific region synchronously (for exports, small areas)

Definition at line 284 of file SKSlideRenderer.cs.

        {
            if (!_hasSource || _stitchingPipeline == null)
                return null;
 
            return _stitchingPipeline.StitchRegion(region, level, coordinate, resolution, pxwidth, pxheight);
        }

◆ SetSource() [1/2]

void BioGTK.SKSlideRenderer.SetSource ( OpenSlideGTK.OpenSlideBase openSlideSource )

Set OpenSlide source and initialize pipeline.

Definition at line 71 of file SKSlideRenderer.cs.

        {
            if (openSlideSource == null)
                throw new ArgumentNullException(nameof(openSlideSource));
 
            ClearCurrentSource();
 
            _openSlideSource = openSlideSource;
            _isOpenSlide = true;
            _hasSource = true;
 
            InitializeStitchingPipeline();
        }

◆ SetSource() [2/2]

void BioGTK.SKSlideRenderer.SetSource ( SlideBase slideSource )

Set BioLib slide source and initialize pipeline.

Definition at line 88 of file SKSlideRenderer.cs.

        {
            if (slideSource == null)
                throw new ArgumentNullException(nameof(slideSource));
 
            ClearCurrentSource();
 
            _slideSource = slideSource;
            _isOpenSlide = false;
            _hasSource = true;
 
            InitializeStitchingPipeline();
        }

◆ UpdateConfiguration()

void BioGTK.SKSlideRenderer.UpdateConfiguration	(	int?	maxCacheSizeMB = null,
		int?	tileSize = null,
		SKSamplingOptions?	sampling = null,
		bool?	enablePrefetch = null,
		bool?	enableProgressiveRendering = null )

Update renderer configuration and reinitialize if needed.

Definition at line 443 of file SKSlideRenderer.cs.

        {
            bool needsReinit = false;
 
            if (maxCacheSizeMB.HasValue && maxCacheSizeMB.Value != MaxCacheSizeMB)
            {
                MaxCacheSizeMB = maxCacheSizeMB.Value;
                needsReinit = true;
            }
 
            if (tileSize.HasValue && tileSize.Value != TileSize)
            {
                TileSize = tileSize.Value;
                needsReinit = true;
            }
 
            // Reinitialize pipeline if structural changes were made
            if (needsReinit && _hasSource)
            {
                InitializeStitchingPipeline();
            }
        }

◆ UpdateViewAsync()

async Task BioGTK.SKSlideRenderer.UpdateViewAsync	(	PointD	origin,
		double	resolution,
		ZCT	coordinate,
		int	width = 600,
		int	height = 400 )

Update the rendered view asynchronously - main entry point for rendering.

Definition at line 145 of file SKSlideRenderer.cs.

        {
            if (!_hasSource || _stitchingPipeline == null)
                return;
            /*
            // Check if update is needed
            if (!forceUpdate && !NeedsUpdate(origin, width, height, resolution, coordinate))
                return;
            */
            // Cancel any in-progress render
            //CancelCurrentRender();
 
            // Acquire update lock
            //await _updateSemaphore.WaitAsync();
 
            try
            {
                IsRendering = true;
                /*
                // Create new cancellation token for this render
                _renderCancellation = new CancellationTokenSource();
                var cancellationToken = _renderCancellation.Token;
                */
                // Store current parameters
                _lastOrigin = origin;
                _lastResolution = resolution;
                _lastCoordinate = coordinate;
                _lastWidth = width;
                _lastHeight = height;
                /*
                // Progressive rendering: render low-res preview first if enabled
                if (_useProgressiveRendering && ShouldRenderPreview(resolution))
                {
                    await RenderLowResPreviewAsync(origin, width, height, resolution, coordinate);
                }
                */
                // Render full quality
                await RenderFullQualityAsync(origin, resolution, coordinate, width, height);
            }
            catch (Exception ex)
            {
                Console.WriteLine($"Error during view update: {ex.Message}");
            }
            finally
            {
                IsRendering = false;
            }
        }

Property Documentation

◆ EnablePrefetch

bool BioGTK.SKSlideRenderer.EnablePrefetch = true

getset

Definition at line 37 of file SKSlideRenderer.cs.

37{ get; set; } = true;

◆ HasValidImage

bool BioGTK.SKSlideRenderer.HasValidImage

get

Definition at line 41 of file SKSlideRenderer.cs.

◆ IsRendering

bool BioGTK.SKSlideRenderer.IsRendering

get

Definition at line 40 of file SKSlideRenderer.cs.

40{ get; private set; }

◆ MaxCacheSizeMB

int BioGTK.SKSlideRenderer.MaxCacheSizeMB = 512

getset

Definition at line 34 of file SKSlideRenderer.cs.

34{ get; set; } = 512;

◆ Sampling

SKSamplingOptions BioGTK.SKSlideRenderer.Sampling = SKSamplingOptions.Default

getset

Definition at line 36 of file SKSlideRenderer.cs.

36{ get; set; } = SKSamplingOptions.Default;

◆ TileSize

int BioGTK.SKSlideRenderer.TileSize = 256

getset

Definition at line 35 of file SKSlideRenderer.cs.

35{ get; set; } = 256;

The documentation for this class was generated from the following file:

BioGTK/BioGTK/Source/SKSlideRenderer.cs

Classes

Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ SKSlideRenderer()

Member Function Documentation

◆ ClearCache()

◆ Dispose()

◆ DrawToCanvas()

◆ GetCacheStatistics()

◆ GetCurrentImage()

◆ RenderCurrentViewSync()

◆ RenderRegion()

◆ SetSource() [1/2]

◆ SetSource() [2/2]

◆ UpdateConfiguration()

◆ UpdateViewAsync()

Property Documentation

◆ EnablePrefetch

◆ HasValidImage

◆ IsRendering

◆ MaxCacheSizeMB

◆ Sampling

◆ TileSize