BioGTK.SkiaStitchingPipeline Class Reference

SkiaSharp-based tile stitching pipeline for compositing large pyramidal images. More...

Inheritance diagram for BioGTK.SkiaStitchingPipeline:

Classes
class	TileRequest
	Tile request information. More...

Public Member Functions
	SkiaStitchingPipeline (OpenSlideGTK.OpenSlideBase openSlideSource, int maxCacheSizeMB=512)
	Initialize pipeline for OpenSlide source.
	SkiaStitchingPipeline (SlideBase slideSource, int maxCacheSizeMB=512)
	Initialize pipeline for BioLib slide source.
async Task< SKImage >	StitchViewportAsync (PointD origin, double resolution, ZCT coordinate, int viewportWidth=600, int viewportHeight=400)
	Stitch tiles for a given viewport asynchronously.
SKImage	StitchRegion (RectangleD region, int level, ZCT coordinate, double resolution, int pxwidth, int pxheight)
	Stitch a specific region synchronously (for smaller areas)
void	ClearCache ()
	Clear entire cache.
void	Dispose ()

Properties
int	TileSize = 256 [get, set]
int	PrefetchRadius = 1 [get, set]
SKSamplingOptions	Sampling = SKSamplingOptions.Default [get, set]
bool	EnablePrefetch = false [get, set]

Detailed Description

SkiaSharp-based tile stitching pipeline for compositing large pyramidal images.

Definition at line 20 of file SkiaStitch.cs.

Constructor & Destructor Documentation

SkiaStitchingPipeline() [1/2]

BioGTK.SkiaStitchingPipeline.SkiaStitchingPipeline	(	OpenSlideGTK.OpenSlideBase	openSlideSource,
		int	maxCacheSizeMB = 512 )

Initialize pipeline for OpenSlide source.

Definition at line 162 of file SkiaStitch.cs.

        {
            _openSlideSource = openSlideSource ?? throw new ArgumentNullException(nameof(openSlideSource));
            _isOpenSlide = true;
 
            InitializeCommon(maxCacheSizeMB);
        }

SkiaStitchingPipeline() [2/2]

BioGTK.SkiaStitchingPipeline.SkiaStitchingPipeline	(	SlideBase	slideSource,
		int	maxCacheSizeMB = 512 )

Initialize pipeline for BioLib slide source.

Definition at line 173 of file SkiaStitch.cs.

        {
            _slideSource = slideSource ?? throw new ArgumentNullException(nameof(slideSource));
            _isOpenSlide = false;
 
            InitializeCommon(maxCacheSizeMB);
        }

Member Function Documentation

ClearCache()

void BioGTK.SkiaStitchingPipeline.ClearCache

(

)

Clear entire cache.

Definition at line 735 of file SkiaStitch.cs.

        {
            lock (_cacheLock)
            {
                foreach (var tile in _tileCache.Values)
                {
                    tile.Image?.Dispose();
                }
                _tileCache.Clear();
            }
        }

Dispose()

void BioGTK.SkiaStitchingPipeline.Dispose

(

)

Definition at line 825 of file SkiaStitch.cs.

        {
            ClearCache();
            _pendingTileFetches.Clear();;
        }

StitchRegion()

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

Stitch a specific region synchronously (for smaller areas)

Definition at line 237 of file SkiaStitch.cs.

        {
            var tileRequests = CalculateTileRequests(
                new PointD(region.X,region.Y),pxwidth, pxheight, level, coordinate, resolution);
 
            int outputWidth = (int)Math.Ceiling(region.W);
            int outputHeight = (int)Math.Ceiling(region.H);
 
            using (var surface = SKSurface.Create(new SKImageInfo(outputWidth, outputHeight)))
            {
                var canvas = surface.Canvas;
                canvas.Clear(SKColors.Transparent);
 
                foreach (var request in tileRequests)
                {
                    var tileImage = FetchTileSync(request);
                    if (tileImage != null)
                    {
                        DrawTileToCanvas(canvas,request, new AForge.PointD(region.X,region.Y), resolution,  tileImage);
                    }
                }
 
                return surface.Snapshot();
            }
        }

StitchViewportAsync()

async Task< SKImage > BioGTK.SkiaStitchingPipeline.StitchViewportAsync	(	PointD	origin,
		double	resolution,
		ZCT	coordinate,
		int	viewportWidth = 600,
		int	viewportHeight = 400 )

Stitch tiles for a given viewport asynchronously.

Definition at line 195 of file SkiaStitch.cs.

        {
            // Calculate viewport parameters
            int level = CalculateLevelFromResolution(resolution);
            var tileRequests = CalculateTileRequests(origin, viewportWidth, viewportHeight, level, coordinate, resolution);
            if (viewportWidth <= 1 || viewportHeight <= 1)
            {
                viewportWidth = 600;
                viewportHeight = 400;
            }
            // Create a NEW surface for this render - no shared state, fully parallel-safe
            using (var surface = SKSurface.Create(new SKImageInfo(
                viewportWidth,
                viewportHeight,
                SKColorType.Rgba8888,
                SKAlphaType.Premul)))
            {
                if (surface == null)
                {
                    Console.WriteLine("Failed to create SKSurface");
                    return null;
                }
 
                var canvas = surface.Canvas;
                canvas.Clear(SKColors.Gray);
 
                // Fetch and composite all tiles
                await CompositeTilesAsync(canvas, tileRequests, origin, resolution);
 
                // Create and return snapshot
                return surface.Snapshot();
            }  // Surface automatically disposed here
        }

Property Documentation

EnablePrefetch

bool BioGTK.SkiaStitchingPipeline.EnablePrefetch = false

getset

Definition at line 47 of file SkiaStitch.cs.

{ get; set; } = false;

PrefetchRadius

int BioGTK.SkiaStitchingPipeline.PrefetchRadius = 1

getset

Definition at line 45 of file SkiaStitch.cs.

{ get; set; } = 1;

Sampling

SKSamplingOptions BioGTK.SkiaStitchingPipeline.Sampling = SKSamplingOptions.Default

getset

Definition at line 46 of file SkiaStitch.cs.

{ get; set; } = SKSamplingOptions.Default;

TileSize

int BioGTK.SkiaStitchingPipeline.TileSize = 256

getset

Definition at line 44 of file SkiaStitch.cs.

{ get; set; } = 256;

---

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

• BioGTK/BioGTK/Source/SkiaStitch.cs