提取文档中节点之间的内容

处理文档时，能够轻松地从文档中的特定范围中提取内容非常重要。然而，内容可能由复杂的元素组成，例如段落、表格、图像等。

无论需要提取什么内容，提取该内容的方法始终取决于选择哪些节点来提取其间的内容。这些可以是整个文本主体或简单的文本流。

有许多可能的情况，因此在提取内容时需要考虑许多不同的节点类型。例如，您可能想要提取以下内容之间的内容：

• 两个特定段落
• 特定的文本运行
• 各种类型的字段，例如合并字段
• 书签或评论的开始和结束范围
• 不同部分中包含的各种文本正文

在某些情况下，您甚至可能需要组合不同的节点类型，例如提取段落和字段之间，或者运行和书签之间的内容。

本文提供了在不同节点之间提取文本的代码实现，以及常见场景的示例。

这些示例只是多种可能性的几个演示。我们计划将来将文本提取功能纳入公共 API 的一部分，并且不需要额外的代码。同时，请随时在 Aspose.Words论坛 上发布有关此功能的请求。

为什么提取内容

通常，提取内容的目标是将其复制或单独保存在新文档中。例如，您可以提取内容并：

• 将其复制到单独的文档中
• 将文档的特定部分转换为 PDF 或图像
• 多次重复文档中的内容
• 与文档的其余部分分开处理提取的内容

使用 Aspose.Words 和下面的代码实现可以轻松实现这一点。

提取内容算法

本节中的代码使用一种通用且可重用的方法解决了上述所有可能的情况。该技术的总体轮廓包括：

1. 收集指示将从文档中提取的内容区域的节点。检索这些节点是由用户根据他们想要提取的内容在其代码中处理的。
2. 将这些节点传递给下面提供的 ExtractContent 方法。您还必须传递一个布尔参数，该参数指示这些充当标记的节点是否应包含在提取中。
3. 检索指定要提取的克隆内容（复制节点）的列表。您可以以任何适用的方式使用此节点列表，例如，创建仅包含所选内容的新文档。

如何提取内容

要从文档中提取内容，您需要调用下面的 ExtractContent 方法并传递适当的参数。该方法的基本原理涉及查找块级节点（段落和表格）并克隆它们以创建相同的副本。如果传递的标记节点是块级的，则该方法能够简单地复制该级别上的内容并将其添加到数组中。

但是，如果标记节点是内联的（段落的子节点），则情况会变得更加复杂，因为有必要在内联节点处拆分段落，无论是运行、书签字段等。克隆的父节点中的内容不会标记之间存在的内容被删除。此过程用于确保内联节点仍保留父段落的格式。该方法还将对作为参数传递的节点进行检查，如果任一节点无效，则抛出异常。要传递给该方法的参数是：

1.StartNode 和 EndNode。前两个参数是分别定义内容提取的开始和结束位置的节点。这些节点可以是块级（Paragraph、Table）或内联级（例如 Run、FieldStart、BookmarkStart 等）：

1. 要传递字段，您应该传递相应的 FieldStart 对象
2. 传递书签需要传递BookmarkStart和BookmarkEnd节点
3. 传递评论需要使用CommentRangeStart和CommentRangeEnd节点 1.IsInclusive。定义标记是否包含在提取中。如果该选项设置为false并且传递相同的节点或连续的节点，那么将返回一个空列表：
4. 如果传递 FieldStart 节点，则此选项定义是否包含或排除整个字段
5. 如果传递 BookmarkStart 或 BookmarkEnd 节点，则此选项定义是否包含书签或仅包含书签范围之间的内容。
6. 如果传递 CommentRangeStart 或 CommentRangeEnd 节点，则此选项定义是包含注释本身还是仅包含注释范围内的内容。

ExtractContent方法的实现你可以找到在 Aspose.Words GitHub 上。本文的场景中会用到该方法。

我们还将定义一个自定义方法来轻松地从提取的节点生成文档。此方法在下面的许多场景中都会使用，只需创建一个新文档并将提取的内容导入其中即可。

以下代码示例演示如何获取节点列表并将它们插入到新文档中：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
public static Document GenerateDocument(Document srcDoc, List<Node> nodes)
{
    Document dstDoc = new Document();
    // Remove the first paragraph from the empty document.
    dstDoc.FirstSection.Body.RemoveAllChildren();

    // Import each node from the list into the new document. Keep the original formatting of the node.
    NodeImporter importer = new NodeImporter(srcDoc, dstDoc, ImportFormatMode.KeepSourceFormatting);
    foreach (Node node in nodes)
    {
        Node importNode = importer.ImportNode(node, true);
        dstDoc.FirstSection.Body.AppendChild(importNode);
    }

    return dstDoc;
}

提取段落之间的内容

这演示了如何使用上述方法提取特定段落之间的内容。在本例中，我们想要提取文档前半部分中找到的信件正文。我们可以看出这是在第7段和第11段之间。

下面的代码完成了这个任务。使用文档上的 GetChild 方法并传递指定的索引来提取适当的段落。然后，我们将这些节点传递给 ExtractContent 方法，并声明这些节点将包含在提取中。此方法将返回这些节点之间复制的内容，然后将其插入到新文档中。

以下代码示例展示了如何使用上面的 ExtractContent 方法提取特定段落之间的内容：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Extract content.docx");

Paragraph startPara = (Paragraph) doc.FirstSection.Body.GetChild(NodeType.Paragraph, 6, true);
Paragraph endPara = (Paragraph) doc.FirstSection.Body.GetChild(NodeType.Paragraph, 10, true);
// Extract the content between these nodes in the document. Include these markers in the extraction.
List<Node> extractedNodes = ExtractContentHelper.ExtractContent(startPara, endPara, true);

Document dstDoc = ExtractContentHelper.GenerateDocument(doc, extractedNodes);
dstDoc.Save(ArtifactsDir + "ExtractContent.ExtractContentBetweenParagraphs.docx");

您可以从 Aspose.Words GitHub 下载本示例的示例文件。

提取不同类型节点之间的内容

我们可以在块级或内联节点的任意组合之间提取内容。在下面的这种情况下，我们将提取第一段和第二部分中的表格之间的内容。我们通过在文档的第二部分调用 FirstParagraph 和 GetChild 方法来检索适当的 Paragraph 和 Table 节点来获取标记节点。对于轻微的变化，让我们复制内容并将其插入到原始内容下方。

以下代码示例演示如何使用 ExtractContent 方法提取段落和表格之间的内容：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Extract content.docx");

Paragraph startPara = (Paragraph) doc.LastSection.GetChild(NodeType.Paragraph, 2, true);
Table endTable = (Table) doc.LastSection.GetChild(NodeType.Table, 0, true);
// Extract the content between these nodes in the document. Include these markers in the extraction.
List<Node> extractedNodes = ExtractContentHelper.ExtractContent(startPara, endTable, true);

// Let's reverse the array to make inserting the content back into the document easier.
extractedNodes.Reverse();
foreach (Node extractedNode in extractedNodes)                
    endTable.ParentNode.InsertAfter(extractedNode, endTable);            

doc.Save(ArtifactsDir + "ExtractContent.ExtractContentBetweenBlockLevelNodes.docx");

您可以从 Aspose.Words GitHub 下载本示例的示例文件。

根据样式提取段落之间的内容

您可能需要提取相同或不同样式的段落之间的内容，例如标有标题样式的段落之间。下面的代码展示了如何实现这一点。这是一个简单的示例，它将提取"标题 1"和"标题 3"样式的第一个实例之间的内容，而不提取标题。为此，我们将最后一个参数设置为 false，它指定不应包含标记节点。

在正确的实现中，应该循环运行以从文档中提取这些样式的所有段落之间的内容。提取的内容将复制到新文档中。

以下代码示例展示了如何使用 ExtractContent 方法提取具有特定样式的段落之间的内容：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Extract content.docx");

// Gather a list of the paragraphs using the respective heading styles.
List<Paragraph> parasStyleHeading1 = ParagraphsByStyleName(doc, "Heading 1");
List<Paragraph> parasStyleHeading3 = ParagraphsByStyleName(doc, "Heading 3");

// Use the first instance of the paragraphs with those styles.
Node startPara = parasStyleHeading1[0];
Node endPara = parasStyleHeading3[0];

// Extract the content between these nodes in the document. Don't include these markers in the extraction.
List<Node> extractedNodes = ExtractContentHelper.ExtractContent(startPara, endPara, false);

Document dstDoc = ExtractContentHelper.GenerateDocument(doc, extractedNodes);
dstDoc.Save(ArtifactsDir + "ExtractContent.ExtractContentBetweenParagraphStyles.docx");

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
public List<Paragraph> ParagraphsByStyleName(Document doc, string styleName)
{
    // Create an array to collect paragraphs of the specified style.
    List<Paragraph> paragraphsWithStyle = new List<Paragraph>();
    NodeCollection paragraphs = doc.GetChildNodes(NodeType.Paragraph, true);

    // Look through all paragraphs to find those with the specified style.
    foreach (Paragraph paragraph in paragraphs)
    {
        if (paragraph.ParagraphFormat.Style.Name == styleName)
            paragraphsWithStyle.Add(paragraph);
    }

    return paragraphsWithStyle;
}

您可以从 Aspose.Words GitHub 下载本示例的示例文件。

在特定运行之间提取内容

您还可以提取内联节点（例如 Run）之间的内容。不同段落的 Runs 可以作为标记传递。下面的代码显示了如何提取同一 Paragraph 节点之间的特定文本。

以下代码示例演示如何使用 ExtractContent 方法提取同一段落的特定运行之间的内容：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Extract content.docx");

Paragraph para = (Paragraph) doc.GetChild(NodeType.Paragraph, 7, true);
Run startRun = para.Runs[1];
Run endRun = para.Runs[4];

// Extract the content between these nodes in the document. Include these markers in the extraction.
List<Node> extractedNodes = ExtractContentHelper.ExtractContent(startRun, endRun, true);
foreach (Node extractedNode in extractedNodes)
    Console.WriteLine(extractedNode.ToString(SaveFormat.Text));

您可以从 Aspose.Words GitHub 下载本示例的示例文件。

使用字段提取内容

要使用字段作为标记，应传递 FieldStart 节点。 ExtractContent 方法的最后一个参数将定义是否包含整个字段。让我们提取"FullName"合并字段和文档中的段落之间的内容。我们使用DocumentBuilder类的MoveToMergeField方法。这将从传递给它的合并字段的名称返回 FieldStart 节点。

在我们的例子中，我们将传递给 ExtractContent 方法的最后一个参数设置为 false 以从提取中排除该字段。我们会将提取的内容呈现为 PDF。

以下代码示例演示如何使用 ExtractContent 方法提取文档中特定字段和段落之间的内容：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Extract content.docx");
DocumentBuilder builder = new DocumentBuilder(doc);
// Pass the first boolean parameter to get the DocumentBuilder to move to the FieldStart of the field.
// We could also get FieldStarts of a field using GetChildNode method as in the other examples.
builder.MoveToMergeField("Fullname", false, false);

// The builder cursor should be positioned at the start of the field.
FieldStart startField = (FieldStart) builder.CurrentNode;
Paragraph endPara = (Paragraph) doc.FirstSection.GetChild(NodeType.Paragraph, 5, true);
// Extract the content between these nodes in the document. Don't include these markers in the extraction.
List<Node> extractedNodes = ExtractContentHelper.ExtractContent(startField, endPara, false);

Document dstDoc = ExtractContentHelper.GenerateDocument(doc, extractedNodes);
dstDoc.Save(ArtifactsDir + "ExtractContent.ExtractContentUsingField.docx");

您可以从 Aspose.Words GitHub 下载本示例的示例文件。

从书签中提取内容

在文档中，书签中定义的内容由 BookmarkStart 和 BookmarkEnd 节点封装。在这两个节点之间找到的内容构成了书签。您可以将这些节点中的任何一个作为任何标记传递，甚至可以是来自不同书签的标记，只要起始标记出现在文档中的结束标记之前即可。我们将使用下面的代码将此内容提取到一个新文档中。 IsInclusive 参数选项显示如何保留或丢弃书签。

以下代码示例演示如何使用 ExtractContent 方法提取引用书签的内容：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Extract content.docx");            

Bookmark bookmark = doc.Range.Bookmarks["Bookmark1"];            
BookmarkStart bookmarkStart = bookmark.BookmarkStart;
BookmarkEnd bookmarkEnd = bookmark.BookmarkEnd;

// Firstly, extract the content between these nodes, including the bookmark.
List<Node> extractedNodesInclusive = ExtractContentHelper.ExtractContent(bookmarkStart, bookmarkEnd, true);
            
Document dstDoc = ExtractContentHelper.GenerateDocument(doc, extractedNodesInclusive);
dstDoc.Save(ArtifactsDir + "ExtractContent.ExtractContentBetweenBookmark.IncludingBookmark.docx");

// Secondly, extract the content between these nodes this time without including the bookmark.
List<Node> extractedNodesExclusive = ExtractContentHelper.ExtractContent(bookmarkStart, bookmarkEnd, false);
            
dstDoc = ExtractContentHelper.GenerateDocument(doc, extractedNodesExclusive);
dstDoc.Save(ArtifactsDir + "ExtractContent.ExtractContentBetweenBookmark.WithoutBookmark.docx");

您可以从 Aspose.Words GitHub 下载本示例的示例文件。

从评论中提取内容

注释由 CommentRangeStart、CommentRangeEnd 和 Comment 节点组成。所有这些节点都是内联的。前两个节点封装了注释引用的文档中的内容，如下面的屏幕截图所示。

Comment 节点本身是一个可以包含段落和运行的 InlineStory。它代表评论的消息，在审阅窗格中显示为评论气泡。由于此节点是内联的并且是正文的后代，因此您也可以从此消息中提取内容。

注释概括了第二部分中的标题、第一段和表格。让我们将此评论提取到一个新文档中。 IsInclusive 选项指示评论本身是保留还是丢弃。

以下代码示例展示了如何执行此操作：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Extract content.docx");

CommentRangeStart commentStart = (CommentRangeStart) doc.GetChild(NodeType.CommentRangeStart, 0, true);
CommentRangeEnd commentEnd = (CommentRangeEnd) doc.GetChild(NodeType.CommentRangeEnd, 0, true);

// Firstly, extract the content between these nodes including the comment as well.
List<Node> extractedNodesInclusive = ExtractContentHelper.ExtractContent(commentStart, commentEnd, true);
            
Document dstDoc = ExtractContentHelper.GenerateDocument(doc, extractedNodesInclusive);
dstDoc.Save(ArtifactsDir + "ExtractContent.ExtractContentBetweenCommentRange.IncludingComment.docx");

// Secondly, extract the content between these nodes without the comment.
List<Node> extractedNodesExclusive = ExtractContentHelper.ExtractContent(commentStart, commentEnd, false);
            
dstDoc = ExtractContentHelper.GenerateDocument(doc, extractedNodesExclusive);
dstDoc.Save(ArtifactsDir + "ExtractContent.ExtractContentBetweenCommentRange.WithoutComment.docx");

您可以从 Aspose.Words GitHub 下载本示例的示例文件。

如何使用 DocumentVisitor 提取内容

使用DocumentVisitor类来实现这个使用场景。该类对应于众所周知的 Visitor 设计模式。使用 DocumentVisitor ,，您可以定义和执行需要枚举文档树的自定义操作。

DocumentVisitor 提供了一组 VisitXXX 方法，当遇到特定文档元素（节点）时将调用这些方法。例如，当找到文本段落的开头时，将调用 VisitParagraphStart；当找到文本段落的结尾时，将调用 VisitParagraphEnd。每个 DocumentVisitor.VisitXXX 方法接受它遇到的相应对象，因此您可以根据需要使用它（例如检索格式），例如 DocumentVisitor.VisitParagraphStart 和 DocumentVisitor.VisitParagraphEnd 都接受 Paragraph 对象。

每个 DocumentVisitor.VisitXXX 方法都会返回一个控制节点枚举的 VisitorAction 值。您可以请求继续枚举、跳过当前节点（但继续枚举）或停止节点枚举。

您应遵循以下步骤以编程方式确定和提取文档的各个部分：

• 创建一个从 DocumentVisitor 派生的类
• 覆盖并提供部分或全部 DocumentVisitor.VisitXXX 方法的实现以执行一些自定义操作
• 在要开始枚举的节点上调用Node.Accept，例如，如果要枚举整个文档，则使用Document.Accept

DocumentVisitor 为所有 DocumentVisitor.VisitXXX 方法提供默认实现。这使得创建新的文档访问者变得更容易，因为只需要覆盖特定访问者所需的方法。没有必要重写所有访问者方法。

以下示例演示如何使用访问者模式向 Aspose.Words 对象模型添加新操作。在本例中，我们创建一个简单的文本格式文档转换器：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Extract content.docx");

ConvertDocToTxt convertToPlainText = new ConvertDocToTxt();
// Note that every node in the object model has the accept method so the visiting
// can be executed not only for the whole document, but for any node in the document.
doc.Accept(convertToPlainText);

// Once the visiting is complete, we can retrieve the result of the operation,
// That in this example, has accumulated in the visitor.
Console.WriteLine(convertToPlainText.GetText());

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
/// <summary>
/// Simple implementation of saving a document in the plain text format. Implemented as a Visitor.
/// </summary>
internal class ConvertDocToTxt : DocumentVisitor
{
    public ConvertDocToTxt()
    {
        mIsSkipText = false;
        mBuilder = new StringBuilder();
    }

    /// <summary>
    /// Gets the plain text of the document that was accumulated by the visitor.
    /// </summary>
    public string GetText()
    {
        return mBuilder.ToString();
    }

    /// <summary>
    /// Called when a Run node is encountered in the document.
    /// </summary>
    public override VisitorAction VisitRun(Run run)
    {
        AppendText(run.Text);
        // Let the visitor continue visiting other nodes.
        return VisitorAction.Continue;
    }

    /// <summary>
    /// Called when a FieldStart node is encountered in the document.
    /// </summary>
    public override VisitorAction VisitFieldStart(FieldStart fieldStart)
    {
        // In Microsoft Word, a field code (such as "MERGEFIELD FieldName") follows
        // after a field start character. We want to skip field codes and output field.
        // Result only, therefore we use a flag to suspend the output while inside a field code.
        // Note this is a very simplistic implementation and will not work very well.
        // If you have nested fields in a document.
        mIsSkipText = true;
        return VisitorAction.Continue;
    }

    /// <summary>
    /// Called when a FieldSeparator node is encountered in the document.
    /// </summary>
    public override VisitorAction VisitFieldSeparator(FieldSeparator fieldSeparator)
    {
        // Once reached a field separator node, we enable the output because we are
        // now entering the field result nodes.
        mIsSkipText = false;
        return VisitorAction.Continue;
    }

    /// <summary>
    /// Called when a FieldEnd node is encountered in the document.
    /// </summary>
    public override VisitorAction VisitFieldEnd(FieldEnd fieldEnd)
    {
        // Make sure we enable the output when reached a field end because some fields
        // do not have field separator and do not have field result.
        mIsSkipText = false;
        return VisitorAction.Continue;
    }

    /// <summary>
    /// Called when visiting of a Paragraph node is ended in the document.
    /// </summary>
    public override VisitorAction VisitParagraphEnd(Paragraph paragraph)
    {
        // When outputting to plain text we output Cr+Lf characters.
        AppendText(ControlChar.CrLf);
        return VisitorAction.Continue;
    }

    public override VisitorAction VisitBodyStart(Body body)
    {
        // We can detect beginning and end of all composite nodes such as Section, Body, 
        // Table, Paragraph etc and provide custom handling for them.
        mBuilder.Append("*** Body Started ***\r\n");
        return VisitorAction.Continue;
    }

    public override VisitorAction VisitBodyEnd(Body body)
    {
        mBuilder.Append("*** Body Ended ***\r\n");
        return VisitorAction.Continue;
    }

    /// <summary>
    /// Called when a HeaderFooter node is encountered in the document.
    /// </summary>
    public override VisitorAction VisitHeaderFooterStart(HeaderFooter headerFooter)
    {
        // Returning this value from a visitor method causes visiting of this
        // Node to stop and move on to visiting the next sibling node
        // The net effect in this example is that the text of headers and footers
        // Is not included in the resulting output
        return VisitorAction.SkipThisNode;
    }

    /// <summary>
    /// Adds text to the current output. Honors the enabled/disabled output flag.
    /// </summary>
    private void AppendText(string text)
    {
        if (!mIsSkipText)
            mBuilder.Append(text);
    }

    private readonly StringBuilder mBuilder;
    private bool mIsSkipText;
}

您可以从 Aspose.Words GitHub 下载本示例的示例文件。

如何仅提取文本

从文档中检索文本的方法有：

• 使用 Document.Save 和 SaveFormat.Text 将纯文本保存到文件或流中
• 使用Node.ToString并传递SaveFormat.Text参数。在内部，这会调用另存为文本到内存流中并返回结果字符串
• 使用 Node.GetText 检索包含所有 Microsoft Word 控制字符（包括域代码）的文本
• 实现自定义 DocumentVisitor 来执行自定义提取

使用 Node.GetText 和 Node.ToString

Word 文档可以包含指定特殊元素（例如字段、单元格结尾、节结尾等）的控制字符。可能的 Word 控制字符的完整列表在 ControlChar 类中定义。 Node.GetText 方法返回包含节点中存在的所有控制字符的文本。

调用 ToString 仅返回不带控制字符的文档的纯文本表示形式。有关导出为纯文本的更多信息，请参阅以下 “使用 SaveFormat.Text” 部分。

以下代码示例显示了在节点上调用 GetText 和 ToString 方法之间的区别：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);            
            
builder.InsertField("MERGEFIELD Field");

// When converted to text it will not retrieve fields code or special characters,
// but will still contain some natural formatting characters such as paragraph markers etc. 
// This is the same as "viewing" the document as if it was opened in a text editor.
Console.WriteLine("Convert to text result: " + doc.ToString(SaveFormat.Text));

使用 SaveFormat.Text

本示例保存文档如下：

• 过滤掉字段字符和字段代码、形状、脚注、尾注和注释引用
• 用 ControlChar.CrLf 组合替换 ControlChar.Cr 段落末尾字符
• 使用UTF8编码

以下代码示例展示了如何将文档保存为 TXT 格式：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Document.docx");
doc.Save(ArtifactsDir + "BaseConversions.DocxToTxt.txt");

从形状中提取图像

您可能需要提取文档图像来执行某些任务。 Aspose.Words 也允许您这样做。

以下代码示例展示了如何从文档中提取图像：

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document(MyDir + "Images.docx");

NodeCollection shapes = doc.GetChildNodes(NodeType.Shape, true);
int imageIndex = 0;
            
foreach (Shape shape in shapes)
{
    if (shape.HasImage)
    {
        string imageFileName =
            $"Image.ExportImages.{imageIndex}_{FileFormatUtil.ImageTypeToExtension(shape.ImageData.ImageType)}";

        // Note, if you have only an image (not a shape with a text and the image),
        // you can use shape.GetShapeRenderer().Save(...) method to save the image.
        shape.ImageData.Save(ArtifactsDir + imageFileName);
        imageIndex++;
    }
}