#region MigraDoc - Creating Documents on the Fly
//
// Authors:
// Klaus Potzesny
//
// Copyright (c) 2001-2017 empira Software GmbH, Cologne Area (Germany)
//
// http://www.pdfsharp.com
// http://www.migradoc.com
// http://sourceforge.net/projects/pdfsharp
//
// Permission is hereby granted, free of charge, to any person obtaining a
// copy of this software and associated documentation files (the "Software"),
// to deal in the Software without restriction, including without limitation
// the rights to use, copy, modify, merge, publish, distribute, sublicense,
// and/or sell copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included
// in all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
// DEALINGS IN THE SOFTWARE.
#endregion
using MigraDoc.DocumentObjectModel;
using PdfSharp.Drawing;
using MigraDoc.DocumentObjectModel.Tables;
using MigraDoc.DocumentObjectModel.Shapes;
using MigraDoc.DocumentObjectModel.Shapes.Charts;
namespace MigraDoc.Rendering
{
///
/// Abstract base class for all renderers.
///
public abstract class Renderer
{
///
/// Determines the maximum height a single element may have.
///
public XUnit MaxElementHeight
{
get { return _maxElementHeight; }
set { _maxElementHeight = value; }
}
public Renderer(XGraphics gfx, DocumentObject documentObject, FieldInfos fieldInfos)
{
_documentObject = documentObject;
_gfx = gfx;
_fieldInfos = fieldInfos;
}
public Renderer(XGraphics gfx, RenderInfo renderInfo, FieldInfos fieldInfos)
{
_documentObject = renderInfo.DocumentObject;
_gfx = gfx;
_renderInfo = renderInfo;
_fieldInfos = fieldInfos;
}
///
/// In inherited classes, gets a layout info with only margin and break information set.
/// It can be taken before the documen object is formatted.
///
///
/// In inherited classes, the following parts are set properly:
/// MarginTop, MarginLeft, MarginRight, MarginBottom,
/// KeepTogether, KeepWithNext, PagebreakBefore, Floating,
/// VerticalReference, HorizontalReference.
///
public abstract LayoutInfo InitialLayoutInfo { get; }
///
/// Renders the contents shifted to the given Coordinates.
///
/// The x shift.
/// The y shift.
/// The render infos.
protected void RenderByInfos(XUnit xShift, XUnit yShift, RenderInfo[] renderInfos)
{
if (renderInfos == null)
return;
foreach (RenderInfo renderInfo in renderInfos)
{
XUnit savedX = renderInfo.LayoutInfo.ContentArea.X;
XUnit savedY = renderInfo.LayoutInfo.ContentArea.Y;
renderInfo.LayoutInfo.ContentArea.X += xShift;
renderInfo.LayoutInfo.ContentArea.Y += yShift;
Renderer renderer = Create(_gfx, _documentRenderer, renderInfo, _fieldInfos);
renderer.Render();
renderInfo.LayoutInfo.ContentArea.X = savedX;
renderInfo.LayoutInfo.ContentArea.Y = savedY;
}
}
protected void RenderByInfos(RenderInfo[] renderInfos)
{
RenderByInfos(0, 0, renderInfos);
}
///
/// Gets the render information necessary to render and position the object.
///
public RenderInfo RenderInfo
{
get { return _renderInfo; }
}
protected RenderInfo _renderInfo;
///
/// Sets the field infos object.
///
/// This property is set by the AreaProvider.
public FieldInfos FieldInfos
{
set { _fieldInfos = value; }
}
protected FieldInfos _fieldInfos;
///
/// Renders (draws) the object to the Graphics object.
///
public abstract void Render();
///
/// Formats the object by calculating distances and linebreaks and stopping when the area is filled.
///
/// The area to render into.
/// An information object received from a previous call of Format().
/// Null for the first call.
public abstract void Format(Area area, FormatInfo previousFormatInfo);
///
/// Creates a fitting renderer for the given document object for formatting.
///
/// The XGraphics object to do measurements on.
/// The document renderer.
/// the document object to format.
/// The field infos.
/// The fitting Renderer.
public static Renderer Create(XGraphics gfx, DocumentRenderer documentRenderer, DocumentObject documentObject, FieldInfos fieldInfos)
{
Renderer renderer = null;
if (documentObject is Paragraph)
renderer = new ParagraphRenderer(gfx, (Paragraph)documentObject, fieldInfos);
else if (documentObject is Table)
renderer = new TableRenderer(gfx, (Table)documentObject, fieldInfos);
else if (documentObject is PageBreak)
renderer = new PageBreakRenderer(gfx, (PageBreak)documentObject, fieldInfos);
else if (documentObject is TextFrame)
renderer = new TextFrameRenderer(gfx, (TextFrame)documentObject, fieldInfos);
else if (documentObject is Chart)
renderer = new ChartRenderer(gfx, (Chart)documentObject, fieldInfos);
else if (documentObject is Image)
renderer = new ImageRenderer(gfx, (Image)documentObject, fieldInfos);
if (renderer != null)
renderer._documentRenderer = documentRenderer;
return renderer;
}
///
/// Creates a fitting renderer for the render info to render and layout with.
///
/// The XGraphics object to render on.
/// The document renderer.
/// The RenderInfo object stored after a previous call of Format().
/// The field infos.
/// The fitting Renderer.
public static Renderer Create(XGraphics gfx, DocumentRenderer documentRenderer, RenderInfo renderInfo, FieldInfos fieldInfos)
{
Renderer renderer = null;
if (renderInfo.DocumentObject is Paragraph)
renderer = new ParagraphRenderer(gfx, renderInfo, fieldInfos);
else if (renderInfo.DocumentObject is Table)
renderer = new TableRenderer(gfx, renderInfo, fieldInfos);
else if (renderInfo.DocumentObject is PageBreak)
renderer = new PageBreakRenderer(gfx, renderInfo, fieldInfos);
else if (renderInfo.DocumentObject is TextFrame)
renderer = new TextFrameRenderer(gfx, renderInfo, fieldInfos);
else if (renderInfo.DocumentObject is Chart)
renderer = new ChartRenderer(gfx, renderInfo, fieldInfos);
//else if (renderInfo.DocumentObject is Chart)
// renderer = new ChartRenderer(gfx, renderInfo, fieldInfos);
else if (renderInfo.DocumentObject is Image)
renderer = new ImageRenderer(gfx, renderInfo, fieldInfos);
if (renderer != null)
renderer._documentRenderer = documentRenderer;
return renderer;
}
public readonly static XUnit Tolerance = XUnit.FromPoint(0.001);
private XUnit _maxElementHeight = -1;
protected DocumentObject _documentObject;
protected DocumentRenderer _documentRenderer;
protected XGraphics _gfx;
}
}