/* ------------------------------------------------------------------------- */
//
// Copyright (c) 2010 CubeSoft, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//  http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
/* ------------------------------------------------------------------------- */
namespace Cube.Pdf.Mixin
{
    /* --------------------------------------------------------------------- */
    ///
    /// IDocumentWriterExtension
    ///
    /// <summary>
    /// Provides extended methods of the IDocumentWriter class.
    /// </summary>
    ///
    /* --------------------------------------------------------------------- */
    public static class IDocumentWriterExtension
    {
        #region Methods

        /* ----------------------------------------------------------------- */
        ///
        /// Add
        ///
        /// <summary>
        /// Adds a new page.
        /// </summary>
        ///
        /// <param name="src">IDocumentWriter object.</param>
        /// <param name="page">Page information.</param>
        ///
        /* ----------------------------------------------------------------- */
        public static void Add(this IDocumentWriter src, Page page) =>
            src.Add(new[] { page });

        /* ----------------------------------------------------------------- */
        ///
        /// Add
        ///
        /// <summary>
        /// Adds a new page.
        /// </summary>
        ///
        /// <param name="src">IDocumentWriter object.</param>
        /// <param name="page">Page information.</param>
        /// <param name="hint">
        /// Document reader object to get more detailed information about
        /// the specified pages.
        /// </param>
        ///
        /* ----------------------------------------------------------------- */
        public static void Add(this IDocumentWriter src, Page page, IDocumentReader hint) =>
            src.Add(new[] { page }, hint);

        /* ----------------------------------------------------------------- */
        ///
        /// Add
        ///
        /// <summary>
        /// Adds all pages of the specified document.
        /// </summary>
        ///
        /// <param name="src">IDocumentWriter object.</param>
        /// <param name="reader">IDocumentReader object.</param>
        ///
        /* ----------------------------------------------------------------- */
        public static void Add(this IDocumentWriter src, IDocumentReader reader) =>
            src.Add(reader.Pages, reader);

        /* ----------------------------------------------------------------- */
        ///
        /// Attach
        ///
        /// <summary>
        /// Adds a new attached file.
        /// </summary>
        ///
        /// <param name="src">IDocumentWriter object.</param>
        /// <param name="file">Attached file.</param>
        ///
        /* ----------------------------------------------------------------- */
        public static void Attach(this IDocumentWriter src, Attachment file) =>
            src.Add(new[] { file });

        #endregion
    }
}
