Skip to content

Commit c85b462

Browse files
committed
Added missing xml comments
1 parent 3c2ca9d commit c85b462

File tree

3 files changed

+35
-1
lines changed

3 files changed

+35
-1
lines changed

src/Synercoding.FileFormats.Pdf/PdfInternals/Objects/IPdfObject.cs

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,18 @@
33

44
namespace Synercoding.FileFormats.Pdf.PdfInternals.Objects
55
{
6+
/// <summary>
7+
/// Interface representing a pdf object
8+
/// </summary>
69
public interface IPdfObject : IStreamWriteable, IDisposable
710
{
11+
/// <summary>
12+
/// A pdf reference object that can be used to reference to this object
13+
/// </summary>
814
PdfReference Reference { get; }
15+
/// <summary>
16+
/// Indicator to check whether this object has been written to the PDF stream
17+
/// </summary>
918
bool IsWritten { get; }
1019
}
1120
}

src/Synercoding.FileFormats.Pdf/PdfInternals/Objects/Image.cs

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,9 @@
55

66
namespace Synercoding.FileFormats.Pdf.PdfInternals.Objects
77
{
8+
/// <summary>
9+
/// A class representing an image
10+
/// </summary>
811
public class Image : IPdfObject, IDisposable
912
{
1013
private readonly SixLabors.ImageSharp.Image _image;
@@ -16,10 +19,13 @@ internal Image(PdfReference id, SixLabors.ImageSharp.Image image)
1619
_image = image;
1720
}
1821

22+
/// <inheritdoc />
1923
public PdfReference Reference { get; private set; }
2024

25+
/// <inheritdoc />
2126
public bool IsWritten { get; private set; }
2227

28+
/// <inheritdoc />
2329
public void Dispose()
2430
{
2531
if(!_disposed)
@@ -29,6 +35,7 @@ public void Dispose()
2935
}
3036
}
3137

38+
/// <inheritdoc />
3239
public uint WriteToStream(Stream stream)
3340
{
3441
if(_disposed)
Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,36 @@
11
namespace Synercoding.FileFormats.Pdf.PdfInternals
22
{
3-
public struct PdfReference
3+
/// <summary>
4+
/// A struct representing a reference
5+
/// </summary>
6+
public readonly struct PdfReference
47
{
8+
/// <summary>
9+
/// Constructor for <see cref="PdfReference"/> that uses generation 0
10+
/// </summary>
11+
/// <param name="objectId">The id of the reference</param>
512
public PdfReference(int objectId)
613
: this(objectId, 0)
714
{ }
815

16+
/// <summary>
17+
/// Constructor for <see cref="PdfReference"/>
18+
/// </summary>
19+
/// <param name="objectId">The id of the reference</param>
20+
/// <param name="generation">The generation of the reference</param>
921
public PdfReference(int objectId, int generation)
1022
{
1123
ObjectId = objectId;
1224
Generation = generation;
1325
}
1426

27+
/// <summary>
28+
/// The object id of this reference
29+
/// </summary>
1530
public int ObjectId { get; }
31+
/// <summary>
32+
/// The generation of this reference
33+
/// </summary>
1634
public int Generation { get; }
1735
}
1836
}

0 commit comments

Comments
 (0)