/// <summary>
/// Initializes a new instance of a <see cref="GenericMediaObject" /> object.
/// </summary>
/// <param name="id">The ID that uniquely identifies this object. Specify int.MinValue for a new object.</param>
/// <param name="parentAlbum">The album that contains this object. This is a required parameter.</param>
/// <param name="thumbnailFilename">The filename of the thumbnail image.</param>
/// <param name="thumbnailWidth">The width (px) of the thumbnail image.</param>
/// <param name="thumbnailHeight">The height (px) of the thumbnail image.</param>
/// <param name="thumbnailSizeKb">The size (KB) of the thumbnail image.</param>
/// <param name="originalFilename">The filename of the original image.</param>
/// <param name="originalWidth">The width (px) of the original image.</param>
/// <param name="originalHeight">The height (px) of the original image.</param>
/// <param name="originalSizeKb">The size (KB) of the original image.</param>
/// <param name="sequence">An integer that represents the order in which this image should appear when displayed.</param>
/// <param name="createdByUsername">The user name of the account that originally added this object to the data store.</param>
/// <param name="dateAdded">The date this image was added to the data store.</param>
/// <param name="lastModifiedByUsername">The user name of the account that last modified this object.</param>
/// <param name="dateLastModified">The date this object was last modified.</param>
/// <param name="isPrivate">Indicates whether this object should be hidden from un-authenticated (anonymous) users.</param>
/// <param name="isInflated">A bool indicating whether this object is fully inflated.</param>
/// <param name="file">A <see cref="FileInfo"/> object containing the original file for this object. This is intended to be
/// specified when creating a new media object from a file. Specify null when instantiating an object for an existing database
/// record.</param>
/// <param name="metadata">A collection of <see cref="Data.MetadataDto" /> instances containing metadata for the
/// object. Specify null if not available.</param>
/// <exception cref="InvalidMediaObjectException">Thrown when
/// the <paramref name="file"/> parameter is specified (not null) and the file it refers to is not in the same directory
/// as the parent album's directory.</exception>
/// <exception cref="ArgumentNullException">Thrown when <paramref name="parentAlbum" /> is null.</exception>
/// <remarks>This constructor does not verify that <paramref name="file"/> refers to a file type that is enabled in the
/// configuration file.</remarks>
internal GenericMediaObject(int id, IAlbum parentAlbum, string thumbnailFilename, int thumbnailWidth, int thumbnailHeight, int thumbnailSizeKb, string originalFilename, int originalWidth, int originalHeight, int originalSizeKb, int sequence, string createdByUsername, DateTime dateAdded, string lastModifiedByUsername, DateTime dateLastModified, bool isPrivate, bool isInflated, FileInfo file, IEnumerable <MetadataDto> metadata)
{
if (parentAlbum == null)
{
throw new ArgumentNullException("parentAlbum");
}
this.Id = id;
this.Parent = parentAlbum;
this.GalleryId = this.Parent.GalleryId;
//this.Title = title;
this.Sequence = sequence;
this.CreatedByUserName = createdByUsername;
this.DateAdded = dateAdded;
this.LastModifiedByUserName = lastModifiedByUsername;
this.DateLastModified = dateLastModified;
this.IsPrivate = isPrivate;
this.IsWritable = parentAlbum.IsWritable;
this.SaveBehavior = Factory.GetMediaObjectSaveBehavior(this);
this.DeleteBehavior = Factory.GetMediaObjectDeleteBehavior(this);
this.MetadataReadWriter = Factory.GetMetadataReadWriter(this);
string parentPhysicalPath = this.Parent.FullPhysicalPathOnDisk;
IGallerySettings gallerySetting = Factory.LoadGallerySetting(GalleryId);
// Thumbnail image
this.Thumbnail = DisplayObject.CreateInstance(this, thumbnailFilename, thumbnailWidth, thumbnailHeight, DisplayObjectType.Thumbnail, new GenericThumbnailCreator(this));
this.Thumbnail.FileSizeKB = thumbnailSizeKb;
if (thumbnailFilename.Length > 0)
{
// The thumbnail is stored in either the album's physical path or an alternate location (if thumbnailPath config setting is specified) .
string thumbnailPath = HelperFunctions.MapAlbumDirectoryStructureToAlternateDirectory(parentPhysicalPath, gallerySetting.FullThumbnailPath, gallerySetting.FullMediaObjectPath);
this.Thumbnail.FileNamePhysicalPath = System.IO.Path.Combine(thumbnailPath, thumbnailFilename);
}
// GenericMediaObject instances do not have an optimized version.
this.Optimized = DisplayObject.CreateInstance(this, originalFilename, originalWidth, originalHeight, DisplayObjectType.Optimized, new NullObjects.NullDisplayObjectCreator());
// Original file
this.Original = DisplayObject.CreateInstance(this, originalFilename, originalWidth, originalHeight, DisplayObjectType.Original, new NullObjects.NullDisplayObjectCreator());
this.Original.ExternalHtmlSource = String.Empty;
this.Original.ExternalType = MimeTypeCategory.NotSet;
if (file != null)
{
this.Optimized.FileInfo = file; // Will throw InvalidMediaObjectException if the file's directory is not the same as the album's directory.
this.Original.FileInfo = file; // Will throw InvalidMediaObjectException if the file's directory is not the same as the album's directory.
if (this.MimeType.TypeCategory == MimeTypeCategory.Other)
{
// Specify a default width and height for any object other than audio, video, and image. We leave those to their default
// value of int.MinValue because we do not accurately know their real width and height. For example, a corrupt image file
// will be rejected by the Image class (an UnsupportedImageTypeException is thrown) and will be routed to this class instead.
// In this case, we don't know it's real width and height. Similarly, audio and video files are normally handled by the
// Audio and Video classes. If one of them ends up here, we need to treat it generically and not assign a width and height.
this.Optimized.Width = gallerySetting.DefaultGenericObjectWidth;
this.Optimized.Height = gallerySetting.DefaultGenericObjectHeight;
this.Original.Width = gallerySetting.DefaultGenericObjectWidth;
this.Original.Height = gallerySetting.DefaultGenericObjectHeight;
}
int fileSize = (int)(file.Length / 1024);
this.Optimized.FileSizeKB = (fileSize < 1 ? 1 : fileSize); // Very small files should be 1, not 0.
this.Original.FileSizeKB = (fileSize < 1 ? 1 : fileSize); // Very small files should be 1, not 0.
if (IsNew)
{
ExtractMetadata();
}
//// Assign the title, resorting to the filename if necessary.
//if (String.IsNullOrEmpty(title))
//{
// SetTitle();
// if (String.IsNullOrEmpty(this.Title))
// {
// this.Title = file.Name;
// }
//}
}
else
{
this.Original.FileNamePhysicalPath = System.IO.Path.Combine(parentPhysicalPath, originalFilename);
this.Original.FileSizeKB = originalSizeKb;
}
if (metadata != null)
{
AddMeta(GalleryObjectMetadataItemCollection.FromMetaDtos(this, metadata));
}
this.IsInflated = isInflated;
// Setting the previous properties has caused HasChanges = true, but we don't want this while
// we're instantiating a new object. Reset to false.
this.HasChanges = false;
// Set up our event handlers.
//this.Saving += new EventHandler(Image_Saving); // Don't need
this.Saved += Image_Saved;
}
/// <summary>
/// Initializes a new instance of an <see cref="Audio"/> object.
/// </summary>
/// <param name="id">The ID that uniquely identifies this object. Specify int.MinValue for a new object.</param>
/// <param name="parentAlbum">The album that contains this object. This is a required parameter.</param>
/// <param name="thumbnailFilename">The filename of the thumbnail image.</param>
/// <param name="thumbnailWidth">The width (px) of the thumbnail image.</param>
/// <param name="thumbnailHeight">The height (px) of the thumbnail image.</param>
/// <param name="thumbnailSizeKb">The size (KB) of the thumbnail image.</param>
/// <param name="optimizedFilename">The filename of the optimized image.</param>
/// <param name="optimizedWidth">The width (px) of the optimized image.</param>
/// <param name="optimizedHeight">The height (px) of the optimized image.</param>
/// <param name="optimizedSizeKb">The size (KB) of the optimized image.</param>
/// <param name="originalFilename">The filename of the original image.</param>
/// <param name="originalWidth">The width (px) of the original image.</param>
/// <param name="originalHeight">The height (px) of the original image.</param>
/// <param name="originalSizeKb">The size (KB) of the original image.</param>
/// <param name="sequence">An integer that represents the order in which this image should appear when displayed.</param>
/// <param name="createdByUsername">The user name of the account that originally added this object to the data store.</param>
/// <param name="dateAdded">The date this image was added to the data store.</param>
/// <param name="lastModifiedByUsername">The user name of the account that last modified this object.</param>
/// <param name="dateLastModified">The date this object was last modified.</param>
/// <param name="isPrivate">Indicates whether this object should be hidden from un-authenticated (anonymous) users.</param>
/// <param name="isInflated">A bool indicating whether this object is fully inflated.</param>
/// <param name="audioFile">A <see cref="FileInfo"/> object containing the original audio file for this object. This is intended to be
/// specified when creating a new media object from a file. Specify null when instantiating an object for an existing database
/// record.</param>
/// <param name="metadata">A collection of <see cref="Data.MetadataDto" /> instances containing metadata for the
/// object. Specify null if not available.</param>
/// <exception cref="InvalidMediaObjectException">Thrown when
/// <paramref name="audioFile"/> is specified (not null) and the file it refers to is not in the same directory
/// as the parent album's directory.</exception>
/// <exception cref="UnsupportedMediaObjectTypeException">Thrown when
/// <paramref name="audioFile"/> is specified (not null) and its file extension does not correspond to an audio MIME
/// type, as determined by the MIME type definition in the configuration file.</exception>
/// <remarks>This constructor does not verify that <paramref name="audioFile"/> refers to a file type that is enabled in the
/// configuration file.</remarks>
/// <exception cref="ArgumentNullException">Thrown when <paramref name="parentAlbum" /> is null.</exception>
internal Audio(int id, IAlbum parentAlbum, string thumbnailFilename, int thumbnailWidth, int thumbnailHeight, int thumbnailSizeKb, string optimizedFilename, int optimizedWidth, int optimizedHeight, int optimizedSizeKb, string originalFilename, int originalWidth, int originalHeight, int originalSizeKb, int sequence, string createdByUsername, DateTime dateAdded, string lastModifiedByUsername, DateTime dateLastModified, bool isPrivate, bool isInflated, FileInfo audioFile, IEnumerable <MetadataDto> metadata)
{
if (parentAlbum == null)
{
throw new ArgumentNullException("parentAlbum");
}
System.Diagnostics.Debug.Assert(((originalFilename.Length > 0) || (audioFile != null)), "Invalid Audio constructor arguments: The original filename or a FileInfo reference to the original file must be passed to the Audio constructor.");
this.Id = id;
this.Parent = parentAlbum;
this.GalleryId = this.Parent.GalleryId;
//this.Title = title;
this.Sequence = sequence;
this.CreatedByUserName = createdByUsername;
this.DateAdded = dateAdded;
this.LastModifiedByUserName = lastModifiedByUsername;
this.DateLastModified = dateLastModified;
this.IsPrivate = isPrivate;
this.IsWritable = parentAlbum.IsWritable;
this.SaveBehavior = Factory.GetMediaObjectSaveBehavior(this);
this.DeleteBehavior = Factory.GetMediaObjectDeleteBehavior(this);
this.MetadataReadWriter = Factory.GetMetadataReadWriter(this);
string parentPhysicalPath = this.Parent.FullPhysicalPathOnDisk;
IGallerySettings gallerySetting = Factory.LoadGallerySetting(GalleryId);
// Thumbnail image
this.Thumbnail = DisplayObject.CreateInstance(this, thumbnailFilename, thumbnailWidth, thumbnailHeight, DisplayObjectType.Thumbnail, new GenericThumbnailCreator(this));
this.Thumbnail.FileSizeKB = thumbnailSizeKb;
if (thumbnailFilename.Length > 0)
{
// The thumbnail is stored in either the album's physical path or an alternate location (if thumbnailPath config setting is specified) .
string thumbnailPath = HelperFunctions.MapAlbumDirectoryStructureToAlternateDirectory(parentPhysicalPath, gallerySetting.FullThumbnailPath, gallerySetting.FullMediaObjectPath);
this.Thumbnail.FileNamePhysicalPath = Path.Combine(thumbnailPath, thumbnailFilename);
}
// Optimized audio
this.Optimized = DisplayObject.CreateInstance(this, optimizedFilename, optimizedWidth, optimizedHeight, DisplayObjectType.Optimized, new AudioOptimizedCreator(this));
this.Optimized.FileSizeKB = optimizedSizeKb;
if (optimizedFilename.Length > 0)
{
// Calcululate the full file path to the optimized audio. If the optimized filename is equal to the original filename, then no
// optimized version exists, and we'll just point to the original. If the names are different, then there is a separate optimized
// image file, and it is stored in either the album's physical path or an alternate location (if optimizedPath config setting is specified).
string optimizedPath = parentPhysicalPath;
if (optimizedFilename != originalFilename)
{
optimizedPath = HelperFunctions.MapAlbumDirectoryStructureToAlternateDirectory(parentPhysicalPath, gallerySetting.FullOptimizedPath, gallerySetting.FullMediaObjectPath);
}
this.Optimized.FileNamePhysicalPath = System.IO.Path.Combine(optimizedPath, optimizedFilename);
}
// Original audio file
this.Original = DisplayObject.CreateInstance(this, originalFilename, originalWidth, originalHeight, DisplayObjectType.Original, new NullObjects.NullDisplayObjectCreator());
this.Original.ExternalHtmlSource = String.Empty;
this.Original.ExternalType = MimeTypeCategory.NotSet;
if (audioFile != null)
{
this.Optimized.FileInfo = audioFile; // Will throw InvalidMediaObjectException if the file's directory is not the same as the album's directory.
this.Original.FileInfo = audioFile; // Will throw InvalidMediaObjectException if the file's directory is not the same as the album's directory.
if (this.Original.MimeType.TypeCategory != MimeTypeCategory.Audio)
{
throw new Events.CustomExceptions.UnsupportedMediaObjectTypeException(this.Original.FileInfo);
}
this.Optimized.Width = gallerySetting.DefaultAudioPlayerWidth;
this.Optimized.Height = gallerySetting.DefaultAudioPlayerHeight;
this.Original.Width = gallerySetting.DefaultAudioPlayerWidth;
this.Original.Height = gallerySetting.DefaultAudioPlayerHeight;
int fileSize = (int)(audioFile.Length / 1024);
this.Optimized.FileSizeKB = (fileSize < 1 ? 1 : fileSize); // Very small files should be 1, not 0.
this.Original.FileSizeKB = (fileSize < 1 ? 1 : fileSize); // Very small files should be 1, not 0.
if (IsNew)
{
ExtractMetadata();
}
}
else
{
this.Original.FileNamePhysicalPath = Path.Combine(parentPhysicalPath, originalFilename);
this.Original.FileSizeKB = originalSizeKb;
}
if (metadata != null)
{
AddMeta(GalleryObjectMetadataItemCollection.FromMetaDtos(this, metadata));
}
this.IsInflated = isInflated;
// Setting the previous properties has caused HasChanges = true, but we don't want this while
// we're instantiating a new object. Reset to false.
this.HasChanges = false;
// Set up our event handlers.
//this.Saving += new EventHandler(Image_Saving); // Don't need
this.Saved += MediaObject_Saved;
}
/// <summary>
/// Initializes a new instance of a ExternalMediaObject object.
/// </summary>
/// <param name="id">The ID that uniquely identifies this object. Specify int.MinValue for a new object.</param>
/// <param name="parentAlbum">The album that contains this object. This is a required parameter.</param>
/// <param name="thumbnailFilename">The filename of the thumbnail image.</param>
/// <param name="thumbnailWidth">The width (px) of the thumbnail image.</param>
/// <param name="thumbnailHeight">The height (px) of the thumbnail image.</param>
/// <param name="thumbnailSizeKb">The size (KB) of the thumbnail image.</param>
/// <param name="externalHtmlSource">The HTML that defines an externally stored media object, such as one hosted at
/// YouTube or Silverlight.live.com.</param>
/// <param name="mimeType">Specifies the category to which this mime type belongs. This usually corresponds to the first portion of
/// the full mime type description. (e.g. "image" if the full mime type is "image/jpeg").</param>
/// <param name="sequence">An integer that represents the order in which this image should appear when displayed.</param>
/// <param name="createdByUsername">The user name of the account that originally added this object to the data store.</param>
/// <param name="dateAdded">The date this image was added to the data store.</param>
/// <param name="lastModifiedByUsername">The user name of the account that last modified this object.</param>
/// <param name="dateLastModified">The date this object was last modified.</param>
/// <param name="isPrivate">Indicates whether this object should be hidden from un-authenticated (anonymous) users.</param>
/// <param name="isInflated">A bool indicating whether this object is fully inflated.</param>
/// <param name="metadata">A collection of <see cref="Data.MetadataDto" /> instances containing metadata for the
/// object. Specify null if not available.</param>
/// <exception cref="InvalidMediaObjectException">Thrown when
/// the file parameter is specified (not null) and the file it refers to is not in the same directory
/// as the parent album's directory.</exception>
/// <exception cref="ArgumentNullException">Thrown when <paramref name="parentAlbum" /> is null.</exception>
internal ExternalMediaObject(int id, IAlbum parentAlbum, string thumbnailFilename, int thumbnailWidth, int thumbnailHeight, int thumbnailSizeKb, string externalHtmlSource, MimeTypeCategory mimeType, int sequence, string createdByUsername, DateTime dateAdded, string lastModifiedByUsername, DateTime dateLastModified, bool isPrivate, bool isInflated, IEnumerable <MetadataDto> metadata)
{
if (parentAlbum == null)
{
throw new ArgumentNullException("parentAlbum");
}
this.Id = id;
this.Parent = parentAlbum;
this.GalleryId = this.Parent.GalleryId;
//this.Title = title;
this.Sequence = sequence;
this.CreatedByUserName = createdByUsername;
this.DateAdded = dateAdded;
this.LastModifiedByUserName = lastModifiedByUsername;
this.DateLastModified = dateLastModified;
this.IsPrivate = isPrivate;
this.IsWritable = parentAlbum.IsWritable;
this.SaveBehavior = Factory.GetMediaObjectSaveBehavior(this);
this.DeleteBehavior = Factory.GetMediaObjectDeleteBehavior(this);
this.MetadataReadWriter = Factory.GetMetadataReadWriter(this);
string parentPhysicalPath = this.Parent.FullPhysicalPathOnDisk;
IGallerySettings gallerySetting = Factory.LoadGallerySetting(GalleryId);
// Thumbnail image
this.Thumbnail = DisplayObject.CreateInstance(this, thumbnailFilename, thumbnailWidth, thumbnailHeight, DisplayObjectType.Thumbnail, new ExternalThumbnailCreator(this));
this.Thumbnail.FileSizeKB = thumbnailSizeKb;
if (thumbnailFilename.Length > 0)
{
// The thumbnail is stored in either the album's physical path or an alternate location (if thumbnailPath config setting is specified).
string thumbnailPath = HelperFunctions.MapAlbumDirectoryStructureToAlternateDirectory(parentPhysicalPath, gallerySetting.FullThumbnailPath, gallerySetting.FullMediaObjectPath);
this.Thumbnail.FileNamePhysicalPath = System.IO.Path.Combine(thumbnailPath, thumbnailFilename);
}
// ExternalMediaObject instances do not have an optimized version.
this.Optimized = new NullObjects.NullDisplayObject();
// Original file
this.Original = DisplayObject.CreateInstance(this, DisplayObjectType.External, mimeType);
this.Original.ExternalHtmlSource = externalHtmlSource;
switch (mimeType)
{
case MimeTypeCategory.Audio:
this.Original.Width = gallerySetting.DefaultAudioPlayerWidth;
this.Original.Height = gallerySetting.DefaultAudioPlayerHeight;
break;
case MimeTypeCategory.Video:
this.Original.Width = gallerySetting.DefaultVideoPlayerWidth;
this.Original.Height = gallerySetting.DefaultVideoPlayerHeight;
break;
case MimeTypeCategory.Image:
case MimeTypeCategory.Other:
this.Original.Width = gallerySetting.DefaultGenericObjectWidth;
this.Original.Height = gallerySetting.DefaultGenericObjectHeight;
break;
}
if (IsNew)
{
ExtractMetadata();
}
if (metadata != null)
{
AddMeta(GalleryObjectMetadataItemCollection.FromMetaDtos(this, metadata));
}
this.IsInflated = isInflated;
// Setting the previous properties has caused HasChanges = true, but we don't want this while
// we're instantiating a new object. Reset to false.
this.HasChanges = false;
// Set up our event handlers.
//this.Saving += new EventHandler(Image_Saving); // Don't need
this.Saved += Image_Saved;
}