/// <summary>
/// This function is used to create image pyramids.
/// </summary>
/// <param name="inputDetails">
/// Input image details.
/// </param>
public void CreatePyramids(ImagePyramidDetails inputDetails)
{
if (!this.createImageWorker.IsBusy)
{
this.tileGenerator = null;
this.plateGenerator = null;
this.cancellationToken = null;
// Start the image pyramids generation operation asynchronously.
this.createImageWorker.RunWorkerAsync(inputDetails);
}
}
/// <summary>
/// This event is raised when the create pyramid function is called.
/// </summary>
/// <param name="sender">
/// create ImageWorker.
/// </param>
/// <param name="e">
/// DoWork EventArgs.
/// </param>
private void OnCreateImageWorkerDoWork(object sender, DoWorkEventArgs e)
{
ImagePyramidDetails inputDetails = e.Argument as ImagePyramidDetails;
if (inputDetails != null)
{
this.CheckCancel(e);
NotifyMessage(PyramidGenerationSteps.LoadingImage, PyramidGenerationStatus.Started);
this.CheckCancel(e);
NotifyMessage(PyramidGenerationSteps.PyramidGeneration, PyramidGenerationStatus.Started);
// Define ITileCreator instance for creating image tiles.
// If the input projection type and output projection type is same then we need to tile the image.
Core.ITileCreator tileCreator = null;
// Calculates the estimated thumbnail generation time
Stopwatch thumbnailGenerationStopwatch = new Stopwatch();
thumbnailGenerationStopwatch.Start();
if (inputDetails.InputProjection == InputProjections.EquiRectangular)
{
// Read and initialize the image as an IGrid.
var imageGrid = new Core.ImageGrid(inputDetails.InputImagePath, true);
var equirectangularGridMap = new Core.EquirectangularGridMap(imageGrid, inputDetails.InputBoundary);
var imageColorMap = new Core.ImageColorMap(equirectangularGridMap);
tileCreator = Core.TileCreatorFactory.CreateImageTileCreator(
imageColorMap,
inputDetails.OutputProjection,
inputDetails.OutputDirectory);
}
else
{
Core.IImageTileSerializer serializer = new Core.ImageTileSerializer(
Core.TileHelper.GetDefaultImageTilePathTemplate(inputDetails.OutputDirectory),
ImageFormat.Png);
tileCreator = new Core.TileChopper(inputDetails.InputImagePath, serializer, inputDetails.OutputProjection, inputDetails.InputBoundary);
}
thumbnailGenerationStopwatch.Stop();
// Thumbnail estimated time is time required to load the image and then create the thumbnail with graphics
this.ThumbnailEstimatedTime = thumbnailGenerationStopwatch.ElapsedMilliseconds * Constants.ThumbnailMultiplier;
// Define plumbing for looping through all the tiles to be created for base image and pyramid.
tileGenerator = new Core.TileGenerator(tileCreator);
this.cancellationToken = new CancellationTokenSource();
tileGenerator.ParallelOptions.CancellationToken = this.cancellationToken.Token;
this.CheckCancel(e);
// Define bounds of the image. Image is assumed to cover the entire world.
// If not, change the coordinates accordingly.
// For Mercator projection, longitude spans from -180 to +180 and latitude from 90 to -90.
Core.Boundary gridBoundary = new Core.Boundary(
inputDetails.InputBoundary.Left,
inputDetails.InputBoundary.Top,
inputDetails.InputBoundary.Right,
inputDetails.InputBoundary.Bottom);
if (inputDetails.OutputProjection == ProjectionTypes.Toast)
{
// For Toast projection, longitude spans from 0 to +360 and latitude from 90 to -90.
gridBoundary.Left += 180;
gridBoundary.Right += 180;
}
// Start building base image and the pyramid.
tileGenerator.Generate(inputDetails.Level, gridBoundary);
if (inputDetails.IsGeneratePlate)
{
NotifyMessage(PyramidGenerationSteps.PlateFileGeneration, PyramidGenerationStatus.Started);
this.CheckCancel(e);
// Generate Plate file.
Core.ImageTileSerializer pyramid = new Core.ImageTileSerializer(
Core.TileHelper.GetDefaultImageTilePathTemplate(inputDetails.OutputDirectory),
ImageFormat.Png);
plateGenerator = new Core.PlateFileGenerator(
System.IO.Path.Combine(inputDetails.OutputDirectory, inputDetails.OutputFilename + ".plate"),
inputDetails.Level,
ImageFormat.Png);
plateGenerator.CreateFromImageTile(pyramid);
}
this.CheckCancel(e);
NotifyMessage(PyramidGenerationSteps.ThumbnailGeneration, PyramidGenerationStatus.Started);
// Generate Thumbnail Images.
string thumbnailFile = System.IO.Path.Combine(inputDetails.OutputDirectory, inputDetails.OutputFilename + ".jpeg");
Core.TileHelper.GenerateThumbnail(inputDetails.InputImagePath, 96, 45, thumbnailFile, ImageFormat.Jpeg);
this.CheckCancel(e);
NotifyMessage(PyramidGenerationSteps.WTMLGeneration, PyramidGenerationStatus.Started);
// Get the path of image tiles created and save it in WTML file.
string pyramidPath = Core.WtmlCollection.GetWtmlTextureTilePath(Core.TileHelper.GetDefaultImageTilePathTemplate(inputDetails.OutputDirectory), ImageFormat.Png.ToString());
Core.Boundary inputBoundary = new Core.Boundary(
inputDetails.InputBoundary.Left,
inputDetails.InputBoundary.Top,
inputDetails.InputBoundary.Right,
inputDetails.InputBoundary.Bottom);
// Create and save WTML collection file.
Core.WtmlCollection wtmlCollection = new Core.WtmlCollection(inputDetails.OutputFilename, thumbnailFile, pyramidPath, inputDetails.Level, inputDetails.OutputProjection, inputBoundary);
wtmlCollection.Credit = inputDetails.Credits;
wtmlCollection.CreditUrl = inputDetails.CreditsURL;
string path = System.IO.Path.Combine(inputDetails.OutputDirectory, inputDetails.OutputFilename + ".wtml");
wtmlCollection.Save(path);
}
}
/// <summary>
/// This function is used to create image pyramids.
/// </summary>
/// <param name="inputDetails">
/// Input image details.
/// </param>
public void CreatePyramids(ImagePyramidDetails inputDetails)
{
if (!this.createImageWorker.IsBusy)
{
this.tileGenerator = null;
this.plateGenerator = null;
this.cancellationToken = null;
// Start the image pyramids generation operation asynchronously.
this.createImageWorker.RunWorkerAsync(inputDetails);
}
}
/// <summary>
/// Processes a list of input image tiles and generates pyramid for level N.
/// </summary>
/// <param name="inputFilePath">Xml file with list of image tile information.</param>
/// <param name="outputDir">Output directory where the image tiles of pyramid has to be stored.</param>
/// <param name="projection">Projection to be used.</param>
/// <param name="inputBoundary">Input image boundary.</param>
private static void ProcessMultipartEquirectangularImage(string inputFilePath, string outputDir, ProjectionTypes projection, Boundary inputBoundary)
{
ImageFormat imageFormat = ImageFormat.Png;
Trace.TraceInformation("{0}: Reading image..", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
// Get the list of equirectangular images input.
string[,] imageTiles = Program.GetInputImageList(inputFilePath);
// Check if the image is circular.
double longitudeDelta = inputBoundary.Right - inputBoundary.Left;
bool circular = (360.0 - longitudeDelta) < 0.000001;
// Build an image grid using the input images
var imageGrid = new ImageGrid(imageTiles, circular);
// Build the grid map for equirectangular projection using the image grid and boundary co-ordinates
var equirectangularGridMap = new EquirectangularGridMap(imageGrid, inputBoundary);
// Build the color map using equirectangular projection grid map
var imageColorMap = new ImageColorMap(equirectangularGridMap);
var maximumLevelsOfDetail = TileHelper.CalculateMaximumLevel(imageGrid.Height, imageGrid.Width, inputBoundary);
// Define ITileCreator instance for creating image tiles.
ITileCreator tileCreator = TileCreatorFactory.CreateImageTileCreator(imageColorMap, projection, outputDir);
// Define bounds of the image. Image is assumed to cover the entire world.
// If not, change the coordinates accordingly.
// For Mercator projection, longitude spans from -180 to +180 and latitude from 90 to -90.
Boundary gridBoundary = new Boundary(inputBoundary.Left, inputBoundary.Top, inputBoundary.Right, inputBoundary.Bottom);
if (projection == ProjectionTypes.Toast)
{
// For Toast projection, longitude spans from 0 to +360 and latitude from 90 to -90.
gridBoundary.Left += 180;
gridBoundary.Right += 180;
}
// Define plumbing for looping through all the tiles to be created for base image and pyramid.
var tileGenerator = new TileGenerator(tileCreator);
// Start building base image and the pyramid.
Trace.TraceInformation("{0}: Building base and parent levels...", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
tileGenerator.Generate(maximumLevelsOfDetail, gridBoundary);
string fileName = Path.GetFileNameWithoutExtension(inputFilePath);
// Generate Plate file.
Trace.TraceInformation("{0}: Building Plate file...", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
ImageTileSerializer pyramid = new ImageTileSerializer(TileHelper.GetDefaultImageTilePathTemplate(outputDir), ImageFormat.Png);
PlateFileGenerator plateGenerator = new PlateFileGenerator(
Path.Combine(outputDir, fileName + ".plate"),
maximumLevelsOfDetail,
ImageFormat.Png);
plateGenerator.CreateFromImageTile(pyramid);
// Generate Thumbnail Images.
Trace.TraceInformation("{0}: Building Thumbnail image..", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
string thumbnailFile = Path.Combine(outputDir, fileName + ".jpeg");
TileHelper.GenerateThumbnail(pyramid.GetFileName(0, 0, 0), 96, 45, thumbnailFile, ImageFormat.Jpeg);
// Get the path of image tiles created and save it in WTML file.
Trace.TraceInformation("{0}: Building WTML file..", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
string pyramidPath = WtmlCollection.GetWtmlTextureTilePath(TileHelper.GetDefaultImageTilePathTemplate(outputDir), imageFormat.ToString());
// Create and save WTML collection file.
WtmlCollection wtmlCollection = new WtmlCollection(fileName, thumbnailFile, pyramidPath, maximumLevelsOfDetail, projection, inputBoundary);
string path = Path.Combine(outputDir, fileName + ".wtml");
wtmlCollection.Save(path);
Trace.TraceInformation("{0}: Collection successfully generated.", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
}
/// <summary>
/// Processes a list of input image tiles and generates pyramid for level N.
/// </summary>
/// <param name="inputFilePath">Xml file with list of image tile information.</param>
/// <param name="outputDir">Output directory where the image tiles of pyramid has to be stored.</param>
/// <param name="projection">Projection to be used.</param>
private static void ProcessMultipartEquirectangularImage(string inputFilePath, string outputDir, ProjectionTypes projection)
{
ImageFormat imageFormat = ImageFormat.Png;
Trace.TraceInformation("{0}: Reading image..", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
// Get the list of equirectangular images input.
string[,] imageTiles = Program.GetInputImageList(inputFilePath);
// Set the grid boundaries
var imageBoundary = new Boundary(-180, -90, 180, 90);
// Build an image grid using the input images
var imageGrid = new ImageGrid(imageTiles, true);
// Build the grid map for equirectangular projection using the image grid and boundary co-ordinates
var equirectangularGridMap = new EquirectangularGridMap(imageGrid, imageBoundary);
// Build the color map using equirectangular projection grid map
var imageColorMap = new ImageColorMap(equirectangularGridMap);
var maximumLevelsOfDetail = TileHelper.CalculateMaximumLevel(imageGrid.Height, imageGrid.Width, imageBoundary);
// Define ITileCreator instance for creating image tiles.
ITileCreator tileCreator = TileCreatorFactory.CreateImageTileCreator(imageColorMap, projection, outputDir);
// Define plumbing for looping through all the tiles to be created for base image and pyramid.
var tileGenerator = new TileGenerator(tileCreator);
// Start building base image and the pyramid.
Trace.TraceInformation("{0}: Building base and parent levels...", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
tileGenerator.Generate(maximumLevelsOfDetail);
string fileName = Path.GetFileNameWithoutExtension(inputFilePath);
// Generate Plate file.
Trace.TraceInformation("{0}: Building Plate file...", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
ImageTileSerializer pyramid = new ImageTileSerializer(TileHelper.GetDefaultImageTilePathTemplate(outputDir), ImageFormat.Png);
PlateFileGenerator plateGenerator = new PlateFileGenerator(
Path.Combine(outputDir, fileName + ".plate"),
maximumLevelsOfDetail,
ImageFormat.Png);
plateGenerator.CreateFromImageTile(pyramid);
// Generate Thumbnail Images.
Trace.TraceInformation("{0}: Building Thumbnail image..", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
string thumbnailFile = Path.Combine(outputDir, fileName + ".jpeg");
TileHelper.GenerateThumbnail(pyramid.GetFileName(0, 0, 0), 96, 45, thumbnailFile, ImageFormat.Jpeg);
// Get the path of image tiles created and save it in WTML file.
Trace.TraceInformation("{0}: Building WTML file..", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
string pyramidPath = WtmlCollection.GetWtmlTextureTilePath(TileHelper.GetDefaultImageTilePathTemplate(outputDir), imageFormat.ToString());
// Create and save WTML collection file.
WtmlCollection wtmlCollection = new WtmlCollection(fileName, thumbnailFile, pyramidPath, maximumLevelsOfDetail, projection);
string path = Path.Combine(outputDir, fileName + ".wtml");
wtmlCollection.Save(path);
Trace.TraceInformation("{0}: Collection successfully generated.", DateTime.Now.TimeOfDay.ToString(@"hh\:mm\:ss", CultureInfo.InvariantCulture));
}
/// <summary>
/// This event is raised when the create pyramid function is called.
/// </summary>
/// <param name="sender">
/// create ImageWorker.
/// </param>
/// <param name="e">
/// DoWork EventArgs.
/// </param>
private void OnCreateImageWorkerDoWork(object sender, DoWorkEventArgs e)
{
ImagePyramidDetails inputDetails = e.Argument as ImagePyramidDetails;
if (inputDetails != null)
{
this.CheckCancel(e);
NotifyMessage(PyramidGenerationSteps.LoadingImage, PyramidGenerationStatus.Started);
this.CheckCancel(e);
NotifyMessage(PyramidGenerationSteps.PyramidGeneration, PyramidGenerationStatus.Started);
// Define ITileCreator instance for creating image tiles.
// If the input projection type and output projection type is same then we need to tile the image.
Core.ITileCreator tileCreator = null;
// Calculates the estimated thumbnail generation time
Stopwatch thumbnailGenerationStopwatch = new Stopwatch();
thumbnailGenerationStopwatch.Start();
if (inputDetails.InputProjection == InputProjections.EquiRectangular)
{
// Read and initialize the image as an IGrid.
var imageGrid = new Core.ImageGrid(inputDetails.InputImagePath, true);
var equirectangularGridMap = new Core.EquirectangularGridMap(imageGrid, inputDetails.InputBoundary);
var imageColorMap = new Core.ImageColorMap(equirectangularGridMap);
tileCreator = Core.TileCreatorFactory.CreateImageTileCreator(
imageColorMap,
inputDetails.OutputProjection,
inputDetails.OutputDirectory);
}
else
{
Core.IImageTileSerializer serializer = new Core.ImageTileSerializer(
Core.TileHelper.GetDefaultImageTilePathTemplate(inputDetails.OutputDirectory),
ImageFormat.Png);
tileCreator = new Core.TileChopper(inputDetails.InputImagePath, serializer, inputDetails.OutputProjection, inputDetails.InputBoundary);
}
thumbnailGenerationStopwatch.Stop();
// Thumbnail estimated time is time required to load the image and then create the thumbnail with graphics
this.ThumbnailEstimatedTime = thumbnailGenerationStopwatch.ElapsedMilliseconds * Constants.ThumbnailMultiplier;
// Define plumbing for looping through all the tiles to be created for base image and pyramid.
tileGenerator = new Core.TileGenerator(tileCreator);
this.cancellationToken = new CancellationTokenSource();
tileGenerator.ParallelOptions.CancellationToken = this.cancellationToken.Token;
this.CheckCancel(e);
// Define bounds of the image. Image is assumed to cover the entire world.
// If not, change the coordinates accordingly.
// For Mercator projection, longitude spans from -180 to +180 and latitude from 90 to -90.
Core.Boundary gridBoundary = new Core.Boundary(
inputDetails.InputBoundary.Left,
inputDetails.InputBoundary.Top,
inputDetails.InputBoundary.Right,
inputDetails.InputBoundary.Bottom);
if (inputDetails.OutputProjection == ProjectionTypes.Toast)
{
// For Toast projection, longitude spans from 0 to +360 and latitude from 90 to -90.
gridBoundary.Left += 180;
gridBoundary.Right += 180;
}
// Start building base image and the pyramid.
tileGenerator.Generate(inputDetails.Level, gridBoundary);
if (inputDetails.IsGeneratePlate)
{
NotifyMessage(PyramidGenerationSteps.PlateFileGeneration, PyramidGenerationStatus.Started);
this.CheckCancel(e);
// Generate Plate file.
Core.ImageTileSerializer pyramid = new Core.ImageTileSerializer(
Core.TileHelper.GetDefaultImageTilePathTemplate(inputDetails.OutputDirectory),
ImageFormat.Png);
plateGenerator = new Core.PlateFileGenerator(
System.IO.Path.Combine(inputDetails.OutputDirectory, inputDetails.OutputFilename + ".plate"),
inputDetails.Level,
ImageFormat.Png);
plateGenerator.CreateFromImageTile(pyramid);
}
this.CheckCancel(e);
NotifyMessage(PyramidGenerationSteps.ThumbnailGeneration, PyramidGenerationStatus.Started);
// Generate Thumbnail Images.
string thumbnailFile = System.IO.Path.Combine(inputDetails.OutputDirectory, inputDetails.OutputFilename + ".jpeg");
Core.TileHelper.GenerateThumbnail(inputDetails.InputImagePath, 96, 45, thumbnailFile, ImageFormat.Jpeg);
this.CheckCancel(e);
NotifyMessage(PyramidGenerationSteps.WTMLGeneration, PyramidGenerationStatus.Started);
// Get the path of image tiles created and save it in WTML file.
string pyramidPath = Core.WtmlCollection.GetWtmlTextureTilePath(Core.TileHelper.GetDefaultImageTilePathTemplate(inputDetails.OutputDirectory), ImageFormat.Png.ToString());
Core.Boundary inputBoundary = new Core.Boundary(
inputDetails.InputBoundary.Left,
inputDetails.InputBoundary.Top,
inputDetails.InputBoundary.Right,
inputDetails.InputBoundary.Bottom);
// Create and save WTML collection file.
Core.WtmlCollection wtmlCollection = new Core.WtmlCollection(inputDetails.OutputFilename, thumbnailFile, pyramidPath, inputDetails.Level, inputDetails.OutputProjection, inputBoundary);
wtmlCollection.Credit = inputDetails.Credits;
wtmlCollection.CreditUrl = inputDetails.CreditsURL;
string path = System.IO.Path.Combine(inputDetails.OutputDirectory, inputDetails.OutputFilename + ".wtml");
wtmlCollection.Save(path);
}
}