Border.cs :  » PDF » PDF-Clown » it » stefanochizzolini » clown » documents » interaction » annotations » C# / CSharp Open Source

/*
  Copyright 2008 Stefano Chizzolini. http://clown.stefanochizzolini.it

  Contributors:
    * Stefano Chizzolini (original code developer, http://www.stefanochizzolini.it)

  This file should be part of the source code distribution of "PDF Clown library"
  (the Program): see the accompanying README files for more info.

  This Program is free software; you can redistribute it and/or modify it under
  the terms of the GNU General Public License as published by the Free Software
  Foundation; either version 2 of the License, or (at your option) any later version.

  This Program is distributed in the hope that it will be useful, but WITHOUT ANY
  WARRANTY, either expressed or implied; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the License for more details.

  You should have received a copy of the GNU General Public License along with this
  Program (see README files); if not, go to the GNU website (http://www.gnu.org/).

  Redistribution and use, with or without modification, are permitted provided that such
  redistributions retain the above copyright notice, license and disclaimer, along with
  this list of conditions.
*/

using it.stefanochizzolini.clown.bytes;
using it.stefanochizzolini.clown.documents;
using it.stefanochizzolini.clown.documents.contents;
using it.stefanochizzolini.clown.objects;

using System;
using System.Collections.Generic;

namespace it.stefanochizzolini.clown.documents.interaction.annotations{
  /**
    <summary>Border characteristics [PDF:1.6:8.4.3].</summary>
  */
  public class Border
    : PdfObjectWrapper<PdfDictionary>
  {
    #region types
    /**
      <summary>Border style [PDF:1.6:8.4.3].</summary>
    */
    public enum StyleEnum
    {
      /**
        <summary>Solid.</summary>
      */
      Solid,
      /**
        <summary>Dashed.</summary>
      */
      Dashed,
      /**
        <summary>Beveled.</summary>
      */
      Beveled,
      /**
        <summary>Inset.</summary>
      */
      Inset,
      /**
        <summary>Underline.</summary>
      */
      Underline
    };
    #endregion

    #region static
    #region fields
    private static readonly LineDash DefaultLineDash = new LineDash(new int[]{3});
    private static readonly StyleEnum DefaultStyle = StyleEnum.Solid;
    private static readonly double DefaultWidth = 1;

    private static readonly Dictionary<StyleEnum,PdfName> StyleEnumCodes;
    #endregion

    #region constructors
    static Border()
    {
      StyleEnumCodes = new Dictionary<StyleEnum,PdfName>();
      StyleEnumCodes[StyleEnum.Solid] = PdfName.S;
      StyleEnumCodes[StyleEnum.Dashed] = PdfName.D;
      StyleEnumCodes[StyleEnum.Beveled] = PdfName.B;
      StyleEnumCodes[StyleEnum.Inset] = PdfName.I;
      StyleEnumCodes[StyleEnum.Underline] = PdfName.U;
    }
    #endregion

    #region interface
    #region private
    /**
      <summary>Gets the code corresponding to the given value.</summary>
    */
    private static PdfName ToCode(
      StyleEnum value
      )
    {return StyleEnumCodes[value];}

    /**
      <summary>Gets the style corresponding to the given value.</summary>
    */
    private static StyleEnum ToStyleEnum(
      PdfName value
      )
    {
      foreach(KeyValuePair<StyleEnum,PdfName> style in StyleEnumCodes)
      {
        if(style.Value.Equals(value))
          return style.Key;
      }
      return DefaultStyle;
    }
    #endregion
    #endregion
    #endregion

    #region dynamic
    #region constructors
    public Border(
      Document context
      ) : base(
        context.File,
        new PdfDictionary()
        )
    {}

    public Border(
      Document context,
      double width,
      StyleEnum style,
      LineDash pattern
      ) : this(context)
    {
      Width = width;
      Style = style;
      Pattern = pattern;
    }

    public Border(
      PdfDirectObject baseObject,
      PdfIndirectObject container
      ) : base(baseObject,container)
    {}
    #endregion

    #region interface
    #region public
    public override object Clone(
      Document context
      )
    {throw new NotImplementedException();}

    /**
      <summary>Gets/Sets the dash pattern used in case of dashed border.</summary>
    */
    public LineDash Pattern
    {
      get
      {
        /*
          NOTE: 'D' entry may be undefined.
        */
        PdfArray dashObject = (PdfArray)BaseDataObject[PdfName.D];
        if(dashObject == null)
          return DefaultLineDash;

        int[] dashArray = new int[dashObject.Count];
        for(
          int dashIndex = 0,
            dashLength = dashArray.Length;
          dashIndex < dashLength;
          dashIndex++
          )
        {dashArray[dashIndex] = ((PdfInteger)dashObject[dashIndex]).RawValue;}

        return new LineDash(dashArray);
      }
      set
      {
        if(value == null)
        {BaseDataObject.Remove(PdfName.D);}
        else
        {
          PdfArray dashObject = new PdfArray();

          int[] dashArray = value.DashArray;
          for(
            int dashIndex = 0,
              dashLength = dashArray.Length;
            dashIndex < dashLength;
            dashIndex++
            )
          {dashObject.Add(new PdfInteger(dashArray[dashIndex]));}

          BaseDataObject[PdfName.D] = dashObject;
        }
      }
    }

    /**
      <summary>Gets/Sets the border style.</summary>
    */
    public StyleEnum Style
    {
      get
      {return ToStyleEnum((PdfName)BaseDataObject[PdfName.S]);}
      set
      {
        if(value == 0
          || value == DefaultStyle)
        {BaseDataObject.Remove(PdfName.S);}
        else
        {BaseDataObject[PdfName.S] = ToCode(value);}
      }
    }

    /**
      <summary>Gets/Sets the border width in points.</summary>
    */
    public double Width
    {
      get
      {
        /*
          NOTE: 'W' entry may be undefined.
        */
        IPdfNumber widthObject = (IPdfNumber)BaseDataObject[PdfName.W];
        if(widthObject == null)
          return DefaultWidth;

        return widthObject.RawValue;
      }
      set
      {BaseDataObject[PdfName.W] = new PdfReal(value);}
    }
    #endregion
    #endregion
    #endregion
  }
}